system(4)                                                         system(4)


   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>) | NODEV
          <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.




   8/91                                                                 Page 1

   system(4)                                                         system(4)


         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.

         SWAPDEV:  <fname> <number> <number>
               Identifies the device to be used as swap space.  The <fname> 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 (swplo) and the number of swap blocks available
               (nswap).  If nswap is zero, the kernel will automatically
               determine this quantity from the size of the device or file.

         ICDDEV: <fname>  (UNIX System V/88 only)
               Specifies the regular special file containing an s5 file system
               image to be used for the In-Core Disk by the new operating
               system.  cunix(1M) will call icdpatch(1M) to open and read the
               file if this field has a valid file name, <fname>.

   FILES
         /stand/system

   SEE ALSO
         crash(1M), cunix(1M), mkboot(1M) and icdpatch in the Administrator's
         Reference Manual.
         master(4).





















   Page 2                                                                 8/91