Alpha Microprocessors Motherboard Debug Monitor User’s Guide Order Number: EC–QHUVF–TE Revision/Update Information: This is a revised document. It supersedes the Alpha Microprocessors Motherboard Debug Monitor User’s Guide, EC–QHUVE–TE. Digital Equipment Corporation Maynard, Massachusetts http://www.digital.
October 1997 While DIGITAL believes the information included in this publication is correct as of the date of publication, it is subject to change without notice. Digital Equipment Corporation makes no representations that the use of its products in the manner described in this publication will not infringe on existing or future patent rights, nor do the descriptions contained in this publication imply the granting of licenses to make, use, or sell equipment or software in accordance with the description.
Contents Preface 1 Introduction 1.1 1.2 1.3 2 Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . General Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Recommended Host System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1–1 1–1 1–2 Getting Started 2.1 2.2 2.3 2.3.1 2.3.2 2.3.3 2.3.4 2.3.4.1 2.3.4.2 2.3.4.3 2.4 2.4.1 2.4.2 2.4.3 2.4.4 2.4.
2.8 2.9 3 What Is a Debugger? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . What Is a Remote Debugger? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Remote Debug Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Programming Guidelines . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . The Run-Time Environment. . . . . . . . . . . . . . . . . . . .
edevice . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . edmp. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . einit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . eml . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . emq. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
prl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . prw . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . pw . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . pwb . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . pwl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Figures 2–1 Debug Monitor Memory Map. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Tables 4–1 viii Command Summary Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Preface Introduction This document describes the software features of an Alpha microprocessor motherboard. The motherboard software is intended to provide software monitor and debug capabilities to customers who use an Alpha microprocessor motherboard as a development platform for creating their own Alpha microprocessor-based systems. Audience This document is for anyone who develops software or hardware to be used with an Alpha microprocessor.
Content Overview The information in this document is organized as follows: • Chapter 1 is an introduction to the Debug Monitor. • Chapter 2 describes how to use this Debug Monitor. • Chapter 3 describes how to use remote debugging. • Chapter 4 lists all Debug Monitor commands. • Appendix A contains information about technical support services and associated documentation.
1 Introduction 1.1 Overview The Alpha Microprocessors Motherboard Debug Monitor can be used to load code into the system and perform other software debug functions, such as memory read/write and instruction breakpointing.
Recommended Host System • Disassemble CPU instructions in memory. • Transfer control to programs loaded into memory. • Perform native debugging, including breakpoints and single stepping. • Perform full source-level debugging using the DIGITAL Ladebug debugger (Ladebug) for DIGITAL UNIX running on a remote host that communicates through an Ethernet connection. 1.
2 Getting Started 2.1 Overview This chapter describes how to set up your motherboard and host system. 2.2 System Requirements The minimum configuration that you need in order to use your motherboard is a power supply and a terminal. However, to take full advantage of the motherboard, you need an Alpha host development system running the Windows NT or DIGITAL UNIX operating systems. 2.
Configuring Your System After the terminal and the motherboard are connected and the motherboard is powered on, the terminal screen should display the banner and prompt. For example: DECchip 21064 Evaluation Board (EB64) Debug Monitor Version: Tue May 04 16:55:54 EDT 1993 Bootadr: 0x100000, memSize: 0x2000000 (32MB) EB64> Note: Using a terminal in this manner is the most effective way to quickly verify that your motherboard was not damaged during shipping.
Configuring Your System Save these settings in a file. For example, settings for the EB64 could be saved in a file called eb64.trm. For consistency, all examples and command descriptions assume that the motherboard serial port 1 is connected to COM1. 2.3.4 Connecting from a System Running DIGITAL UNIX DIGITAL UNIX supports serial communications and Ethernet communications with the motherboard.
Configuring Your System 2.3.4.1 Connecting to a Serial Port After you modify the /etc/remote and /etc/inittab files, you can connect to the serial port under the DIGITAL UNIX operating system using the DIGITAL UNIX tip command. If the connection is successful, the motherboard prompt displays, and you are ready to use the Debug Monitor load or boot commands to download your file. For example, % tip port_name0 EB64> load Send File now ...
Updating the Debug Monitor Firmware 4. Modify the /etc/bootptab file to specify the Ethernet hardware address of the motherboard and the IP address assigned to that node. Contact your network administrator to obtain an IP address. Refer to the literature supplied with your Ethernet card to obtain information about the hardware address. If the hardware address is accessible through software, you can use the einit command to display it.
Updating the Debug Monitor Firmware For the AlphaPC 164SX, AlphaPC 164LX, AlphaPC 164, EB164, AlphaPC 64, and EB66+, you update the Debug Monitor firmware in the flash ROM. The EB64+, EB66, and EB64 have a UVPROM. A new UVPROM containing the Debug Monitor firmware needs to be obtained and installed on these motherboards. After the Debug Monitor firmware has been installed, the motherboard system is restarted to activate the new firmware.
Updating the Debug Monitor Firmware Use the following table to determine the update procedure for your motherboard. System If your system is running... Then see this section...
Updating the Debug Monitor Firmware Key or Key Combination Description Tab Move highlight forward between fields of a dialog. Shift + Tab Move highlight backwards between fields of a dialog. ↓ or ↑ Move highlight within a menu, or cycle through available field values in a dialog window. Alt + ↓ Drop down a menu of choices from a drop-down listbox. A drop-down listbox can be recognized by the symbol ⇓. Home Move to the beginning of a text entry field. End Move to the end of a text entry field.
Updating the Debug Monitor Firmware 4. The AlphaBIOS Upgrade Options screen is displayed. If more than one image is found, the new image’s name is displayed. If the name of the new image is not Debug Monitor, use the down arrow key to cycle through the available field values until Debug Monitor is displayed. Press Enter to continue the installation. 5. An AlphaBIOS screen warning you that you have selected to switch the operating system is displayed. Press Enter to continue the installation. 6.
Updating the Debug Monitor Firmware When you power up your motherboard system, the firmware displays a blue screen on the monitor and initializes the firmware drivers. If autoboot is enabled, cancel it by pressing the Esc key before the timeout period expires. This allows you to interact with the firmware. Starting the Firmware Update Utility To invoke the firmware update utility to update the firmware in a flash ROM, follow this procedure: 1.
Updating the Debug Monitor Firmware Starting the Firmware Update Utility To start the firmware update utility from the firmware update diskette you created, follow this procedure: 1. Insert the firmware update diskette into drive A. 2. At the Debug Monitor prompt, enter the following command: EBxxx> fwupdate Notes: Debug Monitor firmware versions prior to V2.0 do not recognize the fwupdate command. For versions prior to V2.
Updating the Debug Monitor Firmware A display appears showing information about the devices on your system. In the following example, DKA400 is the CD–ROM device: dka0.0.0.9.0 dka400.4.0.9.0 dva0.0.0.0.1 ewa0.0.0.7.0 pka0.7.0.9.0 >>> DKA0 DKA400 DVA0 EWA0 PKA0 RZ26L RRD43 440C 1084 08-00-2B-E2-B1-08 SCSI Bus ID 7 The numbers in the middle column are the unit numbers assigned to each drive on your system, where: • The letters DK refer to a SCSI CD–ROM or disk device.
Updating the Debug Monitor Firmware 5. If updating the firmware on the AlphaPC 164SX or the AlphaPC 164LX, go to Section 2.4.2. If updating the firmware on any other motherboard, proceed to Section 2.4.6. Starting the Firmware Update Utility from a Diskette The firmware update utility is provided only on a compact disc; a diskette is not provided. See the Alpha Motherboards Software Developer’s Kit and Firmware Update Read Me First for information about how to create a firmware update diskette.
Updating the Debug Monitor Firmware the COM1 serial port or on the graphics display unit after starting the firmware update utility. When the message Initializing Flash Driver is displayed, press the A key to enable the Advanced menu. For all other systems, proceed to step 2. 2. Choose whichever selection appears: Update Debug Monitor Update Firmware 3. When prompted to continue the update, choose Yes.
Switching to the Debug Monitor Firmware on Flash ROM Systems Note: For versions of the Debug Monitor firmware prior to V2.0, the prompt will be displayed only on the terminal attached to the COM1 serial port. 2.5 Switching to the Debug Monitor Firmware on Flash ROM Systems This section describes how to switch to the Debug Monitor firmware from either the Windows NT ARC firmware or the Alpha SRM Console firmware on the EB164, AlphaPC 64, EB66+, and EB64+.
Debug Monitor Memory Map Switching from Alpha SRM Console Firmware To switch to the Debug Monitor firmware from the Alpha SRM Console firmware, follow this procedure: 1. At the Alpha SRM Console prompt, enter the following command: >>> deposit -b toy:3f 0 2. Restart your motherboard system. 3. Observe the Debug Monitor prompt on the terminal attached to the COM1 serial port or on the graphics display unit. Note: For versions of the Debug Monitor firmware prior to V2.
Debug Monitor Memory Map Figure 2–1 Debug Monitor Memory Map Top of Main Memory 8KB Guard Page Top of Stack Stack 0x300000 Default Boot Address (bootadr) 0x200000 DMA Buffers 0x100000 DMA Buffer Base Debug Monitor Kernel 0x10000 Debug Monitor Entry Debug Monitor PALcode 0x0 PALcode Base Address FM-05670.AI4 The Debug Monitor image consists of PALcode at physical address 0 and the Debug Monitor kernel at physical address 1000016.
Downloading Files 2.6.2 DMA Buffers Various devices used with the motherboard require direct memory access (DMA). The device drivers provided in the Debug Monitor for these devices are designed to perform their DMA within a 1MB range starting at 1 megabyte (physical address 10000016). At startup, the Debug Monitor initializes the I/O subsystem with DMA windows that include this range. The device drivers included with the Debug Monitor that require DMA are the Ethernet and diskette drivers.
Resetting the Debug Monitor 2.9 Resetting the Debug Monitor If the software hangs the motherboard, then the hardware reset on the board can be used to reset to the Debug Monitor command line. For information about connecting the reset signals, see your motherboard’s user’s manual.
3 Remote Debugging The Debug Monitor supports remote debugging for DIGITAL UNIX host systems with Ladebug. The Ladebug software provides the full source-level debugging capabilities of most programs that run on the motherboard, including the Debug Monitor. This chapter describes some debugging hints for use with the Debug Monitor and the remote debugger. This chapter also describes the guidelines for writing programs that allow you to take full advantage of remote debugging. 3.
Programming Guidelines 3.4 Programming Guidelines The following sections describe the programming guidelines for remote debugging. 3.4.1 The Run-Time Environment When a program is started by the Debug Monitor’s go command, it is started at the appropriate IPL to enable real-time clock interrupts (usually IPL 4). If a program does not install its own interrupt handler, then the Debug Monitor will handle all interrupts.
Programming Guidelines Programs that define or install their own interrupt handler must ensure that the Debug Monitor polls the Ethernet device often enough to receive all the messages sent to it by Ladebug. An easy way to do this is to use the ladbx_poll function. When this function is called, the following occurs: • All frames that have been received on the Ethernet device are read. • All remote debug frames are processed and acted upon. • Any Ethernet interrupt is cleared.
Ladebug Command Line Options • The debug server uses the DBGSTOP PAL call to implement breakpoints. The program must contain an identical implementation of the DBGSTOP PAL call. This PAL call, rather than the BPT PAL call, is used because complex programs (such as operating systems) are likely to reset the EntIF system entry point during initialization. • The program reset PALcode routine must preserve the address of the debug entry point through the installation of the new PALcode.
Building the Executable File (Sheet 2 of 2) Command Line Option Description -rinsist Connects to a running remote process using the connect insist protocol message instead of the connect protocol message. This option functions as a request to the server to connect to the client even if some other client is already connected. (The previously connected client is disconnected.) Use only with -rn and -pid. -rp debug protocol name Specifies the remote debug protocol to be used.
Starting a Ladebug Session 3.7 Starting a Ladebug Session The Debug Monitor ladebug command configures the motherboard as a remote debugger target. Communication is performed through the Ethernet connection. To debug a program running on a motherboard using Ladebug running on a remote host, follow these steps: 1. Set up the host DIGITAL UNIX machine as described in Chapter 2. 2. Start the motherboard. 3. Load the program into memory on the motherboard. 4. Set a breakpoint in the program. 5.
Starting a Ladebug Session The following command, entered from the host system, starts Ladebug and causes it to connect to the EB64: % ladebug size.out -rn eb64 -pid 0 Welcome to the Ladebug Debugger Version 1.3.1 -----------------object file name: size.out machine name: eb64 process id: 0 Reading symbolic information ...done Connected to remote debugger (ladebug) The (ladebug) in the previous example is the Ladebug prompt. You are now ready to debug a process that is running on the EB64.
4 User Commands 4.1 Overview This chapter describes how to use the Alpha Microprocessors Motherboard Debug Monitor commands. The Debug Monitor supports advanced command line editing, including cursor key movements and an Emacs-like editing interface. In addition, a history buffer has been added to facilitate repetition of commands. (Sheet 1 of 2) Keys Description . (period) Repeats the last command entered. ↑(up arrow) Ctrl/P1 Scrolls up (older entries) the history buffer.
Using the Commands (Sheet 2 of 2) Keys Description Ctrl/U Erases the current line of command text. End2 Moves to the end of the line. Ctrl/E Esc/B Moves cursor to the previous word. Esc/Backspace Esc/DELETE Deletes previous word. Esc/D Deletes the next word. Esc/F Moves cursor to the next word. Home2 Ctrl/A1 Moves to the beginning of the line. Insert Toggles between insert and overwrite mode. Return Ctrl/J Ctrl/M Enters current command.
Using the Commands • Examine and modify memory commands These commands are used to examine and change memory in various formats beginning at a specified address and ending at a specified address. Quadwords (64 bits), longwords (32 bits), halfwords (16 bits), and bytes (8 bits) are all supported by these commands. • PCI commands These commands are used to access PCI configuration space.
User Commands Quick Reference 4.3 User Commands Quick Reference Table 4–1 contains a summary of all Debug Monitor commands. The commands are grouped by category and function. Table 4–1 Command Summary Table Command Parameters (Sheet 1 of 7) Description Download and Execution Commands load address Downloads a file through the active serial port using the XMODEM protocol. boot address Downloads a file through the active serial port using the XMODEM protocol and begins execution.
User Commands Quick Reference Table 4–1 Command Summary Table (Sheet 2 of 7) Command Parameters Description romboot type, address Loads the specified image from ROM and begins execution. romlist none Lists the ROM image headers contained in ROM. romverify type, address Compares an image in memory to an image in ROM. bootadr address Sets default boot address. bootopt type Selects the operating system and firmware type to be used on the next power-up.
User Commands Quick Reference Table 4–1 Command Summary Table (Sheet 3 of 7) Command Parameters Description cl address Edits memory longwords (32-bit). cw address Edits memory words (16-bit). cb address Edits memory bytes (8-bit). fill start_address, end_address, fill_value Fills the specified memory block with the specified 32-bit pattern. copy start_address, end_address, destination Copies a memory range to the specified address.
User Commands Quick Reference Table 4–1 Command Summary Table (Sheet 4 of 7) Command Parameters Description mrb address, iterations, silent Reads a byte from memory in I/O address space. mwl address, data, iterations Writes a longword to memory I/O address space. mww address, data, iterations Writes a word to memory I/O address space. mwb address, data, iterations Writes a byte to memory I/O address space.
User Commands Quick Reference Table 4–1 Command Summary Table (Sheet 5 of 7) Command Parameters Description pwb pci_address, id, data, Writes a byte to a specified address in PCI configuration bus, function space. Utility Commands bcon none Enables the backup cache. bcoff none Disables the backup cache. date yymmddhhmmss Modifies or displays the date and time. flash source_address, destination_offset, bytes_to_write Programs data into flash memory.
User Commands Quick Reference Table 4–1 Command Summary Table (Sheet 6 of 7) Command Parameters Description stop address Sets a breakpoint at the specified address. bpstat none Displays the current breakpoint status. step none Executes a machine instruction by stepping into the first instruction of the function being called. next none Executes a machine instruction without stepping into subroutines. cont none Continues execution from a breakpoint.
User Commands Table 4–1 Command Summary Table Command Parameters (Sheet 7 of 7) Description Ethernet Commands edevice device_number Selects a registered Ethernet device. eshow none Displays all registered Ethernet devices. ereg none Displays the Ethernet controller registers. estat none Displays Ethernet statistics. einit none Initializes Ethernet controller and displays the Ethernet hardware address. estop none Stops the Ethernet controller.
User Commands apropos apropos The apropos command displays help descriptions for the specified keyword. Format apropos keyword Parameters keyword Specifies the string to match in the help command text. Description The apropos command is an additional form of help. This command searches the help file and displays all matches for the specified keyword.
User Commands arpshow arpshow The arpshow command displays all known address resolution protocol (ARP) entries. Format arpshow Parameters None. Description The arpshow command displays an IP routing table entry. If there are no ARP entries, nothing is shown for that device. The Ethernet device number displayed matches the number that is displayed when the eshow and edevice commands are entered. Example EB64> arpshow Arp Table Contents (at 0x00074570): Ethernet Device 0 IP Address: 16.123.45.
User Commands bcoff bcoff The bcoff command disables the backup cache. Format bcoff Parameters None. Description The bcoff command disables the external (backup) cache. Use of this command assumes that the cache has already been initialized (usually by the SROM). If the cache is initialized but already disabled, this command has no effect on the state of the cache. Example EB66+ bcoff ...
User Commands bcon bcon The bcon command enables the backup cache. Format bcon Parameters None. Description The bcon command enables the external (backup) cache when it has been disabled using the bcoff command. If the cache has never been initialized (usually by the SROM), the bcon cannot be expected to be capable of enabling it. If the cache is already enabled, this command has no effect on the state of the cache. Example EB66+ bcon ...
User Commands beep beep The beep command tests the speaker. Format beep duration frequency Parameters duration Specifies the duration of the beep in milliseconds. frequency Specifies the frequency in hertz. Description The beep command causes the speaker to beep for the specified duration and frequency.
User Commands boot boot The boot command downloads a file through the active serial port using the XMODEM protocol and begins execution. Format boot [address] Parameters address Specifies the address at which to download the file. The default is the boot address. Description The boot command uses the XMODEM protocol to download a file through the active serial port. The program is loaded to the supplied address or to the boot address if an address is not specified.
User Commands bootadr bootadr The bootadr command allows you to display or modify the default boot address. Format bootadr [address] Parameters address Specifies the starting address at which a program is loaded. Programs loaded with the netboot command automatically begin program execution at this address. The default address is 30000016. Description The boot address is the address at which your programs load and begin execution.
User Commands bootopt bootopt The bootopt command selects the operating system and firmware type to be used on the next power-up. Format bootopt [type] Parameters type Specifies the operating system type. If the specified image is not found at power-up, the first image is booted. If there are no ROM headers, the whole ROM will be loaded at address 0. Description The bootopt command selects the operating system and associated firmware type that will be used the next time you power up your motherboard.
User Commands bootopt The bootopt command can also be used to select a ROM image based on its position in the ROM. Specifying the type as #0 selects the whole ROM. Specifying the type as #1 selects the first image; #2 selects the second image, and so on. The bootopt command is not supported for the EB64+, EB66, or EB64. Example AlphaPC 64> bootopt Predefined bootoptions are...
User Commands bpstat bpstat The bpstat command displays the current breakpoint status. Format bpstat Parameters None. Description The bpstat command lists the breakpoints set with the stop command. The disassembled instructions for that location are also displayed.
User Commands cb cb The cb command allows you to edit memory bytes (8-bit). Format cb [address] Parameters address Specifies the address of the memory byte you want to change. Description The cb command allows you to modify the contents of a specified memory address. If no address is specified, then the next byte is selected. The Debug Monitor displays the address followed by the current data and a colon (:).
User Commands cfreg cfreg The cfreg command modifies the saved CPU floating-point register state. Format cfreg register_number value Parameters register_number Identifies the register. value Specifies the new value of the register in hexadecimal numbers. Description The cfreg command modifies the saved CPU floating-point register state to contain the specified value. The program register contents are stored in memory to the saved-state area when a breakpoint is encountered.
User Commands cfreg Example EB64> pfreg Floating Point Registers register file @: 0000C840 f00: 0000000000000000 0000000000000000 0000000000000000 f04: 0000000000000000 0000000000000000 0000000000000000 f08: 0000000000000000 0000000000000000 0000000000000000 f12: 0000000000000000 0000000000000000 0000000000000000 f16: 0000000000000000 0000000000000000 0000000000000000 f20: 0000000000000000 0000000000000000 0000000000000000 f24: 0000000000000000 0000000000000000 0000000000000000 f28: 0000000000000000 000000
User Commands cl cl The cl command allows you to edit memory longwords (32-bit). Format cl [address] Parameters address Specifies the address of the memory longword you want to change. Description The cl command allows you to modify the contents of a specified memory address. If no address is specified, then the next longword is selected. The Debug Monitor displays the address followed by the current data and a colon (:).
User Commands compare compare The compare command compares a memory range to a specified address. Format compare start_address end_address compare_address Parameters start_address Specifies the memory address at which to start the comparison. end_address Specifies the last address that will be compared. compare_address Specifies the address to be compared to the memory range.
User Commands cont cont The cont command continues execution from a breakpoint. Format cont Parameters None. Description The cont command continues from a breakpoint. The program continues until another breakpoint or the end of the program is reached. Example EB64> stop 100000 EB64> go Executing at 0x100000...
User Commands copy copy The copy command copies the specified memory range to the new specified address. Format copy start_address end_address destination Parameters start_address Specifies the starting address for this copy. end_address Specifies the last address to be included in this copy. destination Specifies the new starting address for the memory range. Description The copy command copies the data from the specified block of memory to a new location in memory. The original location is unchanged.
User Commands copy Example This example displays the original location and the destination before and after the copy command.
User Commands cq cq The cq command allows you to edit memory quadwords (64-bit). Format cq [address] Parameters address Specifies the address of the memory quadword you want to change. Description The cq command allows you to modify the contents of the specified memory address. If no address is specified, then the next quadword is selected. The Debug Monitor displays the address followed by the current data and a colon (:).
User Commands cq Example This example modifies only quadword 20002016. EB64> cq 200020 00200020: 0000000004000000: 0000000011111111 00200028: 0000000000000000: 00200030: 3402010400120106: 00200038: 0402010004020100: 00200040: FBFDFEFFFFFDFEFF: ; EB64> pq 200000 00200000: FA7D7299CE7F3299 DA65FA99DA7D32D9 .2...r}..2}...e. 00200010: FFFFFFFBFBFFFFDB FFFFFFFFFFFFFFFF ................ 00200020: 0000000011111111 0000000000000000 ................ 00200030: 3402010400120106 0402010004020100 .......4........
User Commands creg creg The creg command modifies the saved CPU general-purpose register state. Format creg register_number value Parameters register_number Identifies the register. value Specifies the new value of the register in hexadecimal numbers. Description The creg command modifies the saved CPU general-purpose register state to contain the specified value. The program register contents are stored in memory to the saved-state area when a breakpoint is encountered.
User Commands creg Example EB64> preg General Purpose Registers register file @: 0000C040 r00: 0000000000000020 0000000000000005 000000000000C000 r04: 00000000000003F8 0000000000000000 0000000000000000 r08: FFFFFC000005F470 0000000000027340 0444306453605341 r12: 208090EA6024C19C 882C08AA92065B2D 4100610AE100244F r16: 0000000000100000 000000000000000D 0000000000000006 r20: 0000000E20026335 5619A46B2B1A5125 0000000000000000 r24: 0000000000000003 0000000000000000 FFFFFC0000042C3C r28: FFFFFC02C0000000 FFFFFC0
User Commands cw cw The cw command allows you to edit memory words (16-bit). Format cw [address] Parameters address Specifies the address of the memory word you want to change. Description The cw command allows you to modify the contents of the specified memory address. If no address is specified, then the next word is selected. The Debug Monitor displays the address followed by the current data and a colon (:).
User Commands cw Example This example modifies words 20009416 through 20009816.
User Commands date date The date command displays or modifies the date and time. Format date [yymmddhhmmss] Parameters yymmddhhmmss To modify the date, supply the year, month, day, hour, minute, and second. Description If the date command is specified alone, the month, day, time, and year is displayed. If you supply a parameter, the date is modified. Example This example displays the current date and time setting.
User Commands delete delete The delete command removes a breakpoint from the specified address. Format delete address Parameters address Specifies the address from which to delete the breakpoint. Description The delete command removes a breakpoint from the specified address. You can use an asterisk (*) to remove all breakpoints.
User Commands dis dis The dis command displays memory as CPU instructions. Format dis [start_address [end_address]] Parameters start_address Specifies the address at which to start disassembling instructions. If the start_address is not specified, the address of the last load command, the last breakpoint, or the last dis command is used. end_address Specifies the address at which to end disassembling instructions. The default is the start_address plus 32 bytes (8 instructions).
User Commands dis Example EB64> dis 243a0 000243A0: 43020122 000243A4: 48441722 000243A8: 74420050 000243AC: 64630082 000243B0: 209F07E1 000243B4: 48855724 000243B8: 44640103 000243BC: 47203019 EB64> dis 000243C0: 4B037698 000243C4: 4703F118 000243C8: 47190418 000243CC: 4B055738 000243D0: 44780403 000243D4: 746300A2 000243D8: 77FF0055 000243DC: 77FF0000 EB64> 4–38 User Commands subl sll mt mf lda sll bic and r24, r2, r2 r2, 0x20, r2 r2, cc r3, pt2 r4, 2017(zero) r4, 0x2A, r4 r3, r4, r3 r25, 0x1, r25 s
User Commands dml dml The dml command deposits the specified longword data in the specified memory location. Format dml address data [iterations] Parameters address Specifies the memory address. data Specifies the longword data to be stored. iterations Specifies how many times the command is executed. The default is 1. Description The dml command deposits the specified longword data in the specified memory location.
User Commands dmq dmq The dmq command deposits the specified quadword data in the specified memory location. Format dmq address data [iterations] Parameters address Specifies the memory address. data Specifies the quadword data to be stored. iterations Specifies how many times the command is executed. The default is 1. Description The dmq command deposits the specified quadword data in the specified memory location.
User Commands ebuff ebuff The ebuff command sets the base address for the Ethernet transmit receive buffers. Format ebuff [address] Parameters address Specifies the address for the transmit and receive buffers. The default is 10000016. Description The ebuff command sets the address in physical memory where the transmit and receive buffers are located. If specified without an address, this command displays the current location of the buffers in memory.
User Commands edevice edevice The edevice command selects the registered Ethernet device that the Debug Monitor will use. Format edevice [device_number] Parameters device_number Specifies the net device number of any registered Ethernet device. If no device number is provided, the current device number is displayed. Description The edevice command sets the Debug Monitor to use one of the registered Ethernet devices. Use the eshow command to display all of the registered Ethernet devices.
User Commands edmp edmp The edmp command displays packets received or transmitted to the terminal screen. Format edmp [status] Parameters status Determines whether packets are displayed. Status can be 1 (on) or 0 (off). Description The edmp command sets or clears the display of packets received or transmitted to the screen. If this command is entered with no status, then the current status is displayed. Example EB64> edmp packet dumps are OFF.
User Commands einit einit The einit command initializes the Ethernet controller. Format einit Parameters None. Description The einit command initializes the Ethernet controller and displays the Ethernet hardware address. Example EB64> einit Ethernet Base Address: 360, DMA Mask: 1 = DRQ5 Init Block Address 80000 Init Done.
User Commands eml eml The eml command examines and displays a longword of data in memory. Format eml address [iterations [silent]] Parameters address Specifies the memory address. iterations Specifies how many times the command is executed. The default is 1. silent Specifies whether or not the data is displayed. Setting this parameter to 1 causes the data to be read but not displayed. The default is 0 (data is displayed).
User Commands emq emq The emq command examines and displays a quadword of data in memory. Format emq address [iterations [silent]] Parameters address Specifies the memory address. iterations Specifies how many times the command is executed. The default is 1. silent Specifies whether or not the data is displayed. Setting this parameter to 1 causes the data to be read but not displayed. The default is 0 (data is displayed).
User Commands eprom eprom The eprom command sets or clears a flag for receiving all packets (promiscuous mode). Format eprom [status] Parameters status Determines whether packets are displayed. Status can be 1 (on) or 0 (off). Description The eprom command sets a flag for receiving packets. If status is set to 1 (on), then promiscuous mode is turned on and packets can be continuously received. If this command is entered with no status, then the current status is displayed. The default status is 0 (off).
User Commands ereg ereg The ereg command displays the Ethernet controller registers. Format ereg Parameters None. Description The ereg command displays the Ethernet controller registers. This command’s output is dependent on the Ethernet device selected for the motherboard. For example, the ISA-based AM79C960 controller must be in stop mode (write 0 to register port 372 and write 4 to data port 370) to view most of its registers.
User Commands ereg Example EB64> ww 372 0 EB64> ww 370 4 EB64> ereg Ethernet Controller Base Address 360, CSR 0...
User Commands eshow eshow The eshow command displays all of the registered Ethernet devices. Format eshow Parameters None. Description The eshow command displays all of the installed device drivers and works for all of the motherboards. To set the Debug Monitor to use one of these devices, see the edevice command. An asterisk following the net device number indicates the selected Ethernet device to be used by the Debug Monitor Ethernet commands.
User Commands estat estat The estat command displays Ethernet statistics. Format estat Parameters None. Description The estat command displays Ethernet statistics kept by the Ethernet device driver.
User Commands estop estop The estop command stops the Ethernet controller. Format estop Parameters None. Description The estop command allows you to stop sending or receiving packets from an Ethernet device selected with the edevice command.
User Commands fill fill The fill command fills a specified memory block with the specified 32-bit pattern. Format fill start_address end_address [fill_value] Parameters start_address Specifies the start address for the fill value. end_address Specifies the end address for the fill value. The fill value includes the end_address. fill_value Specifies a longword hexadecimal number as the fill value for the specified address. The default is 0.
User Commands fill Example This example displays the original value in address range 08000000 through 08000080 and the value of the same address range after the fill command.
User Commands flash flash The flash command programs data into flash memory. Format flash [source_address [destination_offset [bytes_to_write]]] Parameters source_address Specifies the address in memory of the data to be programmed into the flash. The default is the default boot address (see bootadr). destination_offset Specifies the offset, in bytes, into the flash where the first byte of source data will be programmed. If not provided, you are prompted with a default destination_offset value.
User Commands flash Example AlphaPC 64> netload pc64dbm.rom Attempting BOOTP... Loading /users/eval/pc64/pc64dbm.rom at 300000 My IP address: 16.123.45.67 Server IP address: 16.123.45.69 ###################File loaded AlphaPC 64> flash Image source address : 0x300000 Standard image header: Found. Header Size......... 56 bytes Image Checksum...... 0x6eeb (28395) Memory Image Size... 0x30B2C (199468 = 194 KB) Compression Type.... 0 Image Destination... 0x0000000000300000 Header Version......
User Commands flash Press Y to proceed, any other key to abort. Writing Flash Block: 4W 5W 6W 7W Verifying Flash Block: 4V 5V 6V 7V AlphaPC 64> romlist ROM image header found at offset: 0x040000 Header Size......... 56 bytes Image Checksum...... 0x6eeb (28395) Memory Image Size... 0x30B2C (199468 = 194 KB) Compression Type.... 0 Image Destination... 0x0000000000300000 Header Version...... 2 Firmware ID......... 0 - Alpha Evaluation Board Debug Monitor ROM Image Size......
User Commands flasherase flasherase The flasherase command erases data from flash memory. Format flasherase [starting_offset [bytes_to_erase]] Parameters starting_offest Specifies the offset, in bytes, into the flash where data will be erased. If not provided, the entire flash will be erased. bytes_to_erase Specifies how many bytes to erase. If not specified, all bytes from the starting_offset through the rest of the flash will be erased.
User Commands flasherase Firmware ID (Opt.).. 0202009706130904 ........ ROM offset.......... 0x00000000 Header Checksum..... 0x94a5 AlphaPC164> flasherase 40000 Flash offset : 0x40000 Bytes to be erased : 786432 (Block 4 to 15 inclusive). !!!!! Warning: About to overwrite flash memory !!!!! Press Y to proceed, any other key to abort.
User Commands flboot flboot The flboot command downloads the specified file from the diskette and begins execution of that file. Format flboot file [address] Parameters file Specifies the name of the file to access on the diskette. address Specifies the address at which to load the file. The default is the boot address. Description The flboot command downloads the specified file into the specified address or the boot address.
User Commands flcd flcd The flcd command displays or changes the current working directory or drive. Format flcd [drive_pathname] Parameters drive_pathname Specifies the new drive and working directory. Description The flcd command allows you to change the current working directory for the current drive. It can also be used to switch to a different default drive. If no parameters are specified, then the default drive and working directory are displayed.
User Commands flcd Example AlphaPC 64> flcd a:\ AlphaPC 64> fldir High Density selected 10/04/95 02:07p 10/04/95 02:08p 10/06/95 10:05a 10/06/95 10:05a AlphaPC 64> flcd dir1 a:\dir1\ AlphaPC 64> fldir High Density selected 10/06/95 10:05a 10/06/95 10:05a 10/06/95 10:05a 203088 rom.cmp 203140 rom.
User Commands flcopy flcopy The flcopy command copies a file to another location. Format flcopy source_file destination_file Parameters source_file Specifies the file to be copied. If no drive and path are specified, the default drive and path are used. destination_file Specifies the name of the copied file. If no drive and path are specified, the default drive and path are used. Note that a destination file name must always be specified, even if copying to a subdirectory.
User Commands flcopy Example AlphaPC 64> flcd \dir3 a:\dir3\ AlphaPC 64> fldir High Density selected 10/06/95 10:05a 10/06/95 10:05a 04/28/95 05:50p . .. 71 diff.lst 1048064 bytes free AlphaPC 64> flcopy diff.lst ..\dir1\dir2\diff2.lst High Density selected Copying files... Done... AlphaPC 64> fldir ..\dir1\dir2\ High Density selected 10/06/95 10:05a
. 10/06/95 10:05a .. 10/06/95 10:48a 71 diff2.lst 1047552 bytes free AlphaPC 64> flcopy diff.lst b:\diff2.User Commands fldir fldir The fldir command displays a list of files in the current or specified directory. Format fldir [drive_pathname] Parameters drive_pathname Specifies the drive or subdirectory. Description The fldir command displays a directory of files in the current or specified directory. Drives are specified by using the letters A through Z. The path is a list of subdirectories separated by a slash (/) for DIGITAL UNIX users or a backslash (\) for DOS users.
User Commands fldir Example AlphaPC 64> flcd a:\ AlphaPC 64> fldir High Density selected 10/04/95 02:07p 10/04/95 02:08p 10/06/95 10:05a 10/06/95 10:05a AlphaPC 64> fldir /dir1 High Density selected 10/06/95 10:05a 10/06/95 10:05a 10/06/95 10:05a 203088 rom.cmp 203140 rom.rom
dir1 dir3 1048064 bytes free 1048064 AlphaPC 64> flcd dir1\dir2 a:\dir1\dir2\ AlphaPC 64> fldir ..\..User Commands flload flload The flload command downloads the specified file from the diskette. Format flload file [address] Parameters file Specifies the name of the file to access on the diskette. address Specifies the address at which to load the file. The default is the boot address. Description The flload command downloads the specified file into the specified address or the boot address. The program can then be executed with the go or jtopal commands.
User Commands flread flread The flread command reads logical sectors from a diskette. Format flread [first_sector [bytes [dest_address [iterations [drive]]]] Parameters first_sector Specifies the first logical sector of diskette to read. The default is sector 0 (the boot sector). bytes Specifies the number of bytes to be read from the diskette. The default sector is one sector. dest_address Specifies the beginning address where data will be loaded. The default is the boot address.
User Commands flread Example AlphaPC164> flread 1 High Density selected Reading 0 bytes to 0x300000 starting at Done... 512 (0X200) bytes transferred AlphaPC164> flread 1 1500 High Density selected Reading 1500 bytes to 0x300000 starting Done... 1536 (0X600) bytes transferred AlphaPC164> flread 1 1500 400000 High Density selected Reading 1500 bytes to 0x400000 starting Done...
User Commands flsave flsave The flsave command writes a memory range to a file. Format flsave file_name start_address file_size Parameters file_name Specifies the name of the file to be created with the data. If no drive or path is specified, the file is created in the default working directory. start_address Specifies the address in memory to start writing to the file. file_size Specifies the size in bytes of the file to write. Description The flsave command writes a section of memory to a file.
User Commands flwrite flwrite The flwrite command writes data to logical sectors on a diskette. Caution: This is a destructive command. You must be careful which sectors you write to because you may render the disk unusable. Format flwrite [first_sector [image_size [source_address [iterations [drive]]]] Parameters first_sector Specifies the first logical sector of diskette to be written. The default is sector 0 (the boot sector). image_size Specifies the number of bytes to write to the diskette.
User Commands flwrite Example AlphaPC164> flwrite 30 High Density selected Writing 0 bytes from 0x400000 starting at Done... 512 (0X200) bytes transferred AlphaPC164> flwrite 30 3400 High Density selected Writing 3400 bytes from 0x400000 starting Done... 3584 (0XE00) bytes transferred AlphaPC164> flwrite 30 3400 300000 High Density selected Writing 3400 bytes from 0x300000 starting Done...
User Commands fwupdate fwupdate The fwupdate command loads and runs the firmware update utility from diskette. Format fwupdate Parameters None. Description The fwupdate command loads and executes the firmware update utility (fwupdate.exe) from diskette. The utility gets loaded into physical address 90000016 (physical location 9 MB), and gets executed in PALmode. This command expects the diskette to be formatted with a FAT file structure. Example AlphaPC 64> fwupdate ...
User Commands go go The go command begins execution of instructions at the specified address. Format go [start_address] Parameters start_address Specifies the address at which to start executing the instructions. Description The go command jumps to a location in memory and begins executing instructions. If no address is specified, then the execution of instructions begins at the boot address. Example This example starts executing instructions at address 10000016.
User Commands help help The help command displays a list of commands currently available. If you specify a command keyword, information about the specified command is displayed. Format h[elp] [command_keyword] Parameters command_keyword Indicates any command name that appears in the list when you type the help command. An asterisk (*) displays help for all commands. Description The help command displays a list of command keywords implemented in the current release.
User Commands help Example The help command without a parameter displays a list of all commands implemented in the current version of the software. When specified with a parameter, it displays more information about that command keyword. AlphaPC164LX> help A brief help description is available for each of the following commands.
User Commands iack iack The iack command performs an interrupt acknowledge cycle. Format iack Parameters None. Description The iack command allows you to perform an interrupt acknowledge cycle. Two iack commands are required to read the interrupt vector.
User Commands ident ident The ident command displays revision control system (RCS) ID strings found in the specified memory range. Format ident [start_address [end_address]] Parameters start_address Specifies a hexadecimal number that represents a legal address at which to start searching for RCS keywords. The default value is the boot address. end_address Specifies a hexadecimal number that represents a legal address at which to end the search for RCS keywords.
User Commands ident Example EB64> ident 0 80000 Id: crt_startup.s,v 1.3 1993/06/18 20:30:03 fdh Rel $ Id: crt.c,v 1.1 1993/06/08 19:56:39 fdh Rel $ Id: dis.c,v 1.1 1993/06/08 19:56:40 fdh Rel $ Id: ffexec.c,v 1.2 1993/06/09 20:23:05 fdh Rel $ Id: ffsrec.c,v 1.1 1993/06/08 19:56:41 fdh Rel $ Id: cmd.c,v 1.6 1993/06/18 17:32:36 fdh Rel $ Id: pReg.c,v 1.1 1993/06/08 19:56:41 fdh Rel $ Id: rw.c,v 1.1 1993/06/08 19:56:42 fdh Rel $ Id: netboot.c,v 1.1 1993/06/08 19:56:30 fdh Rel $ Id: amd.c,v 1.
User Commands init init The init command reinitializes the Debug Monitor. Format init Parameters None. Description The init command restarts the Debug Monitor by jumping to the PALcode base address in PALmode. It is analogous to using the jtopal command with the PALbase address. Example AlphaPC 64> init Stopping network device 0 in PCI slot 18: Jumping to 0x000000...
User Commands jtopal jtopal The jtopal command sets the environment to PALmode and begins execution of instructions at the specified address. Format jtopal [start_address] Parameters start_address Specifies the address at which to start executing instructions. The default is the boot address. Description The jtopal command emulates the hardware mechanism for entering PALcode. When instructions contain PALcode, you must set the environment to PALmode to properly execute instructions.
User Commands ladebug ladebug The ladebug command starts the Ladebug server for a remote debug session. Format ladebug Parameters None. Description The ladebug command configures the motherboard as a remote debugger target. You can connect to the motherboard from the Ladebug source-level debugger running on a DIGITAL UNIX host. Communication is performed through the Ethernet connection.
User Commands ladebug Example EB64> netload size Ethernet Base Address: 360, DMA Mask: 1 = DRQ5 Init Block Address 100000 Init Done. Ethernet BA-98-76-54-32-10 Attempting BOOTP...success. my IP address: 16.123.45.67 server IP address: 16.123.45.69 gateway IP address: 16.123.45.69 Loading from /users/eval/boot/size ... #### EB64> stop 200000 EB64> go Executing at 0x200000... 00200000: 23DEFFF0 lda sp, -16(sp) EB64> ladebug Ethernet Base Address: 360, DMA Mask: 1 = DRQ5 Init Block Address 100000 Init Done.
User Commands load load The load command downloads a file through the active serial port using the XMODEM protocol. Format load [address] Parameters address Specifies the address at which to download the file. The default is the boot address. Description The load command uses the XMODEM protocol to download a file through the active serial port. The program is loaded to the supplied address or the boot address if an address is not specified.
User Commands mces mces The mces command sets or displays the machine check error summary register. Format mces [mces_data] Parameters mces_data Specifies the value to be written to the machine check error summary register. Description The machine check error summary register controls machine check and systemcorrectable error handling. The mces command provides direct user access to the rdmces and wrmces PALcode instructions that are defined by the Alpha AXP Architecture Reference Manual.
User Commands mcheck mcheck The mcheck command controls the reporting of hardware error conditions (machine checks). Format mcheck state Parameters state = on Enables all machine check reporting. state = off Disables all machine check reporting. state = system Enables machine check reporting for hardware errors detected external to the CPU. state = cpu Enables machine check reporting for hardware errors detected by the CPU.
User Commands mcheck The mcheck command could also modify the machine check error summary register. See the mces command for more information about the machine check error summary register. Example In the following example, all machine check and correctable error reporting are enabled before running the memory test. The errors displayed in this example are correctable, and without machine checks enabled, these memory errors would be corrected by the CPU.
User Commands memtest memtest The memtest command tests a memory range. Format memtest [iterations [start_address [end_address [increment [mcheck [stop_drivers]]]]]] Parameters iterations Specifies the number of times the memory range test will run. The default iteration is 1. start_address Specifies the address at which to start the memory test. The default is the current address. end_address Specifies the address at which to end the memory test. increment Defines the step size.
User Commands memtest While conducting the memory test, correctable read data errors may be encountered, indicating memory integrity problems. However, if hardware error reporting is disabled, the CPU corrects the correctable errors without reporting them. To alleviate this problem, the mcheck parameter must specify the machine check conditions while running the memory test. Device drivers that use main memory for DMA access while the memory test is running may cause unpredictable results.
User Commands mrb mrb The mrb command reads a byte from memory in the register port in I/O address space. Format mrb address [iterations [silent]] Parameters address Specifies the address in memory I/O space. iterations Specifies how many times the data is read. The default is 1. silent Specifies whether or not the data is displayed. Setting this field to 1 causes the data to be read but not displayed. The default is 0 (data is displayed).
User Commands mrl mrl The mrl command reads a longword from memory in the register port in I/O address space. Format mrl address [iterations [silent]] Parameters address Specifies the address in memory I/O space. iterations Specifies how many times the data is read. The default is 1. silent Specifies whether or not the data is displayed. Setting this field to 1 causes the data to be read but not displayed. The default is 0 (data is displayed).
User Commands mrw mrw The mrw command reads a word from memory in the register port in I/O address space. Format mrw address [iterations [silent]] Parameters address Specifies the address in memory I/O space. iterations Specifies how many times the data is read. The default is 1. silent Specifies whether or not the data is displayed. Setting this field to 1 causes the data to be read but not displayed. The default is 0 (data is displayed).
User Commands mwb mwb The mwb command writes a byte to memory in the register port in I/O address space. Format mwb address data [iterations] Parameters address Specifies the address in memory I/O space where the byte is written. data Specifies byte data. iterations Specifies how many times the data is read. The default is 1. Description The mwb command specifies the memory location in I/O memory space to write data in byte format.
User Commands mwl mwl The mwl command writes a longword to memory in the register port in I/O address space. Format mwl address data [iterations] Parameters address Specifies the address in memory I/O space where the longword is written. data Specifies longword data. iterations Specifies how many times the data is read. The default is 1. Description The mwl command writes a longword to memory in I/O address space. For example, on the EB64, the longword is written to the ISA extension slot.
User Commands mww mww The mww command writes a word to memory in the register port in I/O address space. Format mww address data [iterations] Parameters address Specifies the address in memory I/O space where the word is written. data Specifies word data. iterations Specifies how many times the data is read. The default is 1. Description The mww command writes a word to memory I/O space. For example, on the EB64, a word is written to the ISA extension slot.
User Commands netboot netboot The netboot command downloads the specified file through the Ethernet port and begins execution of that file. Format netboot [file [address]] Parameters file Specifies a legal file name to be downloaded to the motherboard. The default is to load the file specified in the bootptab file. address Specifies the address at which to download the file. The default is the boot address.
User Commands netboot Example This example downloads and begins execution of a file called size. EB64> netboot size Ethernet Base Address: 360, DMA Mask: 1 = DRQ5 Init Block Address 80000 Init Done. Ethernet BA-98-76-54-32-10 Attempting BOOTP...success. my IP address: 16.123.45.67 server IP address: 16.123.45.69 gateway IP address: 16.123.45.69 Loading from /users/eval/boot/size ... ### Jumping to 0x100000...
User Commands netload netload The netload command downloads the specified file through the Ethernet port to the default boot address. Format netload [file [address]] Parameters file Specifies a legal file name to be downloaded to the motherboard. The default is to load the file specified in the bootptab file. address Specifies the address at which to download the file. The default is the boot address. Description The netload command uses BOOTP to download the specified file through the Ethernet port.
User Commands netload Example In this example, a file called size is loaded into the default boot address. EB64> netload size Ethernet Base Address: 360, DMA Mask: 1 = DRQ5 Init Block Address 80000 Init Done. Ethernet BA-98-76-54-32-10 Attempting BOOTP...success. my IP address: 16.123.45.67 server IP address: 16.123.45.69 gateway IP address: 16.123.45.69 Loading from /users/eval/boot/size ...
User Commands next next The next command executes the machine instruction without stepping into subroutines. Format n[ext] Parameters None. Description Use the step command and the next command to execute a machine instruction. When the instruction contains a subroutine, the step command steps into the subroutine being called and the next command executes the subroutine being called.
User Commands next Example In the following example, the step command used at address 200034 steps to the first instruction of the function being called at address 2000c0. The next command used at address 2000ec executes the function being called and steps to the next instruction at address 2000f0. EB164> dis 00200030: a77d8010 00200034: 6b5b4000 00200038: 27ba0001 0020003c: 23bdc148 EB164> step 00200030: a77d8010 EB164> step 00200034: 6b5b4000 EB164> step 002000c0: 27bb0001 . . .
User Commands pb pb The pb command displays the specified memory byte (8-bit). Format pb [start_address [end_address [iterations [silent]]]] Parameters start_address Specifies a hexadecimal number that represents a legal address at which to start the display. The default is the current address. end_address Specifies a hexadecimal number that represents a legal address at which to end the display. The default is the current address plus 127 bytes. iterations Specifies how many times the data is read.
User Commands pb Example This example displays 128 bytes from memory starting with 100000 in byte format.
User Commands pcishow pcishow The pcishow command displays the contents of each PCI slot and the current PCI-to-system address space mapping. Format pcishow bus id function Parameters bus Specifies which bus to show. The default value is 0. id Specifies a decimal number that represents the slot assigned to the PCI device. function Specifies which funtion to read from. The default value is 0. Description The pcishow command applies only to PCI motherboards.
User Commands pcishow Example EB164> pcishow PCI Address Mapping windows are: (1) PCI Base = 0x00100000, Size = 0x00100000 Translated Base = 0x00100000 Bus = 0 primary = 0, secondary = 0, subordinate = 0 PCI I/O space = 1000, PCI Mem space = 3F00000 PCI I/O base = B000, PCI Mem base = 200000 PCI slot 18, vendor = 0x1011, device = 0x4 PCI IO Base = 0x0, PCI IO Size = 0x0 PCI Mem Base = 0x2000000, PCI Mem Size = 0x2000000 Display controller PCI slot 19, vendor = 0x8086, device = 0x484 PCI IO Base = 0x0, PCI
User Commands pfreg pfreg The pfreg command displays the saved CPU floating-point register state. Format pfreg [address] Parameters address Specifies an alternate address for the saved-state area. Description The pfreg command displays the contents of the CPU floating-point registers stored in the saved-state area. A register state is stored when a breakpoint is encountered or the PALcode reset flow is entered.
User Commands pl pl The pl command displays the specified memory longword (32-bit). Format pl [start_address [end_address [iterations [silent]]]] Parameters start_address Specifies a hexadecimal number that represents a legal address at which to start the display. The default is the current address. end_address Specifies a hexadecimal number that represents a legal address at which to end the display. The default is the current address plus 127 bytes. iterations Specifies how many times the data is read.
User Commands pl Example This example displays memory longwords.
User Commands pq pq The pq command displays the specified memory quadword (64-bit). Format pq [start_address [end_address [iterations [silent]]]] Parameters start_address Specifies a hexadecimal number that represents a legal address at which to start the display. The default is the current address. end_address Specifies a hexadecimal number that represents a legal address at which to end the display. The default is the current address plus 127 bytes. iterations Specifies how many times the data is read.
User Commands pq Example This example displays memory quadwords.
User Commands prb prb The prb command reads a byte (8 bits) from the specified address in the PCI configuration space. Format prb pci_address id bus function Parameters pci_address Specifies the address in PCI space. id Specifies a decimal number that represents the slot assigned to the PCI device. bus Specifies which bus to read from. The default value is 0. function Specifies which function to read from. The default value is 0.
User Commands preg preg The preg command displays the saved CPU general-purpose register state. Format preg [address] Parameters address Specifies an alternate address for the saved-state area. Description The preg command displays the contents of the CPU general-purpose registers stored in the saved-state area. A register state is stored when a breakpoint is encountered or the PALcode reset flow is entered.
User Commands prl prl The prl command reads a longword (32 bits) from the specified address in the PCI configuration space. Format prl pci_address id bus function Parameters pci_address Specifies the address in PCI space. id Specifies a decimal number that represents the slot assigned to the PCI device. bus Specifies which bus to read from. The default value is 0. function Specifies which function to read from. The default value is 0.
User Commands prw prw The prw command reads a word (16 bits) from the specified address in the PCI configuration space. Format prw pci_address id bus function Parameters pci_address Specifies the address in PCI space. id Specifies a decimal number that represents the slot assigned to the PCI device. bus Specifies which bus to read from. The default value is 0. function Specifies which function to read from. The default value is 0.
User Commands prw Example AlphaPC 64> pcishow PCI Address Mapping windows are: (1) PCI Base = 0x00100000, Size = 0x00100000 Translated Base = 0x00100000 Bus = 0 primary = 0, secondary = 0, subordinate = 1 PCI I/O space = 1000, PCI Mem space = 100000 PCI I/O base = B000, PCI Mem base = 200000 PCI slot 17, vendor = 0x1011, device = 0x1 PCI IO Base = 0x0, PCI IO Size = 0x0 PCI Mem Base = 0x0, PCI Mem Size = 0x0 PCI-PCI bridge PCI slot 19, vendor = 0x8086, device = 0x484 PCI IO Base = 0x0, PCI IO Size = 0x0 PC
User Commands pw pw The pw command displays the specified memory word (16-bit). Format pw [start_address [end_address [iterations [silent]]]] Parameters start_address Specifies a hexadecimal number that represents a legal address at which to start the display. The default is the current address. end_address Specifies a hexadecimal number that represents a legal address at which to end the display. The default is the current address plus 127 bytes. iterations Specifies how many times the data is read.
User Commands pw Example This example displays eight memory addresses starting with 10000016 in word format.
User Commands pwb pwb The pwb command writes a byte (8 bits) to an address in the PCI configuration space. Format pwb pci_address id data bus function Parameters pci_address Specifies which address to write to. id Specifies a decimal number that represents the slot assigned to the PCI device. data Specifies the value that is written to the pci_address. bus Specifies which bus to write to. The default value is 0. function Specifies which function to write from. The default value is 0.
User Commands pwl pwl The pwl command writes a longword (32 bits) to an address in the PCI configuration space. Format pwl pci_address id data bus function Parameters pci_address Specifies which address to write to. id Specifies a decimal number that represents the slot assigned to the PCI device. data Specifies the value that is written to the pci_address. bus Specifies which bus to write to. The default value is 0. function Specifies which function to write from. The default value is 0.
User Commands pww pww The pww command writes a word (16 bits) to an address in the PCI configuration space. Format pww pci_address id data bus function Parameters pci_address Specifies which address to write to. id Specifies a decimal number that represents the slot assigned to the PCI device. data Specifies the value that is written to the pci_address. bus Specifies which bus to write to. The default value is 0. function Specifies which function to write from. The default value is 0.
User Commands rabox rabox The rabox command reads the CPU ABOX_CTL register. Format rabox Parameters None. Description The rabox command reads the CPU ABOX_CTL register and displays the value in hexadecimal format. This command applies only to motherboard designs based on the Alpha 21064 and Alpha 21066 microprocessors.
User Commands rb rb The rb command reads a byte (8 bits) from a register port in I/O address space. Format rb register [iterations [silent]] Parameters register Specifies the register from the I/O address space. iterations Specifies how many times the data is read. The default is 1. silent Specifies whether or not the data is displayed. Setting this field to 1 causes the data to be read but not displayed. The default is 0 (data is displayed).
User Commands rbcfg rbcfg The rbcfg command reads the backup cache configuration register. Format rbcfg Parameters None. Description The rbcfg command reads a shadow copy of the backup cache configuration register. If you manually change this register by writing to its architected address, the change will not be reflected for this command. You must use the wbctl or wbcfg command to make any changes. This command is implemented only for the Alpha 21164 microprocessor family.
User Commands rbctl rbctl The rbctl command reads the backup cache control register. Format rbctl Parameters None. Description The rbctl command reads a shadow copy of the backup cache control register. If you manually change this register by writing to its architected address, the change will not be reflected for this command. You must use the wbctl or wbcfg command to make any changes. This command is implemented only for the Alpha 21164 microprocessor family.
User Commands rbiu rbiu The rbiu command reads the CPU BIU_CTL register. Format rbiu Parameters None. Description The rbiu command reads the CPU BIU_CTL register and displays the value in hexadecimal format. This command applies only to motherboard designs based on the Alpha 21064 microprocessor.
User Commands riccsr riccsr The riccsr command reads the CPU ICCSR register. Format riccsr Parameters None. Description The riccsr command reads the CPU ICCSR register and displays the value in the CPU write format. For more information about the write format, see the hardware reference manual that corresponds to your CPU chip.
User Commands rl rl The rl command reads a longword (32 bits) from a register port in I/O address space. Format rl register [iterations [silent]] Parameters register Specifies the register from the I/O address space. iterations Specifies how many times the data is read. The default is 1. silent Specifies whether or not the data is displayed. Setting this field to 1 causes the data to be read but not displayed. The default is 0 (data is displayed).
User Commands rmode rmode The rmode command sets the dis command register display mode. Format rmode [mode] Parameters mode Determines the mode. If set (1), the software register names are displayed. If cleared (0), the hardware register names are displayed. The default is 0. Description The rmode command specifies whether hardware register names, such as r16, or software register names, such as a0, are displayed with the dis command.
User Commands rmode The following table displays the DIGITAL UNIX Alpha microprocessor register usage. Hardware Register Name Software Register Name r0 v0 Used for expression evaluation and to hold integer function results. r1...r8 t0...t7 Temporary registers; not preserved across procedure calls. r9...r14 s0...s5 Saved registers; their values must be preserved across procedure calls. r15 FP or s6 Frame pointer or a saved register. r16...r21 a0...
User Commands rmode Example EB64> rmode rmode = 0 EB64> dis 243a0 000243A0: 43020122 000243A4: 48441722 000243A8: 74420050 000243AC: 64630082 000243B0: 209F07E1 000243B4: 48855724 000243B8: 44640103 000243BC: 47203019 EB64> dis 000243C0: 4B037698 000243C4: 4703F118 000243C8: 47190418 000243CC: 4B055738 000243D0: 44780403 000243D4: 746300A2 000243D8: 77FF0055 000243DC: 77FF0000 EB64> rmode 1 EB64> dis 243a0 000243A0: 43020122 000243A4: 48441722 000243A8: 74420050 000243AC: 64630082 000243B0: 209F07E1 000243
User Commands romboot romboot The romboot command loads the specified image from ROM and begins execution. Format romboot [type] [address] Parameters type Specifies the image to load into ROM. If the type is specified as #0, then any header information is ignored and the entire contents of the ROM is loaded. The default is to load and execute the first image in the system ROM. address Specifies the starting address for loading the image into ROM.
User Commands romboot The romboot command can also be used to select a ROM image based on its position in the ROM. Specifying the type as #0 selects the entire ROM. Specifying the type as #1 selects the first image; #2 selects the second image, and so on. You can specify an address to override what is in the image file header. You may also use the bootadr command. Use the system reset to reset the motherboard to the initial booted state. Example AlphaPC 64> romboot Searching for ROM image #1 Header Size..
User Commands romboot AlphaPC 64> romboot nt Searching for the “Windows NT Firmware”. Header Size......... 52 bytes Image Checksum...... 0xD38C (54156) Image Size (Uncomp). 211728 (206 KB) Compression Type.... 0 Image Destination... 0x0000000000300000 Header Version...... 1 Firmware ID......... 1 - Windows NT Firmware ROM Image Size...... 211728 (206 KB) Firmware ID (Opt.).. 0305109502131030 ASCII: 0....... Header Checksum..... 0xCED2 Loading ROM to address 00300000 Image checksum verified.
User Commands romlist romlist The romlist command lists the ROM image headers contained in ROM. Format romlist Parameters None. Description The romlist command searches the system ROM for any ROM image headers that might be present. It then prints a summary for each header found. Example AlphaPC 64> romlist ROM image header found at offset: 0x000000 Header Size......... 52 bytes Image Checksum...... 0x8111 Image Size (Uncomp). 129552 (126 KB) Compression Type.... 0 Image Destination...
User Commands romload romload The romload command loads the specified image from ROM to the specified address. Format romload [type] [address] Parameters type Specifies the image to load into ROM. If the type is specified as #0, then any header information is ignored and the entire contents of the ROM is loaded. The default is to load the first image in the system ROM. address Specifies the starting address for loading the image into ROM.
User Commands romload The romload command can also be used to select a ROM image based on its position in the ROM. Specifying the type as #0 selects the entire ROM. Specifying the type as #1 selects the first image; #2 selects the second image, and so on. You can specify an address to override what is in the image file header. You may also use the bootadr command. Use the jtopal command to execute the image. Example AlphaPC 64> romload #0 Loading entire ROM.
User Commands romload AlphaPC 64> romload nt Searching for “Windows NT Firmware”. Header Size......... 52 bytes Image Checksum...... 0xD38C (54156) Image Size (Uncomp). 211728 (206 KB) Compression Type.... 0 Image Destination... 0x0000000000300000 Header Version...... 1 Firmware ID......... 1 - Windows NT Firmware ROM Image Size...... 211728 (206 KB) Firmware ID (Opt.).. 0305109502131030 ASCII: 0....... Header Checksum..... 0xCED2 Loading ROM to address 00300000 Image checksum verified.
User Commands romverify romverify The romverify command compares an image in memory to an image in the ROM. Format romverify [type [address]] Parameters type Specifies the name or number of an image in the ROM to compare against memory. If the type specified is #0, then any header information is ignored and the entire contents of the ROM are compared. If the type is #n the nth image in the ROM will be used (#2 is the second entry). The default is to compare the first image in the system ROM.
User Commands romverify Examples AlphaPC164> romload #0 300000 Loading entire ROM. Loading ROM to address 00300000 Loaded 1048576 bytes starting at 0x300000 to 0x3fffff AlphaPC164> romverify #0 Comparing entire ROM to image at 0x300000. Images match. AlphaPC164> netload PC164dbm.rom Attempting BOOTP... Loading PC164dbm.rom at 0x300000 My IP address: 192.168.0.107 Server IP address: 192.168.0.114 ################ File loaded successfully.
User Commands rsys rsys The rsys command reads the EB64 system control register. Format rsys Parameters None. Description The rsys command displays the current value of the system register. This command applies only to the EB64.
User Commands rw rw The rw command reads a word (16 bits) from a register port in I/O address space. Format rw register [iterations [silent]] Parameters register Specifies the register from the I/O address space. iterations Specifies how many times the data is read. The default is 1. silent Specifies whether or not the data is displayed. Setting this field to 1 causes the data to be read but not displayed. The default is 0 (data is displayed).
User Commands sb sb The sb command searches memory by bytes (8-bit). Format sb start_address end_address string [inverse] Parameters start_address Specifies the address at which to begin the search. end_address Specifies the address at which to end the search. string Specifies the search string. inverse Specifies whether to search for a matching string (0) or a nonmatching string (1). The default is 0 (search for a matching string).
User Commands sb Example EB64> pl 100000 100080 00100000: C3E00007 00000000 00100010: 00000000 00000000 00100020: 221F0000 26100012 00100030: 00000000 00000000 00100040: 00000000 00000000 00100050: 00000000 00000000 00100060: 00000000 00000000 00100070: 00000000 00000000 00100080: 00000000 00000000 EB64> sb 100000 100080 2* val = 20 mask = F0 occurrence at 00100023 22 occurrence at 00100027 26 EB64> sb 100000 100080 1* val = 10 mask = F0 occurrence at 00100022 1F occurrence at 00100024 12 occurrence at 001
User Commands setbaud setbaud The setbaud command sets the baud rate for the specified communication port connection. Format setbaud port baud_rate Parameters port Specifies the number identifier for the keyboard or serial port. baud_rate Specifies the baud rate for the specified port. The default is 9600. Description The setbaud command sets the baud rate for the specified keyboard or serial communication port. The baud rate can be set to 1200, 2400, 9600, 19200, or 38400.
User Commands setty setty The setty command sets the Debug Monitor to the specified port. Format setty port Parameters port Specifies the number identifier for the keyboard or serial port. Description The setty command specifies the port used for Debug Monitor interaction. The following table shows the port identifier numbers.
User Commands sl sl The sl command searches memory by longwords (32-bit). Format sl start_address end_address string [inverse] Parameters start_address Specifies the address at which to begin the search. end_address Specifies the address at which to end the search. string Specifies the search string. inverse Specifies whether to search for a matching string (0) or a nonmatching string (1). The default is 0 (search for a matching string).
User Commands sl Example EB64> pl 100000 00100000: C3E00007 00000000 00000000 00100010: 00000000 00000000 00000000 00100020: 221F0000 26100012 6BF00000 00100030: 00000000 00000000 00000000 00100040: 00000000 00000000 00000000 00100050: 00000000 00000000 00000000 00100060: 00000000 00000000 00000000 00100070: 00000000 00000000 00000000 EB64> sl 100000 100070 2******* val = 20000000 mask = F0000000 occurrence at 00100020 221F0000 occurrence at 00100024 26100012 EB64> sl 100000 100070 2*1***** val = 20100000
User Commands sq sq The sq command searches memory by quadwords (64-bit). Format sq start_address end_address string [inverse] Parameters start_address Specifies the address at which to begin the search. end_address Specifies the address at which to end the search. string Specifies the search string. inverse Specifies whether to search for a matching string (0) or a nonmatching string (1). The default is 0 (search for a matching string).
User Commands sq Example EB64> pq 00000000: 00000000C3E00007 0000000000000000 ................ 00000010: 0000000000000000 0000000000000000 ................ 00000020: 26100002221F0000 000000006BF00000 ...”...&...k.... 00000030: 0000000000000000 0000000000000000 ................ 00000040: 0000000000000000 0000000000000000 ................ 00000050: 0000000000000000 0000000000000000 ................ 00000060: 0000000000000000 0000000000000000 ................ 00000070: 0000000000000000 0000000000000000 ......
User Commands step step The step command executes the next instruction. Format s[tep] Parameters None. Description Use the step command and the next command to execute a machine instruction. When the instruction contains a subroutine call, the step command steps into the subroutine being called and the next command executes that subroutine. In the following example, the step command used at address 00200034 steps to the first instruction of the subroutine being called at address 002000c0.
User Commands step Example EB164> dis 00200030: a77d8010 00200034: 6b5b4000 00200038: 27ba0001 0020003c: 23bdc148 EB164> step 00200030: a77d8010 EB164> step 00200034: 6b5b4000 EB164> step 002000c0: 27bb0001 . . .
User Commands stop stop The stop command sets a breakpoint. Format stop address Parameters address Specifies the address at which the breakpoint is set. Description The stop command sets a breakpoint at the specified address. When a breakpoint is encountered, all current register values are stored in memory and can be viewed with the preg and pfreg commands. Example EB64> stop 100000 EB64> go Executing at 0x100000... 00100000: C1000003 br r8, 100010 EB64> stop 100200 EB64> go Executing at 0x100000...
User Commands sum sum The sum command computes the checksum of the data in the specified range. Format sum start_address end_address Parameters start_address Specifies the address at which the checksum check begins. end_address Specifies the address at which the checksum check ends. Description The sum command prints the checksum of the data contained in the specified memory range. The algorithm used computes a 16-bit checksum and is compatible with the standard BSD4.
User Commands sw sw The sw command searches memory by words (16-bit). Format sw start_address end_address string [inverse] Parameters start_address Specifies the address at which to begin the search. end_address Specifies the address at which to end the search. string Specifies the search string. inverse Specifies whether to search for a matching string (0) or a nonmatching string (1). The default is 0 (search for a matching string).
User Commands swpipl swpipl The swpipl command sets or displays the current interrupt priority level (IPL) of the CPU. Format swpipl [ipl] Parameters ipl Specifies the IPL ranging from 0 to 7 as defined for DIGITAL UNIX by the Alpha AXP Architecture Reference Manual. Description The swpipl command reports the current IPL when no parameter is provided. When a value of 0 to 7 is provided to the swpipl command, the current IPL is set to that value.
User Commands sysshow sysshow The sysshow command displays all SROM parameters. Format sysshow Parameters None. Description The sysshow command displays the system status passed from the SROM at initialization or reset. Refer to your motherboard’s user’s manual for more information about the SROM parameters displayed.
User Commands tip tip The tip command connects to the specified serial communication port. Format tip port Parameters port Specifies the serial port. Description The tip command is a subset of the DIGITAL UNIX tip command. It allows you to connect directly from the motherboard to the specified serial communication port. You can specify 1 for serial port 1, or specify 2 for serial port 2. Example In this example, the host system is connected to serial port 1.
User Commands version version The version command displays the current Debug Monitor firmware version information. Format version Parameters None. Description The version command displays the current Debug Monitor firmware version information. This information is also displayed in the banner when you power up the motherboard.
User Commands wabox wabox The wabox command writes to the CPU ABOX_CTL register. Format wabox data Parameters data Specifies the new value written to the register. Description The wabox command writes to the CPU ABOX_CTL register. The motherboard does not check for valid register values. This command applies only to Alpha motherboards based on the 21064 and 21066 microprocessors.
User Commands wb wb The wb command writes a byte (8 bits) to a register port in I/O address space. Format wb register data [iterations] Parameters register Specifies which register to write to. data Specifies the value that is written to the register. iterations Specifies how many times the data is read. The default is 1. Description The wb command writes a byte to the specified register in I/O address space.
User Commands wbcfg wbcfg The wbcfg command writes to the backup cache configuration register. Format wbcfg bcfg_data [bctl_data] Parameters bcfg_data Specifies the new backup cache configuration register value. bctl_data Specifies the new backup cache control register value. If not supplied, the current value remains unchanged. Description The wbcfg command writes to the backup cache configuration register and the backup cache control register in the same command.
User Commands wbctl wbctl The wbctl command writes to the backup cache control register. Format wbctl bctl_data [bcfg_data] Parameters bctl_data Specifies the new backup cache control register value. If not supplied, the current value remains unchanged. bcfg_data Specifies the new backup cache configuration register value. Description The wbctl command writes to the backup cache control register and the backup cache configuration register in the same command.
User Commands wbiu wbiu The wbiu command writes to the CPU BIU_CTL register. Format wbiu data Parameters data Specifies the new value written to the register. Description The wbiu command writes to the CPU BIU_CTL register. The motherboard does not check for valid register values. Caution: Bit 2 of the BIU_CTL register cannot be cleared with this command. Setting the OE could damage the EB64.
User Commands wiccsr wiccsr The wiccsr command writes to the CPU ICCSR register. Format wiccsr data Parameters data Specifies the new value written to the register. Description The wiccsr command writes to the CPU ICCSR register. The motherboard does not check for valid register values.
User Commands wl wl The wl command writes a longword (32 bits) to a register port in I/O address space. Format wl register data [iterations] Parameters register Specifies which register to write to. data Specifies the value that is written to the register. iterations Specifies how many times the data is read. The default is 1. Description The wl command writes a longword to the specified register in I/O address space.
User Commands wrfen wrfen The wrfen command enables or disables floating point. Format wrfen value Parameters value Specifies a value of 0 or 1 that is written into the processor’s floating-point enable register. Description The wrfen (write floating-point enable) command writes bit zero of the value passed to the floating-point enable register in the CPU. The value of FEN is also updated to the PCB.
User Commands wsys wsys The wsys command writes to the EB64 system control register. Format wsys data Parameters data Specifies a value that becomes the new value of the system register. Description The wsys command modifies the contents of the EB64 system register. This command applies only to the EB64.
User Commands ww ww The ww command writes a word (16 bits) to a register port in I/O address space. Format ww register data [iterations] Parameters register Specifies which register to write to. data Specifies the value that is written to the register. iterations Specifies how many times the data is read. The default is 1. Description The ww command writes a word to the specified register in I/O address space. For example, on the EB64, the word is written to the ISA extension slot.
A Support, Products, and Documentation If you need technical support, a DIGITAL Semiconductor Product Catalog, or help deciding which documentation best meets your needs, visit the DIGITAL Semiconductor World Wide Web Internet site: http://www.digital.com/semiconductor You can also call the DIGITAL Semiconductor Information Line or the DIGITAL Semiconductor Customer Technology Center. Please use the following information lines for support.
DIGITAL Semiconductor Products Note: The following products and order numbers might have been revised. For the latest versions, contact your local distributor. Microprocessors To order Alpha microprocessors, contact your local distributor.
DIGITAL Semiconductor Documentation The following table lists some of the available DIGITAL Semiconductor documentation.
(Sheet 2 of 2) Title Order Number Alpha Microprocessors Motherboard Windows NT 3.51 and 4.0 Installation Guide EC-QLUAH-TE Alpha Microprocessors SROM Mini-Debugger User’s Guide EC-QHUXC-TE Alpha SRM Console for Alpha Microprocessor Motherboards User’s Guide EC-QK8DF-TE PALcode for Alpha Microprocessors System Design Guide EC-QFGLC-TE 1 To purchase the Alpha AXP Architecture Reference Manual, contact your local distributor or call Butterworth-Heinemann (Digital Press) at 1–800–366–2665.
Index A C Alpha, 1–2 documentation, A–3 Alpha SRM Console firmware, 2–11 cb, 4–21 AlphaBIOS, 2–7 apropos, 4–11 arpshow, 4–12 Audience, ix cfreg, 4–22 cl, 4–24 Command features, 1–1 Command interface features, 4–1 Command line editing, 4–1 Command overview, 4–1 B Command quick reference, 4–4 Baud rate, 2–1 bcoff, 4–13 Commands usage of, 4–2 Communication ports, 2–1, 2–3 bcon, 4–14 compare, 4–25 beep, 4–15 Configuring the system, 2–1 boot, 2–4, 4–16 Connecting to a PC, 2–2 Boot address, 4–17
creg, 4–31 eprom, 4–47 cw, 4–33 ereg, 4–48 D eshow, 4–50 estat, 4–51 Daemon log file, 2–5 estop, 4–52 date, 4–35 Ethernet, 2–18 Debug Monitor commands, 4–10 Execution commands, 2–18 Debugger definition of, 3–1 Debugging hints, 3–1 F delete, 4–36 Digital Semiconductor Information Line, A–1 DIGITAL UNIX, 1–2, 2–3 DIGITAL UNIX remote debugging, 3–1 DIGITAL UNIX tip command, 2–4 dis, 4–37 Diskette, 2–18 DMA buffers, 2–18 dml, 4–39 dmq, 4–40 Document audience, ix conventions, x structure, x Documen
H Hardware requirements, 2–1 help, 4–75 Host system, 2–4 I mrw, 4–92 mwb, 4–93 mwl, 4–94 mww, 4–95 N iack, 4–77 netboot, 2–4, 4–96 ident, 4–78 netload, 2–4, 4–98 init, 4–80 next, 4–100 Introduction, 1–1 O J Operating system requirements, 2–1 jtopal, 2–18, 4–81 K Kernel stack, 2–17 Ordering products, A–2 P PALcode environment, 3–3 PALcode guidelines, 3–3 L Path, 4–61, 4–65 Ladebug, 2–5, 3–1 command line options, 3–4 starting a session, 3–6 ladebug command, 4–82 pb, 4–102 load, 2–4, 4–84
pwl, 4–119 Setting up for remote debugging, 2–5 pww, 4–120 setty, 4–145 R sl, 4–146 sq, 4–148 rabox, 4–121 Stack, 2–17 rb, 4–122 step, 4–150 rbcfg, 4–123 stop, 4–152 rbctl, 4–124 Structure of document, x rbiu, 4–125 sum, 4–153 Recommended host system, 1–2 Summary of commands, 4–4 Related documentation, A–3 sw, 4–154 Remote debug server, 3–1 swpipl, 4–155 Remote debugger definition of, 3–1 Remote debugging, 2–5, 3–1 command line options, 3–4 executable file, 3–5 guidelines, 3–2 Requirem
wbiu, 4–163 wiccsr, 4–164 Windows NT, 1–2, 2–2 wl, 4–165 wrfen, 4–166 wsys, 4–167 ww, 4–168 Index–5