CVS log for src/usr.sbin/installboot/installboot.8

Up to [cvs.NetBSD.org] / src / usr.sbin / installboot

Request diff between arbitrary revisions

Keyword substitution: kv
Default branch: MAIN

update date for previous

spelling fix

From Alexander Kuleshov in PR bin/58945.

installboot(8): excise stray word

Pull up following revision(s) (requested by tsutsui in ticket #722):

	sys/fs/cd9660/cd9660_util.c: revision 1.16
	sys/arch/hp300/stand/common/clock.c: revision 1.14
	sys/arch/hp300/stand/common/scsireg.h: revision 1.5
	sys/arch/hp300/stand/common/scsireg.h: revision 1.6
	sys/arch/hp300/stand/Makefile.buildboot: revision 1.38
	sys/arch/hp300/include/bus.h: revision 1.23
	sys/arch/hp300/stand/Makefile.buildboot: revision 1.39
	sys/arch/hp300/stand/common/sd.c: revision 1.12
	sys/arch/hp300/stand/common/prf.c: revision 1.6
	sys/arch/hp300/stand/common/sd.c: revision 1.13
	usr.sbin/installboot/installboot.8: revision 1.106
	usr.sbin/installboot/Makefile: revision 1.59
	sys/arch/hp300/stand/common/devopen.c: revision 1.14
	usr.sbin/installboot/installboot.8: revision 1.107
	sys/arch/hp300/stand/common/ite_dumb.c: revision 1.2
	sys/arch/hp300/stand/common/devopen.c: revision 1.15
	usr.sbin/installboot/installboot.8: revision 1.108
	sys/fs/cd9660/cd9660_extern.h: revision 1.29
	usr.sbin/installboot/installboot.8: revision 1.109
	tools/Makefile.nbincludes: revision 1.11 (patch)
	sys/arch/hp300/dev/rboxreg.h: revision 1.3
	sys/arch/hp300/stand/common/scsivar.h: revision 1.5
	sys/arch/hp300/dev/dnkbd.c: revision 1.14
	sys/arch/hp300/hp300/trap.c: revision 1.156
	sys/arch/hp300/stand/mkboot/mkboot.c: revision 1.12
	sys/arch/hp300/dev/frodoreg.h: revision 1.6
	sys/arch/hp300/stand/mkboot/mkboot.c: revision 1.13
	sys/arch/hp300/stand/common/ite_sti.c: revision 1.2
	sys/arch/hp300/stand/common/hil.c: revision 1.15
	usr.sbin/installboot/arch/hp300.c: revision 1.18
	sys/arch/hp300/stand/mkboot/mkboot.c: revision 1.14
	sys/arch/hp300/dev/rbox.c: revision 1.4
	usr.sbin/installboot/arch/hp300.c: revision 1.19
	sys/arch/hp300/stand/mkboot/mkboot.c: revision 1.15
	sys/sys/bootblock.h: revision 1.59
	sys/arch/hp300/stand/mkboot/mkboot.c: revision 1.16
	usr.sbin/installboot/installboot.h: revision 1.44
	sys/arch/hp300/stand/mkboot/volhdr.h: file removal
	sys/arch/hp300/stand/mkboot/mkboot.c: revision 1.17
	sys/arch/hp300/dev/hpib.c: revision 1.45
	usr.sbin/installboot/installboot.h: revision 1.45
	usr.sbin/installboot/cd9660.c: revision 1.1
	sys/arch/hp300/stand/mkboot/mkboot.c: revision 1.18
	sys/arch/hp300/dev/topcatreg.h: revision 1.3
	usr.sbin/installboot/cd9660.c: revision 1.2
	sys/arch/hp300/stand/mkboot/mkboot.c: revision 1.19
	sys/arch/hp300/stand/inst/inst.c: revision 1.25
	sys/arch/hp300/stand/uboot/Makefile: revision 1.12
	sys/arch/hp300/dev/dvbox.c: revision 1.4
	sys/arch/hp300/dev/dma.c: revision 1.45
	sys/arch/hp300/stand/uboot/Makefile: revision 1.13
	sys/arch/hp300/stand/common/rd.c: revision 1.16
	sys/arch/hp300/stand/inst/Makefile: revision 1.12
	distrib/hp300/cdroms/installcd/Makefile: revision 1.4
	sys/arch/hp300/stand/mkboot/volhdr.h: revision 1.6
	sys/arch/hp300/stand/common/machdep.c: revision 1.16
	usr.sbin/installboot/fstypes.c: revision 1.14
	sys/arch/hp300/hp300/machdep.c: revision 1.238
	sys/arch/hp300/include/cpu.h: revision 1.73
	sys/arch/hp300/dev/diofbreg.h: revision 1.4
	sys/arch/hp300/stand/common/scsi.c: revision 1.12
	sys/arch/hp300/stand/common/netio.c: revision 1.19
	sys/arch/hp300/stand/common/scsi.c: revision 1.13
	sys/arch/hp300/dev/sti_sgc.c: revision 1.8
	sys/arch/hp300/dev/rtc.c: revision 1.22
	sys/arch/hp300/stand/mkboot/mkboot.c: revision 1.20
	sys/arch/hp300/stand/common/conf.h: revision 1.4
	sys/arch/hp300/hp300/autoconf.c: revision 1.111
	sys/arch/hp300/stand/common/conf.c: revision 1.15
	sys/arch/hp300/stand/mkboot/Makefile: revision 1.12
	sys/arch/hp300/stand/mkboot/Makefile: revision 1.13
	sys/arch/hp300/hp300/autoconf.c: revision 1.114
	sys/arch/hp300/dev/dcmreg.h: revision 1.11
	sys/arch/hp300/dev/diofbvar.h: revision 1.4
	sys/arch/hp300/dev/dcm.c: revision 1.91
	sys/fs/cd9660/cd9660_util.c: revision 1.15
	sys/arch/hp300/dev/mcclock_frodo.c: revision 1.2

TAB/space cleanup.

installboot(8): formatting improvements

Use Ar foo instead of <foo>; this is mdoc.

Other formatting tweaks.
installboot(8): fix up markup

Don't overuse .Sy - when everything is highlighted, nothing is.  Use
.Ic for options &c to get correct PostScript output (both are bold in
plain text).

Use Aq Ar inside .Pa, as both Pa and Ar are rendered as underscored
text in plain text output, and the distinction is lost.

Don't set examples in bold, but give them .Pp space around - they are
much easier to read this way.

Use consistent -width in FILES.
document how to use installboot on netbsd/vax.

PR/57909: Jan-Benedict Glaw: Don't include (build) timestamp when doing a
reproducible build
fix usage string, improve error handling.
add missing chunk for repro-build. fix gcc warnings.
avoid stringop truncation, fix copyright string to prevent assembler warnings.

Fix build as a tool (Jan-Benedict Glaw)

Fix integer overflow of strtol(3) for "loadpoint" address on ILP32 hosts.

This strtol(3) was introduced in rev 1.12 for PR/57909 after netbsd-10,
but it returns LONG_MAX (0x7FFFFFFF) for 0xFFF00000 on ILP32 hosts and
the wrong loadpoint causes "NOT ENOUGH MEMORY" error by the BOOTROMs
on loading uboot.lif on (at least) my 9000/360 and 9000/425t.

Misc cosmetic changes for mostly readability.
- KNF and add some newlines per blocks
- define and use proper bintobcd() macro
- make local functions and variables static

The same uboot.lif binaries are generated.

Rename ${PROGAOUT} -> ${PROGELF} to reflect reality.
Use proper signedness for the LIF file system data structures.

Ancient 4.3BSD used short and int for location, file size, file type,
and addresses etc. but all of them should be unsigned.

Also rename several variables and add comments for readability.
The LIF file system info can be found in "The HPDir Project" page:
https://www.hp9845.net/9845/projects/hpdir/
The same uboot.lif binaries are generated.

Add a preliminary CD boot support to uboot for preparation of PR/54455.
Briefly tested on mame, but not enalbed yet.

Recognize SCSI CD-ROM devices as a booted device properly.

Necessary for PR port-hp300/54455, to boot an md root root RAMDISK

kernel from CD-ROM without "WARNING: can't find match for bootdev:"
prompt.

Sync with src/sys/arch/hp300/stand/mkboot/volhdr.h rev 1.6.
https://mail-index.netbsd.org/source-changes/2024/05/07/msg151195.html

Use proper signedness for the LIF file system data structures.
mkboot should use this MI <sys/bootblock.h> and volhdr.h should
be removed soon.

Use MI <sys/bootblock.h> to refer LIF filesystem structures.
This should have been done when LIF definitions were initially added
to <sys/bootblock.h> for MI installboot(8).

Enable SUPPORT_CD on uboot.

Make cd9660_util.c usable in userland tools like installboot(8).

This was partially done for src/distrib/cdrom/macppc_installboot,
but more strict prototypes are necessary for native binary builds.

Install cd9660 related system headers for tools installboot(8) builds.

Reorder function prototypes per source files.

Add cd9660 support to search a bootloader file in the target file system.

Also add CD boot support for hp300, using a bootloader file in cd9660 fs.
This is a tool's part to close PR/54455.

HP 9000/300 machines read LIF directory entry allocated after
the LIF volume header at the top of the boot disk during bootstrap,
and a bootstrap file must be contiguously allocated on the disk
due to limitation of the LIF specification.

Current NetBSD/hp300's bootloader is larger than ~80KB so we have
to prepare a special 'boot' partition for FFS (that has only 8KB (ffsv1)
or 32KB (ffsv2) spaces) disks to put such a large bootloader.

On the other hand, on ISO9660 fs all files are allocated contiguously
so we can specify a bootloader file in the target ISO9660 directly
in the LIF directory entry.

Note we can simply use the existing "append" option to create bootable
CD ISO for hp300, but it looks some emulators (at leaset MAME) reject
such non-standard ISO files, i.e. with an appended bootloader file at
the end of the image.

Put a RAMDISK kernel and SYS_UBOOT into hp300 installcd to make it bootable.

This should finally close PR/54455.

Fix tools build errors on Cygwin.

Appease warnings on building tools/installboot on Cygwin.

installboot.8: reflect current evbmips support

Add cd9660 support to search a bootloader file in the target file system.

Also add CD boot support for hp300, using a bootloader file in cd9660 fs.
This is a tool's part to close PR/54455.

HP 9000/300 machines read LIF directory entry allocated after
the LIF volume header at the top of the boot disk during bootstrap,
and a bootstrap file must be contiguously allocated on the disk
due to limitation of the LIF specification.

Current NetBSD/hp300's bootloader is larger than ~80KB so we have
to prepare a special 'boot' partition for FFS (that has only 8KB (ffsv1)
or 32KB (ffsv2) spaces) disks to put such a large bootloader.

On the other hand, on ISO9660 fs all files are allocated contiguously
so we can specify a bootloader file in the target ISO9660 directly
in the LIF directory entry.

Note we can simply use the existing "append" option to create bootable
CD ISO for hp300, but it looks some emulators (at leaset MAME) reject
such non-standard ISO files, i.e. with an appended bootloader file at
the end of the image.

document how to use installboot on netbsd/vax.

installboot(8): fix up markup

Don't overuse .Sy - when everything is highlighted, nothing is.  Use
.Ic for options &c to get correct PostScript output (both are bold in
plain text).

Use Aq Ar inside .Pa, as both Pa and Ar are rendered as underscored
text in plain text output, and the distinction is lost.

Don't set examples in bold, but give them .Pp space around - they are
much easier to read this way.

Use consistent -width in FILES.

installboot(8): formatting improvements

Use Ar foo instead of <foo>; this is mdoc.
Other formatting tweaks.

installboot(8): Note relation to UEFI boot and hybrid images.

installboot(8): Fix capitalization of U-Boot.

usr.sbin/installboot: Add a command line option (-u) to set U-Boot search paths

Installboot can install U-Boot boot blocks directly into a system
image.  Normally, the U-Boot files are searched for in
/usr/pkg/share/u-boot, under the expectation that most people will
build them with pkgsrc.  However, it is also possible to set an
environment variable (INSTALLBOOT_UBOOT_PATHS) to a colon-separated
search path to accommodate other situations.  This commit adds a
command line option (-u) to set the search path; if present, it
overrides the environment and default.

s/filesytem/filesystem/

Adjust manpage for amiga/boot ver 3.1.

Bump date.

Mention fdisk(8) and x86/mbr(8) in example for x86, for careless
people like me ;).

Bump date.

Pull up following revision(s) (requested by tsutsui in ticket #953):

	usr.sbin/installboot/installboot.8: revision 1.99
	usr.sbin/installboot/installboot.8: revision 1.98

Fix ews4800mips example.  Its raw partition is rsd0p, not rsd0c.
Reduce macro arguments.

Reduce macro arguments.

Fix ews4800mips example.  Its raw partition is rsd0p, not rsd0c.

Sync with HEAD

Fix typos. Fix link. Use Pa for path.

Add installboot(8) support for evbarm (and, in the future, other evb*)
boards that use u-boot.  A known board database lists boards and their
respective u-boot packages.  u-boot packages are discovered at run-time
(in /usr/pkg/share/u-boot, by default).  These packages contain board
database overlays that describe u-boot installation procedure that's
specific for that board.

Support this as a native tool and as a host tool.  The native tool
will attempt to determine the running board type using OpenFirmware
calls.  Host tool and native tool alike may also specify a board type
directly using the "-o board=xxx option" or have installboot(8) determine
the board type from a device tree blob using "-o dtb=/path/to/board.dtb".
A "-o media=xxx" option is provided for boards that have different u-boot
binaries and/or installation procedures for different media types (e.g.
SDMMC, eMMC, or USB).

This is trivial to extend to other evb* platforms that use u-boot, even if
they don't use FDT for autoconfiguration.

Pull up following revision(s) (requested by mrg in ticket #231):
	distrib/sets/lists/base/md.evbmips		1.3
	doc/CHANGES					1.2303-1.2304
	etc/etc.evbmips/MAKEDEV.conf			1.8
	etc/etc.evbmips/Makefile.inc			1.22
	etc/mtree/Makefile				1.37
	etc/mtree/NetBSD.dist.evbmips			1.1
	sys/arch/evbmips/Makefile			1.9
	sys/arch/evbmips/conf/SBMIPS			upto 1.2
	sys/arch/evbmips/conf/SBMIPS.MP			upto 1.2
	sys/arch/evbmips/conf/SBMIPS64			upto 1.2
	sys/arch/evbmips/conf/SBMIPS64.MP		upto 1.2
	sys/arch/evbmips/conf/files.sbmips		upto 1.2
	sys/arch/evbmips/conf/std.sbmips		upto 1.2
	sys/arch/evbmips/include/disklabel.h		1.6
	sys/arch/evbmips/include/loadfile_machdep.h
	sys/arch/evbmips/include/param.h		1.10
	sys/arch/evbmips/include/pci_machdep.h		1.3
	sys/arch/evbmips/sbmips/TODO
	sys/arch/evbmips/sbmips/autoconf.c
	sys/arch/evbmips/sbmips/autoconf.h
	sys/arch/evbmips/sbmips/console.c
	sys/arch/evbmips/sbmips/cpu.c			upto 1.3
	sys/arch/evbmips/sbmips/cpuvar.h
	sys/arch/evbmips/sbmips/disksubr.c
	sys/arch/evbmips/sbmips/leds.h
	sys/arch/evbmips/sbmips/locore_machdep.S
	sys/arch/evbmips/sbmips/machdep.c		upto 1.2
	sys/arch/evbmips/sbmips/rtc.c			upto 1.2
	sys/arch/evbmips/sbmips/sb1250_icu.c		upto 1.2
	sys/arch/evbmips/sbmips/swarm.h
	sys/arch/evbmips/sbmips/systemsw.c		upto 1.2
	sys/arch/evbmips/sbmips/systemsw.h
	sys/arch/evbmips/sbmips/zbbus.c			upto 1.2
	sys/arch/evbmips/stand/Makefile			1.1
	sys/arch/evbmips/stand/sbmips/Makefile
	sys/arch/evbmips/stand/sbmips/Makefile.bootprogs upto 1.2
	sys/arch/evbmips/stand/sbmips/Makefile.bootprogs 1.3
	sys/arch/evbmips/stand/sbmips/Makefile.bootxx
	sys/arch/evbmips/stand/sbmips/Makefile.inc	upto 1.3
	sys/arch/evbmips/stand/sbmips/boot/Makefile
	sys/arch/evbmips/stand/sbmips/boot/filesystem.c
	sys/arch/evbmips/stand/sbmips/boot/version
	sys/arch/evbmips/stand/sbmips/bootxx_cd9660/Makefile
	sys/arch/evbmips/stand/sbmips/bootxx_ffs/Makefile
	sys/arch/evbmips/stand/sbmips/bootxx_lfs/Makefile
	sys/arch/evbmips/stand/sbmips/common/bbinfo.h
	sys/arch/evbmips/stand/sbmips/common/blkdev.c	upto 1.2
	sys/arch/evbmips/stand/sbmips/common/blkdev.h
	sys/arch/evbmips/stand/sbmips/common/boot.c	upto 1.2
	sys/arch/evbmips/stand/sbmips/common/boot.ldscript
	sys/arch/evbmips/stand/sbmips/common/booted_dev.c upto 1.2
	sys/arch/evbmips/stand/sbmips/common/bootxx.c
	sys/arch/evbmips/stand/sbmips/common/cfe.c
	sys/arch/evbmips/stand/sbmips/common/cfe_api.c
	sys/arch/evbmips/stand/sbmips/common/cfe_api.h
	sys/arch/evbmips/stand/sbmips/common/cfe_api_int.h
	sys/arch/evbmips/stand/sbmips/common/cfe_error.h
	sys/arch/evbmips/stand/sbmips/common/cfe_ioctl.h
	sys/arch/evbmips/stand/sbmips/common/checksize.sh
	sys/arch/evbmips/stand/sbmips/common/common.h
	sys/arch/evbmips/stand/sbmips/common/panic_putstr.c
	sys/arch/evbmips/stand/sbmips/common/putstr.c
	sys/arch/evbmips/stand/sbmips/common/start.S
	sys/arch/evbmips/stand/sbmips/netboot/Makefile
	sys/arch/evbmips/stand/sbmips/netboot/conf.c
	sys/arch/evbmips/stand/sbmips/netboot/dev_net.c
	sys/arch/evbmips/stand/sbmips/netboot/devopen.c
	sys/arch/evbmips/stand/sbmips/netboot/getsecs.c	upto 1.2
	sys/arch/evbmips/stand/sbmips/netboot/if_cfe.c	upto 1.2
	sys/arch/evbmips/stand/sbmips/netboot/version
	sys/arch/mips/conf/files.sibyte			1.8
	sys/arch/mips/include/pmap.h			1.70
	sys/arch/mips/sibyte/dev/sbbuswatch.c		1.4
	sys/arch/mips/sibyte/dev/sbmac.c		1.49
	sys/arch/mips/sibyte/dev/sbscn.c		1.43
	sys/arch/mips/sibyte/dev/sbsmbus.c		1.17
	sys/arch/mips/sibyte/dev/sbtimer.c		1.21
	sys/arch/mips/sibyte/dev/sbwdog.c		1.15
	sys/arch/mips/sibyte/pci/sbbrz_pci.c		1.8
	usr.sbin/installboot/installboot.8		1.94

Move sys/arch/sbmips/* into sys/arch/evbmips/*/sbmips.

Remove superfluous Tn macros.

merge the rest of sbmips into evbmips.  install the stand files in
/usr/mdec/sbmips/ and document them in installboot(8) even though
it isn't really ported yet.  also build the SBMIPS kernels.

unfortunately, sbmips has been broken since mips64 merge, but the
fix can happen in the evbmips version, which we might merge into
the older trees anyway.

XXX: releng can turn off sbmips* builds now for -current.

Remove workaround for ancient HTML generation code.

Sync with HEAD

Sync with HEAD

Bump date for previous.

Document option console=auto. Works since at least NetBSD 6. [i386,amd64]

Fix a typo: s/can be use/can be used/

Use An in AUTHORS section.

Appease various mandoc -Tlint warnings and update copyright while we're here

Rebase to HEAD as of a few days ago.

sync with head.

for a reference, the tree before this commit was tagged
as yamt-pagecache-tag8.

this commit was splitted into small chunks to avoid
a limitation of cvs.  ("Protocol error: too many arguments")

Rename NetBSD/hp700 to NetBSD/hppa.

Unfortunately our VCS isn't very helpful here.

sync with head

Add missing word.

Some FAT16 filesystems don't have 'hidden sectors' correctly set to
the offset of the filesystem on the disk.
Let '-b s1blk' be used to fix the value.

Use "NetBSD 6.0" and not "NetBSD 6" and sound less like a broken record.
Add note where the actual example is because that's where it's expected.
Part of earlier commit ok-ed by releng@

Remove trailing whitespace. Put macro arguments on same line.

Update the amd64 and i386 examples to use /usr/mdec/bootxx_ffsv2,
i.e. DEFAULT_UFS2 as src/distrib/utils/sysinst/bsddisklabel.c does
since post-NetBSD5.  This avoids rendering an i386 or amd64 system
unbootable if the given example is thoughtlessly cut-and-pasted on
a NetBSD6.x system (been there, done that ;-) Qualify the descriptions
of /usr/mdec/bootxx_ffsv{1,2} along those lines.

Fixed a small typo in comment of distrib/utils/sysinst/arch/amd64/md.h.

Ok by releng@

Update for hp700. Bump date.

s/ISO9660/ISO 9660/ for consistency with rest of man page.

sync with head

Minor nits in the sparc64 example

Typo.

Explain how to use -e -v without -o to see the current options.
Caution that installing a new primary bootstrap will reset options to
default values.

Use rsd0c instead of the (far less common) rwd0c as boot disk in the
sparc64 example.

Sort options.

On i386/amd64, define two flag bits in the boot parameters which control
whether modules are loaded and whether boot.cfg is evaluated, and
set both to "off" per default in the PXE bootloader.
Extend "installboot" to toggle the bits.
This way, pxeboot works with existing dhcp server setups (and as
described in the manpage) out of the box. Also, boot.cfg reading
involves a stat() call which is horribly inefficient with the
TFTP pseudo file system.

Sync with HEAD.

Third (and last) commit. See http://mail-index.netbsd.org/source-changes/2009/05/13/msg221222.html

Add reminder to confirm the ffs format using dumpfs(8).

Try to improve documentation of the fact that the primary bootstrap is
specified using a file name on the running system, while the secondary
bootstrap is specified using a file name relative to the root of the
file systrem in which the installation is being performed.

Inspired by PR 39728 by der Mouse

Drop trailing whitespace; bump date for previous.

Add example using installboot -e

Add missing comma in SEE ALSO list.

sync with head.

Convert TNF licenses to new 2 clause variant

Sync w/ NetBSD-4-RC_1

Note here that -e can be used on the pxeboot_ia32.bin file.
(It is already mentioned on the pxeboot(8) page.)

Pull up following revision(s) (requested by dyoung in ticket #692):
	usr.sbin/installboot/installboot.8: revision 1.66
Bring the example concerning a bootable ISO9660 for i386 up-to-date,
demonstrating the -e option.

Bring the example concerning a bootable ISO9660 for i386 up-to-date,
demonstrating the -e option.

Sort SEE ALSO.

Add a -f (force) parameter to installboot(8).
If specified then checks on the disks BPB are not done, and any existing BPB
is deleted.
This is needed soince newfs(8) doesn't overwrite the BPB - which is basically
the FAT superblock.
Update documentation and add an example of using bootxx_fat16.

Drop trailing space.

Document bootxx_fat16 with a short description of why it differs from
bootxx_msdos.

Reword OF3 restrictions, ok tsutsui@.
Bump date.

New sentence, new line. Improve English.

Add some macppc specific description. Closes PR port-macppc/34496 by myself.

Pull up following revision(s) (requested by bad in ticket #1524):
	usr.sbin/installboot/installboot.8: revision 1.54 via patch
	usr.sbin/installboot/installboot.h: revision 1.31
	usr.sbin/installboot/fstypes.c: revision 1.9
	usr.sbin/installboot/ffs.c: revision 1.19
Add support for finding files on RAID partitions.  This allows us to
add the block list of the 2nd stage boot loader to the 1st stage boot
loader when the partition is a RAID partition.  Tested on sparc.
Reviewed by gdt.

Mark up a path with .Pa.

Add a note to explain 'c' (or 'd') partition usage in the common example.

Bump date for previous.

Mention landisk as supported.

Add support for finding files on RAID partitions.  This allows us to
add the block list of the 2nd stage boot loader to the 1st stage boot
loader when the partition is a RAID partition.  Tested on sparc.

Reviewed by gdt.

Replace NetBSD with Nx.

Note about ews4800mips.

It is not 2006 yet. Fix typo. Uppercase BIOS.

Don't try to determine the type of the target filesystem unless a second
stage bootstrap is specified.  It is only needed when we need to copy the
sector numbers of the second stage into the first stage.
Document that a configured baud rate of zero will cause the baud rate set by
the bios to be used.

Keeps in SYNOPSIS are not necessary any longer, groff is smart enough nowadays.
Sort options and option descriptions.

Add a -e (edit) option to allow the bootstrap options of an installed
bootstrap or a file containing such a bootstrap to be changed/displayed.
In particular this will (soon) let you modify the parameters for pxeboot.

Add single quotes to escape a semicolon in the makefs(8) argument
list.  Pointed out by Hubert Feyrer.

Punctuation nits; bump date for previous.

Add an example of using installboot(8) and makefs(8) with bootxx_cd9660
to create a bootable CD-ROM for an i386 host with a serial console.

Add hp700 to supported list. Bump date.

Add an option to set bp_consaddr (serial console IO port address)
Only complain about small patch area if we would write something non-zero there.

Document amd64; from Nicolas Joly in PR 26026.

Add example to keymap description. Use more macros. Bump date.

Add a -o keymap=zyz option that will set the boot keymap.
If a character in the map is typed, it gets replaced by the one following.

Use Xr instead of Ic when suitable; NetBSD -> .Nx; add comma;
use Dq for a string.

Provide an example for making a bootable FAT file system, and improve
some of the other examples.

roundup() write of hp300 boot code to a multiplr of the disk sector size.
and re-instate the hp300 code - seems to work.

Comment out hp300 references.

First cut of hp300 installboot, seems to DTRT on i386.
Maybe this code ought to know how to add a file to the LIF filesystem.

Clean up the i386 examples somewhat, adding an example of upgrading
the boot blocks on the existing mounted root file system, and
eliminating references to bootxx_ufs.

I referenced the a partition even though most other ports seem to
reference the c partition. I don't know if that's the most correct
way to do it, but it seems to work for me and no one can tell me what
the canonical method is. I'd let someone else fix the man page but no
one seemed to want to and it really needed the example.

Grammar fixes in previous; use Nx in one place;
sort examples; replace < and > with \*[Lt] and \*[Gt] respectively.
Bump date for previous.

add next68k support to installboot

Overhaul MBR handling (part 1):

<sys/bootblock.h>:
    *	Added definitions for the Master Boot Record (MBR) used by
	a variety of systems (primarily i386), including the format
	of the BIOS Parameter Block (BPB).
	This information was cribbed from a variety of sources
	including <sys/disklabel_mbr.h> which this is a superset of.

	As part of this, some data structure elements and #defines
	were renamed to be more "namespace friendly" and consistent
	with other bootblocks and MBR documentation.
	Update all uses of the old names to the new names.

<sys/disklabel_mbr.h>:
    *	Deprecated in favor of <sys/bootblock.h> (the latter is more
	"host tool" friendly).

amd64 & i386:
    *	Renamed /usr/mdec/bootxx_dosfs to /usr/mdec/bootxx_msdos, to
	be consistent with the naming convention of the msdosfs tools.

    *	Removed /usr/mdec/bootxx_ufs, as it's equivalent to bootxx_ffsv1
	and it's confusing to have two functionally equivalent bootblocks,
	especially given that "ufs" has multiple meanings (it could be
	a synonym for "ffs", or the group of ffs/lfs/ext2fs file systems).

    *	Rework pbr.S (the first sector of bootxx_*):
	    +	Ensure that BPB (bytes 11..89) and the partition table
		(bytes 446..509) do not contain code.
	    +	Add support for booting from FAT partitions if BOOT_FROM_FAT
		is defined.  (Only set for bootxx_msdos).
	    +	Remove "dummy" partition 3; if people want to installboot(8)
		these to the start of the disk they can use fdisk(8) to
		create a real MBR partition table...
	    +	Compile with TERSE_ERROR so it fits because of the above.
		Whilst this is less user friendly, I feel it's important
		to have a valid partition table and BPB in the MBR/PBR.

    *	Renamed /usr/mdec/biosboot to /usr/mdec/boot, to be consistent
	with other platforms.

    *	Enable SUPPORT_DOSFS in /usr/mdec/boot (stage2), so that
    	we can boot off FAT partitions.

    *	Crank version of /usr/mdec/boot to 3.1, and fix some of the other
	entries in the version file.

installboot(8) (i386):
    *	Read the existing MBR of the filesystem and retain the BIOS
    	Parameter Block (BPB) in bytes 11..89 and the MBR partition
	table in bytes 446..509.  (Previously installboot(8) would
	trash those two sections of the MBR.)

mbrlabel(8):
    *	Use sys/lib/libkern/xlat_mbr_fstype.c instead of homegrown code
	to map the MBR partition type to the NetBSD disklabel type.


Test built "make release" for i386, and new bootblocks verified to work
(even off FAT!).

Document the various bootxx_ variants seen on i386, since it's a FAQ.

Document /usr/mdec/biosboot.  (Arguably that should be renamed to
"/usr/mdec/boot" or "/usr/mdec/boot.i386" for consistency with other platforms)

Add an example for creating a bootable i386 floppy.

Add explicit descriptions of the `filesystem', `primary', and `secondary'
arguments, including a clarification that `secondary' is relative to the root
of the filesystem, not a path name to that file if `filesystem' is mounted.
Resolves PR 20977 from Jim Bernard.

Bump date for last; sort authors; add comma after e.g.

Change the way -o options are parsed, now done in MI code with a check after
all the options have been processed that they are supported my the
specific system.
Add i386 MD options (console, password, speed and timeout)
(Approved by christos and lukem)

.Nm does not need a dummy argument ("") before punctuation or
for correct formatting of the SYNOPSIS any longer.

Add support for amiga.

alpha also supports append & sunsum

pull up revisions 1.20-1.22 (requested by lukem in ticket #410):
    revision 1.22
	Mdoc nit.
    revision 1.21
	- be consistent with formatting, and use FSTYPE instead of <fs>
	- remove sparc and sun[23] BUGS that aren't relevant in this version
    revision 1.20
	update to reflect current state of reality for alpha, pmax, sparc,
	sparc64, sun2, sun3 and vax.
	clean up examples.
	include bugs/caveats from the (now removed) arch installboot man pages.

Mdoc nit.

- be consistent with formatting, and use FSTYPE instead of <fs>
- remove sparc and sun[23] BUGS that aren't relevant in this version

update to reflect current state of reality for alpha, pmax, sparc,
sparc64, sun2, sun3 and vax.
clean up examples.
include bugs/caveats from the (now removed) arch installboot man pages.

Add x68k stuff.

No .Pp before section headers, and use .Nx instead of NetBSD in one place.

- use uint8_t instead of char for boot block blobs
- bbinfo_params:
	- replace "int littleendian" with "bbinfo_endian endian"
	- add comments
- shared_bbinfo_clearboot():
	- add callback method to shared_bbinfo_clearboot()
	- don't clear from 0..headeroffset; use a callback to do that
- add news68k and newsmips support.
  From Izumi Tsutsui <tsutsui@ceres.dti.ne.jp>, with a rework by me to
  take advantage of the new shared_bbinfo_clearboot() callback.
  (XXX: untested yet)

Enable sun3, using same sun68k backend as sun2.

XXX: sun3 port still needs to be cut over to using sun68k bootxx...

advertise macppc support.  other tart-ups

user visible stuff:
- add `-B s2bno', to provide the starting block for the secondary bootstrap.
  intended for use on platforms where the blocks of the stage2 bootstrap
  are hardcoded into the stage1 bootstrap (currently: sparc, sun2)
- don't support `-b s1bno' for sparc or sun2, since the primary is always
  at a fixed location on the disk.
- if `filesystem' is a regular file, use fsync(2) instead of sync(2)

code changes:
- add hardcode_stage2(), which uses -B s2bno and the size of the
  provided secondary bootstrap (as an actual file, not as part of the
  `filesystem' argument) to provide a sequential list of blocks from s2bno,
  each block being the appropriate file system size (from
  params->fstype->blocksize)
- add blocksize and needswap run-time parameters to ib_fs
- in *_match(), set params->fstype->blocksize to the underlying block size
  (8KB for raw), and params->fstype->needswap as appropriate
- rename IB_STARTBLOCK to IB_STAGE1START, and add IB_STAGE2START
- use hardcode_stage2() to implement raw_findstage2() and IB_STAGE2BLOCK
  support for ffs_findstage2()
- improve some comments, add some prototypes, ...

sparc now has a back-end

document what uses the optional secondary arg.  add sun2 example

implement "raw" file system type.  this can be used when the primary
bootstrap is being installed at a particular block offset and the underlying
filesystem doesn't matter (e.g, alpha ustarboot in ustar floppies)

Add sun2 backend from Matthew Fredette.
(Implemented with "sun68k.c" as it should eventually support "sun3" as well.)

- Add code from Matt Fredette <fredette@theory.lcs.mit.edu> to implement
  fstype checking, and back-end "ffs" support.
- Consistently use at least uint32_t for blocknumbers (vs. int / long / ...)
- Consistently use uintXX_t instead of u_intXX_t.
- Move various duplicated prototypes into "installboot.h"

- support optional secondary bootstrap arg for install (unused by
  existing backends, but future ones need it)
- use "bootstrap" instead of "boot block" in various messages where appropriate
- rename some members of ib_params

Add sparc64 back-end, contributed by Matthew Green.

Mostly typo fixes, some formatting nits.

-n and -v are optional ...

update description, history, authors, examples, bugs,
including pmax specific stuff

Add support for alpha, based on {vax,pmax}.c and
sys/arch/alpha/stand/installboot.
XXX: not fully tested yet.

Add pmax installboot back-end; from vax.c and arch/pmax/stand/installboot/*.
XXX: not tested yet.

Machine independent "unified" installboot(8).
Currently only supports vax, with more MD back-ends to be added RSN.