hacktricks/exploiting/tools/pwntools.md

# PwnTools

```
pip3 install pwntools
```

## Pwn asm 

Get opcodes from line or file. 

```
pwn asm "jmp esp" 
pwn asm -i <filepath>
```

**Can select: **

* output type (raw,hex,string,elf)
* output file context (16,32,64,linux,windows...)
* avoid bytes (new lines, null, a list) 
* select encoder debug shellcode using gdb run the output

##   **Pwn checksec**

Checksec script 

```
pwn checksec <executable>
```

## Pwn constgrep

## Pwn cyclic 

Get a pattern

```
pwn cyclic 3000
pwn cyclic -l faad
```

**Can select:**    

* The used alphabet (lowercase chars by default)
* Length of uniq pattern (default 4)
* context (16,32,64,linux,windows...)
* Take the offset (-l)

## Pwn debug

Attach GDB to a process

```
pwn debug --exec /bin/bash
pwn debug --pid 1234
pwn debug --process bash
```

**Can select:** 

* By executable, by name or by pid context (16,32,64,linux,windows...) 
* gdbscript to execute 
* sysrootpath

## Pwn disablenx 

Disable nx of a binary  

```
pwn disablenx <filepath>
```

## Pwn disasm 

Disas hex opcodes

```
pwn disasm ffe4
```

**Can select:** 

* context (16,32,64,linux,windows...) 
* base addres 
* color(default)/no color

## Pwn elfdiff 

Print differences between 2 fiels

```
pwn elfdiff <file1> <file2>
```

## Pwn hex 

Get hexadecimal representation

```bash
pwn hex hola #Get hex of "hola" ascii
```

## Pwn phd 

Get hexdump 

```
pwn phd <file>
```

 **Can select:** 

* Number of bytes to show 
* Number of bytes per line highlight byte 
* Skip bytes at beginning

## Pwn pwnstrip 

## Pwn scrable

## Pwn shellcraft 

Get shellcodes

```
pwn shellcraft -l #List shellcodes 
pwn shellcraft -l amd #Shellcode with amd in the name
pwn shellcraft -f hex amd64.linux.sh #Create in C and run
pwn shellcraft -r amd64.linux.sh #Run to test. Get shell 
pwn shellcraft .r amd64.linux.bindsh 9095 #Bind SH to port
```

**Can select:**

* shellcode and arguments for the shellcode
* Out file
* output format
* debug (attach dbg to shellcode)
* before (debug trap before code) 
* after
* avoid using opcodes (default: not null and new line)
* Run the shellcode
* Color/no color
* list syscalls 
* list possible shellcodes 
* Generate ELF as a shared library

## Pwn template 

Get a python template 

```
pwn template
```

**Can select:** host, port, user, pass, path and quiet

## Pwn unhex 

From hex to string 

```
pwn unhex 686f6c61
```

## Pwn update 

To update pwntools

```
pwn update
```