aboutsummaryrefslogtreecommitdiff
path: root/stand/man
Commit message (Collapse)AuthorAgeFilesLines
* loader.efi(8): clarify UEFI boot path and boot1.efi usagekitkat14242026-01-091-24/+23
| | | | | | | | | | | | | Reorganise and clarify the legacy role of boot1.efi in DESCRIPTION to improve clarity. Add a minor missing word in the BUGS section ["...caution is required*..."]. See also - PR: 290794 Signed-off-by: Aaditya Singh <aadityavksingh@gmail.com> Reviewed by: imp Pull Request: https://github.com/freebsd/freebsd-src/pull/1939
* loader.efi.8: Minor formatting nitsJohn Baldwin2025-11-221-1/+8
| | | | | | | | | | - Add several missing .Pp after lists and literal blocks. - Fix the column widths for the console table and use a shorter indent so that it doesn't wrap on an 80-col display. Reviewed by: imp Differential Revision: https://reviews.freebsd.org/D53866
* loader.8: Document module commandsAlexander Ziaee2025-11-141-1/+47
| | | | | | | | | | | | Begin documenting module loader commands in loader(8), where the reader would look for them. Segregate them by their availability in individual loader implementations, like build(7) targets. These details were graciously donated by kevans. MFC after: 3 days Reviewed by: kevans Co-authored-by: Kyle Evans <kevans@freebsd.org> Differential Revision: https://reviews.freebsd.org/D50727
* loader manuals: Clarify console and boot_serialAlexander Ziaee2025-11-141-2/+2
| | | | | | | | | | | | console=comconsole is for the loader and boot_serial is for the kernel. I think we should centralize documentation on the loader settings in one manual, such a loader.8. The current proliferation is not obvious where to find the documentation. To the user, these are all set in loader.conf or at the loader prompt. MFC after: 3 days Differential Revision: https://reviews.freebsd.org/D53695
* stand/man: Fix mdoc typos for emails, tag spdxAlexander Ziaee2025-09-185-6/+20
| | | | MFC after: 3 days
* loader: set boot_safe when safe mode is selectedKyle Evans2024-12-141-1/+16
| | | | | | | | | This may be used to disable or limit functionality of some services when safe mode is selected. The particular value of boot_safe should not be considered significant, only its presence in the environment. Reviewed by: imp, tsoome Differential Revision: https://reviews.freebsd.org/D32172
* man: Misc syntax fixesGraham Percival2024-11-141-1/+1
| | | | | | | | | | | | - loader.efi.8: use proper way of printing a backslash. - usr.bin/gzip/gzip.1: contained a non-breaking space (in utf-8, 0xC2A0). - lib/libpmc/pmc.*.3: remove two duplicate .Xr lines Signed-off-by: Graham Percival <gperciva@tarsnap.com> Reviewed by: mhorne, Alexander Ziaee <concussious.bugzilla@runbox.com> MFC after: 3 days Sponsored by: Tarsnap Backup Inc. Pull Request: https://github.com/freebsd/freebsd-src/pull/1523
* manuals: Remove trailing spacesGraham Percival2024-11-041-1/+1
| | | | | | | | | | This does not change the rendered ascii at all. Signed-off-by: Graham Percival <gperciva@tarsnap.com> Reviewed by: mhorne, Alexander Ziaee <concussious.bugzilla@runbox.com> MFC after: 3 days Sponsored by: Tarsnap Backup Inc. Pull Request: https://github.com/freebsd/freebsd-src/pull/1473
* manuals: Misc syntax fixesGraham Percival2024-10-281-2/+2
| | | | | | | | | These were reported by `mandoc -T lint ...` as errors. Signed-off-by: Graham Percival <gperciva@tarsnap.com> Reviewed by: mhorne, Alexander Ziaee <concussious.bugzilla@runbox.com> Sponsored by: Tarsnap Backup Inc. Pull Request: https://github.com/freebsd/freebsd-src/pull/1472
* Canonicalize the name of the FreeBSD FoundationLi-Wen Hsu2024-10-231-1/+1
| | | | | Reviewed by: emaste Sponsored by: The FreeBSD Foundation
* manuals: Fix "missing end of block" errorsGraham Percival2024-10-082-0/+3
| | | | | | | | | | | | These were reported by `mandoc -T lint ...` as errors. The rendered output (in ascii and html) is not affected by this commit. Signed-off-by: Graham Percival <gperciva@tarsnap.com> Reviewed by: mhorne, Alexander Ziaee <concussious.bugzilla@runbox.com> MFC after: 3 days Sponsored by: Tarsnap Backup Inc. Pull Request: https://github.com/freebsd/freebsd-src/pull/1454
* loader.efi.8: BOOOTX64.EFI: fix typoGraham Perrin2024-09-211-1/+1
| | | | | Reviewed by: imp Pull Request: https://github.com/freebsd/freebsd-src/pull/1412
* loader.efi.8: Remove rogue duplicated linesJessica Clarke2024-09-031-4/+1
| | | | | Fixes: 871911a4ab73 ("loader.efi(8): beef up the updating the ESP") MFC after: 1 week
* loader.efi(8): beef up the updating the ESPWarner Losh2024-08-261-22/+120
| | | | | | | | | There's a huge variety of situations when booting with UEFI. Document more of them, hopefully better. Feedback from: jrtc27 MFC After: 3 days Sponsored by: Netflix
* Remove residual blank line at start of MakefileWarner Losh2024-07-151-1/+0
| | | | | | | This is a residual of the $FreeBSD$ removal. MFC After: 3 days (though I'll just run the command on the branches) Sponsored by: Netflix
* loader.efi.8: Fix a typoMateusz Piotrowski2023-11-221-2/+2
| | | | | MFC after: 3 days Sponsored by: Klara, Inc.
* loader.efi.8: Fix style warningsBenedict Reuschling2023-11-061-1/+3
| | | | | This is a follow-up commit to bce728719e7f57272d99b6d039f10b4c636fa024 to address mandoc(1) warnings.
* Add paragraph documenting loader.env functionlityGuido Falsi2023-11-061-0/+8
| | | | | Approved by: docs (carlavilla) Differential Revision: https://reviews.freebsd.org/D42476
* Use 115200 bps by default for serial communicationEd Maste2023-08-171-1/+1
| | | | | | | | | | | | | 9600 was a standard baud rate decades ago, but 115200 is now more common so choose defaults that are useful to the largest number of users. Note that boot0sio does not support rates above 9600 so it remains unchanged. Reviewed by: bz, imp, manu Relnotes: Yes Sponsored by: The FreeBSD Foundation Differential Revision: https://reviews.freebsd.org/D36295
* Remove $FreeBSD$: two-line nroff patternWarner Losh2023-08-166-12/+0
| | | | Remove /^\.\\"\n\.\\"\s*\$FreeBSD\$$\n/
* Remove $FreeBSD$: one-line sh patternWarner Losh2023-08-162-2/+0
| | | | Remove /^\s*#[#!]?\s*\$FreeBSD\$.*$\n/
* spdx: The BSD-2-Clause-FreeBSD identifier is obsolete, drop -FreeBSDWarner Losh2023-05-121-1/+1
| | | | | | | | | The SPDX folks have obsoleted the BSD-2-Clause-FreeBSD identifier. Catch up to that fact and revert to their recommended match of BSD-2-Clause. Discussed with: pfg MFC After: 3 days Sponsored by: Netflix
* loader.efi(8): document slop control, amd64 nocopy, and amd64 fault commandsKonstantin Belousov2022-09-061-1/+116
| | | | | | | | | Reviewed by: imp Discussed with: gbe (man pages) English wording help by: rpokala Sponsored by: The FreeBSD Foundation MFC after: 3 days Differential revision: https://reviews.freebsd.org/D36435
* stand: Document EFI consolesWarner Losh2022-09-011-8/+180
| | | | | | | | | | | | | | Document how EFI consoles work, at least on x86. There's a number of weird quirks and limitations that are generally known, but not documented until now. Include information on how EFI decides what the defualt console is, how to set it and how to cope with common situations. Note limitations and mismatch between ACPI (which uses UID to identify a device) and our console code (which uses a raw address) and explain why we can't translate between them in the loader. Sponsored by: Netflix Reviewed by: manu, kevans, rpokala, pauamma Differential Revision: https://reviews.freebsd.org/D36286
* loader.efi: add cross-reference to loader(8)Ed Maste2022-05-181-0/+1
| | | | | | | | The loader.efi man page describes UEFI-specific loader details, but not general loader information. MFC after: 3 days Sponsored by: The FreeBSD Foundation
* stand: Change libstand.3 to libsa.3Warner Losh2022-04-304-7/+7
| | | | | | | Changes instances of the non-existant libstand.3 to the more correct, but also non-existant libsa.3. Sponsored by: Netflix
* Clean up some grammos I left behind.Jens Schweikhardt2022-04-111-7/+7
|
* Correct typos and more precise wording.Jens Schweikhardt2022-04-111-19/+18
|
* Correct a grammo.Jens Schweikhardt2022-04-041-2/+1
|
* loader.efi: Improve the manual pageMateusz Piotrowski2022-03-181-11/+62
| | | | | | | | | | | | | | - Add SPDX tag - Add a files section describing different locations related to the loader - Add an example explaining how to install a new loader.efi to ESP - Reference uefi(8) Reviewed by: tsoome Reviewed by: Pau Amma <pauamma@gundo.com> Reviewed by: Jose Luis Duran <jlduran@gmail.com> MFC after: 2 weeks Differential Revision: https://reviews.freebsd.org/D34592
* Delete a blank that messed up punctuation.Jens Schweikhardt2022-03-051-1/+1
|
* loader_lua.8: Fix first versionWarner Losh2021-09-291-11/+1
| | | | | | | | | Lua bindings appeared in FreeBSD 12.0. Delete the authors section of the man page, since it's unclear who wrote different parts of the man page. Noted by: Trond Endrestol Sponsored by: Netflix
* loader: create separate man pages for each of the loadersWarner Losh2021-09-295-1064/+911
| | | | | | | | | | | | | | | Create a man page per loader. Loader(8) will have information common to all of them, while loader_${INTERP}(8) will have information relevant to that specific loader. Rewrite loader(8) to give an overview and point to the appropriate man page. Rewrite each of the loader_${INTER}(8) man pages to contain only the relevant information to that loader. Put all the common commands, environment variables, etc in loader_simp(8) and refernce that from the loader_lua or loader_4th man pages. The loader_lua(8) could use more details about the Lua integration. Additional organization may be benefitial. Sponsored by: Netflix Differential Revision: https://reviews.freebsd.org/D31340
* loader: Set twiddle globaldiv to 16 by defaultColin Percival2021-09-282-2/+4
| | | | | | | | | | | | | | | | | | | | | | | | Booting FreeBSD on an EC2 c5.xlarge instance, the loader "twiddles" 810 times over the course of 510 ms, a rate of 1.59 kHz. Even accepting that many systems are slower than this particular VM and will take longer to boot (especially if using spinning-rust disks), this seems like an unhelpfully large amount of twiddling when compared to the ~60 Hz frame rate of many displays; printing the twiddles also consumes roughly 10% of the boot time on the aforementioned VM. Setting the default globaldiv to 16 dramatically reduces the time spent printing twiddles to the console while still twiddling at roughly 100 Hz; this should be ample even for systems which take longer to boot and consequently twiddle slower. Note that this can adjusted via the twiddle_divisor variable in loader.conf, but that file is not processed until nearly halfway through the loader's runtime. Reviewed by: allanjude, jrtc27, kevans MFC after: 1 week Sponsored by: https://www.patreon.com/cperciva Differential Revision: <https://reviews.freebsd.org/D32163>
* loader: Create loader_simp(8) to document simple version of loaderWarner Losh2021-07-142-0/+763
| | | | | | | | | | loader_simp is a much simplified version of loader that will process a linear sequence of commands from loader.rc. It has neither Forth nor Lua built in and is much smaller. Document it. This is largely copied from loader.8 since it implements those built-in commands. Future revisions will fix this duplication. Sponsored by: Netflix
* loader(8): fix path to be correct loader.4th.Warner Losh2021-07-141-2/+2
| | | | | | | | boot.4th was a thing for only a few months around FreeBSD 3.1. The correct name has been loader.4th for a long time. MFC After: 2 days Sponsored by: Netflix
* loader: small Makefile style changeWarner Losh2021-07-141-7/+5
| | | | | | Move to using M.${option} and M.yes to collecting man pages to install. Sponsored by: Netflix
* loader: update autoboot description and move to loader.conf.5Daniel Gerzo2021-07-121-29/+2
| | | | | | | | | | | Document "NO" special value for the autoboot_delay and move the description to loader.conf.5. imp reworked some of the wording from danger's patch. Reviewed by: imp PR: 85128 Differential Revision: https://reviews.freebsd.org/D11887
* Loader: support booting OS from memory disk (MD)Yongbo Yao2021-04-071-1/+18
| | | | | | | | | | | | | Until now, the boot image can be embedded into the loader with /sys/tools/embed_mfs.sh, and memory disk (MD) is already supported in loader source. But due to memory disk (MD) driver isn't registered to the loader yet, the boot image can't be boot from embedded memory disk. Reviewed by: dab, tsoome MFC after: 1 week Sponsored by: Dell EMC Isilon Differential Revision: https://reviews.freebsd.org/D29512
* gptboot.efi: Add man pageWarner Losh2021-04-061-2/+12
| | | | | | | | | | | | | | | | | | | | | | Add a man page for gptboot.efi. Describe when and how to use this as it differs from the BIOS cases. Include cross reference for the preferred method described in efibootmgr(8) as well as cross links in both gptboot(8) and gptboot.efi(8) to the other. This man page was heavily copied from the gptboot.8 man page by Warren Block. They are different enough to need separate man pages for clarity, but there's enough similarity that I worry about the duplication. In the really long term, gptboot(8) will disappear, so having the same info here will help when that day comes. In the short to medium term, the information is likely to not change in gptboot(8) and any changes to gptboot.efi(8) will be easier to make in a separate copy. loader.efi(8) needs a complete rewrite from scratch, otherwise I'd have referenced gptboot.efi(8) from there. Suggetions from: cress@, mhorne@ Reviewed by: rpokala@ Differential Revision: https://reviews.freebsd.org/D29591
* Correct the documented size of kern.msgbufsizeMateusz Piotrowski2020-10-021-2/+2
| | | | | | | | | | | The correct value is 96KB after r226090. PR: 249971 Submitted by: johannes@jo-t.de MFC after: 3 days Notes: svn path=/head/; revision=366364
* Update to today's dateWarner Losh2020-09-011-3/+1
| | | | | | | Also, fix a whitespace botch Notes: svn path=/head/; revision=365027
* Very preliminary loader.efi(8) man pageWarner Losh2020-09-012-0/+55
| | | | Notes: svn path=/head/; revision=365025
* Document boot1.efiWarner Losh2020-09-012-0/+102
| | | | | | | Crude man page for boo1.efi. Notes: svn path=/head/; revision=365024
* Loader: explain the syntax of currdevAllan Jude2020-07-131-3/+9
| | | | | | | | | | | | | | The origin text was: "Syntax for devices is odd." That is not very helpful. PR: 199103 Reviewed by: kevans, tsoome Sponsored by: Klara Inc. Event: July 2020 Bugathon Differential Revision: https://reviews.freebsd.org/D25629 Notes: svn path=/head/; revision=363139
* Remove sparc64 support from the boot loader.Warner Losh2020-02-031-1/+1
| | | | | | | Remove all the sparc64 specific bits, both files and ifdefs. Notes: svn path=/head/; revision=357454
* Improve formatting.Edward Tomasz Napierala2018-08-151-1/+1
| | | | | | | | MFC after: 2 weeks Sponsored by: DARPA, AFRL Notes: svn path=/head/; revision=337836
* Add SECURITY section to loader(8).Edward Tomasz Napierala2018-08-151-1/+37
| | | | | | | | | | Reviewed by: bcr, jilles, imp (earlier version) MFC after: 2 weeks Sponsored by: DARPA, AFRL Differential Revision: https://reviews.freebsd.org/D16700 Notes: svn path=/head/; revision=337834
* Add init_exec kenv(1) variable, to make init(8) execute a fileEdward Tomasz Napierala2018-08-141-1/+4
| | | | | | | | | | | | | | | | | after opening the console, replacing init as PID 1. From the user point of view, it makes it possible to run eg the shell as PID 1, using 'set init_exec=/bin/sh' at the loader(8) prompt. Reviewed by: kib MFC after: 2 weeks Relnotes: yes Sponsored by: DARPA, AFRL Differential Revision: https://reviews.freebsd.org/D16625 Notes: svn path=/head/; revision=337740
* Move around text in loader(8), in particular stuff related to ZFS,Edward Tomasz Napierala2018-08-131-61/+51
| | | | | | | | | | to restore the usual section order. MFC after: 2 weeks Sponsored by: DARPA, AFRL Notes: svn path=/head/; revision=337707
generated by cgit v1.2.3 (git 2.25.1) at 2026-03-08 10:00:45 +0000