HP-UX Reference (11i v1 05/09) - 4 File Formats (vol 8)

m
master(4) master(4)
NAME
master - master kernel configuration information
DESCRIPTION
A master file contains sections of information in a form suitable for
config, enabling it to create a kernel
configuration file. Master files are found in the directory
/usr/conf/master.d
.
Master files are of two types:
• A kernel master file is of the type which usually carries information on several drivers/subsystems.
• A kernel module master file carries information on an individual module. Such master files are
named after the module to which they belong and are installed onto a system via
kminstall.
Each section of a master file begins with a line containing a
$ in column one followed by a section keyword.
The section continues to the end of the file or until a line containing only three
$ characters is encountered.
Lines beginning with an asterisk (
*
) are comments.
Kernel Master File
The following table lists the section keywords for the kernel master file and their purpose. Note that some
of the section keywords may also be used for the kernel module master file described later:
Section keyword Section purpose
$DEVICE Device driver specification
$CDIO Context Dependent I/O table
$DRIVER_INSTALL List of drivers with installation functions
$DYN_MAJOR Dynamic block and character major numbers
$ALIAS Driver alias table
$TUNABLE Tunable parameters
$DRIVER_DEPENDENCY
Driver-to-driver dependency table
$DRIVER_LIBRARY Library location of driver table
$LIBRARY Required/optional library table
$SUBSYSTEMS_DEFINE
Subsystems requiring #defines
$STREAMS_SYNC_LEVEL
STREAMS synchronization level table
$STREAMS_DVR_SYNC
STREAMS driver and module synchronization table
Each section consists of text fields separated by space and tab characters and is described separately below.
Bit mask fields are expressed as hexadecimal values which are constructed by computing the logical OR of
the component bit values.
$DEVICE Section
NOTE: This section is provided for compatibility with previous HP-UX releases. New drivers should be
added to the
$DRIVER_INSTALL
section.
Software drivers are defined using five fields defined as follows:
Field_1 Device name, used in the user-specified system_file (8 characters maximum).
Field_2 Handler name, used by the kernel to prefix routines such as
lp_write and others (8 charac-
ters maximum).
Field_3 Driver characteristics, which are specified by computing the logical OR using the hexadecimal bit
mask value of the following seven bits.
0x40 STREAMS module
0x20 STREAMS driver
0x10 I/O card or pseudo driver
0x08 Allow only one specification of driver
0x04 Required device (included in all systems)
0x02 Block device
0x01 Character device
Field_4 Functions for the device, specified by creating a bit mask using the following bits:
0x100000 Turn off map buffer to kernel flag (C_MAP_BUFFER_TO_KERNEL)
0x010000 Set driver is multiprocessor capable flag (C_MGR_IS_MP )
0x008000 Set STREAMS clone major device flag (C_CLONESMAJOR)
HP-UX 11i Version 1: September 2005 − 1 − Hewlett-Packard Company Section 4−−167