NAME

installboot − install bootblocks in a disk partition

SPARC SYNOPSIS

installboot bootblk raw-disk-device

x86 SYNOPSIS

installboot pboot bootblk raw-disk-device

PowerPC Edition SYNOPSIS

installboot [ −f openfirmware] bootblk raw-disk-device

AVAILABILITY

SUNWcsu

DESCRIPTION

The boot(1M) program is loaded from disk by the bootblock program which resides in the boot area of a disk partition. 

The ufs boot objects are platform-dependent, and reside in the /usr/platform/platform-name/lib/fs/ufs directory.  The platform name can be found using the −i option of uname(1). 

PowerPC Edition DESCRIPTION

bootblk is copied into the primary DOS partition that must exist on the raw-disk-device which is determined by reading the fdisk partition table (sector 0 of the "p0" partition of raw-disk-device). The primary DOS partition is mounted as a PCFS file system,  and bootblk is copied into the partition as the file SOLARIS.ELF.  If the −f openfirmware argument is specified, the openfirmware file is copied into the PowerPC boot partition (type 0x41).  This is needed only for systems that do not have real Open Firmware.  If this argument is provided and the PowerPC boot partition does not exist or if the primary DOS partition does not exist, installboot fails. 

OPERANDS

bootblk The name of the bootblock code. 

raw-disk-device The name of the disk device onto which the bootblock code is to be installed; it must be a character device which is readable and writable.  Naming conventions for a SCSI or IPI drive are c?t?d?s? and c?d?s? for an IDE drive. 

pboot The name of the partition boot file. 

SPARC EXAMPLES

To install a ufs bootblock on slice 0 of target 0 on controller 1 of the platform where the command is being run, use:

example# installboot /usr/platform/‘uname −i‘/lib/fs/ufs/bootblk \
/dev/rdsk/c1t0d0s0

x86 EXAMPLES

To install the ufs bootblock and partition boot program on slice 2 of target 0 on controller 1 of the platform where the command is being run, use:

example# installboot /usr/platform/‘uname −i‘/lib/fs/ufs/pboot \
/usr/platform/‘uname −i‘/lib/fs/ufs/bootblk /dev/rdsk/c1t0d0s2

PowerPC Edition EXAMPLES

To install the ufs bootblock and openfirmware program on target 0 on controller 1 of the platform where the command is being run, use:

example# installboot -f /platform/‘uname −i‘/openfirmware.x41 \
/usr/platform/‘uname −i‘/lib/fs/ufs/bootblk /dev/rdsk/c1t0d0s2

FILES

/usr/platform/platform-name/lib/fs/ufs
Directory where ufs boot objects reside. 

SEE ALSO

od(1), uname(1), boot(1M), init(1M), kadb(1M), kernel(1M), reboot(1M), rpc.bootparamd(1M), init.d(4)

SPARC: Installing Solaris Software
x86: Installing Solaris Software
Solaris PowerPC Edition: Installing Solaris Software

SPARC only

monitor(1M)

x86 and PowerPC Edition

fdisk(1M), fmthard(1M)

WARNINGS

installboot will fail if the bootblk, pboot or openfirmware files do not exist or if the raw disk device is not a character device. 

SunOS 5.5.1  —  Last change: 2 Nov 1995