NAME
mk_kernel — build a boot-able HP-UX kernel.
SYNOPSIS
/usr/sbin/mk_kernel
[-v]
[-o
file]
[-s
file]
DESCRIPTION
mk_kernel
builds an executable file which can be used as a boot-able
kernel. If the build succeeds, the newly built binary will be a file
named
vmunix_test
located in the build directory, as defined below.
The build directory is a directory where
mk_kernel
places files created by its processes. Other files that are created by the
invocation of
mk_kernel,
such as
conf.c
and
conf.o
are left in the build directory. The build directory is
/stand/build
if the system file used is
/stand/system,
either by default or by designation. If another path is used to
designate the system file, the build directory
will be the present working directory.
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.
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.
- -v
Verbose mode. More verbose messages are sent to stdout if errors
are encountered.
- -o file
Specify the target file path. The resultant kernel file will
be moved from
vmunix_test
in the build directory to the path specified
by the option argument. If the path is
/stand/vmunix,
and if a file already exists at that location, it will be moved to
/stand/vmunix.prev.
An error encountered in moving the file will
result in the newly built kernel being left in the build directory.
- -s file
Specify the kernel template file. If this option is not
specified, the system file
/stand/system,
is used.
RETURN VALUES
mk_kernel
returns 0 upon normal completion, and 1 if an error occurred.
EXAMPLES
mk_kernel -o /stand/vmunix
Uses the file
/stand/system
to build a new kernel which will be
placed in
/stand/vmunix
upon success.
mk_kernel -s /mnt/altsys/stand/system.new
Uses the file
/mnt/altsys/stand/system.new
to build a new kernel which will remain in file
vmunix_test
in the present working directory.
mk_kernel -s /stand/system -o /tmp/new_kernel
Uses the file
/stand/system
to build a new kernel which will be placed in
/tmp/new_kernel
upon success.
DIAGNOSTICS
Messages and warnings are sent to stdout. Diagnostic messages from
mk_kernel
are self explanatory. Messages from
config
and other commands are not suppressed. Errors cause
mk_kernel
to halt immediately; warnings allow the program to continue.
AUTHOR
mk_kernel
was developed by the Hewlett-Packard Company.
Printable version
