OSF

NAME

sysconfigtab − Subsystem definition data base file

SYNOPSIS

/etc/sysconfigtab

DESCRIPTION

The sysconfigtab file contains information about the subsystems that can be dynamically configured.  The file consists of stanza formatted entries that include fields to describe each subsystem.  One field is specified per line.  Refer to stanza(4) for information on the field format.  Each stanza entry is separated by blank lines. 

The first field (line) for an entry specifies the subsystem name; subsequent fields specify the entry’s attributes and values.  The subsystem name field specifies the subsystem that is used with the sysconfig command. 

The sysconfigtab file contains two entries that specify the subsystems that you want to load automatically during system reboot.  The automatic list specifies the subsystems that must be loaded during an early phase of system startup.  The multiuser list specifies the subsystems that must be loaded during a final phase of system startup.  Refer to the sysconfigdb(8) command for information about administering the startup lists. 

Generic Fields

The configuration manager uses the following generic subsystem fields to handle configuration requests:

Subsystem_Description
Specifies a short literal string used as a description. This is an optional field.

Method_Name
Specifies the unique logical name of the configuration method associated with the subsystem. This field is required.

Method_Path
Specifies the file path name for the configuration method object module. For a static configuration method, specify None.  For a dynamic configuration method, specify the location of the loadable module.  This field is required if you specify Dynamic in the Method_Type field. 

Method_Flags
Specifies the loader flags for the configuration method. This field is optional.

Method_Type
Specifies either the Static or Dynamic method.  If you specify Static, the method is statically configured into the cfgmgr daemon.  If you specify Dynamic, the method is dynamically loaded into the cfgmgr daemon.  This field is required.

Module_Type
Specifies the type of subsystem.  If you specify Static, the subsystem is statically configured into the kernel.  This enables statically configured subsystems to be included in the global stanza database.  If you specify Dynamic, the subsystem is a loadable module.  You should specify Dynamic for loadable drivers.  This field is required.

Module_Path
Specifies the full pathname where a loadable subsystem is located. This field is required if you specify Dynamic in the Module_Path field. 

Driver-Specific Fields

The following fields are only for driver subsystems:

Module_Config_Name
Specifies the driver name. This field is used to identify configuration information about a specific driver and is required only if you specify the Module_Config field. 

Device_DirSpecifies the directory where the device special files will be located.  This field is optional.

Device_Subdir
Specifies a Device_Dir subdirectory where the device special files for character and block drivers will be located unless you specify the Device_Char_Subdir or Device_Block_Subdir field.  The Device_Subdir field is used if you want to locate the device special files for both character and block drivers in a single directory.  This field is optional.

Device_Major_Req
Specifies the requirements that relate to major number assignment. Specify Same if the driver needs the same major number in the block and character device switch tables.  The driver load will fail if the major number is not available in both the block and character device switch tables.  If you specify Same, the value of the Device_Char_Major and Device_Block_Major fields must be the same; if they are not the same, the driver load will fail.  This field is optional.

Device_Char_Major
Specifies the character major number for the driver. Specify Any to assign the next available major number.  Specify a number value (for example, 24) to assign that value if it is not being used.  This field is optional.

Device_Char_Minor
Specifies the minor numbers that are used to create the device special files for the driver.  You can specify more than one minor number by separating them with commas or by indicating a range of numbers.  Each minor number must be paired with a file name specified in the Device_Char_Files field.  This field is optional.

Device_Char_Files
Specifies the device special files to be created.  You can specify more than one file name by separating them with commas or by indicating a range of files.  Each file name must be paired with a minor number specified in the Device_Char_Minor field.  If a driver is also a block driver, you must specify both Device_Char_Files and Device_Block_Files fields.  This field is optional.

Device_Char_Subdir
Specifies a Device_Dir subdirectory that will contain the character special files.  If you specify the Device_Char_Subdir field, the Device_Subdir field is ignored.  This field is optional.

Device_Block_Major
Specifies the block major number for the driver. Specify Any to assign the next available major number.  Specify a number value (for example, 24) to assign that value if it is not being used.  This field is optional.

Device_Block_Minor
Specifies the minor numbers that are used to create the device special files for the driver.  You can specify more than one minor number by separating them with commas or by indicating a range of numbers.  Each minor number must be paired with a file name specified in the Device_Block_Files field.  This field is optional.

Device_Block_Files
Specifies the device special files to be created.  You can specify more than one file name by separating them with commas or by indicating a range of files.  Each file name must be paired with a minor number specified in the Device_Block_Minor field.  If a driver is also a character driver, you must specify both Device_Char_Files and Device_Block_Files fields.  This field is optional.

Device_Block_Subdir
Specifies a Device_Dir subdirectory that will contain the block special files.  If you specify the Device_Block_Subdir field, the Device_Subdir field is ignored.  This field is optional.

Device_User
Specifies the user name that will own the device special files. This field is optional.

Device_Group
Specifies the group to which the device special files will belong. This field is optional.

Device_Mode
Specifies the protection mode for the device special files. This field is optional.

Module_Confign
Specifies n as a number value in the range of 0 to 499 (for example, Module_Config2).  This field is optional.

To specify a range of number values for the Device_Char_Minor and Device_Block_Minor fields, use the following syntax: [x-y]

The x and y variables specify positive integer values.  You cannot specify a value greater than 99999.  Also, the value for y must be greater than the value for x.  All integers within the range are used.  A maximum of 512 device special files can be created for a device major number unless a driver is both a character and a block device, which would allow a maximum of 1024 device special files (512 for the character driver and 512 for the block driver).  The following is an example of a valid range:

Device_Char_Minor = [1-10]

Use commas to separate more than one range, for example:

Device_Char_Minor = [1-10],[21-30]

To specify a range of letter values for the Device_Char_Files and Device_Block_Files fields, use the following syntax: [b-e]

The b and e variables specify single letters that are either both upper case or both lower case.  The letter specified by b must come before the letter specified by e.  The following is an example of a valid letter range:

Device_Block_Files = rz1[a-z]

Use commas to separate more than one range, for example:

Device_Block_Files = rz1[a-h],rz2[i-t]

Each integer value in the Device_Char_Minor and Device_Block_Minor fields must have a corresponding letter value in the Device_Char_Files and Device_Block_Files fields.  If you do not specify the same number of letter and integer values, no device special files are created.  The following shows the specification for a range of 8 integers and 8 files:

Device_Block_Minor = [0-7]
Device_Block_Files = foo[a-h]

RESTRICTIONS

The maximum length of a stanza entry is 40960 bytes.  An entry cannot contain more than 2048 fields (lines). 

The maximum length of a stanza field is 500 bytes. 

RELATED INFORMATION

Commands:  sysconfig(8), sysconfigdb(8), cfgmgr(8)

Files:  stanza(4)