dis68k is a public domain disassembler for the 68000 by W. de Waal, originally developed in 1991 and written in era-appropriate unstandardised C. It was released into the public domain in 1993.
This fork of dis68k was created by Kevin Cozens from the Thomas Harte fork. The following changes were made:
- map files only need the region start address
- added more region types
- outputs a warning if regions overlap
- generated op-codes line up properly
- fixed some bugs including one that locked up the program
The Thomas Harte fork seeked to modernise the original source code written by W. de Waal:
- to ensure that it builds with modern compilers;
- to give it normative command-line invocation; and
- where possible, to adapt the code to utilise more modern language constructs.
dis68k < file.rom > disassembly.txt
This disassembler reads from stdin and writes to stdout. You can therefore
use the usual means of composition to disassemble directly from compressed
files and/or to compress the output: zcat file.gz | dis68k > disassembly.txt
or similar.
By default the disassembler will assume that the input begins at address 0 and that execution begins at address 0. You can modify that assumption with a map file.
Example map file:
romstart = FC0000
FC0000,byte
FC0030,code
FF0000,end
This says:
- the input file data should be located at address
FC0000. - treat the region starting at
FF0000and ending atFC002Fas bytes. - treat the region starting at
FC0030and ending atFEFFFFas code. - stop processing any more data upon reaching address FF0000.
The region types that can be specified are: byte, word, long, text, rsvd, code, and end.
Use rsvd to skip a region of memory where the contents don't matter. Use end to mark the end of the input data. The address specified, and all later data, will not be decoded and included in the output.
Map files are specified to the disassembler using the -m option, e.g.
dis68k -m file.map < file.rom > disassembly.txt