History log of /src/share/man/man8/man8.x86/boot.8
Revision (<<< Hide revision tags) (Show revision tags >>>) Date Author Comments
# 1.39 14-Oct-2025 skrll

Trailing whitespace


# 1.38 10-Oct-2025 gutteridge

man8.x86/boot.8: remove stray period inadvertently added


# 1.37 10-Oct-2025 gutteridge

man8.x86/boot.8: various minor fixes

Fix spelling and grammar, bump date for significant changes made
earlier today, new sentence = new line.


# 1.36 09-Oct-2025 manu

Add support for USB-to-serial adapter in UEFI bootstrap.

This change lets UEFI bootstrap use any UEFI supported serial port.
com0 to com3 remain used for EISA based serial ports. com4 and over
are used for serial ports based on something else (USB, PCI or whatever).

Support for non-EISA serial ports may be provided by UEFI. An open
source UEFI driver exists for FTDI FT232R USB-to-serial adapter.

The change also introduce the kconsdev command, to select the kernel
console device without altering the bootstrap console device. This
useful because the device names can differ in bootstrap and kernel.
For instance an USB-to-serial device could be com4 in boostrap and
ucom0 for the kernel.

An upcoming change will add console suport to ucom(4).


Revision tags: perseant-exfatfs-base-20250801 netbsd-11-base
# 1.35 20-May-2025 pgoyette

Historically (prior to supporting the KERNEL_DIR build option), the
boot-commands ``boot file'' and ``boot /file'' were equivalent and
attempted to execute the same set of files. (In the boot-loader,
all path (filename) lookups start at the root directory whether or
not a leading slash is present.)

However, with the recent addition of support for the KERNEL_DIR
option, the leading slash character resulted in skipping the attempt
to load /file/kernel and /file/kernel.gz, and thus the boot loader
will not attempt to boot from a new KERNEL_DIR environment if the
leading slash is present. This commit restores attempting to load
these files, thus making these two boot-commands once again equivalent
in both legacy and KERNEL_DIR environments..

Changes were tested on both i386 (biosboot/qemu) and amd64 (both
biosboot/qemu and efiboot/bare-metal). Correct behavior was observed
using the filenames printed by a preexisting printf(). The output
from ``boot'' commands without arguments was also confirmed to meet
expectations, and commands other than ``boot'' continued to work as
expected.

As discussed on tech-kern, port-i386, and port-amd64 mailing lists.
The more extensive documentation requested by riastradh@ should have
been dealt with more than five years ago with the initial KERNEL_DIR
commit; this commit doesn't pretend to meet that request. As noted
by kre@, the changes being made here are minor/trivial and highly
unlikely to break anything. These changes only affect booting in
new KERNEL_DIR environments; "legacy" environments are not affected.


# 1.34 20-May-2025 pgoyette

Reverrt previous. I will recomit with proper log message.


# 1.33 20-May-2025 pgoyette

/home/paul/COMMIT.txt


# 1.32 11-May-2025 pgoyette

Update the set of filenames/pathnames that the boot loader will try
to boot. Changes result from support of KERNEL_DIR build option.


# 1.31 22-Mar-2025 pgoyette

Typos


Revision tags: perseant-exfatfs-base-20240630 perseant-exfatfs-base
# 1.30 14-May-2023 riastradh

branches: 1.30.2;
x86/boot(8): Nix trailing whitespace.


# 1.29 08-May-2023 manu

Remove XXX todo marker left by mistake


# 1.28 05-May-2023 manu

Add a SELFRELOC kernel option for the sake of documentation clarity.

Instead of telling that x86/boot(8) reloc command needs a kernel able
to self relocate, we can tell it needs a kernel built with the
SELFRELOC option. This keeps the reader from wondering what could
make a kernel able to self relocate.


# 1.27 24-Apr-2023 manu

Merge x86 boot options in x86/boot(8) and add undocumented UEFI options

We were supposed to keep the option list in x86/boot(8), x86/dosoot(8)
and x86/pxeboot(8) in sync, but it did not happen, hence it may work
better with all the options in x86/boot(8). Also add the undocumented
UEFI boot options.


Revision tags: netbsd-10-base
# 1.26 22-Jun-2021 gutteridge

branches: 1.26.2;
boot.8: minor grammar tweaks


Revision tags: cjep_sun2x-base1 cjep_sun2x-base cjep_staticlib_x-base1
# 1.25 30-May-2021 mlelstv

Add "root" command to pass a root specification.


Revision tags: cjep_staticlib_x-base
# 1.24 22-Apr-2021 rin

branches: 1.24.2;
Capitalize /EFI and /EFI/NetBSD as usual. Both are case-insensitive although.
Maybe not worth bumping dates...


# 1.23 10-Aug-2020 uwe

Formatting fixes for PostScript output.

Mostly use .Ar instead of .Va and use -literal, .Ql, etc where
appropriate.


# 1.22 09-Aug-2020 kim

Fix cross-refs to x86/mbr that were still missing x86

Additionally made some typo fixes, and added some vertical whitespace
to lists that felt crowded. Unified markup for displaying commands.


# 1.21 15-Jul-2020 kim

Document optional speed argument to consdev


Revision tags: phil-wifi-20200421 phil-wifi-20200411 is-mlppp-base phil-wifi-20200406 phil-wifi-20191119
# 1.20 16-Sep-2019 manu

Remove obsoeolete BUGS note that UEFI bootloader does not support multiboot


# 1.19 13-Sep-2019 wiz

New sentence, new line. Bump date for previous.


# 1.18 13-Sep-2019 manu

Document that bootdev option accepts device specification as NAME=label


# 1.17 18-Aug-2019 wiz

Typo fixes, 'file system'; new sentence, new line; expand IA-32.
Bump date for previous.


# 1.16 18-Aug-2019 manu

Document new GPT and RAIDframe capacity of bootstrap code

While there, also document EFI setup and some bugs


Revision tags: netbsd-9-base phil-wifi-20190609
# 1.15 15-May-2019 maxv

branches: 1.15.2;
RB_MD3 now disables SVS.


Revision tags: pgoyette-compat-20190127 pgoyette-compat-20190118 pgoyette-compat-1226
# 1.14 27-Nov-2018 wiz

Remove superfluous Ns.


Revision tags: pgoyette-compat-1126
# 1.13 25-Nov-2018 maya

port-i386/44562: mention correct kernel name order.


Revision tags: pgoyette-compat-1020 pgoyette-compat-0930 pgoyette-compat-0906 pgoyette-compat-0728 phil-wifi-base pgoyette-compat-0625 pgoyette-compat-0521 pgoyette-compat-0502 pgoyette-compat-0422 pgoyette-compat-0415 pgoyette-compat-0407 pgoyette-compat-0330 pgoyette-compat-0322 pgoyette-compat-0315 pgoyette-compat-base perseant-stdc-iso10646-base
# 1.12 03-Jul-2017 wiz

branches: 1.12.4; 1.12.6;
Remove workaround for ancient HTML generation code.


Revision tags: netbsd-8-1-RELEASE netbsd-8-1-RC1 netbsd-8-0-RELEASE netbsd-8-0-RC2 netbsd-8-0-RC1 matt-nb8-mediatek-base netbsd-8-base prg-localcount2-base3 prg-localcount2-base2 prg-localcount2-base1 prg-localcount2-base pgoyette-localcount-20170426 bouyer-socketcan-base1 pgoyette-localcount-20170320
# 1.11 18-Feb-2017 christos

branches: 1.11.4;
remove extra /


# 1.10 18-Feb-2017 wiz

Fix xrefs, sort.


# 1.9 17-Feb-2017 christos

fix crossrefs


# 1.8 17-Feb-2017 christos

fix cross references.


Revision tags: bouyer-socketcan-base pgoyette-localcount-20170107 pgoyette-localcount-20161104 localcount-20160914 pgoyette-localcount-20160806 pgoyette-localcount-20160726 pgoyette-localcount-base
# 1.7 19-Jun-2016 pgoyette

branches: 1.7.2; 1.7.4;
Fix typo.


# 1.6 25-Apr-2015 wiz

New sentence, new line. Bump date for previous. Various minor changes.


# 1.5 25-Apr-2015 mlelstv

Explain how the kernel determines the root filesystem from information
passed by the bootloader.


# 1.4 16-Aug-2014 apb

branches: 1.4.2;
Document supported subsets of image formats,
extracted from comments in src/sys/dev/stbi/stb_image.c.

XXX: This is not the right place to document supported image formats
for splash screens.


# 1.3 16-Aug-2014 apb

Document fs, menu, rndseed, and splash commands.
Add rescue(8) to SEE ALSO.
Also a little copy editing.


# 1.2 16-Aug-2014 apb

To get no space between [device:] and [filename],
the mdoc input needs ... Oc Ns Oo ..., not ... Ns Oc Oo ....


Revision tags: tls-maxphys-base netbsd-7-base yamt-pagecache-base9 tls-earlyentropy-base riastradh-xf86-video-intel-2-7-1-pre-2-21-15 riastradh-drm2-base3
# 1.1 31-Jul-2013 soren

branches: 1.1.4; 1.1.6;
Move shared x86 man pages from man8.i386 to man8.x86.