Updated READMEs

Author: voydstack

ARM32/README.md

@@ -1,48 +1,55 @@
 # Shellcodes Linux ARMv7 (32 bits)
 
-Voici une collection de shellcodes pour Linux ARMv7, pour l'instant ceux-là sont disponibles j'en rajouterai sûrement à l'avenir.
+Linux ARMv7 shellcode collection without any nullbytes, spaces or newlines.
 
-### **[exit(0) (16 octets)](https://github.com/voydstack/shellcoding/tree/master/ARM32/exit)**
+### **[exit(0) (16 bytes)](https://github.com/voydstack/shellcoding/tree/master/ARM32/exit)**
 
-Sort du programme en cours d'exécution avec 0 en code de retour.
+Simply exits.
 
-### **[Hello, World (43 octets)](https://github.com/voydstack/shellcoding/tree/master/ARM32/hello)**
+### **[Hello, World (36 bytes)](https://github.com/voydstack/shellcoding/tree/master/ARM32/hello)**
 
-Affiche "Hello, World !\n" puis quitte le programme.
+Displays "Hello,World!".
 
-### **[/bin/sh (28 octets)](https://github.com/voydstack/shellcoding/tree/master/ARM32/shell)**
+### **[/bin/sh (28 bytes)](https://github.com/voydstack/shellcoding/tree/master/ARM32/shell)**
 
-Ouvre un shell sans fixer les permissions.
+Executes `execve("/bin/sh", NULL, NULL)`.
 
-### **[setreuid /bin/sh (40 octets)](https://github.com/voydstack/shellcoding/tree/master/ARM32/setreuid-shell)**
+### **[setreuid /bin/sh (40 bytes)](https://github.com/voydstack/shellcoding/tree/master/ARM32/setreuid-shell)**
 
-Ouvre un shell en fixant les permissions avec setreuid(1000, 1000).
+Executes `setreuid(1000, 1000); execve("/bin/sh", NULL, NULL)`.
 
-### **[bindshell (104 octets)](https://github.com/voydstack/shellcoding/tree/master/ARM32/bind-shell)**
+### **[bindshell (92 bytes)](https://github.com/voydstack/shellcoding/tree/master/ARM32/bind-shell)**
 
-Attache un shell au port 1337.
+Runs a bind-shell on port 4444.
 
-### **[reverse shell (84 octets)](https://github.com/voydstack/shellcoding/tree/master/ARM32/reverse-shell)**
+### **[reverse shell (72 bytes)](https://github.com/voydstack/shellcoding/tree/master/ARM32/reverse-shell)**
 
-Se connecte en retour à l'adresse 192.168.1.64 au port 1337.
+Runs a reverse shell on 127.0.0.1:4444.
 
-### **[read /etc/passwd (52 octets)](https://github.com/voydstack/shellcoding/tree/master/ARM32/readfile)**
+### **[read /etc/passwd (56 bytes)](https://github.com/voydstack/shellcoding/tree/master/ARM32/readfile)**
 
-Lit un fichier (dans ce cas là /etc/passwd) et affiche son contenu sur stdout.
+Reads a file (/etc/passwd in the shellcode).
 
-## Modifier et assembler un shellcode
+### **[read second stage (20 bytes)](https://github.com/voydstack/shellcoding/tree/master/ARM32/read-stage)**
 
-Pour modifier les shellcodes présents ici, par exemple pour changer le numéro de port, il suffit de faire la modification directement dans le code du shellcode, puis de l'assembler avec la commande:
+Reads a second stage shellcode next to it.
 
-```sh
-as shellcode.s -o shellcode.o && ld shellcode.o -N -o shellcode
-objcopy -O binary shellcode shellcode.bin && rm shellcode.o shellcode
+
+
+### Assemble shellcodes
+
+```
+arm-linux-gnueabihf-gcc shellcode.s -c && arm-linux-gnueabihf-ld shellcode.o -o shellcode
+arm-linux-gnueabihf-objcopy -O binary shellcode shellcode.bin && rm shellcode.o shellcode
+```
+
+### Run shellcodes
+
+```
+qemu-arm -L /usr/lib/arm-linux-gnueabihf/ ./executor < shellcode.bin
 ```
 
-Pour le tester, on peut utiliser le programme executor qui va mapper une zone mémoire exécutable puis l'exécuter avec notre shellcode à l'intérieur.
+### References
 
-```sh
-cat shellcode.bin | ./executor
-# Ou encore
-./executor "$(cat shellcode.bin)"
-```
+- [https://azeria-labs.com/writing-arm-shellcode/](https://azeria-labs.com/writing-arm-shellcode/)
+- https://www.ic.unicamp.br/~ranido/mc404/docs/ARMv7-cheat-sheet.pdf

aarch64/README.md

@@ -1,6 +1,6 @@
-# Linux Shellcodes - aarch64 (ARM 64 bits)
+# Linux aarch64 Shellcodes (ARM 64 bits)
 
-Here is a aarch64 nullbyte-free shellcode collection.
+Linux aarch64 shellcode collection without any nullbytes, spaces or newlines.
 
 ### **[exit(0) (12 bytes)](https://github.com/voydstack/shellcoding/tree/master/aarch64/exit)**
 
@@ -41,7 +41,7 @@ aarch64-linux-gnu-as shellcode.s -o shellcode.o && aarch64-linux-gnu-ld shellcod
 aarch64-linux-gnu-objcopy -O binary shellcode shellcode.bin && rm shellcode.o shellcode
 ```
 
-Run shellcodes:
+### Run shellcodes:
 
 ```sh
 ./executor [start offset] < shellcode.bin

mips32/README.md

@@ -1,6 +1,6 @@
-# Linux Shellcodes - MIPS (MIPS 32 bits, big endian)
+# Linux MIPS Shellcodes - (32 bits, big endian)
 
-MIPS shellcode collection without any nullbytes, spaces or newlines.
+Linux MIPS shellcode collection without any nullbytes, spaces or newlines.
 
 ### **[exit(0) (12 bytes)](https://github.com/voydstack/shellcoding/tree/master/mips32/exit)**
 
@@ -39,7 +39,7 @@ mips-linux-gnu-objcopy -O binary shellcode shellcode.bin && rm shellcode.o shell
 ./assemble.sh
 ```
 
-Run shellcodes:
+### Run shellcodes:
 
 ```sh
 ./executor [start offset] < shellcode.bin

risc-v/README.md

@@ -1,6 +1,6 @@
-# Linux Shellcodes - MIPS (MIPS 32 bits, big endian)
+# Linux Shellcodes - RISC-V (64 bits)
 
-Here is a RISC-V space, newline and null-byte free shellcode collection.
+Linux RISC-V shellcode collection without any nullbytes, spaces or newlines.
 
 ### **[exit(0) (32 bytes)](https://github.com/voydstack/shellcoding/tree/master/risc-v/exit)**
 
@@ -32,7 +32,9 @@ Reads a file and displays its output to stdout.
 
 ### **[read second stage (38 bytes)](https://github.com/voydstack/shellcoding/tree/master/risc-v/read-stage)**
 
-Reads a second-stage shellcode next to it (position independent)
+Reads a second-stage shellcode next to it (position independent).
+
+
 
 ## Assemble shellcodes
 
@@ -41,7 +43,7 @@ riscv64-linux-gnu-gcc shellcode.s -c && riscv64-linux-gnu-ld shellcode.o -o shel
 riscv64-linux-gnu-objcopy -O binary shellcode shellcode.bin && rm shellcode.o shellcode
 ```
 
-Run shellcodes:
+### Run shellcodes:
 
 ```sh
 qemu-riscv64 -L /usr/riscv64-linux-gnu/ ./executor < shellcode.bin
@@ -53,4 +55,5 @@ qemu-riscv64 -L /usr/riscv64-linux-gnu/ ./executor < shellcode.bin
 - [http://csl.snu.ac.kr/courses/4190.307/2020-1/riscv-user-isa.pdf](http://csl.snu.ac.kr/courses/4190.307/2020-1/riscv-user-isa.pdf)
 - [https://www.cs.sfu.ca/~ashriram/Courses/CS295/assets/notebooks/RISCV/RISCV_CARD.pdf](https://www.cs.sfu.ca/~ashriram/Courses/CS295/assets/notebooks/RISCV/RISCV_CARD.pdf)
 - [https://modexp.wordpress.com/2017/09/11/shellcode-linux-risc-v/](https://modexp.wordpress.com/2017/09/11/shellcode-linux-risc-v/)
-- [https://î.fr/riscv-alphanumeric-shellcoding/defcon27_riscv-alphanumeric-shellcoding.pdf](https://î.fr/riscv-alphanumeric-shellcoding/defcon27_riscv-alphanumeric-shellcoding.pdf)
+- [https://î.fr/riscv-alphanumeric-shellcoding/defcon27_riscv-alphanumeric-shellcoding.pdf](https://î.fr/riscv-alphanumeric-shellcoding/defcon27_riscv-alphanumeric-shellcoding.pdf)
+

x64/README.md

@@ -1,6 +1,6 @@
-# Shellcodes Linux x64
+# Linux x64 Shellcodes
 
-x64 shellcode collection without any nullbytes, spaces or newlines.
+Linux x64 shellcode collection without any nullbytes, spaces or newlines.
 
 ### **[exit(0) (8 bytes)](https://github.com/voydstack/shellcoding/tree/master/x64/exit)**
 
@@ -34,15 +34,15 @@ Reads a file (/etc/passwd in the shellcode).
 
 Reads a second stage shellcode next to it.
 
-Assemble shellcodes:
+### Assemble shellcodes:
 
 ```sh
 ./assemble.sh # Assembles every shellcodes in this directory
 # or 
 nasm -f bin shellcode.asm -o shellcode.bin
 ```
 
-To test shellcodes:
+### Run shellcodes:
 
 ```sh
 ./executor < shellcode.bin

x86/README.md

@@ -1,6 +1,6 @@
-# Shellcodes Linux x86
+# Linux x86 Shellcodes
 
-x86 shellcode collection without any nullbytes, spaces or newlines.
+Linux x86 shellcode collection without any nullbytes, spaces or newlines.
 
 ### **[exit(0) (7 bytes)](https://github.com/voydstack/shellcoding/tree/master/x86/exit)**
 
@@ -34,16 +34,15 @@ Reads a file (/etc/passwd in the shellcode).
 
 Reads a second stage shellcode next to it.
 
-
-Assemble shellcodes:
+### Assemble shellcodes:
 
 ```sh
 ./assemble.sh # Assembles every shellcodes in this directory
 # or 
 nasm -f bin shellcode.asm -o shellcode.bin
 ```
 
-To test shellcodes:
+### Run shellcodes:
 
 ```sh
 ./executor < shellcode.bin