The scsiboot command loads binary object files over a specified local scsi interface device.
The format for this command is:
scsiboot [-xbensy] [[-m]-d device] [-l len] [-a addr] [args]...
where args:
| -x | don't exec boot loaded file |
| -b | suppresses deletion of all breakpoints before the load. |
| -e | suppresses clearing of the exception handlers. |
| -y | loads only the symbols from the file. |
| -d | specify scsi device (e.g., sd0) |
| -l | length in disk blocks |
| -a | memory destination for loaded file |
|
-m
|
manually specify boot dev/file (otherwise use env var: bootdev) |
| -- [args]... | args to be passed to client, e.g. bsd -s |
Invoking the scsiboot command with no parameters or arguments clears the symbol table, deletes all current breakpoints, and attempts to load the program found on the device specified by the bootdev, bootaddr, bootlen, and bootfile environment variables.
The scsiboot command is used to load an executable binary file with the built-in scsi bootloader module from a local disk drive.
PMON/2000 scsiboot can read files in ELF format as used in:
PMON/2000 extracts any symbol table information from these files, and adds it to the target symbol table, unless overridden on command line.
The scsiboot command normally clears the symbol table, exception handlers, and all breakpoints. The -s and -b options suppress the clearing of the symbol table and breakpoints, respectively. The value of the PC register is set automatically to the entry point of the program. Therefore, to execute the downloaded program, only the g command is required.
The scsiboot command may return a large number of different error messages, relating to disk problems or file access permissions on the local machine.
When reading the symbol table PMON/2000 may complain that it does not have enough room to store the program’s symbols. To increase the size of the heap, use the set heaptop command to reserve more space and, if necessary, relink your program with a higher base address. The scsiboot command will also detect cases where the program being loaded would overwrite PMON’s crucial data or heap: again relinking your program at a different address will cure the problem.
While it is loading each section of the file, scsiboot displays the memory address (in hex) and size (in decimal) of that section. Typically these sections will be in the order .text, .data and .bss.
Navigation: Document Home | Document Contents | Document Index