NAME
mkbootimage
—
turn Alpha bootstrap programs into
bootable images
SYNOPSIS
/usr/mdec/mkbootimage |
[-nv ] infile
[outfile] |
DESCRIPTION
Themkbootimage
utility creates bootable image files
from NetBSD/alpha bootstrap programs. Bootable image
files can be placed directly on disk or tape to create bootable media which
can be booted by the SRM console. This is primarily useful for creating
bootable tapes or disk sets with the
/usr/mdec/ustarboot bootstrap program, or for creating
firmware upgrade media using firmware upgrade programs.
The bootstrap program infile is padded to a 512-byte boundary, has a properly formed Alpha Boot Block prepended, and is written to the output file outfile. If no output file is specified, the result is written to standard output.
The mkbootimage
utility does not install
bootstrap programs to make disks bootable. To do that, use
installboot(8). Similarly, it is not necessary to use
mkbootimage
to create images to boot over the
network; network-capable bootstrap programs are usable without
modification.
The options recognized by mkbootimage
are
as follows:
-n
- Do not actually write the result to the output file or standard output.
-v
- Print information about what
mkbootimage
is doing.
FILES
- /usr/mdec/ustarboot
- “ustar” file system bootstrap program
EXIT STATUS
The mkbootimage
utility exits 0 on
success, and >0 if an error occurs.
EXAMPLES
mkbootimage as200_v5_8.exe as200_v5_8.exe.bootimage
Create a bootable image from the (firmware image) file as200_v5_8.exe. That bootable image could then be written to floppy, disk, CD-ROM, or tape to create bootable firmware update media.
(mkbootimage /usr/mdec/ustarboot; tar cvf - netbsd) | \ dd of=/dev/rst0
Make a bootable image from the bootstrap program /usr/mdec/ustarboot, concatenate it with a tar file containing a kernel, and write the output to a tape. This is an example of how to create a tape which boots a kernel.
SEE ALSO
HISTORY
The NetBSD/alpha
mkbootimage
command first appeared in
NetBSD 1.4.
AUTHORS
The mkbootimage
utility was written by
Chris Demetriou.