sysinfo.cf - Configuration File for MagniComp(tm) SysInfo


SYNOPSIS

       ConfDir PathName

       Define | Type | StringKey | NumericKey | Value1 | Value 2

       Device  |  Name  |  Type/[SubType]  |  NumericID | Model |
       Description | Flags | DevFiles

       Include FileName


DESCRIPTION

       sysinfo.cf files are parsed by the  MagniComp(tm)  SysInfo
       program.   Text  starting with ``#'' and continuing to the
       end of the line is ignored.  Each line starts with a  spe-
       cific  keyword as described below.  All leading and trail-
       ing white space (space and TAB characters) for each  field
       is removed before parsing.  All keywords are case insensi-
       tive.  The valid keywords are:

       ConfDir PathName
              Set the name of the directory to look for  configu-
              ration files in to be PathName.  This also sets the
              value of the ${ConfDir} variable available for  use
              with the Include keyword.  The default is /opt/sys-
              info/config

       Define fields
              Definetion.  Each field is  seperated  by  a  ``|''
              character.   Any  fields that are not specified are
              initialized to NULL.  The StringKey  and/or  Numer-
              icKey  fields are used in matching search criteria.
              The specification for each field follows:

              Type   Specify the definetion type.  The  following
                     Type values are allowed:

                     CPU,  Category, KArch, Kernel, NetType, OBP,
                     Part, SysConf, SysModel, TapeInfo, VPD


              StringKey
                     A string to use as a key.

              NumericKey
                     A numeric value to use as a key.

              Value1 A string to return for the entry.

              Value2 A string to return for the entry.

              Device specification.  Each field is seperated by a
              ``|'' character.  Any fields that are not specified
              are initialized to  NULL.   The  specification  for
              each field follows:

              Name   The name of the device.  ( e.g.  sd, cgsix )

              Type/[SubType]
                     The type of device.  The Type value is  used
                     to  determine  how  to  probe the device and
                     what device type label to assign to it.   If
                     SubType  is  specified,  then the Type field
                     specifies how to probe the  device  and  the
                     SubType  field  specifies  what  device type
                     label to assign.  The valid keywords are:

                     Bus,   CDROM,   CPU,    Device,    DiskCtlr,
                     DiskDrive,  FrameBuffer,  Generic, KeyBoard,
                     Memory, NetIF, Pseudo, TapeCtlr, TapeDrive


              NumericID
                     Specifies a unique numeric identifier for  a
                     particuliar device type.  This field is typ-
                     ically used to find a device  by  a  numeric
                     value returned from the kernel.

              Model  The device's model.

              Description
                     A description of the device.

              Flags  The  Flags  field may contain either a valid
                     keyword or a numeric value.  Numeric  values
                     are used in a device-type specific manner by
                     the device type's probe routine.  The  valid
                     keywords are:

                     DefInfo
                             Use default device definetion infor-
                             mation.   Usage  varies  by   device
                             type.

                      LenCmp Compare device name by length.

                      NoUnit Don't  add  a  unit  number  to  the
                             device's name.

                      Zombie If the device is present,  treat  it
                             as  if  it  were alive regardless of
                             whether the kernel has indicated so.

                     A  list of space seperated device files that
                     provide access to the device.  Each file may
                     contain  a `%d' which will be expanded to be
                     the device's unit number.

       Include FileName
              Read and parse a sysinfo.cf file  called  FileName.
              Parsing  of  the  current  file resumes on the next
              line when finished with FileName.  If FileName does
              not exist, MagniComp(tm) SysInfo will silently con-
              tinue parsing the current file.  FileName may  con-
              tain variables that are expanded at runtime.  Vari-
              able names are enclosed inside of ${}  or  $()  and
              are  case insensitive.  The following variables are
              available:

              ${ConfDir}
                     The path to the MagniComp(tm)  SysInfo  con-
                     figuration directory.

              ${DefConfFile}
                     The  name of the default sysinfo.cf configu-
                     ration file.  ( e.g.  Default.cf )

              ${OSname}
                     The name of the operating  system.   (  e.g.
                     SunOS )

              ${OSver}
                     The operating system version number.  ( e.g.
                     4.1.3 )

              ${OSmajver}
                     The operating system major  version  number.
                     ( e.g. for 4.1.3 the value would be 4 )


AUTHOR

       Michael A. Cooper
       MagniComp
       www.MagniComp.com


HOME PAGE

       http://www.magnicomp.com/sysinfo


SEE ALSO

       sysinfo(1) mcsysinfo(3)


DIAGNOSTICS


BUGS