HP-UX Reference (11i v1 00/12) - 1M System Administration Commands A-M (vol 3)
__________________________________________________________________________________________________________________________________________________________________________________________________
__________________________________________________________________________________________________________________________________________________________________________________________________
STANDARD Printed by: Nora Chuang [nchuang] STANDARD
/build/1111/BRICK/man1m/!!!intro.1m
________________________________________________________________
___ ___
m
mk_kernel(1M) mk_kernel(1M)
NAME
mk_kernel - build a bootable HP-UX kernel and/or kernel modules
SYNOPSIS
usr/sbin/mk_kernel [-o pathname][-s system_file][-S][-v]
/usr/sbin/mk_kernel -M module_name [[-M module_name]...] [-v]
DESCRIPTION
mk_kernel builds an executable file which can be used as a bootable kernel and kernel modules if any are
configured. If the build succeeds, the newly built kernel is called vmunix_test , and the kernel function
set directory (where the function set directory is the directory structure containing the set of modules that
correspond to the kernel) is called dlkm.vmunix_test. The file and directory are placed in the build
directory, as defined below.
The build directory is the target directory where mk_kernel places files and directories. In addition to
the kernel and kernel modules, files such as conf.c, conf.o, and tune.h are also placed in the build
directory.
If the path used to designate the system file is
/stand/system, the build directory is
/stand/build .
If another path is used to designate the system file, the build directory is the current working directory.
System files for the kernel modules are expected to be found in
/stand/system.d
. Libraries for the
kernel are expected to be found in
/usr/conf/lib
. The master file used is the composite of files found
under
/usr/conf/master.d
.
If the
-o option is not specified, the kernel file and kernel function set directory remain in the working
directory. If -o /stand/vmunix
is specified, the target kernel file and kernel function set directory are
not overwritten. The new kernel file and the kernel function set directory are moved to the default path as
the system shuts down or starts up. The previous versions of the file and directory are renamed to
/stand/vmunix.prev
and /stand/dlkm.vmunix.prev. Until the system reboots, the new ker-
nel file and the directory must be kept as
vmunix_test and dlkm.vmunix_test
, respectively.
If the
-o option is specified with other than /stand/vmunix
, the kernel file and kernel function set
directory is created or updated immediately. In case the administrator needs to place these targets to the
system default path, the
kmupdate command must be used to trigger the replacement. Manually replac-
ing the default kernel (/stand/vmunix
) or any file under the kernel function set directory
(
/stand/dlkm ) must be avoided.
mk_kernel exits with no action if the environment variable SW_INITIAL_INSTALL
has the value of 1.
SW_INITIAL_INSTALL
is exported by SD with that value only when the system is undergoing its initial
software system installation.
Options
mk_kernel recognizes the following options.
-M module_name
Specify the module to configure. No kernel image will be generated. For details see config(1M).
-o pathname
Specify the target file path. The created kernel file, vmunix_test , is moved from the build
directory to the path specified by the option argument. The associated kernel function set direc-
tory, dlkm.vmunix_test
, is moved to the same destination directory.
If the default kernel,
/stand/vmunix,
is specified or the -o option is not specified, the
created kernel file does not replace
/stand/vmunix
and remains as vmunix_test.
The kernel file and associated kernel function set directory are automatically moved to
/stand/vmunix and /stand/dlkm during either shutdown or startup.
-s system_file
Specify the kernel template file. If this option is not specified, the system file /stand/system
is used.
-S Specify that all configured kernel modules are to be statically linked into the kernel. For details
see config(1M).
-v Verbose mode.
Section 1M−−486 − 1 − HP-UX Release 11i: December 2000
___
___