 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 DriveNintendo® Confidential |
|
 |
|
readmem
Syntaxreadmem id vaddr len
Explanation
It reads data from a target system memory space. Specifically, it sends a request to read data from the memory space of the target system by way of the dbgif tool. The id is the thread number. Even though all threads share the same address space, you must still specify a thread. This command is shared with other debuggers in which threads may have different address spaces. The virtual address vaddr is the starting
location to read. The len argument is the number of bytes to be read, starting from the specified location.
The contents of memory are displayed (in hexadecimal) on stdout as a
sequence of byte values. For example, this command:
readmem 3 0x80001000 20
produces this output:
id 3 vaddr 0x80001000 len 20
0x80001000 44 84 b0 00 00 00 00 00 20 84 00 01 44 84 b8 00
0x80001010 00 00 00 00
Before executing this command, you must ensure that the dbgif program is running and that the METHOD environment variable is set to indicate whether this is a
request for the R4300 CPU or the RCP co-processor. The value zero represents
the CPU and the number one represents the RCP. In csh, this is accomplished by specifying:
setenv METHOD 0
If METHOD is set to 1 and the co-processor is running, the request will probably fail (as it should). It is generally unwise to use METHOD 1 for this command anyway; all addresses may be accessed from the CPU.
Bugs
In the event of a communications failure, the program will dump core. If that happens, you must remove the core file manually.
See Also
dbgif
listthreads
writeword
|
|
|
|
|
|
|
 |
 |
 |
 |
 |
 |
 |
 |
 |
 |
 |
 |
|
|
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 |