fst — Apollo

4.0;fst (fault_status), revision 4.0, 81/10/22
FST (FAULT_STATUS) -- Print fault status information.
usage:  FST [ [-S] [-R] | [-A] ] [-U n]


FORMAT

  FST [options]


  FST prints information about the most recent fault that occurred in the
  process.  The information always includes the fault status, the program
  counter (PC) at which the fault occurred, and a textual description of the
  error (as reported by the system call ERROR_$PRINT).

  This command is intended for system-level debugging.

  If you are using a Peripheral Bus Unit (PBU) device, you can get fault
  information by using the option "-U" (see below).


OPTIONS

  -R               Print the contents of the CPU general registers when the
                   fault occurred.

  -S               Print the supervisor PC, entry control block (ECB), and
                   status register (SR) if the fault occurred in supervisor
                   mode. This option is ignored if the fault occurred in
                   user mode.

  -A               Print all available fault information.  (Prints the same
                   information as both -S and -R.)

  -U n             Print the same information as both -S and -R for faults
                   caused by the PBU interrupt handler for unit n.


EXAMPLE

  $ fst -a
  Fault Diagnostic Information
  Fault Status   = 00120010:
  process quit (from OS / fault handler)
  User Fault PC  = 000157FC
  D0-D7:  00120010 00000000 00000002 FFFFFFFE 00000008 00000006 00000182 00000004
  A0-A7:  0020A452 00E2F22E 0020A3D4 0020A450 00E2F174 0000C92C 002746B4 002746AC
  Supervisor ECB = 00000000
  Supervisor SR  = 0000
  Supervisor PC  = 00000000
Museum
