debug(8)

NAME
debug - low-level hardware debugger utility

SYNOPSIS
debug

DESCRIPTION
This program allows you to display and/or modify memory or I/O registers. It bears some resemblance to the DOS program of the same name. This is not too surprising since the fellow who wrote it used to be a DOS programmer.

Usage of this program is pretty straightforward, and is not documented extensively here. Use the `?' command within the program too see a list of the available commands. Basically, the contents of memory can be displayed as bytes, or longs using the `db', `dw' and `dd' commands. Memory may be edited using the `eb', `ew' and `ed' commands. For accessing the SuperIO chip, a chip unlock sequence must first be issued: the `si' and `so' commands perform this task for you.

The `m' command displays a listing of the NetWinder's memory map. This indicates where various hardware can be found in memory. Note that the physical and virtual mappings differ between the processor and the PCI bus, ie. what the CPU sees at one particular address will be addressed at a different address if a PCI device needs to do DMA.

FILES
/sbin/debug /man/man8/debug.8

DIAGNOSTICS
The program must be run by the super-user or it will fail with a polite error message. This is to avoid arbitrary users from writing values into other people's processes. If you want override this, you may recompile with the check disabled, or simply set the SUID bit on the executable.

AUTHOR
The program is written by Woody Suwalski <woody@corelcomputer.com>, and the man page was written by Ralph Siemsen <ralphs@corelcomputer.com>. Both are distributed under the terms of the GPL.