SYSTEM(4)                                               SYSTEM(4)



     NAME
          system - system configuration information table

     DESCRIPTION
          This file is used by the lboot program to obtain
          configuration information.  This file generally contains
          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 swapdev, 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 /usr/sysgen/system file is case sensitive.  All
          upper case strings in the syntax below should be upper case
          in the /usr/sysgen/system 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 specified, 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 directory /usr/sysgen/boot , it is used as the
               interrupt routine.  If the quadruplet (vector, ipl,
               unit, base) is specified, a VME interrupt structure is
               assigned, using the corresponding VME address "vector",
               priority level "ipl", unit "unit", and accessing the



     Page 1                                        (last mod. 8/20/87)

     SYSTEM(4)                                               SYSTEM(4)



               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 /usr/sysgen/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.
          PIPEDEV:  <device>
               identifies the device to be used for pipe space.
          DUMPDEV:  <device>
               identifies the device to be used for kernel dumps.
          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 /usr/sysgen/boot.
          KERNEL: [ <string> ] ...
               Specifies the module containing the heart of the
               operating system.  It must be present in the system
               file.
          LCOPTS
          LDOPTS
               are option strings given to cc(1) and ld(1)
               respectively, to compile the master.c file and link the
               operating system.
     FILES
          /usr/sysgen/system

     SEE ALSO
          master(4).
          lboot(1M)
     ORIGIN
          AT&T V.3











     Page 2                                        (last mod. 8/20/87)