OS9GEN
Build and Link a Bootstrap File
os9gen
device name
Description
OS9Gen is used to create and link the OS9Boot file required on any
disk from which OS-9 is to be bootstrapped. OS9Gen is used to add
modules to an existing boot or to create an entirely new boot file.
If an exact copy of the existing OS9Boot file is desired, the
cobbler command should be used instead.
The name of the device on which the OS9Boot file is to be
installed is passed to OS9Gen as a command line parameter. OS9Gen then
creates a working file called TempBoot on the device specified.
Next it reads file names (pathlists) from its standard input, one
pathlist per line. Every file named is opened and copied to
TempBoot. This is repeated until end-of-file or a blank line is
reached on OS9Gen's standard input. All boot files must contain the
OS-9 component modules listed in section .
After all input files have been copied to TempBoot, the old
OS9Boot file, if present, is deleted. TempBoot is then renamed
to OS9Boot, and its starting address and size is linked in the
disk's Identification Sector (LSN 0) for use by the OS-9 bootstrap
firmware.
WARNING: Any OS9Boot file must be stored in physically contiguous
sectors. Therefore, OS9Gen is normally used on a freshly formatted
disk. If the OS9Boot file is fragmented, OS9Gen will print a
warning message indicated the disk cannot be used to bootstrap OS-9.
The list of file names given to OS9Gen can be entered from a keyboard, or
OS9Gen's standard input may be redirected to a text file
containing a list of file names (pathlists) . If names are entered
manually, no prompts are given, and the end-of-file key (usually
ESCAPE) or a blank line is entered after the line containing the
last pathlist.
For more information see: ,
,
Examples
To manually install a boot file on device "d1" which is an exact
copy of the OS9Boot file on device "d0":
OS9: os9gen /d1 (run OS9Gen)
/d0/os9boot (enter file to be installed)
[ESCAPE] (enter end-of-file)
To manually install a boot file on device "d1" which is a copy of
the OS9Boot file on device "d0" with the addition of
modules stored in the files /d0/tape.driver and /d2/video.driver:
OS9: os9gen /d1 (run OS9Gen)
/d0/os9boot (enter main boot file name)
/d0/tape.driver (enter name of first file to be added)
/d2/video.driver (enter name of second file to be added)
[ESCAPE] (enter end-of-file)
As above, but automatically by redirecting OS9Gen standard input:
OS9: build /d0/bootlist (use build to create file bootlist)
? /d0/os9boot (enter first file name)
? /d0/tape.driver (enter second file name)
? /d2/video.driver (enter third file name)
? [RETURN] (terminate build)
OS9: os9gen /d1 </d0/bootlist (run OS9gen with redirected input)