NAME
mk_kernel — load a kernel configuration from a system file
SYNOPSIS
/usr/sbin/mk_kernel
[-o
path_name]
[-s
system_file]
[-v]
DESCRIPTION
mk_kernel
reads configuration information from the system file (see
system(4))
and applies those changes to a kernel configuration (see
kconfig(5)).
mk_kernel
performs a function similar to that of
kconfig -i,
but has some semantic differences in order to preserve compatibility
with previous releases.
mk_kernel
will build a new kernel executable only if needed to effect the
requested changes.
mk_kernel
may reuse existing kernel executables when possible.
Options
mk_kernel
recognizes the following options.
- -o path_name
Specify the target kernel path.
If the target kernel path specified is
/stand/vmunix,
changes are applied to the currently running kernel configuration.
They will take effect immediately if possible; otherwise, they will
take effect at next boot.
If the target kernel path specified is of the form
/stand/config/vmunix,
changes are applied to the saved kernel configuration named
config.
The changes will not take effect at next boot unless that saved kernel
configuration was already marked for use at next boot.
If the target kernel name is a single word containing no slashes, that
name is used as the name of a saved kernel configuration. The changes
are applied to that saved kernel configuration. The changes will not
take effect at next boot unless that saved kernel configuration was
already marked for use at next boot.
If the target kernel path is not one of the forms specified above,
then
mk_kernel
exits with an error. Other locations for kernel executable files are
no longer supported.
If the
-o
option is not specified, the changes are applied to the kernel
configuration called
hpux_test.
The changes will not take effect at next boot unless that kernel
configuration was already marked for use at next boot.
- -s system_file
Specify the HP-UX system description file.
If this option is not specified, the system file
/stand/system
is used. For details see
system(4).
- -v
Verbose mode. (Has no effect; retained for backward compatibility.)
RETURN VALUE
mk_kernel
returns 0 upon normal completion; it returns 1 if an error occurred.
DIAGNOSTICS
Messages and warnings are sent to
stderr.
Messages from
kconfig
and other commands are displayed when invoked from
mk_kernel.
Errors cause
mk_kernel
to halt immediately; warnings allow the program to continue.
EXAMPLES
- mk_kernel -o /stand/vmunix
Uses the default HP-UX system description file
/stand/system.
The changes are applied to the currently running kernel configuration,
marked to take effect at next boot.
- mk_kernel -s /mnt/altsys/stand/system.new
Uses the system description file
/mnt/altsys/stand/system.new.
- mk_kernel -s /stand/system -o fred
Uses the system description file
/stand/system
The changes are applied to the saved kernel configuration called
fred.
WARNINGS
Do not manually modify the contents of the kernel configuration directories.
FILES
- /stand/system
Default HP-UX system description file