SYSTEM(4-SVR4)      RISC/os Reference Manual       SYSTEM(4-SVR4)



NAME
     system - system configuration information table

DESCRIPTION
     This file is used by the lboot(1M) or mboot program to
     obtain configuration information.  This file generally con-
     tains information used to determine if specified hardware
     exists, a list of software drivers to include in the load,
     the assignment of system devices such as pipedev and swap-
     dev, as well as instructions for manually overriding the
     drivers selected by the self-configuring boot process.

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

          <fname>  ::= master file name from /master.d directory
          <func> ::= interrupt function 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 VECTOR, EXCLUDE and INCLUDE are
     cumulative.  For all other entries, the last line to appear
     in the file is used -- any earlier entries are ignored.

     VECTOR: (Note: this is one line)  module=<fname> [ intr=<func> ]
     [ vector=<number> ipl=<number> unit=<number> base=<number> ]
     [ probe=<number> [ probe_size=<number> ] ]
               specifies hardware to conditionally load.  If a
               probe address is specified, the boot program will
               read probe_size bytes (default 4) to determine if
               the hardware exists for the module.  If so, the
               module is included.  If a probe address is not
               specified, the hardware will be assumed to exist.
               The intr function specifies the name of the
               module's interrupt handler.  If it is not speci-
               fied, the prefix defined in the module's master
               file (see master(4)) is concatenated with the
               string "intr", and, if a routine with that name is
               found in the module's object (which resides in the
               boot directory, typically
               $ROOT/usr/src/uts/mips/bootarea), it is used as
               the interrupt routine.  If the quadruplet (vector,
               ipl, unit, base) is specified, a VME interrupt



                        Printed 11/19/92                   Page 1

SYSTEM(4-SVR4)      RISC/os Reference Manual       SYSTEM(4-SVR4)



               structure is assigned, using the corresponding VME
               address "vector", priority level "ipl", unit
               "unit", and accessing the device beginning at
               memory location "base".

     EXCLUDE: [ <string> ] ...
               specifies drivers to exclude from the load even if
               the device is found via VECTOR information.

     INCLUDE: [ <string>[(<number>)]  ] ...
               specifies software drivers or loadable modules to
               be included in the load.  This is necessary to
               include the drivers for software "devices".  The
               optional <number> (parenthesis 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 two of the master file.

     ROOTDEV: <device>
               identifies the device containing the root file
               system.

     SWAPDEV: <device> <number> <number>
               identifies the device to be used as swap space,
               the block number the swap space starts at, and the
               number of swap blocks available.  Absence of this
               parameter will cause the default swap space to be
               placed at the root partition plus one, which gen-
               erally is the next immediate partition and the
               start and size will be set to contain the entire
               partition.

     PIPEDEV:  <device>
               identifies the device to be used for pipe space.

     DUMPDEV:  <device>
               identifies the device to be used for kernel dumps.
               Absence of this parameter will cause the default
               dump device to be placed in the same partition as
               the swap space.

     USE: [ <string>[(<number>)]  ] ...
               If the driver is present, it is the same as
               INCLUDE.  Behaves like EXCLUDE if the module or
               driver is not present in boot directory, typically
               $ROOT/usr/src/uts/mips/bootarea.

     KERNEL: [ <string> ] ...
               specifies the module containing the heart of the
               operating system.  It must be present in the sys-
               tem file.



 Page 2                 Printed 11/19/92

SYSTEM(4-SVR4)      RISC/os Reference Manual       SYSTEM(4-SVR4)



     LCOPTS
     LDOPTS    option strings given to cc(1) and ld(1) respec-
               tively, to compile the master.c file and link the
               operating system.

FILES
     $ROOT/usr/src/uts/mips/master.d/system[.suffix]


SEE ALSO
     master(4) lboot(1M) in the System Administrator's Reference
     Manual.











































                        Printed 11/19/92                   Page 3