DataMuseum.dk

top - download

    Length: 2676 (0xa74)
    Types: TextFile
    Notes: R1k Text-file segment

└─⟦8527c1e9b⟧ Bits:30000544 8mm tape, Rational 1000, Arrival backup of disks in PAM's R1000
    └─ ⟦5a81ac88f⟧ »Space Info Vol 1« 
        └─⟦2240a6a5a⟧ 
            └─⟦this⟧ 

TextFile

The ENP_Debugger is a tool for examining ENP memory or memory dumps.

    procedure Enp_Examine (Enp_Dump : String := ""; Iop_Dump : String := "");
    
Enp_Dump is the name of a ENP memory dump file.  If Enp_Dump is "", the
ENP_Driver spec is called to read the ENP memory.  The Iop_Dump file is
currently not used, and should be left "".

You will get a Rational IO window, with a prompt ">".  At this prompt
the following commands are accepted:  (Commands may be in any case,
and any unique prefix will be accepted).


> COUNT <positive>

Set the default count for the number of bytes displayed by the READ
or PUT command to the specified positive value.  Initially set to 128.  

> READ  <address>  <count>

Display a hex dump of memory at address.   Address is accepted in 2
formats:  #hhhhhhhhh is interpreted as a host base address.  0xhhhhh
is interpreted as a 0 based ENP memory address.  'h' is a Hex digit.
Count should be in decimal and defaults to the value last specified
by the COUNT command.


> PUT  <name>

PUT displays an ENP structure or object.  With no parameters, put displays
the ENP based addresses of the shared data structures:

    > put
        K1_Kernel_Mailbox : 0xE0001000
        Sysparam          : 0xE0001100
        Shared            : 0xE0001200
        Shared_Rings      : 0xE0001220
        Pib               : 0xE0001230
                    
Host addresses are displayed with a "#", as are other Hex values.  ENP
based addresses are display with a leading "0x".

PUT follows basic ada naming conventions.  You can omit the command name PUT,
and the command line is treated as a named object to display.  For example
the following two commands are equivalent.
                                             
    > PUT shared_rings.e_tohost.r_slot(0).all    
    > shared_rings.e_tohost.r_slot(0).all    
    
.all is used to dereference pointers to structures or arrays.

If the command line starts with a '.', the previous PUT is repeated,
and the command line is appended to the previous put.  Both of the
following are legal:

    > .
    > .b_type        
    
Examples:               

    to see the PIB structures, 0..3

        > pib(0)             
    
    to see the channels, 0..64

        > shared.chanaddr(0)
    
    to see a buffer on a ring
    
        > shared_Rings.e_tohost.r_slot(0).all
    
As in C, arrays start at 0 and there is no bounds.
        
> ENP_FILE  <file_name>

Opens a new ENP dump file.  With no file name specified, reads from
ENP memory.

> IOP_FILE

Not Implemented.

> HELP

Displays the list of commands.

> VERSION

Displays a version message.

> QUIT

Closes any files and terminates.