Museum

Home

Lab Overview

Retrotechnology Articles

⇒ Online Manual

Media Vault

Software Library

Restoration Projects

Artifacts Sought

Related Articles

crash(1M)

cunix(1M)

mkboot(1M)

master(4)

system(4)  —  FILE FORMATS

NAME

system − system configuration information file

DESCRIPTION

The system file is used during the configuration of a new operating system to obtain configuration information that cannot be obtained from the Equipped Device Table (EDT).  The system file is /stand/system. 

The system file generally contains a list of software drivers to include in the new bootable operating system, the assignment of system devices such as swapdev and rootdev, and instructions for excluding drivers from the configuration process. 

The parser for the system file is case-sensitive.  All upper case strings in the syntax below should be upper case in the system file as well.  Nonterminal symbols are enclosed in angle brackets <>, whereas optional arguments are enclosed in square brackets [].  Ellipses (. . .) indicate optional repetition of the argument for that line. 

The symbols in the syntax description below are interpreted as follows:

<fname> ::= pathname
<string> ::= driver file name from /boot or EDT entry name
<device> ::= special device name | DEV(<major>,<minor>)
<major> ::= <number>
<minor> ::= <number>
<number> ::= decimal, octal or hex literal

The lines listed below may appear in any order.  Blank lines may be inserted at any point.  Comment lines must begin with an asterisk.  Entries for EXCLUDE and INCLUDE are cumulative.  For all other entries, the last line to appear in the file is used—any earlier entries are ignored. 

BOOT: <fname>
Specifies the KERNEL object file to be used to build the bootable operating system; if <fname> is the keyword DEFAULT, the configuration program takes the KERNEL file from whatever boot directory it is using.  For example, if the user types cunix −b /my_boot_directory and the system file contains the DEFAULT keyword for the BOOT directive, then the KERNEL file used is /my_boot_directory/KERNEL.  If no −b option is used then cunix searches /boot by default; see cunix(1M). 

EXCLUDE: <string> . . .
Specifies drivers to exclude from the configuration even if the device is found in the EDT.

INCLUDE: <string>[(<number>)] . . .
Specifies software drivers or loadable modules to be included in the configuration. The optional <number> (parentheses required) specifies the number of devices to be controlled by the driver (defaults to 1).  This number corresponds to the builtin variable #C which may be referred to by expressions in part one of the master file. 

ROOTDEV: <device>
Identifies the device containing the root file system. The operating system automatically assigns the root device at boot time; this directive overrides the automatic assignment and should be used with caution.

SWAPDEV: <device> <number> <number>
This optional directive, if specified, identifies the device to be used for initial swap space. The <device> in this case may be a special device file name or a regular file.  The <number>s correspond to the block number the swap space starts at and the number of swap blocks available.  When this directive is not present, the operating system attempts to automatically determine the initial swap device. This is accomplished by using /dev/swap, if present, or the lowest numbered slice tagged SWAP on the boot disk. 

FILES

/stand/system

SEE ALSO

crash(1M), cunix(1M), mkboot(1M),
master(4)

Typewritten Software • bear@typewritten.org • Edmonds, WA 98026