diff options
Diffstat (limited to 'package/aboot/src/doc/man/swriteboot.8')
-rw-r--r-- | package/aboot/src/doc/man/swriteboot.8 | 58 |
1 files changed, 58 insertions, 0 deletions
diff --git a/package/aboot/src/doc/man/swriteboot.8 b/package/aboot/src/doc/man/swriteboot.8 new file mode 100644 index 000000000..485c0f4a7 --- /dev/null +++ b/package/aboot/src/doc/man/swriteboot.8 @@ -0,0 +1,58 @@ +.\" sdisklabel - Write secondary SRM bootloader to harddisk +.TH swriteboot 8 "17 January 1995" "David Mosberger" "" +.SH NAME +swriteboot \- Write secondary SRM bootloader to harddisk. +.SH SYNOPSIS +\fBswriteboot\fP [-v] [-f#] <dev> <bootloader> [kernel] +.SH DESCRIPTION + +\fBswriteboot\fP can be used to write a secondary bootstrap loader +and - optionally - a kernel to +a harddisk. The loader is written in a way that allows the SRM +firmware to boot from that disk (SRM is the firmware that is also used +to boot \fBHP Tru64\fP, \fBOpenVMS\fP and *BSD). +Specifically, the loader is written to occupy +a physically contiguous range of sectors starting at sector 2 and the +first sector is updated such that the SRM firmware can find the boot +loader. \fBswriteboot\fP may fail if the bootstrap loader is too big +to fit into the sectors reserved for boot purposes. It is therefore +suggested to reserve the first 512 sectors of a harddisk for boot +purposes. This will leave 256 kB of space for a secondary bootstrap +loader which should be plenty (currently, the \fBaboot\fP(8) bootstrap +loader is about 90 kB large). Use more if you want to have a kernel in this +area, too - 2 MB should be sufficient in this case. + +.P +The \fI<dev>\fP argument specifies the special device to which the +\fI<bootloader>\fP file should be written to. The boot loader file +must be a header-less image (not an object file) containing the raw +contents of the text, data, and bss sections. A typical command to +make SCSI disk 0 bootable with the \fIaboot\fP(8) loader is shown +below: + +.I "swriteboot /dev/sda bootlx" + +.P +The \fI-v\fP option makes \fBswriteboot\fP be a bit more verbose. +.P +The \fI-f#\fP option tells \fBswriteboot\fP to ignore an overlap of the boot area with +partition \fI#\fP. +.P +The \fI-c#\fP option explicitly tells \fBswriteboot\fP the boot partition. +If this argument is missing, then \fBswriteboot\fP tries to autodetect the +boot partition if possible. Note that you can set the boot partition later +on with \fBabootconf\fP(8) as well. + +.nf +.SH SEE ALSO +.IR aboot (8) , +.IR abootconf (8) , +.IR mke2fs (8) , +.IR e2writeboot (8) +.nf +.SH AUTHORS +.nf +Bob Manson <manson@magnus.acs.ohio-state.edu> +Michael Schwingen <michael@schwingen.org> +Helge Kreutzmann <debian@helgefjell.de> (Update of man page) +.fi |