dcdis is a very simple Sega Dreamcast(tm) disassembler initially made by Lars Olsson (Maiwe).
This tool produces text files which contains all the disassembled code of any Sega Dreamcast binary executable. The Dreamcast's CPU, a Hitachi SH7091, is virtually identical to the Renesas SH7750 series of SH4 CPUs. dcdis will produces a disassembled text file containing SH7091/SH7750 instructions.
Note: This utility only supports the binary format, all others file format
are unsupported, including SREC or ELF file formats.
You have 2 modes to build and install dcdis:
- KallistiOS mode
- Standalone mode
Starting from v1.0.0, dcdis is ready to be integrated in a KallistiOS
installation, in the utils directory. The Makefile located in the root
directory is designed for that use case.
Input the following to install dcdis in your KallistiOS utilities directory:
git clone https://github.com/sizious/dcdis.git ${KOS_BASE}/utils/dcdis
cd ${KOS_BASE}/utils/dcdis
make
The dcdis binary will be installed in the /opt/toolchains/bin/ directory.
If you want to use dcdis in a standalone mode, i.e. without KallistiOS, then you may do it by following instructions of this section. You just need a working GCC toolchain in order to do that.
In that case, for most machines and configurations, the following is all you need:
cd src
./configure
make
make install
In standalone, i.e. in manual installation mode, dcdis will be installed in
/usr/local/bin by default, but this can be altered by specifying another
location to configure using this formula:
./configure --prefix=/installation/directory
The usage of dcdis is very simple, it can be used as the follow:
dcdis [options] <dcprog.bin>
The following options are supported:
-b<address> binary file, text start (default: 0x8c010000)
-o<filename> file to write output to (default: stdout)
-s<filename> use Sega Katana MAP file
-d standard displacement
<filename> file to disassemble
- Lars Olsson (Maiwe): Initial maker of this tool;
- Moopthehedgehog: Port to modern ANSI C.
- SiZiOUS: Additional improvements and fixes.
dcdis is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the LICENSE file for more information.