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

m
mkboot(1M) mkboot(1M)
NAME
mkboot, rmboot - install, update or remove boot programs from disk
SYNOPSIS
/usr/sbin/mkboot
[-b boot_file_path][-c [
-u]| -f | -h | -u][-i included_lif_file]
[
-p preserved_lif_file][
-l | -H | -W
][-v] device
/usr/sbin/mkboot
[-a auto_file_string ][-v ] device
/usr/sbin/rmboot
device
DESCRIPTION
mkboot is used to install or update boot programs on the specified device file.
The position on device at which boot programs are installed depends on the disk layout of the device.
mkboot examines device to discover the current layout and uses this as the default. If the disk is unini-
tialized, the default is LVM layout. The default can be overridden by the
-l, -H,or-W options.
Boot programs are stored in the boot area in Logical Interchange Format (LIF), which is similar to a file
system. For a device to be bootable, the LIF volume on that device must contain at least the
ISL (the ini-
tial system loader) and
HPUX (the HP-UX bootstrap utility) LIF files. If, in addition, the device is an LVM
physical volume, the LABEL file must be present (see lvlnboot(1M) ).
Options
mkboot recognizes the following options:
-a auto_file_string If the
-a option is specified, mkboot creates an autoexecute file AUTO on
device, if none exists.
mkboot deposits auto_file_string in that file. If this
string contains spaces, it must be quoted so that it is a single parameter.
-b boot_file_path If this option is given, boot programs in the pathname specified by
boot_file_path are installed on the given device.
-c If this option is specified, mkboot checks if the available space on device is
sufficient for the boot programs. If the
-i option is also specified, mkboot
checks if each included_lif_file is present in the boot programs. If the
-p
option is specified, it checks if each preserved_lif_file is present on the dev-
ice. If all these checks succeed,
mkboot exits with a status code of 0. If any
of these checks fail, mkboot exits with a status code of 1. If the verbose
option is also selected, a message is also displayed on the standard output.
-f This option forces the information contained in the boot programs to be
placed on the specified device without regard to the current swapping status.
Its intended use is to allow the boot area to grow without having to boot the
system twice (see -h option).
This option should only be used when the system is in the single user state.
This could be a dangerous operation because swap space that is already allo-
cated and possibly in use will be overwritten by the new boot program infor-
mation. A message is also displayed to the standard output stating that the
operator should immediately reboot the system to avoid system corruption
and to reflect new information on the running system.
A safer method for reapportioning space is to use the -h option.
This option is valid only if device has the Whole Disk layout.
-h Specifying this option shrinks the available space allocated to swap in the
LIF header by the amount required to allow the installation of the new boot
programs specified by boot_file_path.
After the LIF header has been modified, reboot the system to reflect the new
swap space on the running system. At this point, the new boot programs
can be installed and the system rebooted again to reflect the new boot pro-
grams on the running system. This is the safe method for accomplishing the
capability of the -f option.
This option is valid only if device has the Whole Disk layout.
HP-UX 11i Version 1: September 2005 − 1 − Hewlett-Packard Company Section 1M−−479