DragonFly On-Line Manual Pages

X86DIS(1)                          libdisasm                         X86DIS(1)

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)

mammon_                              0.21                            X86DIS(1)