NAME¶

x86dis - disassemble a bytestream of Intel x86 instructions

SYNTAX¶

x86dis [ -a offset|--addr=offset]
[ -r offset len|--range=offset len]
[ -e offset|--entry=offset]
[ -s name|--syntax=name]
[ -d name|--desc=name]
[ -f file|--file=file]
[ -o file|--out=file]
[ -l file|--log=file]
[ -p num|--pagesize=num]
[ -h|-?|--help]
[ -v|--version]

DESCRIPTION¶

A command-line interface to the libdisasm disassembler library.

OPTIONS¶

At least one option from the list -a, -e, -r must be given.

-f, --file=file

 

Read input bytes from file instead of stdin

-o, --out=file

 

Write output to file instead of stdout

-l, --log=file

 

Log errors to file instead of stderr

-p, --pagesize=num

 

Set page size for buffering STDIN to num (default 512K)

-s, --syntax=name

 

Set output syntax to name, where name is one of intel

 

(Intel syntax), att (AT&T syntax), raw (libdisasm syntax)

-d, --desc=name

 

Print a description of syntax name

-a, --addr=offset

 

Disassemble single instruction at offset

-e, --entry=offset

 

Disassemble forward from offset

-r, --range=offset len

 

Disassemble len bytes starting at offset

 

All offset and len parameters are expected to follow the conventions used in strtoul(3), where hexadecimal numbers have the prefix 0x, octal numbers have the prefix 0, and decimal numbers have no prefix. A value of 0 for len indicates that that range extends to the end of the file.

EXAMPLES¶

cat `which ls` | x86dis -s intel -e 0x00 -r 0x00 -1 -a 0xEEEE x86dis -e 0 -s intel < bootsect.img x86dis -d -s raw -f a.out -e `readelf -h a.out |
grep Entry | awk '{ printf( "0x%%x", strtonum($4) - 0x8048000 ) }` echo '55 89 e5 83 EC 08' | perl -ane 'foreach(@F){print pack("C",hex);}'| x86dis -e 0 -s att

NOTES¶

x86dis performs no file format parsing, nor any verification that its input is in fact executable binary code. All offsets are assumed to be from the start of the file, with no load addresses applied. The intent is to provide a bytestream disassembler rather than an object file disassembler. Descriptions of the various output formats can be obtained using the -d option.

AUTHORS¶

mammon_ <mammon_@users.sourceforge.net>

SEE ALSO¶

bastard(1), libdisasm(7), x86_disasm(3), x86_format_insn(3), x86_init(3)