Page MenuHomeFreeBSD

bsdinstall.8: Document DISTRIBUTIONS defaults correctly
ClosedPublic

Authored by 0mp on Apr 20 2026, 3:53 PM.
Tags
None
Referenced Files
Unknown Object (File)
Mon, May 18, 5:19 AM
Unknown Object (File)
Mon, May 18, 5:11 AM
Unknown Object (File)
Sun, May 17, 8:10 PM
Unknown Object (File)
Sun, May 17, 8:05 PM
Unknown Object (File)
Thu, May 14, 1:40 PM
Unknown Object (File)
Thu, May 14, 11:46 AM
Unknown Object (File)
Thu, May 14, 2:45 AM
Unknown Object (File)
Thu, May 14, 2:32 AM

Diff Detail

Repository
rG FreeBSD src repository
Lint
Lint Skipped
Unit
Tests Skipped
Build Status
Buildable 72373
Build 69256: arc lint + arc unit

Event Timeline

0mp requested review of this revision.Apr 20 2026, 3:53 PM

Thank you for working on this!

usr.sbin/bsdinstall/bsdinstall.8
86

I think auto sets base.txz kernel.txz by default:
https://cgit.freebsd.org/src/tree/usr.sbin/bsdinstall/scripts/auto#n238

usr.sbin/bsdinstall/bsdinstall.8
86

Ah that's a copy&paste error! Thanks for spotting that!

This revision is now accepted and ready to land.Apr 20 2026, 7:43 PM

Hi @0mp would you mind if I take a stab at extending this patch a bit further or maybe you would like to extend it?
For some context, I am currently working on adding a precompiled option to NanoBSD as part of a GSoC project. It requires using pkgbase, however I found it very useful to also add distribution sets for comparison. As such, we have decided to adopt bsdinstall's configuration options, that is, defining a NANO_DISTRIBUTIONS variable with the distributions you want in the final image. I'm pointing users to this manual page for more information about DISTRIBUTIONS.
My extension will consist of presenting more verbose distribution set information (obtained from the MANIFEST), which includes all the valid options the user can choose:

base-dbg.txz		"Base system debug info"			off
base.txz		"Base system"					on
kernel-dbg.txz		"Kernel debug info"				on
kernel.txz		"Kernel"					on
lib32-dbg.txz		"32-bit compatibility libraries (Debugging)"	off
lib32.txz		"32-bit compatibility libraries"		on
ports.txz		"Ports tree"					off
src.txz			"System source tree"				off
tests.txz		"Test suite"					off

The third column is what bsdinstall selects by default when running interactively (for reasons beyond my understanding, I would have selected base.txz kernel.txz by default as well).