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
|
|
gdis
Syntax
gdis [ options ] file
Explanation
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 March 1998
|
|