HP 3000 Manuals

DR [ System Debug Reference Manual ] MPE/iX 5.0 Documentation


System Debug Reference Manual

DR 

Displays contents of the CM or NM registers.

Syntax 

     DR [cm_register] [base]
     DR [nm_register] [base]

Parameters 

 cm_register     The CM register to be displayed.  This can be the:

                 DB               The stack base relative word offset of
                                  DB.
                 DBDST            The DB data segment number.
                 DL               The DL register word offset, DB
                                  relative.
                 CIR              The current instruction register.
                 CMPC             The full logical CM program counter
                                  address.
                 MAPDST           The CST expansion mapping data segment
                                  number.
                 MAPFLAG          The CST expansion mapping bit.
                 Q                The Q register word offset, DB
                                  relative.
                 S                The S register word offset, DB
                                  relative.
                 SDST             The CM stack data segment number.
                 STATUS           The CM status register.
                 X                The X (index) register.

                 If cm_register is omitted, all of the above CM registers
                 are displayed.

 nm_register     The NM register to be displayed.

                 If no value is provided, all NM registers are displayed
                 (excluding the floating-point registers).  The ENVL ,FP
                 command displays all of the floating-point registers at
                 once.

                 To fully understand the use and conventions for the
                 various registers, refer to the Precision Architecture 
                 and Instruction Reference Manual (09740-90014) and
                 Procedure Calling Conventions Reference Manual 
                 (09740-90015).  (These may be ordered as a set with the
                 part number 09740-64003.)  The Procedure Calling 
                 Conventions Reference Manual is of particular importance
                 for understanding how the language compilers utilize the
                 registers to pass parameters, return values, and hold
                 temporary values.

                 The following tables list the native mode registers
                 available within System Debug.  Many registers have
                 aliases through which they may be referenced.  Alias
                 names in italics are not available in System Debug.

                 Access rights abbreviations are listed below.  PM
                 indicates that privileged mode (PM) capability is
                 required.

                 d                Display access
                 D                PM display access
                 m                Modify access
                 M                PM modify access

                 The following registers are known as the General 
                 Registers.

Name                  Alias                 Access                Description 
---------------------------------------------------------------------------------------
R0                    none                  d                     A constant 0
R1                    none                  dm                    General register 1
R2                    none                  dm                    Used to hold RP at
                                                                  times
R3                    none                  dm                    General register 3
  :
R22                   none                  dm                    General register 22
R23                   ARG3                  dm                    Argument register 3
R24                   ARG2                  dm                    Argument register 2
R25                   ARG1                  dm                    Argument register 1
R26                   ARG0                  dm                    Argument register 0
R27                   DP                    dM                    Global data pointer
R28                   RET1                  dm                    Return register 1
R29                   RET0                  dm                    Return register 0
                      SL                    dm                    Static link
R30                   SP                    dM                    Current stack pointer
R31                   MRP                   dm                    Millicode return
                                                                  pointer

                 The following registers are pseudo-registers.  They are
                 not defined in the Precision Architecture, but are terms
                 used in the procedure calling conventions document and
                 by the language compilers.  They are provided for
                 convenience.  They are computed based on stack unwind
                 information.  They may not be modified.

Name                  Alias                 Access                Description 
---------------------------------------------------------------------------------------
RP                    none                  d                     Return pointer (not
                                                                  the same as R2)
PSP                   none                  d                     Previous stack
                                                                  pointer

                 The following registers are known as the Space 
                 Registers.  Registers SR4 through SR7 are used for short
                 pointer addressing:

Name                  Alias                 Access                Description 
---------------------------------------------------------------------------------------
SR0                   none                  dm                    Space register 0
SR1                   SARG                  dm                    Space register
                                                                  argument
                      SRET                  dm                    Space return register
SR2                   none                  dm                    Space register 2
SR3                   none                  dm                    Space register 3
SR4                   none                  dM                    Process local code
                                                                  space (tracks PC
                                                                  space)
SR5                   none                  dM                    Process local data
                                                                  space
SR6                   none                  dM                    Operating system data
                                                                  space 1
SR7                   none                  dM                    Operating system data
                                                                  space 2

                 The following registers are known as the Control 
                 Registers.  They contain system state information.

Name                  Alias                 Access                Description 
---------------------------------------------------------------------------------------
CR0                   RCTR                  dM                    Recovery counter
CR8                   PID1                  dM                    Protection ID 1 (16
                                                                  bits)
CR9                   PID2                  dM                    Protection ID 2 (16
                                                                  bits)
CR10                  CCR                   dM                    Coprocessor
                                                                  configuration (8
                                                                  bits)
CR11                  SAR                   dm                    Shift amount register
                                                                  (5 bits)
CR12                  PID3                  dM                    Protection ID 3 (16
                                                                  bits)
CR13                  PID4                  dM                    Protection ID 4 (16
                                                                  bits)
CR14                  IVA                   dM                    Interrupt vector
                                                                  address
CR15                  EIEM                  dM                    External interrupt
                                                                  enable mask
CR16                  ITMR                  dM                    Interval timer
CR17                  PCSF                  dM                    PC space queue front
none                  PCSB                  dM                    PC space queue back
CR18                  PCOF                  dM                    PC offset queue front
none                  PCSB                  dM                    PC offset queue back
none                  PCQF                  dM                    PC queue (PCOF.PCSF)
                                                                  front
none                  PCQB                  dM                    PC queue (PCOB.PCSB)
                                                                  back
none                  PC                    dM                    PCQF with priv bits
                                                                  set to zero.
none                  PRIV                  dM                    Low two order bits
                                                                  (30,31) of PCOF.
CR19                  IIR                   dM                    Interrupt instruction
                                                                  register
CR20                  ISR                   dM                    Interrupt space
                                                                  register
CR21                  IOR                   dM                    Interrupt offset
                                                                  register
CR22                  IPSW                  dM                    Interrupt processor
                                                                  status word
                      PSW                   dM                    Processor status word
CR23                  EIRR                  dM                    External interrupt
                                                                  request register
CR24                  TR0                   dM                    Temporary register 0
   :
CR31                  TR7                   dM                    Temporary register 7


NOTE The Precision Architecture and Instruction Reference Manual refers to the PC (program counter) registers as the IA (instruction address) registers. This manual will use the PC mnemonic when referring to the IA registers.
The following registers are floating-point registers. If a machine has a floating-point coprocessor board, these values are from that board. If no floating-point hardware is present, the operating system emulates the function of the hardware; in that case these are the values from floating-point emulation. Name Alias Access Description --------------------------------------------------------------------------------------- FP0 none dm FP register 0 FP1 none dm FP register 1 FP2 none dm FP register 2 FP3 none dm FP register 3 FP4 FARG0 dm FP argument register 0 FRET dm FP return register FP5 FARG1 dm FP argument register 1 FP6 FARG2 dm FP argument register 2 FP7 FARG3 dm FP argument register 3 FP8 none dm FP register 8 : FP15 none dm FP register 15 FPSTATUS none dm FP status reg (left half of FP0) FPE1 none dm FP exception reg 1 (right half of FP0) FPE2 none dm FP exception reg 2 (left half of FP1) FPE3 none dm FP exception reg 3 (right half of FP1) FPE4 none dm FP exception reg 4 (left half of FP2) FPE5 none dm FP exception reg 5 (right half of FP2) FPE6 none dm FP exception reg 6 (left half of FP3) FPE7 none dm FP exception reg 7 (right half of FP3) base Specifies the base used to display the register data. % or OCTAL Octal representation # or DECIMAL Decimal representation $ or HEXADECIMAL Hexadecimal representation ASCII ASCII representation This parameter can be abbreviated to as little as a single character. Examples %cmdebug > dr DBDST=%132 DB=%1000 X=%102 STATUS=%140075=(MItroc CCG 075) SDST=%132 DL=%650 Q=%1006 S=%1007 CMPC=PROG %12.2046 SEG =%12 P=%2046 CIR=%000700 MDST=%0 Display the contents of all CM registers. %cmdebug > dr status STATUS=%022002=(miTRoC CCE 002) Display the contents of the CM status register. $nmdebug > dr R0 =00000000 00464800 005a6e48 00000000 R4 =00000000 00000000 00000000 00000000 R8 =00000000 00000000 00000000 00000000 R12=00000000 00000000 00000000 00000000 R16=00000000 00000000 00000000 0000002a R20=00000006 00007fff ffff8000 400524a8 R24=400524a0 00000400 40052058 c0080008 R28=00000000 00000000 40052520 0000003f IPSW=0006ff0f=jthlnxbCVmrQPDI PRIV=0000 SAR=0010 PCQF=a.5a6e48 a.5a6e4c SR0=0000000a 00000057 00000017 00000000 SR4=0000000a 00000057 0000000a 0000000a TR0=007ea040 0080a040 0000000a 007727c0 TR4=40052848 400526a8 00bba1e0 00bba228 PID1=0020=0010(W) PID2=0000=0000(W) PID3=0000=0000(W) PID4=0000=0000(W) RCTR=ffffffff ISR=00000057 IOR=4005250c IIR=6bc23fd9 IVA=001cb000 ITMR=5b8b1e69 EIEM=ffffffff EIRR=00000000 CCR=0000 Display all NM registers. $nmdebug > dr pcqb PCQB=0000000a.0021d7b8 Display the contents of "pcq back". $nmdebug > dr pid2 PID2=$0004=0002(W) Display the contents of protection ID register number 2. Limitations, Restrictions Floating-point registers are displayed as 64-bit long pointers. No interpretation of the data is attempted.
CAUTION The output format of all System Debug commands is subject to change without notice. Programs that are developed to postprocess System Debug output should not depend on the exact format (spacing, alignment, number of lines, uppercase or lowercase, or spelling) of any System Debug command output.


MPE/iX 5.0 Documentation