HP-UX Reference (11i v1 05/09) - 1M System Administration Commands A-M (vol 3)

c
config(1M) config(1M)
• a makefile (config.mk
) to compile the C program produced and relink the newly configured system
with statically linked kernel module object file (
vmunix_test ), and to generate kernel symbol table
(
symtab).
• another makefile (config.mod ) to generate all dynamically loadable modules to be configured.
• a directory (
dlkm.vmunix_test
) to store the generated dynamically loadable modules, kernel sym-
bol table, and module registry file associated with the kernel being built (
vmunix_test ). This direc-
tory here after will be referred to as the kernel function set directory. The files in this directory will be
referred to as the kernel function set files.
Many header files are needed to compile
conf.c. Also, archive library files containing the kernel objects
are needed to link the kernel. These files are supplied with the system and are contained in the directories
found under
/usr/conf.
config.mod and the module registry file are not generated if there are no dynamically loadable modules
being configured.
config executes the make command to compile
conf.c, to link the kernel with the appropriate kernel
libraries and statically linked modules, and to generate the kernel symbol table. It also executes the
make
command with config.mod to compile dynamically loadable modules.
The make command create several files in a working directory whose location depends on the name of the
system file. If system_file is /stand/system
, the working directory is /stand/build ; otherwise the
working directory is the current directory. With successful completion of the
make command, the follow-
ing files are generated:
• kernel file
The kernel file vmunix_test is generated in the working directory.
• kernel function set directory
The kernel function set directory (dlkm.vmunix_test
) is created in the working directory.
• kernel symbol table
The kernel symbol table
symtab is generated in the kernel function set directory.
• dynamically loadable modules
Dynamically loadable modules are generated under a subdirectory (mod.d) of the kernel function set
directory.
If the -u option is specified, the newly generated kernel file and its kernel function set directory are
automatically copied to their default locations,
/stand/vmunix and /stand/dlkm , respectively, on
system shutdown or restart. The previous kernel file and its kernel function set directory will be saved as
/stand/vmunix.prev
and /stand/dlkm.vmunix.prev, respectively.
Options for Whole Kernel Configuration
When configuring a whole kernel, the
config command recognizes the following arguments:
-c c_file
Specify the name of the C program source file produced by config. The default file name is
conf.c.
-l m_file
Specify the name of the makefile which is generated by config. This is the makefile which will be
used by config to compile the C program source file and make the new kernel. The default file
name is config.mk.
-m master
Specify the name of the master kernel configuration information file or directory that config should
use in creating source files and makefiles. If master is a directory, config reads all files in that
directory to create its data structures. If master is a file, only that file is read for creating data struc-
tures for config. By default, config reads the files in the directory /usr/conf/master.d.
/usr/conf/master.d is supplied as part of the HP-UX operating system and should not be
modified by anyone who does not fully understand its structure and purpose.
-r path
Search the directory path for the libraries and header files needed for making the kernel. By default,
config uses the directory /usr/conf.
HP-UX 11i Version 1: September 2005 − 2 − Hewlett-Packard Company Section 1M−−139