Z80DASM(1)						  Z80 disassembler User's manual						Z80DASM(1)

NAME

       z80dasm - Z80 assembly generating disassembler

SYNOPSIS

       z80dasm [ options ] file

DESCRIPTION

       z80dasm	disassembles  a  binary  file  containing  Z80	machine code into Z80 assembly language source (including a number of undocumented
       opcodes). It can try to guess locations of labels in the code or the labels can be specified by hand in the form of a symbol file. If given
       proper information the disassembler can also split the binary file into code and data sections of several different types.

       Generated  source  file can be assembled back into the original binary using z80asm, zasm or the original Zilog assembler (when the --zilog
       option was used).

OPTIONS

       -a, --address
	      Print the address of the memory location corresponding to each line of assembly code in a comment at the end of the line.

       -b, --block-def=FILE
	      Read block information from a file. If this option is not specified the default is for the entire file to contain machine code.  See
	      BLOCK FILE below.

       -g, --origin=ORG
	      Specify the start address of the binary code being disassembled. A corresponding org directive is generated in the output file.  The
	      argument is read in hexadecimal if  it  begins with 0x or 0X, in octal if it begins with 0, and in base  10  otherwise.  Default	is
	      0x0100.

       -h, --help
	      Show summary of options and exit.

       -l, --labels
	      Try to guess label locations from jump instructions and add them to the assembly code.

       -o, --output=FILE
	      Specify the output file. Default is to write to standard output.

       -s, --sym-output=FILE
	      Write symbol information into a file.

       -S, --sym-input=FILE
	      Read symbol information from a file. See SYMBOL FILE below.

       -t, --source
	      Print  the  binary  data corresponding to each line of assembly code in a comment at the end of the line. Data is printed in hex and
	      ASCII. This is useful for identifying data sections in the first disassembly.

       -v, --verbose
	      Increase verbosity level.  Specify multiple times to be more verbose.  Messages are sent to standard error.

       -V, --version
	      Display version information and exit.

       -z, --zilog
	      Enable compatibility mode for the original Zilog Z80 assembler. This currently only changes the syntax of relative jumps.

SYMBOL FILE

       Symbol files written by z80dasm can be directly used as input symbol files with the --sym-input option. The following directives are recog-
       nized in input symbol files and are propagated to the output symbol files:

       include "filename"
	      Include another symbol file. Double quotes are mandatory. Included files must be in the current directory.

       symbol: equ value
	      Define a symbol with a value. The value is read in hexadecimal if it begins with 0x or 0X, in octal if it begins with 0, and in base
	      10 otherwise. Default is 0x0100.

       ; comment
	      All characters between a semi-colon and end of line are ignored.

BLOCK FILE

       Block files specify the boundaries between different blocks (sections) of binary data in the disassembler input file. The following  direc-
       tives are recognized:

       name: start address end address type type
	      Define  a  block	with the start and end address that contains a certain type of binary data. Start address is the 16 bit address of
	      the first byte in the block. End address is the 16 bit address of the last byte in the block plus one.

       ; comment
	      All characters between a semi-colon and end of line are ignored.

       The following block types are supported:

       code   Block containing Z80 machine code. Data in this block will be written in Z80 assembly language.

       bytedata
	      Data block containing separate bytes. Data in this block will be written with defb directives.

       worddata
	      Data block containing 16 bit words (low order byte first). Data in this block will be written with defw directives.

       pointers
	      Data block containing 16 bit pointers (low order byte first). This type is  equivalent  to  worddata  except  that  values  will	be
	      replaced with labels where that is possible.

DIAGNOSTICS

       If disassembly was successful z80dasm returns 0. On error diagnostic messages are printed to standard error and z80dasm returns 1.

BUGS

       Please report bugs to tomaz.solc@tablix.org

AUTHOR

       z80dasm is based largely on dz80 , written by Jan Panteltje. Feature enhancements and bug fixes were made by Tomaz Solc.

SEE ALSO

       z80asm(1)

Tomaz Solc							    2007-06-14								Z80DASM(1)