N64® Functions Menu

al - Audio Library Functions
gDP - DP GBI Macros
gdSP - General GBI Macros
gSP - SP GBI Macros
gt - Turbo Microcode RDP
gu - Graphics Utilities
Math - Math Functions
nuSys - NuSystem
os - N64 Operating System
sp - Sprite Library Functions
uh - Host to Target IO
64DD - N64 Disk Drive

Nintendo® Confidential

   

gdis

Format
gdis [ options ] file

What This Tool Does
It disassembles object files into machine instructions.

Command Line Options
  • -b beginaddress Disassembles starting at the given address. The address can be in decimal, octal (with a leading 0), or hexadecimal (with a leading 0x).
  • -d section Disassembles the named section as data, printing the offset from the beginning of the section.
  • -C Demangles C++ names.
  • -D section Disassembles the named section as data, printing the actual address of the data.
  • -e endaddress Disassembly stops at the given address. The address can be in decimal, octal (with a leading 0), or hexadecimal (with a leading 0x).
  • -F function Disassembles the named function only in each object file specified on the command line. This option may be specified multiple times on the command line.
  • -h Substitutes the general register names for the software register names in the output.
  • -H Removes the leading source line, leaving the hex value and the instructions.
  • -i Removes the leading source line and hexadecimal value of disassembly, leaving only the instructions.
  • -I directory Uses the directory to help find the source code.
  • -l string Disassembles the archive file specified by string. For example, gdis -l x would add usr/lib/libx.a to the files to be disassembled.
  • -L Looks up source labels for subsequent printing. This option works only if the file was compiled with debugging information.
  • -o Prints addresses and contents in octal. The default is hexadecimal.
  • -p function Exactly the same meaning as >F function.
  • -s Performs symbolic disassembly where possible. Symbolic disassembly output will appear on the line following the instruction. Symbol names will be printed in C syntax. This is the default unless the -svr4 option is given.
  • -svr4 Prints using svr4 output format. This means (if no other options given) no externals are named (when loading data off of the $gp register).
  • -S Displays source code intermixed with the assembly code. There is no guarantee that the source code displayed is the source code used to compile the function because gdis simply looks for a source file starting with the name/path given in the object and continuing by looking in directories specified with -I (if any) and accepts the first appropriately-named file it finds as the source file.
  • -T Sets trace flag for debugging of the disassembler itself.
  • -t section Disassembles the named section as a text section.
  • -V Prints the version of gdis being executed.
  • -w Attempts to print source information (names of user variables involved) after (to the right of) assembly codes. This option comes into effect only if -s is also specified, but does not imply -s. (But recall from above that -s is on by default unless -svr4 is specified, so -w is effective by itself unless -svr4 was specified.)
  • -x Prints offsets as hex numbers. This is the default.
If the -d, -D or -t options are specified, only those named sections from each user-supplied filename will be disassembled. Otherwise, all sections containing text will be disassembled.


Nintendo® Confidential

Warning: all information in this document is confidential and covered by a non-disclosure agreement. You are responsible for keeping this information confidential and protected. Nintendo will vigorously enforce this responsibility.

Copyright © 1998
Nintendo of America Inc. All rights reserved
Nintendo and N64 are registered trademarks of Nintendo
Last updated January 1998