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)