aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorFreeArtMan <dos21h@gmail.com>2015-12-18 21:57:16 +0000
committerFreeArtMan <dos21h@gmail.com>2015-12-18 21:57:16 +0000
commit7eeac6aea8812282a0a206823da77fc8f837c2ee (patch)
tree664a98c1bd4b0ec5d88655d6ea98121c2bdb030f
parent41e9c6754701dc768a07ad9f1b2e14b984b364e9 (diff)
downloaddm-master.tar.gz
dm-master.zip
Added READMEHEADmaster
-rw-r--r--README.md77
1 files changed, 77 insertions, 0 deletions
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..a99abc5
--- /dev/null
+++ b/README.md
@@ -0,0 +1,77 @@
+# DM - data match mini data language
+
+mini language to match some data in files it could be just binary file or
+it could be some bookmarks and when data is found script output some info
+about that
+
+## Examples
+
+### Print about position in file
+
+Here how looks scripts to bookmark some position
+```
+0x01 "byte one"
+0x02 "byte two"
+```
+This could be used to bookmark stuff in files
+
+### Check bytes in position
+
+Here is example where output will tell if its 32/64bit file and with kind of
+file type it is relocatable/executable/shared/core elf.
+
+```
+0x0-0x3
+ "magic number"
+0x4
+ if (0x01) "32 bit elf"
+ if (0x02) "64 bit elf"
+0x5
+ if (0x01) "little endian"
+ if (0x02) "big endian"
+0x10
+ if (0x1) "relocatable ELF"
+ if (0x2) "executable ELF"
+ if (0x3) "shared ELF"
+ if (0x4) "Core ELF what that"
+
+```
+
+## Compiling
+
+just make should work
+
+```text
+make
+```
+
+if not then probably you dont have ragel just remove it from makefile and it
+should work fine as ragel generated *.c file is allready included
+
+## Source
+
+```text
+git clone http://git.main.lv/cgit.cgi/dm.git
+```
+
+or
+
+```text
+git clone https://github.com/FreeArtMan/dm.git
+```
+
+main development site is http://main.lv and main git repo is http://git.main.lv
+
+## Future
+
+Future features will be added if there will practical demand for them if there
+will be some moment when they will be really needed.
+
+Could be added
+* support for if's in the row
+* add binary masks
+* generation of csv table
+* genrate c struct to embed in programms
+* genrate other languages (lua/python/sh)
+* work with pipe could cat some /dev/random or so
+* support streamed data \ No newline at end of file