Home | History | Annotate | only in /src/share/man/man7
History log of /src/share/man/man7
RevisionDateAuthorComments
 1.39 23-Nov-2023  rin share/man/man7/Makefile: Hook stack.7
 1.38 23-Nov-2023  riastradh share/man/man7/Makefile: Split MAN on separate lines, and sort.

Makes sorting and merging changes easier.

No functional change intended.

Preparing for a new stack(7) in the service of PR pkg/57708.

XXX pullup-10
 1.37 27-Aug-2023  rillig c.7: mention that C11 and C17 have been published
 1.36 10-Jan-2021  riastradh branches: 1.36.6;
Various entropy integration improvements.

- New /etc/security check for entropy in daily security report.

- New /etc/rc.d/entropy script runs (after random_seed and rndctl) to
check for entropy at boot -- in rc.conf, you can:

. set `entropy=check' to halt multiuser boot and enter single-user
mode if not enough entropy

. set `entropy=wait' to make multiuser boot wait until enough entropy

Default is to always boot without waiting -- and rely on other
channels like security report to alert the operator if there's a
problem.

- New man page entropy(7) discussing the higher-level concepts and
system integration with cross-references.

- New paragraph in afterboot(8) about entropy citing entropy(7) for
more details.

This change addresses many of the issues discussed in security/55659.
This is a first draft; happy to take improvements to the man pages and
scripted messages to improve clarity.

I considered changing motd to include an entropy warning with a
reference to the entropy(7) man page, but it's a little trickier:
- Not sure it's appropriate for all users to see at login rather than
users who have power to affect the entropy estimate (maybe it is,
just haven't decided).
- We only have a mechanism for changing once at boot; the message would
remain until next boot even if an operator adds enough entropy.
- The mechanism isn't really conducive to making a message appear
conditionally from boot to boot.
 1.35 23-Jun-2020  maxv kernel_sanitizers.7
 1.34 26-Feb-2020  riastradh Draft man pages for the standard users and groups.

These are currently listed in order of uid because I went through
src/etc/group and src/etc/master.passwd line by line, and sorting any
other way after the fact -- like lexicographically, how it should be
-- was kinda inconvenient.

Feel free to sort, add information, add historical references,
correct any mistakes, &c., so that these remain living documents
describing NetBSD's standard users and groups and practices around
them.
 1.33 28-May-2018  nat branches: 1.33.2;
Move the audio specification to section 9 under audio_system.

Ok wiz@
 1.32 15-May-2018  nat Add the audio mixer specification to section 7 of the manual.
See posting on tech-kern - "NetBSD Audio Specification 2018."
 1.31 02-Dec-2014  msaitoh branches: 1.31.8; 1.31.14;
Add missing src(7) reported by Patrick Welche.
 1.30 31-Jul-2013  gdt branches: 1.30.4;
Remove tests.7 in objdir before copying to it.

If one's source tree has non-writable files (because of CVSREAD=t, or
someone else owns it, or it's on some read-only filesystems, some
other reason), recently-added makefile code would cp tests.foo.7 in
the sources to tests.7 in objdir, preserving permissions, but not
forcing the copy. A subsequent copy would result in an error, failing
the build. Therefore, rm -f the target file before doing the copy.

(Arguably there should some standard support for this, but copying
files from the source directory to objdir is quite unusual.)
 1.29 25-Feb-2013  jmmv Provide Kyua instructions in tests(7) when MKKYUA!=no.

I was first going to do this by doing automatic replacements of special
macros within the tests.7 file, but that turned out to be too complex
and confusing.

Instead, just rename the previous tests.7 to tests.atf.7 and add a new
tests.kyua.7 file. Choose which one to install as tests(7) depending on
the MKKYUA knob.
 1.28 24-Sep-2011  christos branches: 1.28.2; 1.28.8;
add new rfc6056.7, from vlad
 1.27 18-Mar-2011  jruoho Move security(8) to the section 7. Discussed on source-changes a while back.
Should address PR # 35718 at least partially.
 1.26 14-Dec-2010  jruoho By majority vote, move module(4) to the section 7.
 1.25 30-Nov-2010  jruoho Add glob(7).

From OpenBSD. Written by Todd C. Miller.
 1.24 30-Nov-2010  jruoho Add c(7).

Pillaged from FreeBSD. Written by Gabor Kovesdan.
 1.23 30-Nov-2010  jruoho Add orders(7) as a miscellaneous manual page.
 1.22 26-Jun-2010  jmmv Add the tests(7) manual page, which describes why and how to run the
test suite and how to configure it.
 1.21 02-Mar-2007  wiz Add simple pkgsrc(7) man page linking to pkg_add, pkg_delete, pkg_info
and the pkgsrc guide. Requested by Alan Barrett.
 1.20 02-Mar-2007  wiz packages(7) has (finally!) completely been integrated in the pkgsrc guide,
remove it.
 1.19 04-Dec-2006  pavel Move the description of sysctl MIBs from sysctl.3 to a new manual page
sysctl.7. Remove the list of MIBs from sysctl.8 so we don't have to
maintain duplicate information, as proposed by YAMAMOTO Takashi on
tech-userlevel. Also remove references to header files from sysctl.8.

The numeric constants remain documented, they are still needed in some
cases. See the discussion on tech-userlevel. ("mib list in sysctl.8")

OK by YAMAMOTO Takashi.
 1.18 07-Oct-2006  elad PR/32641: David Maxwell: No 'pkgsrc' manpage

Link pkgsrc(7) -> packages(7).
 1.17 07-May-2005  perry add script.7
 1.16 30-Jan-2004  christos Add the sticky file in the proper section and add a history section for it
explaining what sticky means and meant on plain files.
 1.15 30-Jun-2003  wiz Do not install mdoc.7 -- we use mdoc.7 from the groff distribution now.
 1.14 17-Feb-2003  wiz Add setuid(7), from Henry Spencer, converted to mdoc by me.
XXX: Improvements are welcome, in parts a bit out of date.
 1.13 12-Feb-2003  gmcgarry Some NLS discussion.
 1.12 17-Apr-2000  augustss Make mandoc point to mdoc.
 1.11 06-Oct-1999  jdolecek Add signal(7) manpage, with list of signals available under NetBSD.
For now, it includes just the list with basic information about
each signal, some more general signal-related staff might be
added in the future.

Thanks to Soren S. Jorvang <soren@NetBSD.org> for his help.
 1.10 27-Sep-1999  jdolecek Move symlink.7 to share/man/man7/, where it belongs
 1.9 05-Jun-1998  mrg branches: 1.9.4;
add a packages(7) man page, cobbled from bsd.pkg.mk
 1.8 25-Nov-1997  thorpej Add a document describing the layout of a NetBSD release.
 1.7 11-Oct-1997  mycroft branches: 1.7.2;
Use bsd.man.mk and bsd.subdir.mk as appropriate.
 1.6 22-Dec-1994  cgd specify man pages the new way.
 1.5 30-Nov-1994  jtc Merged with 4.4lite.
Changed to conform to NetBSD's new RCS Id conventions.
 1.4 31-Jul-1993  mycroft Add RCS indentifiers.
 1.3 26-Apr-1993  mycroft Once more, don't make `all' depend on man page; bsd.prog.mk does this.
 1.2 09-Apr-1993  cgd term manpage is missing
 1.1 21-Mar-1993  cgd branches: 1.1.1;
Initial revision
 1.1.1.2 30-Nov-1994  jtc imported from 4.4lite
 1.1.1.1 21-Mar-1993  cgd initial import of 386bsd-0.1 sources
 1.7.2.1 25-Nov-1997  thorpej Pull up from trunk: document describing a NetBSD release.
 1.9.4.1 27-Dec-1999  wrstuden Pull up to last week's -current.
 1.28.8.2 20-Aug-2014  tls Rebase to HEAD as of a few days ago.
 1.28.8.1 23-Jun-2013  tls resync from head
 1.28.2.1 22-May-2014  yamt 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")
 1.30.4.1 12-Dec-2014  martin Pull up following revision(s) (requested by msaitoh in ticket #309):
share/man/man7/Makefile: revision 1.31
distrib/sets/lists/man/mi: revision 1.1491
Add missing src(7) reported by Patrick Welche.
 1.31.14.2 25-Jun-2018  pgoyette Sync with HEAD
 1.31.14.1 21-May-2018  pgoyette Sync with HEAD
 1.31.8.2 07-Jun-2018  martin Pull up following revision(s) (requested by nat in ticket #848):

share/man/man9/Makefile: revision 1.422
distrib/sets/lists/comp/mi: revision 1.2198
share/man/man7/Makefile: revision 1.33
share/man/man9/audio.9: revision 1.47
share/man/man7/audio.7: file removal
sys/dev/audio.c: revision 1.456
sys/dev/audio.c: revision 1.457
distrib/sets/lists/man/mi: revision 1.1591
share/man/man9/intro.9: revision 1.20
share/man/man7/audio.7: revision 1.3
share/man/man9/audio_system.9: revision 1.1
share/man/man7/intro.7: revision 1.26
share/man/man4/audio.4: revision 1.86

Fix a typo with sc_out/inports when setting the hardware recording gain on the
mix ring. Found by mrg@
XXX pullup-8

Using audioctl without the -p switch defaults to the mix ring. This allows
setting the hardware gain etc.

Update the audio spec in audio.7 to reflect these changes.
Addresses PR kern/52781.

Move the audio specification to section 9 under audio_system.
Ok wiz@
 1.31.8.1 15-May-2018  martin Pull up following revision(s) (requested by nat in ticket #825):

share/man/man7/Makefile: revision 1.32
share/man/man9/audio.9: revision 1.46
sys/dev/audio.c: revision 1.453
sys/dev/audio.c: revision 1.454
sys/dev/audio.c: revision 1.455
share/man/man7/audio.7: revision 1.1
share/man/man7/audio.7: revision 1.2
share/man/man7/intro.7: revision 1.24
share/man/man4/audio.4: revision 1.85
distrib/sets/lists/man/mi: revision 1.1586

Fix numbering of vchan mixer controls to correspond to the vchan number in
use.

This makes the numbering of vchans consistient for audioctl and mixerctl.
Expose the audio_info structure of vchan zero(0) the mix ring to allow
setting the hardware gain and balance via audioctl(1) using the -p 0
switch.

It is not possible to influence the hardware gain/blance from the
audio_info structure of vchans 1 onwards. It is now possible to return
the audio mixers audio format from the audio_info structure of vchan 0 to
ease applications configuring for mmapped play back.

This is conformant to the audio specification posted on tech-kern see:

"NetBSD Audio Specification 2018"

or audio.7 manual page to be added in a follow up commit.
Add the audio mixer specification to section 7 of the manual.
See posting on tech-kern - "NetBSD Audio Specification 2018."
Update the introduction page to section 7 of the manual noting the audio
spec.

Various improvements, more markup, typo fixes.

Fix over cautious compiler error - setmode may not be initialized.
 1.33.2.1 08-Apr-2020  martin Merge changes from current as of 20200406
 1.36.6.1 09-Dec-2023  martin Pull up following revision(s) (requested by riastradh in ticket #486):

distrib/sets/lists/man/mi: revision 1.1767
share/man/man7/Makefile: revision 1.38
share/man/man7/Makefile: revision 1.39
share/man/man7/stack.7: revision 1.1
share/man/man7/stack.7: revision 1.2
share/man/man7/stack.7: revision 1.3
share/man/man7/stack.7: revision 1.4
share/man/man7/stack.7: revision 1.5
share/man/man7/stack.7: revision 1.6

share/man/man7/Makefile: Split MAN on separate lines, and sort.
Makes sorting and merging changes easier.
No functional change intended.

Preparing for a new stack(7) in the service of PR pkg/57708.

stack(7): New man page.
Should help with PR pkg/57708.

stack(7): Clarify thread stack guard vs program stack guard.
Just in case this confuses anyone dealing with PR pkg/57708.

stack(7): Clarify some wording and diagrams.
PR pkg/57708

stack(7): Consistently say `(in)accessible pages', not `... stack'.
PR pkg/57708

share/man/man7/Makefile: Hook stack.7
stack(7): Minor clarifications and wording tweaks.
Suggested by pgoyette@ and uwe@.
PR pkg/57708

stack(7): Fix diagram of non-main thread stacks.
Had stackaddr (pthread_attr_setstack parameter, lowest-numbered
virtual address of stack region) confused with stack base (where the
stack grows from, which is the highest-numbered virtual address on
machines where stack grows down).
PR pkg/57708
 1.15 19-Nov-2019  christos Sync with FreeBSD which capitalizes the control character names, and adds
a binary set.
Add a table with the full names for the control character set.
 1.14 30-Sep-2019  sevan Document standards and correct history.
via Free / OpenBSD.
 1.13 11-Feb-2018  wiz branches: 1.13.4; 1.13.6;
Remove Tn.
 1.12 08-Feb-2018  pgoyette Revert previous changes due to popular demand. Instead, add a note at
the bottom of each document to provide the original ASCII characters'
names.
 1.11 08-Feb-2018  pgoyette While here, also update 014 - it's name is "ff" ("form feed"), and not
"np" ("new page").
 1.10 08-Feb-2018  pgoyette Bump date for previous
 1.9 08-Feb-2018  pgoyette Since this is describing the ASCII character set, use the correct
ASCII abbreviation for character 012. All references I can find
which seem to be even remotely authoritative and/or definitive use
"lf" (for "line feed") rather than "nl" (for "new line").

See https://www.ascii-code.com and https://en.wikipedia.org/wiki/ASCII

From Eitan Adler in PR misc/52989
 1.8 03-Jul-2017  wiz Remove workaround for ancient HTML generation code.
 1.7 07-Aug-2003  agc branches: 1.7.90;
Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.
 1.6 13-Feb-2002  ross Generate <>& symbolically. I'm avoiding .../dist/... directories for now.
 1.5 11-Sep-2001  wiz Boring whitespace fixes.
 1.4 24-Mar-2000  enami Fix .Nm usage.
 1.3 30-Nov-1994  jtc Merged with 4.4lite.
Changed to conform to NetBSD's new RCS Id conventions.
 1.2 01-Aug-1993  mycroft Add RCS indentifiers.
 1.1 21-Mar-1993  cgd branches: 1.1.1;
Initial revision
 1.1.1.2 30-Nov-1994  jtc imported from 4.4lite
 1.1.1.1 21-Mar-1993  cgd initial import of 386bsd-0.1 sources
 1.7.90.1 02-Sep-2019  martin Pull up following revision(s) (requested by sevan in ticket #1351):

share/man/man4/man4.amiga/grf.4: revision 1.7
share/man/man4/si.4: revision 1.11
share/man/man8/man8.sparc/boot.8: revision 1.32
share/man/man5/nsswitch.conf.5: revision 1.29
share/man/man5/mixerctl.conf.5: revision 1.7
share/man/man8/man8.vax/boot.8: revision 1.14
share/man/man4/man4.vax/dn.4: revision 1.12
share/man/man8/man8.vax/drtest.8: revision 1.16
share/man/man8/sysinst.8: revision 1.6
share/man/man4/ip.4: revision 1.37
share/man/man5/boot.cfg.5: revision 1.28
share/man/man1/cd.1: revision 1.10
share/man/man4/usb.4: revision 1.106
share/man/man4/man4.vax/ix.4: revision 1.17
share/man/man7/security.7: revision 1.15
share/man/man7/hier.7: revision 1.123
share/man/man8/afterboot.8: revision 1.58
share/man/man1/man1.x68k/bellctrl.1: revision 1.14
share/man/man4/se.4: revision 1.6
share/man/man4/utoppy.4: revision 1.7
share/man/man4/midi.4: revision 1.32
share/man/man4/cfb.4: revision 1.5
share/man/man4/man4.sparc/magma.4: revision 1.12
share/man/man4/audio.4: revision 1.80
share/man/man4/isic.4: revision 1.18
share/man/man1/cd.1: revision 1.7
share/man/man4/envsys.4: revision 1.51
share/man/man1/cd.1: revision 1.8
share/man/man1/cd.1: revision 1.9
share/man/man3/fast_divide32.3: revision 1.9
share/man/man4/pci.4: revision 1.97
share/man/man5/ranlib.5: revision 1.7
share/man/man3/__arraycount.3: revision 1.7
share/man/man4/isa.4: revision 1.46
share/man/man8/man8.atari/ahdilabel.8: revision 1.14
share/man/man4/chipsfb.4: revision 1.6
share/man/man8/man8.macppc/boot.8: revision 1.8
share/man/man5/passwd.5: revision 1.33
share/man/man8/man8.macppc/ofwboot.8: revision 1.14
share/man/man8/compat_linux.8: revision 1.38
share/man/man4/iop.4: revision 1.22
share/man/man4/ddb.4: revision 1.167
share/man/man4/termios.4: revision 1.37
share/man/man8/compat_freebsd.8: revision 1.18
share/man/man5/ar.5: revision 1.9
share/man/man7/release.7: revision 1.37
share/man/man5/core.5: revision 1.31
share/man/man4/ahd.4: revision 1.6
share/man/man4/man4.vax/ad.4: revision 1.12
share/man/man4/pppoe.4: revision 1.39
share/man/man5/locale.alias.5: revision 1.3
share/man/man8/man8.amiga/installboot.8: revision 1.23
share/man/man4/etherip.4: revision 1.8
share/man/man3/queue.3: revision 1.57
share/man/man5/genassym.cf.5: revision 1.13
share/man/man4/mpls.4: revision 1.10
share/man/man1/wait.1: revision 1.5
share/man/man5/capfile.5: revision 1.4
share/man/man4/man4.alpha/ttwopci.4: revision 1.6
share/man/man4/man4.atari/rtc.4: revision 1.8
share/man/man4/gpiosim.4: revision 1.6
share/man/man3/bitstring.3: revision 1.18
share/man/man4/isdntel.4: revision 1.8
share/man/man4/ai.4: revision 1.9
share/man/man8/man8.hppa/boot.8: revision 1.2
share/man/man4/uyurex.4: revision 1.6
share/man/man8/man8.alpha/mkbootimage.8: revision 1.9
share/man/man4/bpf.4: revision 1.56
share/man/man4/man4.amiga/mfcs.4: revision 1.8
share/man/man4/cmpci.4: revision 1.9
share/man/man8/man8.vax/format.8: revision 1.14
share/man/man8/compat_svr4.8: revision 1.27
share/man/man4/crypto.4: revision 1.26
share/man/man4/userconf.4: revision 1.13
share/man/man4/agp.4: revision 1.17
share/man/man9/man9.i386/bioscall.9: revision 1.10
share/man/man4/uftdi.4: revision 1.20
share/man/man4/radio.4: revision 1.13
share/man/man4/mfb.4: revision 1.5
share/man/man7/ascii.7: revision 1.8
share/man/man4/man4.vax/dl.4: revision 1.13
share/man/man4/ral.4: revision 1.12
share/man/man4/unix.4: revision 1.26
share/man/man4/edc.4: revision 1.12
share/man/man4/pim.4: revision 1.5
share/man/man8/compat_ultrix.8: revision 1.21
share/man/man4/dge.4: revision 1.11
share/man/man8/diskless.8: revision 1.32
share/man/man5/passwd.conf.5: revision 1.11
share/man/man8/man8.acorn26/boot26.8: revision 1.8
share/man/man4/man4.vax/hy.4: revision 1.12
share/man/man4/plip.4: revision 1.4
share/man/man4/sc.4: revision 1.8
share/man/man4/ec.4: revision 1.14
share/man/man4/man4.sgimips/giopci.4: revision 1.9
share/man/man7/sysctl.7: revision 1.114
share/man/man3/bits.3: revision 1.18
share/man/man4/we.4: revision 1.19
share/man/man8/compat_sunos.8: revision 1.21
share/man/man4/ip6.4: revision 1.31
share/man/man4/acpilid.4: revision 1.8
share/man/man4/man4.dreamcast/aica.4: revision 1.6
share/man/man4/mfi.4: revision 1.12
share/man/man4/ugen.4: revision 1.32
share/man/man4/jme.4: revision 1.7
share/man/man4/man4.sparc64/intro.4: revision 1.5
share/man/man4/zyd.4: revision 1.5
share/man/man4/gre.4: revision 1.45
share/man/man3/bitmap.3: revision 1.10
share/man/man4/man4.vax/cons.4: revision 1.12
share/man/man3/gcq.3: revision 1.4
share/man/man4/man4.hppa/pdc.4: revision 1.3
share/man/man4/multicast.4: revision 1.8
share/man/man4/man4.sparc/intro.4: revision 1.27
share/man/man4/ath.4: revision 1.32
share/man/man4/ym.4: revision 1.19
share/man/man3/iso646.3: revision 1.6
share/man/man4/btsco.4: revision 1.13
share/man/man4/man4.i386/ndis.4: revision 1.6
share/man/man4/pad.4: revision 1.6
share/man/man4/strip.4: revision 1.16
share/man/man8/man8.x86/boot.8: revision 1.12
share/man/man4/amr.4: revision 1.15
share/man/man4/ieee80211.4: revision 1.5
share/man/man4/options.4: revision 1.467
share/man/man5/link.5: revision 1.24
share/man/man8/man8.cobalt/boot.8: revision 1.10
share/man/man5/stab.5: revision 1.15
share/man/man3/tree.3: revision 1.12
share/man/man4/route.4: revision 1.31
share/man/man4/man4.sun3/leds.4: revision 1.13
share/man/man4/bluetooth.4: revision 1.20
share/man/man4/man4.i386/pcibios.4: revision 1.19
share/man/man5/veriexec.5: revision 1.8
share/man/man7/operator.7: revision 1.12
share/man/man4/man4.hp300/dcl.4: revision 1.13
share/man/man4/man4.i386/intro.4: revision 1.31
share/man/man5/ld.so.conf.5: revision 1.21
share/man/man8/man8.alpha/boot.8: revision 1.16
share/man/man4/bio.4: revision 1.13
share/man/man4/man4.sun2/leds.4: revision 1.10
share/man/man8/man8.x86/mbr.8: revision 1.4
share/man/man8/man8.mvme68k/boot.8: revision 1.9
share/man/man4/man4.alpha/ttwoga.4: revision 1.6
share/man/man4/ahc.4: revision 1.34

Direct reader to shell documentation generally, rather than csh(1)
specifically.

Mention variables OLDPWD and PWD.

Move the text that explains that cd(1) is a shell built-in to the very
beginning of the description where it can be seen prominently.

Improve formatting.

-

Remove workaround for ancient HTML generation code.
Use EXIT STATUS and .Ex.
 1.13.6.1 19-Nov-2019  martin Pull up following revision(s) (requested by sevan in ticket #454):

share/man/man7/ascii.7: revision 1.14
share/man/man7/ascii.7: revision 1.15

Document standards and correct history.
via Free / OpenBSD.

Sync with FreeBSD which capitalizes the control character names, and adds
a binary set.

Add a table with the full names for the control character set.
 1.13.4.1 13-Apr-2020  martin Mostly merge changes from HEAD upto 20200411
 1.5 28-May-2018  nat Move the audio specification to section 9 under audio_system.

Ok wiz@
 1.4 23-May-2018  wiz Mark up argument. Fix typo.
 1.3 22-May-2018  nat Using audioctl without the -p switch defaults to the mix ring. This allows
setting the hardware gain etc.

Update the audio spec in audio.7 to reflect these changes.

Addresses PR kern/52781.
 1.2 15-May-2018  wiz branches: 1.2.2; 1.2.4;
Various improvements, more markup, typo fixes.
 1.1 15-May-2018  nat Add the audio mixer specification to section 7 of the manual.
See posting on tech-kern - "NetBSD Audio Specification 2018."
 1.2.4.3 25-Jun-2018  pgoyette Sync with HEAD
 1.2.4.2 21-May-2018  pgoyette Sync with HEAD
 1.2.4.1 15-May-2018  pgoyette file audio.7 was added on branch pgoyette-compat on 2018-05-21 04:35:56 +0000
 1.2.2.3 07-Jun-2018  martin Pull up following revision(s) (requested by nat in ticket #848):

share/man/man9/Makefile: revision 1.422
distrib/sets/lists/comp/mi: revision 1.2198
share/man/man7/Makefile: revision 1.33
share/man/man9/audio.9: revision 1.47
share/man/man7/audio.7: file removal
sys/dev/audio.c: revision 1.456
sys/dev/audio.c: revision 1.457
distrib/sets/lists/man/mi: revision 1.1591
share/man/man9/intro.9: revision 1.20
share/man/man7/audio.7: revision 1.3
share/man/man9/audio_system.9: revision 1.1
share/man/man7/intro.7: revision 1.26
share/man/man4/audio.4: revision 1.86

Fix a typo with sc_out/inports when setting the hardware recording gain on the
mix ring. Found by mrg@
XXX pullup-8

Using audioctl without the -p switch defaults to the mix ring. This allows
setting the hardware gain etc.

Update the audio spec in audio.7 to reflect these changes.
Addresses PR kern/52781.

Move the audio specification to section 9 under audio_system.
Ok wiz@
 1.2.2.2 15-May-2018  martin Pull up following revision(s) (requested by nat in ticket #825):

share/man/man7/Makefile: revision 1.32
share/man/man9/audio.9: revision 1.46
sys/dev/audio.c: revision 1.453
sys/dev/audio.c: revision 1.454
sys/dev/audio.c: revision 1.455
share/man/man7/audio.7: revision 1.1
share/man/man7/audio.7: revision 1.2
share/man/man7/intro.7: revision 1.24
share/man/man4/audio.4: revision 1.85
distrib/sets/lists/man/mi: revision 1.1586

Fix numbering of vchan mixer controls to correspond to the vchan number in
use.

This makes the numbering of vchans consistient for audioctl and mixerctl.
Expose the audio_info structure of vchan zero(0) the mix ring to allow
setting the hardware gain and balance via audioctl(1) using the -p 0
switch.

It is not possible to influence the hardware gain/blance from the
audio_info structure of vchans 1 onwards. It is now possible to return
the audio mixers audio format from the audio_info structure of vchan 0 to
ease applications configuring for mmapped play back.

This is conformant to the audio specification posted on tech-kern see:

"NetBSD Audio Specification 2018"

or audio.7 manual page to be added in a follow up commit.
Add the audio mixer specification to section 7 of the manual.
See posting on tech-kern - "NetBSD Audio Specification 2018."
Update the introduction page to section 7 of the manual noting the audio
spec.

Various improvements, more markup, typo fixes.

Fix over cautious compiler error - setmode may not be initialized.
 1.2.2.1 15-May-2018  martin file audio.7 was added on branch netbsd-8 on 2018-05-15 13:42:49 +0000
 1.15 27-Aug-2023  rillig c.7: mention that C11 and C17 have been published
 1.14 18-Mar-2014  riastradh Merge riastradh-drm2 to HEAD.
 1.13 20-Jul-2013  wiz Use Mt for email addresses.
 1.12 30-Mar-2011  jruoho branches: 1.12.4; 1.12.10; 1.12.14;
Xref cdefs(3).
 1.11 19-Jan-2011  uwe Use .Va __func__ and .Vt restrict
 1.10 17-Dec-2010  jruoho There is no harm to add a manual page for the GNU typeof()-construct, given
that it has already crawled into the source tree.
 1.9 17-Dec-2010  jruoho Note __func__ and restrict.
 1.8 16-Dec-2010  jruoho Mention attribute(3) in passing.
 1.7 13-Dec-2010  jruoho Prompted by dholland@; add the C99 TCORs.
 1.6 02-Dec-2010  wiz Various (mostly wording) improvements. Sort SEE ALSO.
 1.5 01-Dec-2010  jruoho Reference stdbool(3), stdint(3), and inttypes(3). Use .Vt.
 1.4 01-Dec-2010  dholland typo
 1.3 01-Dec-2010  dholland Minor grammar patrol.

XXX: if this is going to mention the c89 TC's, it should really
XXX: mention the c99 TC's too.
 1.2 30-Nov-2010  jruoho Fix botched CVS identifier.
 1.1 30-Nov-2010  jruoho Add c(7).

Pillaged from FreeBSD. Written by Gabor Kovesdan.
 1.12.14.1 23-Jul-2013  riastradh sync with HEAD
 1.12.10.1 20-Aug-2014  tls Rebase to HEAD as of a few days ago.
 1.12.4.1 22-May-2014  yamt 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")
 1.10 20-Jul-2023  gutteridge entropy.7: add a missing word to a sentence

While here, bump the date to reflect when substantive changes were last
made.
 1.9 30-Jun-2023  riastradh entropy(9): Reintroduce netbsd<=9 time-delta estimator for unblocking.

The system will (in a subsequent change) by default block for this
condition before almost all of userland is running (including
/etc/rc.d/sshd key generation). That way, a never-blocking
getentropy(3) API will never return any data without at least
best-effort entropy like netbsd<=9 did to applications except in
single-user mode (where you have to be careful about everything
anyway) or in the few processes that run before a seed can even be
loaded (where blocking indefinitely, e.g. when generating a stack
protector cookie in libc, could pose a severe availability problem
that can't be configured away, but where the security impact is low).

However, (in another subsequent change) we will continue to use
_only_ HWRNG driver estimates and seed estimates, and _not_
time-delta estimator, for _warning_ about security in motd, daily
security report, etc. And if HWRNG/seed provides enough entropy
before time-delta estimator does, that will unblock /dev/random too.

The result is:

- Machines with HWRNG or seed won't warn about entropy and will
essentially never block -- even on first boot without a seed, it
will take only as long as the fastest HWRNG to unblock.

- Machines with neither HWRNG nor seed:
. will warn about entropy, giving feedback about security;
and
. will avoid returning anything more predictable than netbsd<=9;
but
. won't block (much) longer than netbsd<=9 would (and won't block
again after blocking once, except with kern.entropy.depletion=1 for
testing).

(The threshold for unblocking is now somewhat higher than before:
512 samples that pass the time-delta estimator, rather than 80 as
it used to be.)

And, of course, adding a seed (or HWRNG) will prevent both warnings
and blocking.

The mechanism is:

1. /dev/random will block until _either_

(a) enough bits of entropy (256) from reliable sources have been
added to the pool, _or_

(b) enough samples have been added from any sources (512), passing
the old time-delta entropy estimator, that the possible
security benefit doesn't justify holding up availability any
longer (`best effort'), except on systems with higher security
requirements like securelevel=2 which can disable non-HWRNG,
non-seed sources with rndctl_flags in rc.conf(5).

2. dmesg will report `entropy: ready' when 1(a) is satisfied, but if
1(b) is satisfied first, it will report `entropy: best effort', so
the concise log messages will reflect the timing and whether in
any period of time any of the system might be relying on best
effort entropy.

3. The sysctl knob kern.entropy.needed (and the ioctl RNDGETPOOLSTAT
variable rndpoolstat_t::added) still reflects the number of bits
of entropy from reliable sources, so we can still use this to
suggest regenerating ssh keys.

This matters on platforms that can only be reached, after flashing
an installation image, by sshing in over a (private) network, like
small network appliances or remote virtual machines without
(interactive) serial consoles. If we blocked indefinitely at boot
when generating ssh keys, such platforms would be unusable. This
way, platforms are usable, but operators can still be advised at
login time to regenerate keys as soon as they can actually load
entropy onto the system, e.g. with rndctl(8) on a seed file copied
from a local machine over the (private) network.

4. On machines without HWRNG, using a seed file still suppresses
warnings for users who need more confident security. But it is no
longer necessary for availability.

This is a compromise between availability and security:

- The security mechanism of blocking indefinitely on machines without
HWRNG hurts availability too much, as painful experience over the
multiple years since I made the mistake of introducing it have
shown. (Sorry!)

- The other main alternative, not having a blocking path at all (as I
pushed for, and as OpenBSD has done for a long time) could
potentially reduce security vs netbsd<=9, and would run against the
expectations set by many popular operating systems to the severe
detriment of public perception of NetBSD security.

Even though we can't _confidently_ assess enough entropy from, e.g.,
sampling interrupt timings, this is the traditional behaviour that
most operating systems provide -- and the result here is a net
nondecrease in security over netbsd<=9, because all paths from the
entropy pool to userland now have at least as high a standard before
returning data as they did in netbsd<=9.

PR kern/55641
PR pkg/55847
PR kern/57185
https://mail-index.netbsd.org/current-users/2020/09/02/msg039470.html
https://mail-index.netbsd.org/current-users/2020/11/21/msg039931.html
https://mail-index.netbsd.org/current-users/2020/12/05/msg040019.html

XXX pullup-10
 1.8 23-Mar-2023  uwe entropy(7): don't use .Nx inside .Ss

These macros don't adapt to context style, so in PostScript output the
.Nx inside .Ss is suddenly in a different font.
 1.7 23-Mar-2023  uwe entropy(7): use .Ql instead of .Sc Li
 1.6 23-Mar-2023  uwe entropy(7): don't try to cram things into one-liners
 1.5 23-Mar-2023  riastradh entropy(7): Omit needless offset for diagnostic listing.
 1.4 20-Mar-2022  riastradh branches: 1.4.2;
entropy(9): Improve entropy warning messages and documentation.

- For the main warning message, use less jargon, say `security', and
cite the entropy(7) man page for further reading. Document this in
rnd(4) and entropy(7).

- For the debug-only warning message, say `entropy' only once and omit
it from the rnd(4) man page -- it's not very important unless you're
debugging the kernel in which case you probably know what you're
doing enough to not need the text explained in the man page.
 1.3 15-Jan-2021  riastradh Clarify that `entropy' may be left unset in rc.conf.
 1.2 13-Jan-2021  riastradh entropy(7): Add missing URL to reference.
 1.1 10-Jan-2021  riastradh Various entropy integration improvements.

- New /etc/security check for entropy in daily security report.

- New /etc/rc.d/entropy script runs (after random_seed and rndctl) to
check for entropy at boot -- in rc.conf, you can:

. set `entropy=check' to halt multiuser boot and enter single-user
mode if not enough entropy

. set `entropy=wait' to make multiuser boot wait until enough entropy

Default is to always boot without waiting -- and rely on other
channels like security report to alert the operator if there's a
problem.

- New man page entropy(7) discussing the higher-level concepts and
system integration with cross-references.

- New paragraph in afterboot(8) about entropy citing entropy(7) for
more details.

This change addresses many of the issues discussed in security/55659.
This is a first draft; happy to take improvements to the man pages and
scripted messages to improve clarity.

I considered changing motd to include an entropy warning with a
reference to the entropy(7) man page, but it's a little trickier:
- Not sure it's appropriate for all users to see at login rather than
users who have power to affect the entropy estimate (maybe it is,
just haven't decided).
- We only have a mechanism for changing once at boot; the message would
remain until next boot even if an operator adds enough entropy.
- The mechanism isn't really conducive to making a message appear
conditionally from boot to boot.
 1.4.2.1 11-Aug-2023  martin Pull up following revision(s) (requested by riastradh in ticket #319):

sys/dev/pci/ubsec.c: revision 1.64
sys/dev/pci/hifn7751.c: revision 1.82
lib/libc/gen/getentropy.3: revision 1.5
lib/libc/gen/getentropy.3: revision 1.6
share/man/man4/rnd.4: revision 1.41
lib/libc/sys/getrandom.2: revision 1.2
lib/libc/sys/getrandom.2: revision 1.3
share/man/man5/rc.conf.5: revision 1.193
share/man/man7/entropy.7: revision 1.5
share/man/man7/entropy.7: revision 1.6
share/man/man7/entropy.7: revision 1.7
share/man/man7/entropy.7: revision 1.8
etc/security: revision 1.130
share/man/man7/entropy.7: revision 1.9
etc/security: revision 1.131
sys/crypto/cprng_fast/cprng_fast.c: revision 1.19
sys/sys/rndio.h: revision 1.3
tests/lib/libc/sys/t_getrandom.c: revision 1.5
etc/defaults/rc.conf: revision 1.164
etc/defaults/rc.conf: revision 1.165
sys/sys/rndsource.h: revision 1.10
sys/kern/kern_entropy.c: revision 1.62
sys/kern/kern_entropy.c: revision 1.63
sys/kern/kern_entropy.c: revision 1.64
sys/kern/subr_cprng.c: revision 1.44
sys/kern/kern_entropy.c: revision 1.65
sys/kern/kern_clock.c: revision 1.149
sys/dev/pci/viornd.c: revision 1.22
share/man/man9/rnd.9: revision 1.32
sys/kern/subr_prf.c: revision 1.202
sys/sys/rndsource.h: revision 1.8
sys/sys/rndsource.h: revision 1.9
share/man/man7/entropy.7: revision 1.10

1. Reinstate netbsd<=9 entropy estimator to unblock /dev/random, in
parallel with assessment of only confident entropy sources (seed,
HWRNG) for security warnings like sshd keys in motd and daily
insecurity report.

2. Make multiuser boot wait for first /dev/random output soon after
loading a seed and configuring rndctl, so that getentropy(3) meets
its contract starting early at boot without introducing blocking
paths that could cause hangs in init(8) or single-user mode.
Operators can choose to disable this wait in rc.conf.

3. Fix some bugs left over from reducing the global entropy lock from
a spin lock at IPL_VM to an adaptive lock at IPL_SOFTSERIAL.

4. Update man pages.
 1.27 27-Jun-2017  kre Document EDITRC
 1.26 25-Feb-2017  abhinav branches: 1.26.4;
Change reference from malloc(3) to jemalloc(3) as the MALLOC_OPTIONS variable
is actually described in jemalloc(3).
 1.25 21-Jan-2011  wiz branches: 1.25.26; 1.25.30;
Add comma in enumeration.
 1.24 21-Jan-2011  roy Describe the new terminfo environment settings.
 1.23 19-Jan-2011  uwe branches: 1.23.2;
Sprinkle some markup.
 1.22 22-Mar-2010  joerg Use .In instead of .Aq Pa for header files.
 1.21 05-Jul-2005  kleink Document LOGNAME; from Pavel Cahyna in PR misc/30671.
 1.20 07-Aug-2003  agc branches: 1.20.4; 1.20.6;
Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.
 1.19 07-Aug-2003  wiz Remove empty line, and use Aq instead of \*[Lt]\*[Gt].
 1.18 20-Jul-2003  lukem add nls(7) environment variables
 1.17 26-May-2003  lukem * Document $RCMD_CMD in environ(7).
* Cross-reference rcmd(1), rcmd(3), and environ(7) as appropriate.

Should fix [bin/21670] from Geoff Wing.
 1.16 02-Apr-2003  wiz Bump date.
 1.15 02-Apr-2003  perry document PAGER
 1.14 12-Jun-2002  wiz Comment out Xref to plot(1), which we don't have.
 1.13 13-Feb-2002  ross Generate <>& symbolically. I'm avoiding .../dist/... directories for now.
 1.12 15-Oct-2001  wiz Whitespace fix.
 1.11 15-Oct-2001  blymn Added TIMEFORMAT entry.
 1.10 03-Jan-2001  lukem add LIBC_DIAGASSERT and MALLOC_OPTIONS
 1.9 28-Mar-2000  enami - Use .Dq instead of hardcoding double quote.
- Sync the value of default PATH environment variable with _DEF_PATH
defined in paths.h.
 1.8 13-Jul-1999  kleink Mention those environment variables related to audio; suggested by Perry.
 1.7 15-Mar-1999  garbled branches: 1.7.2;
First round of .Os cleanups. .Os is defined in the tmac.doc-common file,
so we shouldn't override it with versions in the manpages. Many more to
come.
 1.6 30-Apr-1998  fair fix .Xr references
 1.5 12-Nov-1996  mikel /etc/termcap -> /usr/share/misc/termcap. Fixes misc/1401.
 1.4 03-Jul-1995  jtc fix default path
 1.3 30-Nov-1994  jtc Merged with 4.4lite.
Changed to conform to NetBSD's new RCS Id conventions.
 1.2 01-Aug-1993  mycroft Add RCS indentifiers.
 1.1 21-Mar-1993  cgd branches: 1.1.1;
Initial revision
 1.1.1.2 30-Nov-1994  jtc imported from 4.4lite
 1.1.1.1 21-Mar-1993  cgd initial import of 386bsd-0.1 sources
 1.7.2.1 22-Oct-1999  he Pull up revision 1.8 (requested by dmcmahill):
Document the AUDIODEVICE and AUDIOCTLDEVICE environment variables.
 1.20.6.1 09-Jul-2005  tron Pull up revision 1.21 (requested by kleink in ticket #550):
Document LOGNAME; from Pavel Cahyna in PR misc/30671.
 1.20.4.1 18-Jul-2005  riz Pull up revision 1.21 (requested by kleink in ticket #2069):
Document LOGNAME; from Pavel Cahyna in PR misc/30671.
 1.23.2.1 08-Feb-2011  bouyer Sync with HEAD
 1.25.30.1 21-Apr-2017  bouyer Sync with HEAD
 1.25.26.1 20-Mar-2017  pgoyette Sync with HEAD
 1.26.4.1 23-Jul-2017  snj Pull up following revision(s) (requested by kre in ticket #105):
share/man/man7/environ.7: revision 1.27
Document EDITRC
 1.4 02-Nov-2021  abs Update glob example from X11R6 to X11R7
 1.3 19-Jan-2011  uwe Be consistent in using (fixed width font) literals.
 1.2 19-Jan-2011  uwe Fix PostScript formatting of the character classes table.
 1.1 30-Nov-2010  jruoho Add glob(7).

From OpenBSD. Written by Todd C. Miller.
 1.8 02-Apr-2020  roy branches: 1.8.2;
Add _dhcpcd entries.
 1.7 28-Feb-2020  kim Typo fix (remove extra TPM)
 1.6 28-Feb-2020  kim Fix .Dt to match installed section
 1.5 26-Feb-2020  uwe Minor formatting tweaks.
 1.4 26-Feb-2020  uwe Fix unedited pasto.
 1.3 26-Feb-2020  wiz Minor fixes.
 1.2 26-Feb-2020  wiz Fix Xr section numbers.
 1.1 26-Feb-2020  riastradh Draft man pages for the standard users and groups.

These are currently listed in order of uid because I went through
src/etc/group and src/etc/master.passwd line by line, and sorting any
other way after the fact -- like lexicographically, how it should be
-- was kinda inconvenient.

Feel free to sort, add information, add historical references,
correct any mistakes, &c., so that these remain living documents
describing NetBSD's standard users and groups and practices around
them.
 1.8.2.2 08-Apr-2020  martin Merge changes from current as of 20200406
 1.8.2.1 02-Apr-2020  martin file groups.7 was added on branch phil-wifi on 2020-04-08 14:07:22 +0000
 1.145 26-Aug-2025  mrg add entry for /var/shm.
 1.144 09-May-2025  wiz branches: 1.144.2;
hier(7): mention KERNEL_DIR in /stand section
 1.143 17-Mar-2024  wiz branches: 1.143.2;
hier(7): remove reference to /var/db/pkg

The pkg database lives in ${PREFIX}/pkgdb instead now.

Bump date.
 1.142 10-Oct-2023  riastradh hier(7): Document /usr/share/certs/mozilla.

XXX pullup-10
 1.141 02-Sep-2023  riastradh hier(7): Document /etc/openssl.
 1.140 12-May-2020  leot branches: 1.140.6;
Remove a reference to /etc/netstart

It was removed in rc.d era and no longer honored (except by newbtconf(8)).

Noticed by Ottavio Caruso on #netbsd@Freenode, thanks!
 1.139 04-Apr-2020  jdolecek remove mount_smbfs(8)/nsmb(4) references
 1.138 10-Jan-2020  maya Fix markup typo.
 1.137 10-Jan-2020  maya Add some more licenses appearing in external.
Remove mentions of src/gnu that no longer exists.
Mention /usr/pkg/etc.
Bump date
 1.136 25-Mar-2019  maxv Remove compat_osf1, discussed on tech-kern@.
 1.135 29-Dec-2018  maxv Retire compat_ibcs2, as discussed on tech-kern@. FreeBSD did the same
recently.
 1.134 19-Dec-2018  maxv Remove compat_svr4 and compat_svr4_32, as discussed on tech-kern@ recently,
but also as discussed several times in the past.
 1.133 06-Sep-2018  maxv more netkey->netipsec
 1.132 06-Sep-2018  maxv Replace netkey/ -> netipsec/, everything was moved into netipsec/.
 1.131 06-Sep-2018  maxv Remove the network ATM code.
 1.130 15-Jul-2018  maxv Retire ipkdb entirely. The option was removed from the config files
yesterday.

ok kamil christos
 1.129 01-Mar-2018  snj branches: 1.129.2; 1.129.4;
remove reference to /usr/X11R6
 1.128 24-Jan-2018  skrll Remove port-acorn26

OK core@
 1.127 09-Jan-2018  wiz Use Pa for paths.
 1.126 09-Jan-2018  wiz Remove superfluous Pp.
 1.125 09-Jan-2018  wiz Stop using Tn.
 1.124 09-Jan-2018  christos Merge autofs support from: Tomohiro Kusumi
XXX: Does not work yet
 1.123 03-Jul-2017  wiz Remove workaround for ancient HTML generation code.
 1.122 27-Aug-2016  dholland branches: 1.122.6;
Put some text in pursuant to the rest of PR 48471, about /stand.
 1.121 16-Aug-2016  wiz File system police.
 1.120 16-Aug-2016  dholland More stuff spotted by jnemeth: fix wording for /var/mail, and document
utmpx/wtmpx. While here also document dmesg.boot.
 1.119 16-Aug-2016  dholland Document /etc/login.conf, /etc/profile, /etc/ttyaction.
 1.118 16-Aug-2016  dholland More important fix: there is an /etc/skel but no /usr/share/skel.
 1.117 16-Aug-2016  dholland More improvements from jnemeth
 1.116 16-Aug-2016  dholland Another typo.
 1.115 16-Aug-2016  dholland another typo; spotted by jnemeth
 1.114 16-Aug-2016  dholland typo in previous.
 1.113 16-Aug-2016  dholland Harmfully sentence fragments. Use sentences instead.

I've also made some additional minor edits, and added missing
/usr/src/sys/ufs/{chfs,ext2fs}.
 1.112 15-Aug-2016  maya We don't use mfs for /tmp by default, so the man page shouldn't
suggest this is the typical case.

Because there's so little content in this entry, eliminate the
parentheses around the explanation that /tmp is usually not preserved
across reboots.
 1.111 11-Mar-2016  wiz Fix description of /home

From Vadim Ushakov in PR 50938.
 1.110 25-May-2015  mbalmer Lua 5.1 -> Lua 5.3
From Kamil Rytarowski.
 1.109 31-Mar-2014  martin branches: 1.109.4;
Bring back the playstation2 port - now that a toolchain for it is
available again.
 1.108 24-Feb-2014  skrll Rename NetBSD/hp700 to NetBSD/hppa.

Unfortunately our VCS isn't very helpful here.
 1.107 24-Dec-2013  wiz Bump date for previous.
 1.106 23-Dec-2013  dholland Note the existence of /libdata. PR 48471 from David H. Gutteridge,
with a couple minor adjustments.
 1.105 10-Sep-2013  jnemeth PR/48199 - David H. Gutteridge -- remove some vestiges left over from UUCP removal
 1.104 09-Jul-2013  njoly Fix sendmail section (8 -> 1) in xrefs.
 1.103 14-Mar-2013  njoly Fix dates.
 1.102 01-Mar-2013  joerg Retire OSI network stack. OK core@
 1.101 03-Jun-2012  joerg branches: 1.101.2;
Switch terminfo(3) to cdb(5).
 1.100 21-Apr-2012  roy Add capfile(5) to describe the termcap format.
Adjust various man pages and other documentation to point to capfile(5)
instead of termcap(5).
Remove getcap(3) as curses hasn't been building it for a long time.
Punt wrterm.c as tset no longer uses it.
 1.99 26-Apr-2011  joerg branches: 1.99.4; 1.99.6;
Remove PECOFF/Win32 emulation.
 1.98 01-Apr-2011  jruoho Remove references to UUCP.
 1.97 30-Mar-2011  jruoho Xref paths(3).
 1.96 28-Jan-2011  wiz Bump for emips.
 1.95 27-Jan-2011  pooka plop new emips port into various places it should be plopped in to
 1.94 20-Jan-2011  mbalmer A place for Lua 5.1 modules.
 1.93 20-Dec-2010  njoly branches: 1.93.2;
Fix section, atf(1) -> atf(7).
 1.92 25-Oct-2010  wiz Nit-picks.
 1.91 24-Oct-2010  christos reflect current reality.
 1.90 05-Dec-2009  pooka Remove the portalfs kernel file system driver. Replace mount_portal(8)
with a version based on puffs. User functionality remains the same.
 1.89 05-Dec-2009  pooka Remove support for NetBSD/playstation2.
 1.88 09-Jun-2009  cegger mention both X11R6 and X11R7
requested by mrg@ on source-changes-d
 1.87 09-Jun-2009  cegger X11R6 -> X11R7
ok wiz@
 1.86 18-May-2009  wiz Point to pkg_add(1) instead of non-existing pkg_install(1).
 1.85 09-Apr-2009  joerg Remove physical markup.
 1.84 14-Jan-2009  reed branches: 1.84.2;
Also add cdrom (which is created by sysinst).

And add trailing slash to pts directory (just added a moment ago).
 1.83 14-Jan-2009  reed Add pts, kern, proc mount points.
These are created by sysinst.
(I don't see in mtree spec files either.)
 1.82 12-Nov-2008  ad Remove LKMs and switch to the module framework, pass 1.

Proposed on tech-kern@.
 1.81 22-May-2008  lukem Document src/external.
Per discussion with core.
 1.80 09-Jan-2008  simonb branches: 1.80.4; 1.80.6; 1.80.8;
Remove support for NetBSD/pc532.
 1.79 09-Jan-2008  simonb Remove some old sh5 references.
 1.78 12-Nov-2007  jmmv Add the tests.tgz set

This adds a new tests.tgz set to releases which includes all the tests
for the system. It is important to note that this set does not rely on
comp.tgz: a user of the system can run the tests without having the
development tools installed, which can be useful in a production machine.
 1.77 12-Nov-2007  jmmv Add the libatf library

This adds reachover Makefiles to build the libatf library and enables it in
the parent Makefile.

Things to review in this change:

* Add proper version numbers in the shlib_version files.

* Is libatf properly listed in lib/Makefile? It theoretically needs
libstdc++, but the resulting binary library is not linked against it.
 1.76 17-Oct-2007  garbled Fix a few more misc. pmppc references
 1.75 06-Jan-2007  wiz branches: 1.75.4;
Bump date for previous.

XXX: this needs updating for the sendmail and uucp removals.
 1.74 06-Jan-2007  ober Update to include the new Zaurus port as per new-port checklist.
 1.73 04-Sep-2006  wiz Remove references to netccitt and netns directories. Bump date.
 1.72 02-Sep-2006  wiz Remove /usr/include/netns reference. Bump date.
 1.71 23-Mar-2006  wiz Excise kerberosIV. Bump date.
 1.70 07-Feb-2006  wiz Fix macro. Add /usr/src/common. Bump date.
 1.69 09-Jan-2006  tsutsui - add ews4800mips
- add some missing dirs under sys/arch
(XXX openblocks405 and pdp10 are still missing)
- sync some descriptions with 3.0 announcement

XXX: any reason to keep sys/arch/openblocks405?
 1.68 21-Nov-2004  jmmv Add trailing slashes to some directories missing them.
 1.67 21-Nov-2004  jmmv Add src/sys/fs/ptyfs. Bump date.
 1.66 17-Nov-2004  yamt note about /usr/share/{i18n,locale,nls}
 1.65 14-Oct-2004  snj hparm -> hpcarm.
 1.64 13-Oct-2004  gavan Initial import of iyonix port.

The Iyonix is a desktop machine from Castle Technology, based on a 600MHz
XScale[tm] 80321 processor.

* Uses the bootloader from NetBSD/acorn32, which is now 32-bit compatible.
* Currently boots multiuser with a serial console.
* Device support is not yet complete.

With help from abs.
 1.63 03-Apr-2004  wiz Comment out /amd and /dump, since they are not there in the
default install.
 1.62 13-Feb-2004  snj Gack! Bump date for last.
 1.61 13-Feb-2004  snj Sprinkle a couple of commas and update to reflect x86_64 being renamed to
amd64. Okayed by wiz.
 1.60 29-Jan-2004  wiz Drop trailing space; use Nx instead of NetBSD.
 1.59 27-Jan-2004  agc Might as well put the default location for pkgsrc metadata files in
the right place - /var/db/pkg, not /var/pkg.

Over to you, wiz.
 1.58 07-Aug-2003  agc Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.
 1.57 01-Apr-2003  perry add /etc/kerberosV
 1.56 01-Apr-2003  wiz No dots after last SEE ALSO. Bump date.
 1.55 31-Mar-2003  perry more fixes suggested by Igor Sobrado in PR misc/19609
also a bunch of changes of my own.
also independant->independent
Also 4Kb->4KB (page sizes measured in bytes, not bits)
 1.54 30-Mar-2003  wiz Uppercase MIPS. Igor Sobrado, PR 19678.
 1.53 30-Mar-2003  wiz Uppercase ULTRIX, from Igor Sobrado in PR 19678.
 1.52 30-Mar-2003  perry document /usr/lkm
place /dev/fd and /dev/null into alphabetical order
alphabetize and individually document /etc/master.passwd, /etc/passwd,
/etc/pwd.db, /etc/spwd.db

Partial fix for PR misc/19609 by Igor Sobrado
XXX still need to do a bunch of this PR
XXX it would have been nice if there had been patches supplied.
 1.51 30-Mar-2003  wiz Uppercase VAX. Igor Sobrado in PR 19678.
 1.50 02-Jan-2003  jmmv Add trailing slash to some directories that did not have them (to look like
others in the manpage).
Add missing /libexec/ directory.

Approved by wiz.
 1.49 20-Dec-2002  lukem Remove /usr/local (and children) from the base distribution; we shouldn't
be creating directories or modifying permissions under there.

(/usr/local/* is still retained in various default PATHs, for convenience)
 1.48 19-Dec-2002  lukem Remove /sys -> /usr/src/sys symlink.
 1.47 09-Dec-2002  scw Add evbppc, delete walnut.
 1.46 26-Sep-2002  grant Fix minor formatting bug. From Joerg Klemenz <joerg@gmx.net> in
misc/18428.
 1.45 22-Aug-2002  lukem document /lib and /rescue. other minor tweaks
 1.44 30-May-2002  augustss Add pmppc.
 1.43 24-Mar-2002  bjh21 Move manual pages, man[48].arm26 -> man[48].acorn26.
 1.42 07-Mar-2002  simonb Add entries for evbarm and evbmips.
 1.41 06-Mar-2002  simonb Add entry for sbmips.
 1.40 19-Feb-2002  pooka update sys/arch descriptions closer to reality:
* instead of saying "support for the" for every entry, say it once
* add:
+ algor
+ arm
+ cats
+ cesfic
+ hpcarm
+ sandpoint
+ shark
+ sun2
+ sun68k
+ walnut
+ x86_64
* remove:
+ arm32
 1.39 13-Feb-2002  ross Generate <>& symbolically. I'm avoiding .../dist/... directories for now.
 1.38 21-Jan-2002  wiz Typo in macro.
 1.37 23-Nov-2001  bjh21 Add acorn32.
 1.36 19-Oct-2001  uch add playstation2 port.
 1.35 15-Oct-2001  wiz NetBSD -> .Nx
 1.34 15-Oct-2001  lukem /var/chroot
 1.33 09-Apr-2001  wiz kerberos(8), not (1)
 1.32 19-Jan-2001  enami - add /dev/zero.
- remove sys/vm.
 1.31 18-Jan-2001  itojun add dreamcast and hpcsh
 1.30 08-Nov-2000  lukem minor update of /boot; from simonb
 1.29 08-Nov-2000  lukem update to reality:
- add /boot, /etc/*.conf, /etc/defaults, various bits in /usr/src and /sys,
/var/cron, /var/heimdal, /var/pkg, /var/yp
- remove /etc/disklabels, /usr/src/domestic
 1.28 22-Aug-2000  wdk Add mipsco port
 1.27 14-Jul-2000  fair Correct description of /etc/sliphome/; add a little more introductory
text describing the purpose of the manual page, all per PR 8980.
 1.26 24-Jun-2000  soren Add cobalt and sgimips.
 1.25 04-Jun-2000  itojun branches: 1.25.2;
mention /etc/mail. PR 10273 from roskens@elfin.net.
 1.24 11-May-2000  bjh21 branches: 1.24.2;
Add arm26 port
 1.23 10-Apr-2000  soda remove reference to pica, add a directory sys/arch/arc, pointed out by enami.
 1.22 24-Mar-2000  enami Remove duplicated ``bin'' entry under /usr.
 1.21 06-Mar-2000  enami Remove unnecessary comma at the end of line of SEE ALSO list.
 1.20 05-Jan-2000  itojun add /usr/include/net{inet6,key}.
 1.19 12-Dec-1998  simonb branches: 1.19.2;
Remove specific models numbers from the sys/arch/pmax description.
 1.18 16-Jun-1998  perry Remove a final reference to /usr/src/contrib, to allow us to polish off
PR5599 (from jwise@unicast.com).
 1.17 30-Apr-1998  fair fix .Xr references
 1.16 28-Apr-1998  fair Change occurrences of "UNIX" to .Ux or .At as appropriate.
 1.15 28-Apr-1998  fair Fix mdoc usage: NetBSD -> .Nx
 1.14 02-Apr-1998  hubertf Document pkg, pkgsrc & mk.conf, remove usr/contrib (per PR 5244 by E. Fair)
 1.13 06-Feb-1998  perry macroize BSD, NetBSD, FreeBSD and misc cleanup
 1.12 10-Jan-1998  perry get rid of secretmail residue -- suggested in pr-4568 from Carl Shapiro
 1.11 15-Nov-1997  hubertf xref atalk.4 now as we have it
 1.10 18-Oct-1997  mrg branches: 1.10.2;
update to lite-2; also, update to NetBSD reality, and include our kernel source additions, per the changes in lite-2.
 1.9 06-Oct-1997  hubertf - remove: /usr/include/netimp/, /usr/include/pascal/ /usr/src/kerberosIV/
/usr/src/prgm/
- add: /usr/include/netatalk/ /usr/include/netccitt/ /usr/include/natm/
/usr/share/mk/bsd.README /usr/share/lkm/ /usr/share/nls/
/usr/share/sendmail/ /usr/src/distrib/ /usr/src/domestic/
- add x-ref of ftpd(8) to /var/spool/ftp
 1.8 14-Mar-1997  perry Add a blurb on /usr/mdec.
 1.7 30-Nov-1994  jtc Merged with 4.4lite.
Changed to conform to NetBSD's new RCS Id conventions.
 1.6 09-Jul-1994  mycroft branches: 1.6.2;
Fix description of /usr/share.
 1.5 31-Mar-1994  jtc UUCP config files live in /etc/uucp, not /usr/lib/uucp.
This file needs a lot more work.
 1.4 01-Aug-1993  mycroft Add RCS indentifiers.
 1.3 13-Jun-1993  mycroft Fix up FILES sections.
 1.2 13-Jun-1993  mycroft Update file names.
 1.1 21-Mar-1993  cgd branches: 1.1.1;
Initial revision
 1.1.1.3 17-Oct-1997  mrg 4.4BSD-Lite2
 1.1.1.2 30-Nov-1994  jtc imported from 4.4lite
 1.1.1.1 21-Mar-1993  cgd initial import of 386bsd-0.1 sources
 1.6.2.2 09-Jul-1994  mycroft Fix description of /usr/share.
 1.6.2.1 09-Jul-1994  mycroft file hier.7 was added on branch netbsd-1-0 on 1994-07-09 05:51:14 +0000
 1.10.2.1 18-Nov-1997  mellon Pull rev 1.11 up from trunk (wrstuden)
 1.19.2.1 23-Jul-2000  he Pull up revision 1.27 (requested by fair):
Clarify purpose of manual page, and fix a few other minor problems.
Fixes PR#8980.
 1.24.2.1 22-Jun-2000  minoura Sync w/ netbsd-1-5-base.
 1.25.2.2 26-Apr-2001  he Pull up revision 1.33 (requested by wiz):
Correct kerberos(8) reference.
 1.25.2.1 24-Jun-2000  soren Pull up rev. 1.26:
Add cobalt and sgimips.
 1.75.4.3 23-Mar-2008  matt sync with HEAD
 1.75.4.2 09-Jan-2008  matt sync with HEAD
 1.75.4.1 06-Nov-2007  matt sync with HEAD
 1.80.8.1 23-Jun-2008  wrstuden Sync w/ -current. 34 merge conflicts to follow.
 1.80.6.1 04-Jun-2008  yamt sync with head
 1.80.4.1 02-Jun-2008  mjf Sync with HEAD.
 1.84.2.1 13-May-2009  jym Sync with HEAD.

Third (and last) commit. See http://mail-index.netbsd.org/source-changes/2009/05/13/msg221222.html
 1.93.2.1 08-Feb-2011  bouyer Sync with HEAD
 1.99.6.1 23-Jun-2012  riz Pull up following revision(s) (requested by joerg in ticket #328):
lib/libc/gen/devname.c: revision 1.22
distrib/sparc64/instfs/dot.profile: revision 1.7
distrib/i386/cdroms/install.sh: revision 1.3
tests/lib/libcurses/director/director.c: revision 1.10
lib/libc/include/reentrant.h: revision 1.15
distrib/amd64/cdroms/install.sh: revision 1.3
tests/include/t_paths.c: revision 1.12
share/man/man7/hier.7: revision 1.101
etc/rc.d/sysdb: revision 1.24
include/stdlib.h: revision 1.99
tests/lib/libcurses/Makefile: revision 1.3
distrib/sparc64/cdroms/installcd/install.sh: revision 1.3
distrib/i386/cdroms/Makefile.cdrom: revision 1.27
lib/libc/gen/ttyname.c: revision 1.25
usr.bin/tic/Makefile: revision 1.2
tools/compat/Makefile: revision 1.57
lib/libterminfo/compile.c: revision 1.7
lib/libc/gen/ttyname.c: revision 1.26
lib/libterminfo/compile.c: revision 1.8
tools/compat/Makefile: revision 1.59
tools/compat/cdbw.h: revision 1.1
distrib/i386/installimage/install.sh: revision 1.2
lib/libc/include/namespace.h: revision 1.154
usr.bin/tic/tic.c: revision 1.13
usr.bin/tic/tic.c: revision 1.14
usr.bin/tic/tic.c: revision 1.15
distrib/sets/lists/base/mi: revision 1.996
usr.bin/tic/tic.c: revision 1.16
usr.sbin/dev_mkdb/dev_mkdb.8: revision 1.13
usr.bin/tic/tic.c: revision 1.17
usr.bin/tic/tic.c: revision 1.18
tools/compat/cdbr.h: revision 1.1
distrib/sparc64/instfs/list: revision 1.25
usr.bin/tic/tic.c: revision 1.19
lib/libc/cdb/cdbw.c: revision 1.4
lib/libc/cdb/cdbw.3: revision 1.4
lib/libc/cdb/cdbw.3: revision 1.5
share/terminfo/Makefile: revision 1.3
usr.sbin/dev_mkdb/dev_mkdb.c: revision 1.29
usr.sbin/dev_mkdb/Makefile: revision 1.8
lib/libc/gen/ttyname.3: revision 1.23
lib/libc/gen/ttyname.3: revision 1.24
lib/libc/cdb/cdbr.c: revision 1.3
include/cdbw.h: revision 1.2
distrib/sparc64/cdroms/installcd/Makefile: revision 1.15
lib/libc/gen/devname.3: revision 1.12
tools/compat/compat_defs.h: revision 1.85
tools/compat/compat_defs.h: revision 1.86
lib/libterminfo/term_private.h: revision 1.10
lib/libterminfo/term.c: revision 1.14
usr.bin/tic/tic.1: revision 1.10
lib/libterminfo/term.c: revision 1.15
lib/libterminfo/Makefile.hash: revision 1.5
lib/libterminfo/term.c: revision 1.16
distrib/amd64/installimage/install.sh: revision 1.2
share/man/man5/rc.conf.5: revision 1.152
distrib/sets/lists/tests/mi: revision 1.472
distrib/amd64/cdroms/Makefile.cdrom: revision 1.7
include/paths.h: revision 1.41
bin/ps/ps.1: revision 1.101
lib/libterminfo/terminfo.5.in: revision 1.16
usr.bin/tic/tic.c: revision 1.20
lib/libterminfo/terminfo.5.in: revision 1.17
Prefer __printflike.
Use queue(3)
Replace linear lookup with hash table, reducing runtime by 60%.
Use e* from util.h.
One more strdup -> estrdup.
Maintain nalias and nterm on the fly.
Add void for ttyslot prototype.
Use memcmp in place of strncmp, since length is known to no longer than
either of the arguments.
Fix a number of memory leaks. Keep final loop of the cleanup in tic(1)
under #ifdef __VALGRIND__ though.
Add __predict_true / __predict_false definitions.
Add a special seeder for cdbw_output that gives stable results.
Hook up cdbw(3) for the tool build.
Prototype for cdbw_stable_seeder.
Provide a usable thr_once for !_REENTRANT
Switch device database to cdb(5). Rework ttyname(3) and ttyname_r(3) to
depend on new devname_r(3) as heart. Add /dev/pts magic directly to
devname(3). While it can lead to returning non-existing paths, the
behavior is more consistent that way. Drop caching layer in devname(3),
it doesn't buy anything for the common case of having access to the
database. Teach devname(3) proper fallback behavior of scanning /dev.
Create both old-style and new-style database for now in /etc/rc.d/sysdb.
Switch terminfo(3) to cdb(5).
Fix typos.
Make Alan Barrett happy and add ().
Add cdbr(3) support to tools/compat.
Bump date for previous.
Relax consistency to make it possible to match valid entries.
Prefix devname's buffer with /dev/ as ttyname is supposed to return the
full path. Reported by Dave Huang.
 1.99.4.3 22-May-2014  yamt 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")
 1.99.4.2 30-Oct-2012  yamt sync with head
 1.99.4.1 23-May-2012  yamt sync with head.
 1.101.2.2 20-Aug-2014  tls Rebase to HEAD as of a few days ago.
 1.101.2.1 23-Jun-2013  tls resync from head
 1.109.4.1 21-Aug-2015  snj Pull up following revision(s) (requested by mbalmer in ticket #952):
share/man/man7/hier.7: revision 1.110
Lua 5.1 -> Lua 5.3
From Kamil Rytarowski.
 1.122.6.2 02-Sep-2019  martin Pull up following revision(s) (requested by sevan in ticket #1351):

share/man/man4/man4.amiga/grf.4: revision 1.7
share/man/man4/si.4: revision 1.11
share/man/man8/man8.sparc/boot.8: revision 1.32
share/man/man5/nsswitch.conf.5: revision 1.29
share/man/man5/mixerctl.conf.5: revision 1.7
share/man/man8/man8.vax/boot.8: revision 1.14
share/man/man4/man4.vax/dn.4: revision 1.12
share/man/man8/man8.vax/drtest.8: revision 1.16
share/man/man8/sysinst.8: revision 1.6
share/man/man4/ip.4: revision 1.37
share/man/man5/boot.cfg.5: revision 1.28
share/man/man1/cd.1: revision 1.10
share/man/man4/usb.4: revision 1.106
share/man/man4/man4.vax/ix.4: revision 1.17
share/man/man7/security.7: revision 1.15
share/man/man7/hier.7: revision 1.123
share/man/man8/afterboot.8: revision 1.58
share/man/man1/man1.x68k/bellctrl.1: revision 1.14
share/man/man4/se.4: revision 1.6
share/man/man4/utoppy.4: revision 1.7
share/man/man4/midi.4: revision 1.32
share/man/man4/cfb.4: revision 1.5
share/man/man4/man4.sparc/magma.4: revision 1.12
share/man/man4/audio.4: revision 1.80
share/man/man4/isic.4: revision 1.18
share/man/man1/cd.1: revision 1.7
share/man/man4/envsys.4: revision 1.51
share/man/man1/cd.1: revision 1.8
share/man/man1/cd.1: revision 1.9
share/man/man3/fast_divide32.3: revision 1.9
share/man/man4/pci.4: revision 1.97
share/man/man5/ranlib.5: revision 1.7
share/man/man3/__arraycount.3: revision 1.7
share/man/man4/isa.4: revision 1.46
share/man/man8/man8.atari/ahdilabel.8: revision 1.14
share/man/man4/chipsfb.4: revision 1.6
share/man/man8/man8.macppc/boot.8: revision 1.8
share/man/man5/passwd.5: revision 1.33
share/man/man8/man8.macppc/ofwboot.8: revision 1.14
share/man/man8/compat_linux.8: revision 1.38
share/man/man4/iop.4: revision 1.22
share/man/man4/ddb.4: revision 1.167
share/man/man4/termios.4: revision 1.37
share/man/man8/compat_freebsd.8: revision 1.18
share/man/man5/ar.5: revision 1.9
share/man/man7/release.7: revision 1.37
share/man/man5/core.5: revision 1.31
share/man/man4/ahd.4: revision 1.6
share/man/man4/man4.vax/ad.4: revision 1.12
share/man/man4/pppoe.4: revision 1.39
share/man/man5/locale.alias.5: revision 1.3
share/man/man8/man8.amiga/installboot.8: revision 1.23
share/man/man4/etherip.4: revision 1.8
share/man/man3/queue.3: revision 1.57
share/man/man5/genassym.cf.5: revision 1.13
share/man/man4/mpls.4: revision 1.10
share/man/man1/wait.1: revision 1.5
share/man/man5/capfile.5: revision 1.4
share/man/man4/man4.alpha/ttwopci.4: revision 1.6
share/man/man4/man4.atari/rtc.4: revision 1.8
share/man/man4/gpiosim.4: revision 1.6
share/man/man3/bitstring.3: revision 1.18
share/man/man4/isdntel.4: revision 1.8
share/man/man4/ai.4: revision 1.9
share/man/man8/man8.hppa/boot.8: revision 1.2
share/man/man4/uyurex.4: revision 1.6
share/man/man8/man8.alpha/mkbootimage.8: revision 1.9
share/man/man4/bpf.4: revision 1.56
share/man/man4/man4.amiga/mfcs.4: revision 1.8
share/man/man4/cmpci.4: revision 1.9
share/man/man8/man8.vax/format.8: revision 1.14
share/man/man8/compat_svr4.8: revision 1.27
share/man/man4/crypto.4: revision 1.26
share/man/man4/userconf.4: revision 1.13
share/man/man4/agp.4: revision 1.17
share/man/man9/man9.i386/bioscall.9: revision 1.10
share/man/man4/uftdi.4: revision 1.20
share/man/man4/radio.4: revision 1.13
share/man/man4/mfb.4: revision 1.5
share/man/man7/ascii.7: revision 1.8
share/man/man4/man4.vax/dl.4: revision 1.13
share/man/man4/ral.4: revision 1.12
share/man/man4/unix.4: revision 1.26
share/man/man4/edc.4: revision 1.12
share/man/man4/pim.4: revision 1.5
share/man/man8/compat_ultrix.8: revision 1.21
share/man/man4/dge.4: revision 1.11
share/man/man8/diskless.8: revision 1.32
share/man/man5/passwd.conf.5: revision 1.11
share/man/man8/man8.acorn26/boot26.8: revision 1.8
share/man/man4/man4.vax/hy.4: revision 1.12
share/man/man4/plip.4: revision 1.4
share/man/man4/sc.4: revision 1.8
share/man/man4/ec.4: revision 1.14
share/man/man4/man4.sgimips/giopci.4: revision 1.9
share/man/man7/sysctl.7: revision 1.114
share/man/man3/bits.3: revision 1.18
share/man/man4/we.4: revision 1.19
share/man/man8/compat_sunos.8: revision 1.21
share/man/man4/ip6.4: revision 1.31
share/man/man4/acpilid.4: revision 1.8
share/man/man4/man4.dreamcast/aica.4: revision 1.6
share/man/man4/mfi.4: revision 1.12
share/man/man4/ugen.4: revision 1.32
share/man/man4/jme.4: revision 1.7
share/man/man4/man4.sparc64/intro.4: revision 1.5
share/man/man4/zyd.4: revision 1.5
share/man/man4/gre.4: revision 1.45
share/man/man3/bitmap.3: revision 1.10
share/man/man4/man4.vax/cons.4: revision 1.12
share/man/man3/gcq.3: revision 1.4
share/man/man4/man4.hppa/pdc.4: revision 1.3
share/man/man4/multicast.4: revision 1.8
share/man/man4/man4.sparc/intro.4: revision 1.27
share/man/man4/ath.4: revision 1.32
share/man/man4/ym.4: revision 1.19
share/man/man3/iso646.3: revision 1.6
share/man/man4/btsco.4: revision 1.13
share/man/man4/man4.i386/ndis.4: revision 1.6
share/man/man4/pad.4: revision 1.6
share/man/man4/strip.4: revision 1.16
share/man/man8/man8.x86/boot.8: revision 1.12
share/man/man4/amr.4: revision 1.15
share/man/man4/ieee80211.4: revision 1.5
share/man/man4/options.4: revision 1.467
share/man/man5/link.5: revision 1.24
share/man/man8/man8.cobalt/boot.8: revision 1.10
share/man/man5/stab.5: revision 1.15
share/man/man3/tree.3: revision 1.12
share/man/man4/route.4: revision 1.31
share/man/man4/man4.sun3/leds.4: revision 1.13
share/man/man4/bluetooth.4: revision 1.20
share/man/man4/man4.i386/pcibios.4: revision 1.19
share/man/man5/veriexec.5: revision 1.8
share/man/man7/operator.7: revision 1.12
share/man/man4/man4.hp300/dcl.4: revision 1.13
share/man/man4/man4.i386/intro.4: revision 1.31
share/man/man5/ld.so.conf.5: revision 1.21
share/man/man8/man8.alpha/boot.8: revision 1.16
share/man/man4/bio.4: revision 1.13
share/man/man4/man4.sun2/leds.4: revision 1.10
share/man/man8/man8.x86/mbr.8: revision 1.4
share/man/man8/man8.mvme68k/boot.8: revision 1.9
share/man/man4/man4.alpha/ttwoga.4: revision 1.6
share/man/man4/ahc.4: revision 1.34

Direct reader to shell documentation generally, rather than csh(1)
specifically.

Mention variables OLDPWD and PWD.

Move the text that explains that cd(1) is a shell built-in to the very
beginning of the description where it can be seen prominently.

Improve formatting.

-

Remove workaround for ancient HTML generation code.
Use EXIT STATUS and .Ex.
 1.122.6.1 12-Apr-2018  martin Pull up following revision(s) (requested by snj in ticket #742):

etc/root/dot.profile: revision 1.30
etc/skel/dot.profile: revision 1.10
etc/login.conf: revision 1.7
etc/root/dot.cshrc: revision 1.27
share/man/man7/hier.7: revision 1.129 (patch)
etc/man.conf: revision 1.37
etc/skel/dot.cshrc: revision 1.8

/usr/X11R6 has been empty on most NetBSD installations since 2008,
and the last few straggling ports dumped it in 2015. It's time to
prune references to /usr/X11R6 from our config files.

remove reference to /usr/X11R6
 1.129.4.2 08-Apr-2020  martin Merge changes from current as of 20200406
 1.129.4.1 10-Jun-2019  christos Sync with HEAD
 1.129.2.4 18-Jan-2019  pgoyette Synch with HEAD
 1.129.2.3 26-Dec-2018  pgoyette Sync with HEAD, resolve a few conflicts
 1.129.2.2 30-Sep-2018  pgoyette Ssync with HEAD
 1.129.2.1 28-Jul-2018  pgoyette Sync with HEAD
 1.140.6.2 26-Aug-2025  martin Pull up following revision(s) (requested by kim in ticket #1152):

share/man/man7/hier.7: revision 1.145

add entry for /var/shm.
 1.140.6.1 04-Sep-2023  martin Pull up following revision(s) (requested by riastradh in ticket #343):

external/mpl/mozilla-certdata/dist/certdata.txt: revision 1.1.1.1
external/mpl/mozilla-certdata/share/certs/DigiCert_Assured_ID_Root_G3.pem: revision 1.1
distrib/sets/lists/man/mi: revision 1.1764
external/mpl/mozilla-certdata/share/certs/ACCVRAIZ1.pem: revision 1.1
external/mpl/mozilla-certdata/share/certs/TUBITAK_Kamu_SM_SSL_Kok_Sertifikasi_-_Surum_1.pem: revision 1.1
tests/usr.sbin/certctl/certs4/DigiCert_Global_Root_CA.pem: revision 1.1
external/mpl/mozilla-certdata/share/certs/Sectigo_Public_Server_Authentication_Root_R46.pem: revision 1.1
external/mpl/mozilla-certdata/share/certs/GlobalSign_Secure_Mail_Root_E45.pem: revision 1.1
external/mpl/mozilla-certdata/share/certs/SSL.com_Root_Certification_Authority_ECC.pem: revision 1.1
tests/usr.sbin/certctl/certs3/Autoridad_de_Certificacion_Firmaprofesional_CIF_A62634068.1.pem: revision 1.1
tests/usr.sbin/certctl/certs2/GTS_Root_R1.pem: revision 1.1
external/mpl/mozilla-certdata/share/certs/BJCA_Global_Root_CA1.pem: revision 1.1
external/mpl/mozilla-certdata/share/certs/Izenpe.com.pem: revision 1.1
external/mpl/mozilla-certdata/share/certs/Amazon_Root_CA_2.pem: revision 1.1
tests/usr.sbin/certctl/certs4/Makefile: revision 1.1
external/mpl/mozilla-certdata/share/certs/Global_Chambersign_Root_-_2008.pem: revision 1.1
distrib/sets/lists/etc/mi: revision 1.272
external/mpl/mozilla-certdata/share/certs/ISRG_Root_X1.pem: revision 1.1
external/mpl/mozilla-certdata/share/certs/TunTrust_Root_CA.pem: revision 1.1
external/mpl/mozilla-certdata/share/certs/D-TRUST_BR_Root_CA_1_2020.pem: revision 1.1
external/mpl/mozilla-certdata/share/certs/SSL.com_Root_Certification_Authority_RSA.pem: revision 1.1
external/mpl/mozilla-certdata/share/certs/Certum_EC-384_CA.pem: revision 1.1
external/mpl/mozilla-certdata/share/certs/Security_Communication_RootCA3.pem: revision 1.1
external/mpl/mozilla-certdata/share/certs/IdenTrust_Public_Sector_Root_CA_1.pem: revision 1.1
external/mpl/mozilla-certdata/share/certs/Entrust_Root_Certification_Authority_-_EC1.pem: revision 1.1
external/mpl/mozilla-certdata/share/certs/DigiCert_Global_Root_G2.pem: revision 1.1
external/mpl/mozilla-certdata/share/certs/GlobalSign_Root_CA.pem: revision 1.1
external/mpl/mozilla-certdata/share/certs/SZAFIR_ROOT_CA2.pem: revision 1.1
tests/usr.sbin/certctl/t_certctl.sh: revision 1.1
external/mpl/mozilla-certdata/share/certs/UCA_Global_G2_Root.pem: revision 1.1
external/mpl/mozilla-certdata/share/certs/HARICA_Client_ECC_Root_CA_2021.pem: revision 1.1
external/mpl/mozilla-certdata/share/certs/COMODO_ECC_Certification_Authority.pem: revision 1.1
tests/usr.sbin/certctl/t_certctl.sh: revision 1.2
tests/usr.sbin/certctl/certs1/DigiCert_Global_Root_CA.pem: revision 1.1
tests/usr.sbin/certctl/t_certctl.sh: revision 1.3
external/mpl/mozilla-certdata/Makefile: revision 1.1
external/mpl/mozilla-certdata/share/certs/DIGITALSIGN_GLOBAL_ROOT_RSA_CA.pem: revision 1.1
external/mpl/mozilla-certdata/share/certs/GTS_Root_R2.pem: revision 1.1
usr.sbin/certctl/certctl.sh: revision 1.1
tests/usr.sbin/certctl/t_certctl.sh: revision 1.4
external/mpl/mozilla-certdata/share/certs/Verisign_Class_1_Public_Primary_Certification_Authority_-_G3.pem: revision 1.1
external/mpl/mozilla-certdata/share/certs/SwissSign_Silver_CA_-_G2.pem: revision 1.1
external/mpl/mozilla-certdata/share/certs/Starfield_Class_2_CA.pem: revision 1.1
usr.sbin/certctl/certctl.sh: revision 1.2
tests/usr.sbin/certctl/t_certctl.sh: revision 1.5
usr.sbin/certctl/certctl.sh: revision 1.3
tests/usr.sbin/certctl/t_certctl.sh: revision 1.6
usr.sbin/certctl/certctl.sh: revision 1.4
tests/usr.sbin/certctl/t_certctl.sh: revision 1.7
external/mpl/mozilla-certdata/share/certs/Hellenic_Academic_and_Research_Institutions_RootCA_2015.pem: revision 1.1
tests/usr.sbin/certctl/t_certctl.sh: revision 1.8
external/mpl/mozilla-certdata/share/certs/Sectigo_Public_Server_Authentication_Root_E46.pem: revision 1.1
external/mpl/mozilla-certdata/share/certs/Hongkong_Post_Root_CA_3.pem: revision 1.1
external/mpl/mozilla-certdata/share/certs/Entrust_Root_Certification_Authority_-_G4.pem: revision 1.1
external/mpl/mozilla-certdata/share/certs/Security_Communication_Root_CA.pem: revision 1.1
external/mpl/mozilla-certdata/share/certs/Go_Daddy_Root_Certificate_Authority_-_G2.pem: revision 1.1
external/mpl/mozilla-certdata/share/certs/ANF_Secure_Server_Root_CA.pem: revision 1.1
external/mpl/mozilla-certdata/share/certs/Symantec_Class_1_Public_Primary_Certification_Authority_-_G6.pem: revision 1.1
external/mpl/mozilla-certdata/share/certs/Chambers_of_Commerce_Root_-_2008.pem: revision 1.1
external/mpl/mozilla-certdata/share/certs/Go_Daddy_Class_2_CA.pem: revision 1.1
external/mpl/mozilla-certdata/share/certs/USERTrust_RSA_Certification_Authority.pem: revision 1.1
external/mpl/mozilla-certdata/share/certs/Trustwave_Global_ECC_P384_Certification_Authority.pem: revision 1.1
external/mpl/mozilla-certdata/share/certdata.awk: revision 1.1
external/mpl/mozilla-certdata/share/certs/HARICA_TLS_ECC_Root_CA_2021.pem: revision 1.1
external/mpl/mozilla-certdata/share/certs/Atos_TrustedRoot_Root_CA_ECC_G2_2020.pem: revision 1.1
external/mpl/mozilla-certdata/share/certs/Sectigo_Public_Email_Protection_Root_R46.pem: revision 1.1
external/mpl/mozilla-certdata/share/certs/TrustCor_ECA-1.pem: revision 1.1
external/mpl/mozilla-certdata/share/certs/GlobalSign_ECC_Root_CA_-_R5.pem: revision 1.1
external/mpl/mozilla-certdata/share/certs/SSL.com_TLS_ECC_Root_CA_2022.pem: revision 1.1
usr.sbin/Makefile: revision 1.292
external/mpl/mozilla-certdata/share/certs/AffirmTrust_Premium.pem: revision 1.1
external/mpl/mozilla-certdata/share/certs/CA_Disig_Root_R2.pem: revision 1.1
external/mpl/mozilla-certdata/share/certs/emSign_Root_CA_-_C1.pem: revision 1.1
external/mpl/mozilla-certdata/share/certs/GlobalSign_Root_CA_-_R6.pem: revision 1.1
external/mpl/mozilla-certdata/share/certs/DigiCert_Trusted_Root_G4.pem: revision 1.1
external/mpl/mozilla-certdata/share/certs/Atos_TrustedRoot_Root_CA_RSA_G2_2020.pem: revision 1.1
external/mpl/mozilla-certdata/share/certs/vTrus_Root_CA.pem: revision 1.1
external/mpl/mozilla-certdata/share/certs/T-TeleSec_GlobalRoot_Class_2.pem: revision 1.1
external/mpl/mozilla-certdata/share/certs/GlobalSign_Root_R46.pem: revision 1.1
external/mpl/mozilla-certdata/share/certs/TrustCor_RootCert_CA-2.pem: revision 1.1
etc/mtree/special: revision 1.176
external/mpl/mozilla-certdata/share/certs/USERTrust_ECC_Certification_Authority.pem: revision 1.1
etc/mtree/special: revision 1.177
etc/mtree/special: revision 1.178
external/mpl/mozilla-certdata/share/certs/AffirmTrust_Premium_ECC.pem: revision 1.1
external/mpl/mozilla-certdata/share/certs/vTrus_ECC_Root_CA.pem: revision 1.1
external/mpl/mozilla-certdata/share/certs/DigiCert_TLS_ECC_P384_Root_G5.pem: revision 1.1
external/mpl/mozilla-certdata/share/certs/NAVER_Global_Root_Certification_Authority.pem: revision 1.1
external/mpl/mozilla-certdata/share/server.trust: revision 1.1
external/mpl/mozilla-certdata/share/certs/SecureTrust_CA.pem: revision 1.1
external/mpl/mozilla-certdata/share/code.trust: revision 1.1
external/mpl/mozilla-certdata/share/certs/SSL.com_TLS_RSA_Root_CA_2022.pem: revision 1.1
external/mpl/mozilla-certdata/share/certs/Amazon_Root_CA_4.pem: revision 1.1
external/mpl/mozilla-certdata/share/certs/DigiCert_TLS_RSA4096_Root_G5.pem: revision 1.1
external/mpl/mozilla-certdata/share/certs/DigiCert_Assured_ID_Root_G2.pem: revision 1.1
tests/usr.sbin/certctl/certs1/Makefile: revision 1.1
external/mpl/mozilla-certdata/share/certs/Sectigo_Public_Email_Protection_Root_E46.pem: revision 1.1
external/mpl/mozilla-certdata/share/certs/TWCA_Global_Root_CA.pem: revision 1.1
external/mpl/mozilla-certdata/share/certs/DigiCert_SMIME_RSA4096_Root_G5.pem: revision 1.1
external/mpl/mozilla-certdata/share/certs/Hellenic_Academic_and_Research_Institutions_ECC_RootCA_2015.pem: revision 1.1
external/mpl/mozilla-certdata/share/certs/SSL.com_Client_ECC_Root_CA_2022.pem: revision 1.1
share/man/man7/hier.7: revision 1.141
external/mpl/mozilla-certdata/share/certs/Certigna.pem: revision 1.1
external/mpl/mozilla-certdata/share/certs/certSIGN_Root_CA_G2.pem: revision 1.1
external/mpl/mozilla-certdata/share/certs/Certigna_Root_CA.pem: revision 1.1
external/mpl/mozilla-certdata/share/certs/Amazon_Root_CA_1.pem: revision 1.1
external/mpl/mozilla-certdata/share/certs/Entrust.net_Premium_2048_Secure_Server_CA.pem: revision 1.1
external/mpl/mozilla-certdata/share/certs/GTS_Root_R4.pem: revision 1.1
external/mpl/mozilla-certdata/share/certs/T-TeleSec_GlobalRoot_Class_3.pem: revision 1.1
external/mpl/mozilla-certdata/share/certs/Autoridad_de_Certificacion_Firmaprofesional_CIF_A62634068.pem: revision 1.1
external/mpl/mozilla-certdata/share/certs/Telia_Root_CA_v2.pem: revision 1.1
external/mpl/mozilla-certdata/share/certs/QuoVadis_Root_CA_3_G3.pem: revision 1.1
external/mpl/mozilla-certdata/share/certs/emSign_ECC_Root_CA_-_G3.pem: revision 1.1
external/mpl/mozilla-certdata/share/certs/Security_Communication_RootCA2.pem: revision 1.1
external/mpl/mozilla-certdata/share/certs/TWCA_Root_Certification_Authority.pem: revision 1.1
external/mpl/mozilla-certdata/share/certs/Buypass_Class_2_Root_CA.pem: revision 1.1
external/mpl/mozilla-certdata/share/certs/emSign_ECC_Root_CA_-_C3.pem: revision 1.1
external/mpl/mozilla-certdata/share/certs/SSL.com_EV_Root_Certification_Authority_RSA_R2.pem: revision 1.1
external/mpl/mozilla-certdata/share/certs/GTS_Root_R1.pem: revision 1.1
external/mpl/mozilla-certdata/share/certs/SSL.com_Client_RSA_Root_CA_2022.pem: revision 1.1
external/mpl/mozilla-certdata/share/certs/DigiCert_Assured_ID_Root_CA.pem: revision 1.1
external/mpl/mozilla-certdata/share/certs/HiPKI_Root_CA_-_G1.pem: revision 1.1
external/mpl/mozilla-certdata/share/certs/Starfield_Root_Certificate_Authority_-_G2.pem: revision 1.1
external/mpl/mozilla-certdata/share/certs/SwissSign_Gold_CA_-_G2.pem: revision 1.1
external/mpl/mozilla-certdata/share/certs/OISTE_WISeKey_Global_Root_GB_CA.pem: revision 1.1
external/mpl/mozilla-certdata/share/certs/AffirmTrust_Networking.pem: revision 1.1
external/mpl/mozilla-certdata/share/certs/Autoridad_de_Certificacion_Firmaprofesional_CIF_A62634068.1.pem: revision 1.1
tests/usr.sbin/certctl/Makefile.inc: revision 1.1
external/mpl/mozilla-certdata/share/certs/COMODO_RSA_Certification_Authority.pem: revision 1.1
external/mpl/mozilla-certdata/share/certs/Certum_Trusted_Network_CA_2.pem: revision 1.1
tests/usr.sbin/certctl/certs2/GlobalSign_Root_CA_-_R3.pem: revision 1.1
external/mpl/mozilla-certdata/share/certs/OISTE_WISeKey_Global_Root_GC_CA.pem: revision 1.1
external/mpl/mozilla-certdata/share/certs/D-TRUST_Root_Class_3_CA_2_EV_2009.pem: revision 1.1
external/mpl/mozilla-certdata/share/certs/AffirmTrust_Commercial.pem: revision 1.1
external/mpl/mozilla-certdata/share/certs/Buypass_Class_3_Root_CA.pem: revision 1.1
distrib/sets/lists/tests/mi: revision 1.1292
external/mpl/mozilla-certdata/share/certs/UCA_Extended_Validation_Root.pem: revision 1.1
external/mpl/mozilla-certdata/share/certs/Trustwave_Global_ECC_P256_Certification_Authority.pem: revision 1.1
external/mpl/mozilla-certdata/share/certs/Certum_Trusted_Network_CA.pem: revision 1.1
external/mpl/mozilla-certdata/share/certs/QuoVadis_Root_CA_2.pem: revision 1.1
external/mpl/mozilla-certdata/share/email.trust: revision 1.1
external/mpl/mozilla-certdata/share/certs/Atos_TrustedRoot_2011.pem: revision 1.1
external/mpl/mozilla-certdata/share/certs/Certum_Trusted_Root_CA.pem: revision 1.1
external/mpl/mozilla-certdata/share/certs/D-TRUST_EV_Root_CA_1_2020.pem: revision 1.1
external/mpl/mozilla-certdata/share/certs/ePKI_Root_Certification_Authority.pem: revision 1.1
external/mpl/mozilla-certdata/share/certs/DIGITALSIGN_GLOBAL_ROOT_ECDSA_CA.pem: revision 1.1
external/mpl/mozilla-certdata/share/certs/GlobalSign_ECC_Root_CA_-_R4.pem: revision 1.1
tests/usr.sbin/certctl/certs2/Makefile: revision 1.1
tests/usr.sbin/Makefile: revision 1.8
external/mpl/mozilla-certdata/share/certs/Trustwave_Global_Certification_Authority.pem: revision 1.1
tests/usr.sbin/certctl/Makefile: revision 1.1
external/mpl/mozilla-certdata/share/certs/Verisign_Class_2_Public_Primary_Certification_Authority_-_G3.pem: revision 1.1
external/mpl/mozilla-certdata/share/certs/IdenTrust_Commercial_Root_CA_1.pem: revision 1.1
external/mpl/mozilla-certdata/share/certs/DigiCert_SMIME_ECC_P384_Root_G5.pem: revision 1.1
tests/usr.sbin/certctl/certs1/Explicitly_Distrust_DigiNotar_Root_CA.pem: revision 1.1
external/mpl/mozilla-certdata/share/certs/TrustCor_RootCert_CA-1.pem: revision 1.1
external/mpl/mozilla-certdata/share/certs/Staat_der_Nederlanden_Root_CA_-_G3.pem: revision 1.1
external/mpl/mozilla-certdata/share/certs/Symantec_Class_2_Public_Primary_Certification_Authority_-_G6.pem: revision 1.1
external/mpl/mozilla-certdata/share/certs/QuoVadis_Root_CA_3.pem: revision 1.1
external/mpl/mozilla-certdata/share/Makefile: revision 1.1
external/mpl/mozilla-certdata/share/Makefile: revision 1.2
external/mpl/mozilla-certdata/share/certs/Microsec_e-Szigno_Root_CA_2009.pem: revision 1.1
external/mpl/mozilla-certdata/share/certs/BJCA_Global_Root_CA2.pem: revision 1.1
external/mpl/mozilla-certdata/share/certs/HARICA_Client_RSA_Root_CA_2021.pem: revision 1.1
external/mpl/mozilla-certdata/share/certs/GDCA_TrustAUTH_R5_ROOT.pem: revision 1.1
external/mpl/mozilla-certdata/share/certs/Amazon_Root_CA_3.pem: revision 1.1
tests/usr.sbin/certctl/certs4/AC_RAIZ_FNMT-RCM.pem: revision 1.1
external/mpl/mozilla-certdata/share/certs/ISRG_Root_X2.pem: revision 1.1
external/mpl/mozilla-certdata/share/certs/DigiCert_Global_Root_CA.pem: revision 1.1
external/mpl/mozilla-certdata/share/certs/D-TRUST_Root_CA_3_2013.pem: revision 1.1
external/mpl/mozilla-certdata/share/certs/Microsoft_RSA_Root_Certificate_Authority_2017.pem: revision 1.1
etc/mtree/NetBSD.dist.base: revision 1.252
external/mpl/mozilla-certdata/share/certs/CFCA_EV_ROOT.pem: revision 1.1
etc/mtree/NetBSD.dist.base: revision 1.253
external/mpl/mozilla-certdata/share/certs/Starfield_Services_Root_Certificate_Authority_-_G2.pem: revision 1.1
external/mpl/mozilla-certdata/share/certs/DigiCert_Global_Root_G3.pem: revision 1.1
external/mpl/mozilla-certdata/share/certs/emSign_Root_CA_-_G1.pem: revision 1.1
external/mpl/mozilla-certdata/share/certs/Microsoft_ECC_Root_Certificate_Authority_2017.pem: revision 1.1
external/mpl/mozilla-certdata/share/certs/Explicitly_Distrust_DigiNotar_Root_CA.pem: revision 1.1
usr.sbin/certctl/Makefile: revision 1.1
external/mpl/mozilla-certdata/share/certs/Security_Communication_ECC_RootCA1.pem: revision 1.1
usr.sbin/certctl/Makefile: revision 1.2
usr.sbin/certctl/Makefile: revision 1.3
external/mpl/mozilla-certdata/share/certs/GTS_Root_R3.pem: revision 1.1
external/mpl/mozilla-certdata/share/certs/AC_RAIZ_FNMT-RCM_SERVIDORES_SEGUROS.pem: revision 1.1
external/mpl/mozilla-certdata/share/certs/e-Szigno_Root_CA_2017.pem: revision 1.1
external/mpl/mozilla-certdata/share/certs/certSIGN_ROOT_CA.pem: revision 1.1
doc/3RDPARTY: revision 1.1949
external/mpl/mozilla-certdata/share/certs/Certainly_Root_R1.pem: revision 1.1
external/mpl/mozilla-certdata/share/certs/TeliaSonera_Root_CA_v1.pem: revision 1.1
external/mpl/mozilla-certdata/share/certs/HARICA_TLS_RSA_Root_CA_2021.pem: revision 1.1
external/mpl/mozilla-certdata/share/certs/Entrust_Root_Certification_Authority.pem: revision 1.1
external/mpl/mozilla-certdata/share/certs/NetLock_Arany_Class_Gold.pem: revision 1.1
usr.sbin/postinstall/postinstall.in: revision 1.53
usr.sbin/postinstall/postinstall.in: revision 1.54
tests/usr.sbin/certctl/certs3/Autoridad_de_Certificacion_Firmaprofesional_CIF_A62634068.pem: revision 1.1
etc/Makefile: revision 1.467
usr.sbin/postinstall/postinstall.in: revision 1.55
tests/usr.sbin/certctl/certs3/Makefile: revision 1.1
external/mpl/mozilla-certdata/share/certs/GLOBALTRUST_2020.pem: revision 1.1
etc/mtree/NetBSD.dist.tests: revision 1.200
external/mpl/mozilla-certdata/share/certs/QuoVadis_Root_CA_1_G3.pem: revision 1.1
external/mpl/mozilla-certdata/share/certs/GlobalSign_Root_CA_-_R3.pem: revision 1.1
external/mpl/mozilla-certdata/share/certs/Actalis_Authentication_Root_CA.pem: revision 1.1
distrib/sets/lists/base/mi: revision 1.1326
distrib/sets/lists/base/mi: revision 1.1327
external/mpl/mozilla-certdata/share/certs/SecureSign_RootCA11.pem: revision 1.1
distrib/sets/lists/base/mi: revision 1.1328
external/mpl/mozilla-certdata/share/certs/Comodo_AAA_Services_root.pem: revision 1.1
external/mpl/mozilla-certdata/share/certs/Entrust_Root_Certification_Authority_-_G2.pem: revision 1.1
external/mpl/mozilla-certdata/share/certs/QuoVadis_Root_CA_2_G3.pem: revision 1.1
distrib/sets/lists/base/mi: revision 1.1329
external/mpl/mozilla-certdata/share/certs/COMODO_Certification_Authority.pem: revision 1.1
external/mpl/mozilla-certdata/share/certs/Certum_Root_CA.pem: revision 1.1
external/mpl/mozilla-certdata/share/certs/DigiCert_High_Assurance_EV_Root_CA.pem: revision 1.1
external/mpl/mozilla-certdata/share/certs/GlobalSign_Secure_Mail_Root_R45.pem: revision 1.1
external/mpl/mozilla-certdata/share/certs/Secure_Global_CA.pem: revision 1.1
usr.sbin/certctl/certctl.8: revision 1.1
external/mpl/mozilla-certdata/share/certs/XRamp_Global_CA_Root.pem: revision 1.1
external/mpl/Makefile: revision 1.5
usr.sbin/certctl/certctl.8: revision 1.2
external/mpl/mozilla-certdata/share/certs/D-TRUST_Root_Class_3_CA_2_2009.pem: revision 1.1
external/mpl/mozilla-certdata/share/certs/Baltimore_CyberTrust_Root.pem: revision 1.1
usr.sbin/certctl/certs.conf: revision 1.1
external/mpl/mozilla-certdata/share/certs/LAWtrust_Root_CA2_4096.pem: revision 1.1
external/mpl/mozilla-certdata/share/certs/AC_RAIZ_FNMT-RCM.pem: revision 1.1
external/mpl/mozilla-certdata/share/certs/Atos_TrustedRoot_Root_CA_ECC_TLS_2021.pem: revision 1.1
external/mpl/mozilla-certdata/share/certs/OISTE_WISeKey_Global_Root_GA_CA.pem: revision 1.1
external/mpl/mozilla-certdata/share/certs/Certainly_Root_E1.pem: revision 1.1
external/mpl/mozilla-certdata/share/certs/GlobalSign_Root_E46.pem: revision 1.1
external/mpl/mozilla-certdata/share/certs/Atos_TrustedRoot_Root_CA_RSA_TLS_2021.pem: revision 1.1
external/mpl/mozilla-certdata/share/certs/SSL.com_EV_Root_Certification_Authority_ECC.pem: revision 1.1

certctl(8): New tool for managing OpenSSL CA certificates.
Same command-line syntax as FreeBSD, clearer semantics about which
parts are config and which parts are cache.

mozilla-certdata: Record in doc/3RDPARTY.

mozilla-certdata: Makefile infrastructure.

mozilla-certdata: regen
(actually, just `gen', this first time)

mozilla-certdata: Connect it up to the build.

postinstall(8): Add opensslcerts item to regen /etc/openssl/certs.

Works only with destdir /, since it relies on running openssl(1),
which is not available as a tool or required in the cross-build
environment.

certctl(8): Add xfail test for missing certs.conf.

Command should fail, i.e., exit with nonzero status, but it exits
with zero instead.
certctl(8): Exit nonzero on missing certs.conf.
certctl(8): Test prepopulated /etc/openssl/certs.

This is the scenario when you have previously populated
/etc/openssl/certs manually, or with a package like mozilla-rootcerts
or mozilla-rootcerts-openssl, and you update to a version of NetBSD
with certctl(8). In this case, certctl(8) should avoid destroying
your work.

While here, also test some related but less likely edge cases:
- nonexistent
- symlink
- regular file

certctl(8): Avoid clobbering prepopulated /etc/openssl/certs.

Also avoid clobbering some other edge cases like symlinks or
non-directories there.

This way, we have the following transitions on system updates:
- If /etc/openssl/certs is empty (as in default NetBSD<10 installs):
quietly populated on rehash.
- If /etc/openssl/certs is nonempty (you've added things to it,
e.g. by hand or with mozilla-rootcerts) and has never been managed
by certctl(8): left alone on rehash, with an error message to
explain what you need to do.
- If /etc/openssl/certs has been managed by certctl(8): quietly
updated on rehash.

Note: This means current installations made since certctl(8) was
added will be treated like /etc/openssl/certs is nonempty and has
never been managed by certctl(8). To work around this, you can just
delete /etc/openssl/certs and rerun `certctl rehash'.
postinstall(8): Fail if `certctl rehash' fails.

Not using `set -e' here, evidently (maybe we should), so the separate
return 0 suppressed the error.
distrib/sets/lists: certs.conf belongs in etc, not in base.
Oops.

certctl(8): Set certs.conf 644 and add it to etc/mtree/special.
Now that we have /etc/openssl/certs.conf mentioned here, also
list /etc/openssl.

hier(7): Document /etc/openssl.

certctl(8): Minor man page clarifications.
- Specify exactly what /etc/openssl/certs gets populated with.
- Change HTTPS to TLS.
- Specify the permitted character class in certs.conf.
(Maybe more conservative than strictly needed; but let's stay on
the safe side.)

certctl(8): Fix some bugs with evil pathnames.

certctl(8): Fix quoting and whitespace style in evilpath test.

No functional change intended.

etc/mtree/special: Fix spaces/tabs.
No functional change intended.

mozilla-certdata: Install relative symlinks.
Slightly more compact this way, and you can examine them in a destdir
without chrooting. Not terribly important, but a minor convenience.

certctl(8): Test more evil pathnames.

certctl(8): Install certs.conf in /usr/share/examples too.
This way postinstall(8) can refer to the default one when you've done
an upgrade without etcupdate or similar to pull in new config files
from etc.tgz.

Not great -- we should do this systematically for all config files in
/etc, but this one-off hack is less risky for 10.
postinstall(8): Handle various certs.conf scenarios gracefully.

Tested the following scenarios:
1. fresh install
empty /etc/openssl/certs
default /etc/openssl/certs.conf
- opensslcertsconf
[x] check: pass
[x] fix: pass -- nothing
- opensslcertsrehash
[x] check: fail -- needs rehash
[x] fix: pass -- quietly rehash successfully (go to 4)
2. fresh upgrade
empty /etc/openssl/certs
no /etc/openssl/certs.conf
- opensslcertsconf
[x] check: fail -- complain missing /etc/openssl/certs.conf
[x] fix: pass -- install default /etc/openssl/certs.conf (go to 1)
- opensslcertsrehash
[x] check: fail -- complain missing /etc/openssl/certs.conf
- [x] fix: fail -- complain missing /etc/openssl/certs.conf
3. upgrade from certctl, changes to certs
certctl-managed /etc/openssl/certs
default /etc/openssl/certs.conf
- opensslcertsconf
[x] check: pass
[x] fix: pass -- nothing
- opensslcertsrehash
[x] check: fail -- needs rehash
[x] fix: pass -- quietly rehash successfully (go to 4)
4. upgrade from certctl, no changes to certs
certctl-managed /etc/openssl/certs
default /etc/openssl/certs.conf
- opensslcertsconf
[x] check: pass
[x] fix: pass -- nothing
- opensslcertsrehash
[x] check: pass
[x] fix: pass -- quietly rehash successfully (go to 4)
5. upgrade from mozilla-rootcerts
populated /etc/openssl/certs
no /etc/openssl/certs.conf
- opensslcertsconf:
[x] check: fail -- complain missing /etc/openssl/certs.conf
[x] fix: pass -- install manual /etc/openssl/certs.conf (go to 7)
- opensslcertsrehash:
[x] check: fail -- complain missing /etc/openssl/certs.conf
[x] fix: fail -- complain missing /etc/openssl/certs.conf
6. upgrade from mozilla-rootcerts with etcupdate naively
populated /etc/openssl/certs
default /etc/openssl/certs.conf
- opensslcertsconf:
[x] check: pass
[x] fix: pass -- nothing
- opensslcertsrehash:
[x] check: fail -- complain mismatched certs/ and certs.conf
[x] fix: fail -- complain mismatched certs/ and certs.conf
7. upgrade from mozilla-rootcerts with etcupdate manually
populated /etc/openssl/certs
manual /etc/openssl/certs.conf
- opensslcertsconf:
[x] check: pass
[x] fix: pass -- nothing
- opensslcertsrehash:
[x] check: pass
[x] fix: pass -- skip rehash because manual (go to 7)

XXX Someone should draft automatic tests for postinstall. It has a
very good track record, but it sure would be nice to automate this
testing rather than redo it each time I make a tiny change.
 1.143.2.1 02-Aug-2025  perseant Sync with HEAD
 1.144.2.1 26-Aug-2025  martin Pull up following revision(s) (requested by kim in ticket #17):

share/man/man7/hier.7: revision 1.145

add entry for /var/shm.
 1.13 29-Mar-2012  wiz Replace references to resolver(5) with ones to resolv.conf(5).

From patch by Bug Hunting.
 1.12 22-Mar-2012  wiz Fix whitespace nits. Suggested by Bug Hunting.
 1.11 29-Sep-2010  wiz branches: 1.11.6;
Remove trailing whitespace; new sentence, new line; fix xref.
 1.10 29-Sep-2010  christos new from libbind
 1.9 07-Aug-2003  agc Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.
 1.8 24-Mar-2000  enami Fix .Nm usage.
 1.7 15-Mar-1999  garbled First round of .Os cleanups. .Os is defined in the tmac.doc-common file,
so we shouldn't override it with versions in the manpages. Many more to
come.
 1.6 06-Feb-1998  perry macroize BSD, NetBSD, FreeBSD and misc cleanup
 1.5 11-Nov-1996  lukem fix the the typos
 1.4 30-Nov-1994  jtc Merged with 4.4lite.
Changed to conform to NetBSD's new RCS Id conventions.
 1.3 24-Mar-1994  deraadt reference resolv.conf(5) instead of resolver(5)
 1.2 01-Aug-1993  mycroft Add RCS indentifiers.
 1.1 21-Mar-1993  cgd branches: 1.1.1;
Initial revision
 1.1.1.2 30-Nov-1994  jtc imported from 4.4lite
 1.1.1.1 21-Mar-1993  cgd initial import of 386bsd-0.1 sources
 1.11.6.1 17-Apr-2012  yamt sync with head
 1.29 01-May-2021  nia intro.7: add missing entries
 1.28 26-Feb-2020  wiz Minor fixes.
 1.27 26-Feb-2020  riastradh Draft man pages for the standard users and groups.

These are currently listed in order of uid because I went through
src/etc/group and src/etc/master.passwd line by line, and sorting any
other way after the fact -- like lexicographically, how it should be
-- was kinda inconvenient.

Feel free to sort, add information, add historical references,
correct any mistakes, &c., so that these remain living documents
describing NetBSD's standard users and groups and practices around
them.
 1.26 28-May-2018  nat branches: 1.26.2;
Move the audio specification to section 9 under audio_system.

Ok wiz@
 1.25 15-May-2018  wiz Remove Tn.
 1.24 15-May-2018  nat Update the introduction page to section 7 of the manual noting the audio
spec.
 1.23 01-Jul-2012  christos branches: 1.23.24; 1.23.30;
bump date
 1.22 01-Jul-2012  perry forgot the "7"...
 1.21 01-Jul-2012  perry Add reference to rfc6056.7
 1.20 18-Mar-2011  jruoho branches: 1.20.4;
Note also tests(7).
 1.19 18-Mar-2011  jruoho Move security(8) to the section 7. Discussed on source-changes a while back.
Should address PR # 35718 at least partially.
 1.18 14-Dec-2010  jruoho By majority vote, move module(4) to the section 7.
 1.17 30-Nov-2010  jruoho Update.
 1.16 23-Mar-2010  jruoho General update.
 1.15 10-Jun-2005  wiz NetBSD -> .Nx.
 1.14 07-May-2005  perry update for script(7) man page
update date
 1.13 30-Jan-2004  wiz Bump date for previous; use more macros.
 1.12 30-Jan-2004  christos mention sticky.
 1.11 07-Aug-2003  agc Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.
 1.10 30-Dec-2001  kim Fix typo.
 1.9 22-May-2000  jhawk Resync list with reality:
comment out nonexistant pages (eqnchar, man, me, ms, term)
add missing ones (hostname, mdoc, mdoc.samples, operator, release, signal,
symlink)
 1.8 24-Mar-2000  enami Fix .Nm usage.
 1.7 15-Mar-1999  garbled First round of .Os cleanups. .Os is defined in the tmac.doc-common file,
so we shouldn't override it with versions in the manpages. Many more to
come.
 1.6 22-Apr-1998  mrg convert unknown .Ds/.De sequence into a normal list.
 1.5 22-Apr-1998  ross Add David Brownlee's new intro pages, with editing. (PR #534[23])
Also, while here, expand apparently incorrectly .Dd month abbreviations.
(I thought about doing this in tmac/doc-common...heh...that would have
allowed a possible reverse map back to abbreviations.)
 1.4 06-Feb-1998  perry macroize BSD, NetBSD, FreeBSD and misc cleanup
 1.3 30-Nov-1994  jtc Merged with 4.4lite.
Changed to conform to NetBSD's new RCS Id conventions.
 1.2 01-Aug-1993  mycroft Add RCS indentifiers.
 1.1 21-Mar-1993  cgd branches: 1.1.1;
Initial revision
 1.1.1.2 30-Nov-1994  jtc imported from 4.4lite
 1.1.1.1 21-Mar-1993  cgd initial import of 386bsd-0.1 sources
 1.20.4.1 30-Oct-2012  yamt sync with head
 1.23.30.2 25-Jun-2018  pgoyette Sync with HEAD
 1.23.30.1 21-May-2018  pgoyette Sync with HEAD
 1.23.24.2 07-Jun-2018  martin Pull up following revision(s) (requested by nat in ticket #848):

share/man/man9/Makefile: revision 1.422
distrib/sets/lists/comp/mi: revision 1.2198
share/man/man7/Makefile: revision 1.33
share/man/man9/audio.9: revision 1.47
share/man/man7/audio.7: file removal
sys/dev/audio.c: revision 1.456
sys/dev/audio.c: revision 1.457
distrib/sets/lists/man/mi: revision 1.1591
share/man/man9/intro.9: revision 1.20
share/man/man7/audio.7: revision 1.3
share/man/man9/audio_system.9: revision 1.1
share/man/man7/intro.7: revision 1.26
share/man/man4/audio.4: revision 1.86

Fix a typo with sc_out/inports when setting the hardware recording gain on the
mix ring. Found by mrg@
XXX pullup-8

Using audioctl without the -p switch defaults to the mix ring. This allows
setting the hardware gain etc.

Update the audio spec in audio.7 to reflect these changes.
Addresses PR kern/52781.

Move the audio specification to section 9 under audio_system.
Ok wiz@
 1.23.24.1 15-May-2018  martin Pull up following revision(s) (requested by nat in ticket #825):

share/man/man7/Makefile: revision 1.32
share/man/man9/audio.9: revision 1.46
sys/dev/audio.c: revision 1.453
sys/dev/audio.c: revision 1.454
sys/dev/audio.c: revision 1.455
share/man/man7/audio.7: revision 1.1
share/man/man7/audio.7: revision 1.2
share/man/man7/intro.7: revision 1.24
share/man/man4/audio.4: revision 1.85
distrib/sets/lists/man/mi: revision 1.1586

Fix numbering of vchan mixer controls to correspond to the vchan number in
use.

This makes the numbering of vchans consistient for audioctl and mixerctl.
Expose the audio_info structure of vchan zero(0) the mix ring to allow
setting the hardware gain and balance via audioctl(1) using the -p 0
switch.

It is not possible to influence the hardware gain/blance from the
audio_info structure of vchans 1 onwards. It is now possible to return
the audio mixers audio format from the audio_info structure of vchan 0 to
ease applications configuring for mmapped play back.

This is conformant to the audio specification posted on tech-kern see:

"NetBSD Audio Specification 2018"

or audio.7 manual page to be added in a follow up commit.
Add the audio mixer specification to section 7 of the manual.
See posting on tech-kern - "NetBSD Audio Specification 2018."
Update the introduction page to section 7 of the manual noting the audio
spec.

Various improvements, more markup, typo fixes.

Fix over cautious compiler error - setmode may not be initialized.
 1.26.2.1 08-Apr-2020  martin Merge changes from current as of 20200406
 1.6 12-Jul-2020  skrll Note arm KUBSAN support
 1.5 12-Jul-2020  maxv fix inaccuracy about kmsan
 1.4 10-Jul-2020  skrll Add support for KASAN on ARMv[67]

Thanks to maxv for many pointers and reviews.
 1.3 30-Jun-2020  maxv fix file path
 1.2 24-Jun-2020  wiz New sentence, new line. Fix macro arguments. Improve Nd.
Remove superfluous Pp. Other minor cleanups.
 1.1 23-Jun-2020  maxv kernel_sanitizers.7
 1.14 01-Mar-2010  jruoho Remove dead references to sendmail(8).
 1.13 07-Sep-2003  wiz Consistently use 'RFC 1234' instead of 'RFC1234' or 'RFC-1234'.
From jmc@openbsd.
 1.12 07-Aug-2003  agc Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.
 1.11 04-Jan-2003  wiz existance -> existence (PR 19655); start new sentences on new lines while here.
 1.10 11-Sep-2001  wiz Drop superfluous .Pp's, punctuation fixes, improve citation.
 1.9 11-Sep-2001  wiz Boring whitespace fixes.
 1.8 24-Mar-2000  enami Fix .Nm usage.
 1.7 15-Mar-1999  garbled First round of .Os cleanups. .Os is defined in the tmac.doc-common file,
so we shouldn't override it with versions in the manpages. Many more to
come.
 1.6 17-Jun-1998  perry Update for the late '90s, largely by chopping out obsolete sections.
 1.5 06-Feb-1998  perry macroize BSD, NetBSD, FreeBSD and misc cleanup
 1.4 08-Mar-1997  mouse alternate -> alternative, per PR 2643
 1.3 30-Nov-1994  jtc Merged with 4.4lite.
Changed to conform to NetBSD's new RCS Id conventions.
 1.2 01-Aug-1993  mycroft Add RCS indentifiers.
 1.1 21-Mar-1993  cgd branches: 1.1.1;
Initial revision
 1.1.1.2 30-Nov-1994  jtc imported from 4.4lite
 1.1.1.1 21-Mar-1993  cgd initial import of 386bsd-0.1 sources
 1.30 06-Aug-2013  soren Build orphaned man pages.
 1.29 31-Dec-2003  bjh21 branches: 1.29.56; 1.29.62;
Missing apostrophe. ("authors discretion" -> "author's discretion").
 1.28 07-Aug-2003  agc Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.
 1.27 30-Apr-2003  dsl Straight not strait
 1.26 16-Apr-2003  wiz Document .In, based on the documentation in groff-1.18.1.
Noted missing by perry.
 1.25 11-Apr-2003  jdc Add .Ft.
Remove Fortran only note from .Vt.
From a discussion with Thomas Klausner.
 1.24 13-Feb-2002  ross Generate <>& symbolically. I'm avoiding .../dist/... directories for now.
 1.23 21-Jan-2002  wiz Sort two macros.
 1.22 09-Apr-2001  wiz add sections to xrefs.
 1.21 21-Mar-2001  fair Comment out CONFIGURATION section which refers to a README file that is not
installed in the system (but is in our source repository), per PR 10992
 1.20 24-Sep-2000  kleink Document LIBRARY and Lb.
 1.19 21-Sep-2000  ad - Document Bsx macro.
- Fx, Nx and Ox appear to be parsed and callable.
 1.18 31-Aug-2000  jhawk Correct errors in examples under "MANUAL AND GENERAL TEXT DOMAIN MACROS"
 1.17 28-Aug-2000  kleink Document an ``EXIT STATUS'' section appropriate for section one and eight
commands and utilities.
 1.16 11-Jul-2000  ad Document Ox macro.
 1.15 19-Nov-1999  enami branches: 1.15.4;
List .Nd macro as manual domain macros.
 1.14 30-Aug-1999  ross branches: 1.14.4;
Document .Fl.
 1.13 23-Aug-1999  ross Improve .Ns description, document the barely-useful .Ap macro.
 1.12 31-Mar-1999  ross branches: 1.12.2;
Add -unfilled.
 1.11 28-Oct-1998  ross Correct error: .Fd is _not_ parsed and is _not_ callable.
 1.10 21-Oct-1998  ross The -width attribute for the standard -tag list (.Bl -tag -width EWOULDBLOCK)
is not really optional, and bizarre things will happen if it is left out.
 1.9 08-Jun-1998  lukem Implement a new manual page category ``SECURITY CONSIDERATIONS''
(suggested by mycroft)
 1.8 06-Feb-1998  perry macroize BSD, NetBSD, FreeBSD and misc cleanup
 1.7 27-Nov-1997  mikel .It is not parsed, so spell out Bx and Ux
 1.6 23-Nov-1997  lukem document .Bl options -column, -dash, -hyphen
 1.5 03-Jun-1997  mikel branches: 1.5.2;
fix some paste-os and other minor problems.
 1.4 06-Mar-1997  mikel fix .Nx description
 1.3 15-Oct-1996  perry document Nx (NetBSD) macro
 1.2 30-Nov-1994  jtc Merged with 4.4lite.
Changed to conform to NetBSD's new RCS Id conventions.
 1.1 30-Nov-1994  jtc branches: 1.1.1;
Initial revision
 1.1.1.2 17-Oct-1997  mrg 4.4BSD-Lite2
 1.1.1.1 30-Nov-1994  jtc imported from 4.4lite
 1.5.2.1 27-Nov-1997  mellon Pull rev 1.6 and 1.7 up from trunk (mikel)
 1.12.2.1 01-Apr-2001  he Pull up revision 1.21 (requested by fair):
Remove reference to nonexistent file. Fixes PR#10992.
 1.14.4.1 27-Dec-1999  wrstuden Pull up to last week's -current.
 1.15.4.2 26-Apr-2001  he Pull up revision 1.22 (requested by wiz):
Add section numbers for cross references.
 1.15.4.1 22-Mar-2001  he Pull up revision 1.21 (requested by fair):
Remove reference to non-installed README file. Fixes PR#10992.
 1.29.62.1 20-Aug-2014  tls Rebase to HEAD as of a few days ago.
 1.29.56.1 22-May-2014  yamt 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")
 1.46 06-Aug-2013  soren Build orphaned man pages.
 1.45 22-Mar-2010  joerg branches: 1.45.6; 1.45.12;
- Use .Li for head line in .Bl too.
- Do not use headers as example for .Aq, they should be marked up with
.In
- Drop the use of .Xo/.Xc
- Make sure to quote .Sh as argument to .Bl. groff warns about the list
otherwise and the size computation was off anyway as the string is
used as literal later.
 1.44 09-Mar-2009  wiz Fix order in preamble.
 1.43 09-Mar-2009  joerg Examples should be correct, so fix the order of the preamble to follow
the rules set in mdoc(7).
 1.42 20-Jun-2005  peter branches: 1.42.28; 1.42.30;
Change all .Xr config 8 to .Xr config 1, following the recent move of
config from usr.sbin -> usr.bin.

Reviewed by wiz.
 1.41 04-Oct-2004  rumble Removed accidental repetitious words.
 1.40 07-Aug-2003  agc Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.
 1.39 16-Apr-2003  wiz Document .In, based on the documentation in groff-1.18.1.
Noted missing by perry.
 1.38 04-Apr-2003  wiz Note that Dd argument specifies last major change to man page.
Fixes PR 9705.
 1.37 25-Feb-2003  wiz .Nm does not need a dummy argument ("") before punctuation or
for correct formatting of the SYNOPSIS any longer.
 1.36 12-Feb-2003  wiz New sentence, new line. Document it as policy.
[Compare the output of this man page before and after this change to see the
effects.]
 1.35 06-Jan-2003  wiz Grammar fixes from jmc@prioris.mini.pw.edu via openbsd.
 1.34 04-Jan-2003  wiz Fix some typos, partly from Igor Sobrado in PR 19656.
 1.33 10-Feb-2002  ross fix isolated collateral damage from <>& churn
 1.32 12-Jan-2002  wiz Sync mentioned section headers with mdoc.template; update descriptions of
.Os and .Dt arguments to current practice; don't hardwire NetBSD version
name (was still at 1.4...).
 1.31 08-Jul-2001  blymn Fixed Fo/Fc example, the one given did not format correctly when
used.
 1.30 06-May-2001  wiz Lots of formatting fixes by John Franklin in misc/10078, and some of my own.
 1.29 24-Sep-2000  kleink Document LIBRARY and Lb.
 1.28 21-Sep-2000  ad - Document Bsx and Ox macros.
- Add some missing TOC entries.
 1.27 27-May-2000  mycroft Mention section 9.
 1.26 19-Jan-2000  enami branches: 1.26.2;
Sort SEE ALSO list as described in this manual.
 1.25 08-Jan-2000  tron Fix for several typos supplied by Richard Rauch in PR misc/9145.
 1.24 28-Dec-1999  mjl Fix typos, as noted by Christian Weisgerber in OpenBSD PR/1030.
 1.23 26-Nov-1999  lukem fix typo
 1.22 18-Nov-1999  kristerw Fixed typos (from OpenBSD)
 1.21 23-Aug-1999  ross branches: 1.21.4;
Improve .Ns description, document the barely-useful .Ap macro.
 1.20 31-Mar-1999  ross There was no mention of .Bd -unfilled, the -ragged description was bogus,
(actually, it described -unfilled) and there are six displays, not five.
 1.19 12-Jan-1999  ross Instead of claiming that nested displays work, note that they are prohibited.
Adjust the note permitting list nesting to note that -enum lists can't be.
 1.18 11-Jan-1999  garbled Since we are "NetBSD" and not "BSD Experimental", update the definition
of .Os to reflect reality.
Also document the new AT&T laziness macros.
 1.17 21-Oct-1998  ross The -width attribute for the standard -tag list (.Bl -tag -width EWOULDBLOCK)
is not really optional, and bizarre things will happen if it is left out.
 1.16 05-Feb-1998  perry note that .Dd directives should NOT have the date quoted
 1.15 03-Feb-1998  perry more section 9 changes, plus change UNIX to NetBSD in appropriate spots
 1.14 03-Feb-1998  perry change to reflect that we now have a section 9 of the manual
 1.13 24-Nov-1997  lukem note that SEE ALSO is sorted on section number, then name within section
 1.12 24-Nov-1997  lukem document .Bl -column, and the bug if the first .Bl doesn't have -width
 1.11 24-Nov-1997  lukem fix .Nx usage (use 1.0 instead of 0.9a, etc), and other minor cleanups
 1.10 28-Oct-1997  mikel correct template file name; from Marshall M. Midden <m4@umn.edu> in
OpenBSD PR 336.
 1.9 16-Sep-1997  lukem branches: 1.9.2;
document `` .Nm "" , '' support
 1.8 07-Jun-1997  lukem fix an internal cross reference to "extended arguments"
 1.7 15-Oct-1996  perry document Nx (NetBSD) macro
 1.6 11-Oct-1996  explorer Add a missing quote ; closes pr misc/2832
 1.5 03-Apr-1996  jtc Fix path to mdoc template; From Masanobu Saitoh in PR #2293
 1.4 30-Nov-1994  jtc Merged with 4.4lite.
Changed to conform to NetBSD's new RCS Id conventions.
 1.3 01-Aug-1993  mycroft Add RCS indentifiers.
 1.2 22-Jul-1993  jtc Fixed spelling error: mdoc.sample -> mdoc.samples
Added RCS Header.
 1.1 21-Mar-1993  cgd branches: 1.1.1;
Initial revision
 1.1.1.3 17-Oct-1997  mrg 4.4BSD-Lite2
 1.1.1.2 30-Nov-1994  jtc imported from 4.4lite
 1.1.1.1 21-Mar-1993  cgd initial import of 386bsd-0.1 sources
 1.9.2.1 28-Oct-1997  mellon Pull rev 1.10 up from trunk (mikel)
 1.21.4.1 27-Dec-1999  wrstuden Pull up to last week's -current.
 1.26.2.1 22-Jun-2000  minoura Sync w/ netbsd-1-5-base.
 1.42.30.1 13-May-2009  jym Sync with HEAD.

Third (and last) commit. See http://mail-index.netbsd.org/source-changes/2009/05/13/msg221222.html
 1.42.28.1 15-Mar-2009  snj Pull up following revision(s) (requested by joerg in ticket #559):
share/man/man7/mdoc.samples.7: revision 1.43
Examples should be correct, so fix the order of the preamble to follow
the rules set in mdoc(7).
 1.45.12.1 20-Aug-2014  tls Rebase to HEAD as of a few days ago.
 1.45.6.1 22-May-2014  yamt 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")
 1.9 13-Jul-2020  pgoyette Imnprove previous.
 1.8 13-Jul-2020  jruoho Complete the example.
 1.7 31-Aug-2017  wiz Revert probably unintentional case changes from previous.
Remove superfluous Tn.
 1.6 31-Aug-2017  pgoyette Add a note that some external software is available only via loadable
modules due to licensing concerns.

Also add an additional example of how to build modules only, using
build.sh
 1.5 22-Sep-2015  wiz Bump date for previous.
 1.4 22-Sep-2015  pgoyette Tweaks from Michael McConville - thanks!
 1.3 30-Jun-2011  wiz dependant -> dependent
 1.2 14-Dec-2010  pgoyette Per private email (to myself and core@), cgd has agreed

I'm happy to assign all copyright to this file, ...

So replace original 4-clause cgd with a 2-clause NetBSD.
 1.1 14-Dec-2010  jruoho By majority vote, move module(4) to the section 7.
 1.15 09-Apr-2009  joerg Use semantic markup.
 1.14 30-Apr-2008  martin branches: 1.14.6;
Convert TNF licenses to new 2 clause variant
 1.13 02-Mar-2007  wiz branches: 1.13.10; 1.13.12;
Use more markup. Fix a typo. Bump date for previous.
 1.12 21-Feb-2007  gmcgarry Use correct terminology for UTF.
 1.11 26-Jun-2003  wiz More fixes.
 1.10 26-Jun-2003  wiz .Bl ... -indent -> .Bl ... -offset indent.
 1.9 18-May-2003  wiz New sentence, new line; fix xrefs; sort SEE ALSO; punctuation nits;
uppercase beginning of sentence; bump date for last two.
 1.8 17-May-2003  gmcgarry Xr xfd(1)
 1.7 17-May-2003  gmcgarry More on fonts. ISO C support.
 1.6 08-May-2003  wiz New sentence, new line.
 1.5 08-May-2003  wiz Bump date for last. Drop trailing whitespace.
 1.4 07-May-2003  gmcgarry Consistently use 'Native Language Support' for NLS. From Jeremy C. Reed.
Also, add table of ISO639 language codes.
 1.3 14-Apr-2003  gmcgarry Remove confusing examples.
 1.2 12-Feb-2003  wiz New sentence, new line; use .Ev to mark up environment variables;
use .Dq for double-quoted words; drop trailing white space.
 1.1 12-Feb-2003  gmcgarry Some NLS discussion.
 1.13.12.1 18-May-2008  yamt sync with head.
 1.13.10.1 02-Jun-2008  mjf Sync with HEAD.
 1.14.6.1 13-May-2009  jym Sync with HEAD.

Third (and last) commit. See http://mail-index.netbsd.org/source-changes/2009/05/13/msg221222.html
 1.12 03-Jul-2017  wiz Remove workaround for ancient HTML generation code.
 1.11 18-Jan-2011  uwe branches: 1.11.38;
Bring over improvements from FreeBSD.

List all of the assignment operators explicitly, for those who have
been traumatized by perl.

Add C++ operators (from Christoph Mallon <christoph.mallon@gmx.de>)

Markup improvements to make PostScript output pretty.

Bring back FILES section now that /usr/share/misc/operator is
resurrected.
 1.10 17-Jan-2011  jruoho Remove /usr/share/misc/operator.
 1.9 16-Dec-2010  wiz Sort sections
 1.8 16-Dec-2010  jruoho Xref iso646(3).
 1.7 09-Apr-2009  joerg Don't use an indented display with a single list in it.
When using two columns, declare them indepently.
 1.6 07-Aug-2003  agc branches: 1.6.42;
Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.
 1.5 13-Feb-2002  ross Generate <>& symbolically. I'm avoiding .../dist/... directories for now.
 1.4 01-Jun-1999  chopps s,order of evaluation,associativity, they aren't the same thing
 1.3 30-Nov-1994  jtc Merged with 4.4lite.
Changed to conform to NetBSD's new RCS Id conventions.
 1.2 01-Aug-1993  mycroft Add RCS indentifiers.
 1.1 21-Mar-1993  cgd branches: 1.1.1;
Initial revision
 1.1.1.2 30-Nov-1994  jtc imported from 4.4lite
 1.1.1.1 21-Mar-1993  cgd initial import of 386bsd-0.1 sources
 1.6.42.1 13-May-2009  jym Sync with HEAD.

Third (and last) commit. See http://mail-index.netbsd.org/source-changes/2009/05/13/msg221222.html
 1.11.38.1 02-Sep-2019  martin Pull up following revision(s) (requested by sevan in ticket #1351):

share/man/man4/man4.amiga/grf.4: revision 1.7
share/man/man4/si.4: revision 1.11
share/man/man8/man8.sparc/boot.8: revision 1.32
share/man/man5/nsswitch.conf.5: revision 1.29
share/man/man5/mixerctl.conf.5: revision 1.7
share/man/man8/man8.vax/boot.8: revision 1.14
share/man/man4/man4.vax/dn.4: revision 1.12
share/man/man8/man8.vax/drtest.8: revision 1.16
share/man/man8/sysinst.8: revision 1.6
share/man/man4/ip.4: revision 1.37
share/man/man5/boot.cfg.5: revision 1.28
share/man/man1/cd.1: revision 1.10
share/man/man4/usb.4: revision 1.106
share/man/man4/man4.vax/ix.4: revision 1.17
share/man/man7/security.7: revision 1.15
share/man/man7/hier.7: revision 1.123
share/man/man8/afterboot.8: revision 1.58
share/man/man1/man1.x68k/bellctrl.1: revision 1.14
share/man/man4/se.4: revision 1.6
share/man/man4/utoppy.4: revision 1.7
share/man/man4/midi.4: revision 1.32
share/man/man4/cfb.4: revision 1.5
share/man/man4/man4.sparc/magma.4: revision 1.12
share/man/man4/audio.4: revision 1.80
share/man/man4/isic.4: revision 1.18
share/man/man1/cd.1: revision 1.7
share/man/man4/envsys.4: revision 1.51
share/man/man1/cd.1: revision 1.8
share/man/man1/cd.1: revision 1.9
share/man/man3/fast_divide32.3: revision 1.9
share/man/man4/pci.4: revision 1.97
share/man/man5/ranlib.5: revision 1.7
share/man/man3/__arraycount.3: revision 1.7
share/man/man4/isa.4: revision 1.46
share/man/man8/man8.atari/ahdilabel.8: revision 1.14
share/man/man4/chipsfb.4: revision 1.6
share/man/man8/man8.macppc/boot.8: revision 1.8
share/man/man5/passwd.5: revision 1.33
share/man/man8/man8.macppc/ofwboot.8: revision 1.14
share/man/man8/compat_linux.8: revision 1.38
share/man/man4/iop.4: revision 1.22
share/man/man4/ddb.4: revision 1.167
share/man/man4/termios.4: revision 1.37
share/man/man8/compat_freebsd.8: revision 1.18
share/man/man5/ar.5: revision 1.9
share/man/man7/release.7: revision 1.37
share/man/man5/core.5: revision 1.31
share/man/man4/ahd.4: revision 1.6
share/man/man4/man4.vax/ad.4: revision 1.12
share/man/man4/pppoe.4: revision 1.39
share/man/man5/locale.alias.5: revision 1.3
share/man/man8/man8.amiga/installboot.8: revision 1.23
share/man/man4/etherip.4: revision 1.8
share/man/man3/queue.3: revision 1.57
share/man/man5/genassym.cf.5: revision 1.13
share/man/man4/mpls.4: revision 1.10
share/man/man1/wait.1: revision 1.5
share/man/man5/capfile.5: revision 1.4
share/man/man4/man4.alpha/ttwopci.4: revision 1.6
share/man/man4/man4.atari/rtc.4: revision 1.8
share/man/man4/gpiosim.4: revision 1.6
share/man/man3/bitstring.3: revision 1.18
share/man/man4/isdntel.4: revision 1.8
share/man/man4/ai.4: revision 1.9
share/man/man8/man8.hppa/boot.8: revision 1.2
share/man/man4/uyurex.4: revision 1.6
share/man/man8/man8.alpha/mkbootimage.8: revision 1.9
share/man/man4/bpf.4: revision 1.56
share/man/man4/man4.amiga/mfcs.4: revision 1.8
share/man/man4/cmpci.4: revision 1.9
share/man/man8/man8.vax/format.8: revision 1.14
share/man/man8/compat_svr4.8: revision 1.27
share/man/man4/crypto.4: revision 1.26
share/man/man4/userconf.4: revision 1.13
share/man/man4/agp.4: revision 1.17
share/man/man9/man9.i386/bioscall.9: revision 1.10
share/man/man4/uftdi.4: revision 1.20
share/man/man4/radio.4: revision 1.13
share/man/man4/mfb.4: revision 1.5
share/man/man7/ascii.7: revision 1.8
share/man/man4/man4.vax/dl.4: revision 1.13
share/man/man4/ral.4: revision 1.12
share/man/man4/unix.4: revision 1.26
share/man/man4/edc.4: revision 1.12
share/man/man4/pim.4: revision 1.5
share/man/man8/compat_ultrix.8: revision 1.21
share/man/man4/dge.4: revision 1.11
share/man/man8/diskless.8: revision 1.32
share/man/man5/passwd.conf.5: revision 1.11
share/man/man8/man8.acorn26/boot26.8: revision 1.8
share/man/man4/man4.vax/hy.4: revision 1.12
share/man/man4/plip.4: revision 1.4
share/man/man4/sc.4: revision 1.8
share/man/man4/ec.4: revision 1.14
share/man/man4/man4.sgimips/giopci.4: revision 1.9
share/man/man7/sysctl.7: revision 1.114
share/man/man3/bits.3: revision 1.18
share/man/man4/we.4: revision 1.19
share/man/man8/compat_sunos.8: revision 1.21
share/man/man4/ip6.4: revision 1.31
share/man/man4/acpilid.4: revision 1.8
share/man/man4/man4.dreamcast/aica.4: revision 1.6
share/man/man4/mfi.4: revision 1.12
share/man/man4/ugen.4: revision 1.32
share/man/man4/jme.4: revision 1.7
share/man/man4/man4.sparc64/intro.4: revision 1.5
share/man/man4/zyd.4: revision 1.5
share/man/man4/gre.4: revision 1.45
share/man/man3/bitmap.3: revision 1.10
share/man/man4/man4.vax/cons.4: revision 1.12
share/man/man3/gcq.3: revision 1.4
share/man/man4/man4.hppa/pdc.4: revision 1.3
share/man/man4/multicast.4: revision 1.8
share/man/man4/man4.sparc/intro.4: revision 1.27
share/man/man4/ath.4: revision 1.32
share/man/man4/ym.4: revision 1.19
share/man/man3/iso646.3: revision 1.6
share/man/man4/btsco.4: revision 1.13
share/man/man4/man4.i386/ndis.4: revision 1.6
share/man/man4/pad.4: revision 1.6
share/man/man4/strip.4: revision 1.16
share/man/man8/man8.x86/boot.8: revision 1.12
share/man/man4/amr.4: revision 1.15
share/man/man4/ieee80211.4: revision 1.5
share/man/man4/options.4: revision 1.467
share/man/man5/link.5: revision 1.24
share/man/man8/man8.cobalt/boot.8: revision 1.10
share/man/man5/stab.5: revision 1.15
share/man/man3/tree.3: revision 1.12
share/man/man4/route.4: revision 1.31
share/man/man4/man4.sun3/leds.4: revision 1.13
share/man/man4/bluetooth.4: revision 1.20
share/man/man4/man4.i386/pcibios.4: revision 1.19
share/man/man5/veriexec.5: revision 1.8
share/man/man7/operator.7: revision 1.12
share/man/man4/man4.hp300/dcl.4: revision 1.13
share/man/man4/man4.i386/intro.4: revision 1.31
share/man/man5/ld.so.conf.5: revision 1.21
share/man/man8/man8.alpha/boot.8: revision 1.16
share/man/man4/bio.4: revision 1.13
share/man/man4/man4.sun2/leds.4: revision 1.10
share/man/man8/man8.x86/mbr.8: revision 1.4
share/man/man8/man8.mvme68k/boot.8: revision 1.9
share/man/man4/man4.alpha/ttwoga.4: revision 1.6
share/man/man4/ahc.4: revision 1.34

Direct reader to shell documentation generally, rather than csh(1)
specifically.

Mention variables OLDPWD and PWD.

Move the text that explains that cd(1) is a shell built-in to the very
beginning of the description where it can be seen prominently.

Improve formatting.

-

Remove workaround for ancient HTML generation code.
Use EXIT STATUS and .Ex.
 1.7 19-Nov-2022  jakllsch Extend orders(7) with prefixes from Resolution 3 of the 27th meeting of CGPM.
 1.6 06-Aug-2011  jruoho Note also common bit rates.
 1.5 14-Dec-2010  jruoho Fix small format error. Noted by pgoyette@.
 1.4 14-Dec-2010  jruoho Reference strsuftoll(3) and orders(7) with each other.
 1.3 14-Dec-2010  wiz Sort SECTIONS, fix xref.
 1.2 14-Dec-2010  jruoho Xref number(1) and units(1).
 1.1 30-Nov-2010  jruoho Add orders(7) as a miscellaneous manual page.
 1.101 02-Mar-2007  wiz packages(7) has (finally!) completely been integrated in the pkgsrc guide,
remove it.
 1.100 02-Mar-2007  wiz Undocument internal MTREE_FILE variable.
 1.99 02-Mar-2007  wiz Undocument unsupported FORCE_PKG_REGISTER.
 1.98 02-Mar-2007  wiz Undocument removed NO_DEPENDS.
 1.97 02-Mar-2007  wiz Undocument obsolete NO_PKG_REGISTER. Bump date.
 1.96 01-Mar-2007  wiz Remove SCRIPTDIR description, update SCRIPTS_ENV description. Bump date.
 1.95 13-Sep-2006  wiz Remove some more stuff that is (now) documented
in the pkgsrc guide.
 1.94 10-Sep-2006  wiz Remove another paragraph that is already in the pkgsrc guide.
 1.93 10-Sep-2006  wiz Remove some variables that are described in the pkgsrc guide.
 1.92 11-Sep-2005  wiz Mention that this man page is obsolete and will die.
 1.91 11-Sep-2005  wiz Remove duplicate MAKE_ENV description. From YOMURA Masanori in private mail.
 1.90 01-Aug-2005  wiz Remove another outdated variable.
 1.89 28-Jul-2005  wiz Remove COMMON VARIABLES section, moved to guide.
 1.88 12-Mar-2005  salo Adjust to The Not-Quite-That-New World Order:

bsd.pkg.defaults.mk -> defaults/mk.conf
Packages.txt -> doc/pkgsrc.txt
 1.87 02-Dec-2004  wiz ALL_TARGET is now called BUILD_TARGET.
XXX: this file should be merged to the pkgsrc guide and removed.
Any takers?
 1.86 14-Jan-2004  wiz New sentence, new line. Some other minor changes.
 1.85 14-Jan-2004  rh Document new RECOMMENDED and IGNORE_RECOMMENDED variables.
 1.84 03-Dec-2003  wiz Use more markup and bump date for previous.
 1.83 03-Dec-2003  erh Document the PKGMAKECONF variable.
 1.82 15-Sep-2003  wiz Bump date for previous; Pa is markup for paths, 0/1/2 do not need
markup (or perhaps use a Bl/El list?).
 1.81 15-Sep-2003  agc Document PKG_DEBUG_LEVEL and its possible values, as requested in PR 22200
 1.80 26-Jul-2003  salo netbsd.org->NetBSD.org
 1.79 26-Jun-2003  wiz Remove superfluous macro.
 1.78 06-May-2003  jmmv Drop trailing whitespace. Reviewed by wiz.
 1.77 07-Apr-2003  wiz More e.g. cleanup. Igor Sobrado, PR 19692.
 1.76 18-Jan-2003  jmmv ... and bump date.
 1.75 18-Jan-2003  jmmv Add information about the "replace" target. This closes my own PR pkg/18014.
Okay'ed by wiz.
 1.74 10-Jan-2003  jschauma Remove documentation of obsolete variables EXTRACT_BEFORE_ARGS and
EXTRACT_AFTER_ARGS.
 1.73 04-Jan-2003  wiz Fix some typos, partly from Igor Sobrado in PR 19656.
 1.72 10-Nov-2002  hubertf Fix some nits around BINPKG_SITE(S)
PR pkg/19005 by tv@pobox.com
 1.71 02-Oct-2002  wiz Fix typo. Spotted by Adrian Mrva.
 1.70 23-Jul-2002  jschauma "pairs of other package this package depends" ->
"pairs of other packages this package depends upon"
 1.69 02-Jul-2002  agc Deprecate IS_INTERACTIVE, and explain INTERACTIVE_STAGE
 1.68 13-Feb-2002  ross Generate <>& symbolically. I'm avoiding .../dist/... directories for now.
 1.67 07-Feb-2002  ross Edit -mdoc usage.

* There is no -indent option to .Bd or .Bl, although you would
never know that from its frequent use in this tree. There is a
"-offset indent" combination that makes sense, and you can certainly
say "-width indent".

* Also, you can't markup the -width option argument, tho you CAN
use a callable macro. So "-width Ar filename" doesn't make sense,
but either "-width Ar" or "-width filename" does, as might something
like "-width xxfilename" for a little extra space.

* There are a lot of needlessly complex hanging tag macros in man4 used
to create simple item lists. Those should be simplified one of these
days before someone copies and edits yet another man4 page.
 1.66 05-Jan-2002  tron Udpate documentation of "UNLIMIT_RESOURCES" for new format.
 1.65 04-Jan-2002  wiz Markup improvements.
 1.64 04-Jan-2002  tron Add documentation for "UNLIMIT_RESOURCES".
 1.63 26-Dec-2001  lukem grammar/spelling fixes
 1.62 10-Dec-2001  wiz Refer bsd.pkg.defaults.mk instead of mk.conf.examples. Reported in
pkg/14899 by Jonathan Perkin.
 1.61 29-Nov-2001  hubertf Get rid of manually adding "nbX" to PKGNAME when a pkg was changed in
pkgsrc. Instead, a new variable PKGREVISION is invented that can get
bumped independent of DISTNAME and PKGNAME.

Example #1:
DISTNAME= foo-X.Y
PKGREVISION= Z
=> PKGNAME= foo-X.YnbZ

Example #2:
DISTNAME= barthing-X.Y
PKGNAME= bar-X.Y
PKGREVISION= Z
=> PKGNAME= bar=X.YnbZ (!)

On subsequent changes, only PKGREVISION needs to be bumped, no more risk
of getting DISTNAME changed accidentally.
 1.60 03-Nov-2001  hubertf Make comment about scripts/* go the same place as the scripts/* code: /dev/null
 1.59 14-Sep-2001  jlam Document the new Motif-related variables. Deprecate USE_MOTIF in favor of
including motif.buildlink.mk, which contains more sophisticated and
complete logic for detecting the various Motif options that may be
installed. Though deprecated, USE_MOTIF is still recognized, though it
does no more than include motif.buildlink.mk.
 1.58 11-Sep-2001  wiz Drop superfluous .Pp, punctuation fix.
 1.57 09-Sep-2001  agc Deprecate NO_WRKSUBDIR, replacing it with an explicit assignment of:

WRKSRC= ${WRKDIR}

This is much cleaner, much more indicative of what happens, and removes
another of the negative definitions (NO_.* = value).
 1.56 08-Sep-2001  wiz Fix date.
 1.55 24-Aug-2001  hubertf * When applying patches, also look in $LOCALPATCHES/$PKGPATH for
any local patches that the user wants to maintain outside of
pkgsrc.
* print-PLIST: ignore Linux procfs entries
 1.54 14-Aug-2001  agc Explain that PKGSRCDIR is an internal definition and should not be set
by the user.
 1.53 27-Jun-2001  zuntum Mention REPLACE_PERL

Takes a list of files and replaces each occurence of "/usr/bin/perl", "/usr/local/bin/perl"
and "/usr/pkg/bin/perl" in the named files with the value of ${PERL5}.
This can be used to point perl scripts to the proper interpreter that pkgsrc installs.
Note: it looks for the listed files in ${WRKSRC}.
 1.52 28-May-2001  wiz Fix date, one xref, and some whitespace.
 1.51 20-May-2001  hubertf add some variables related to bin-install
 1.50 29-Apr-2001  tron Add description of "PERL5_REQD".
 1.49 16-Mar-2001  wiz Flesh out the description for MAINTAINER. Addresses pkg/11573.
 1.48 16-Mar-2001  wiz Remove description for NO_DESCRIBE.
 1.47 16-Mar-2001  wiz Remove documentation for NO_EXTRACT.
 1.46 17-Feb-2001  wiz Note COMMENT variable.
 1.45 31-Jan-2001  wiz Document MESSAGE_SUBST, and PLIST_SUBST, and generally update the
document for some changes in the last months (or even earlier).
 1.44 24-Jan-2001  garbled Document OSVERSION_SPECIFIC.
 1.43 21-Jan-2001  veego Document SVR4_PKGNAME.
 1.42 18-Jan-2001  pooka typo (fix it)

Reported by Tetsuya Isaki in misc/11988
 1.41 16-Jan-2001  agc Update the documentation to reflect the deletion of NO_WRKDIR
 1.40 01-Jan-2001  hubertf * Remove documentation of NOCLEANDEPENDS (it's set by default, and there
is no need to change things on that area)
* Document MAKEFILE, per PR 11866 by Richard Tibbetts <tibbetts@mit.edu>
 1.39 22-Oct-2000  rh Note new UPDATE_TARGET
 1.38 15-Oct-2000  rh Explain USE_MESA/USE_GLX
 1.37 11-Oct-2000  hubertf Xref pkgsrc/Packages.txt
 1.36 31-Aug-2000  hubertf Document CHECK_SHLIBS
 1.35 23-Aug-2000  tron Document "USE_XAW" and "USE_XPM".
 1.34 18-Aug-2000  hubertf MIRROR_DISTFILES and NO_CDROM are gone.
 1.33 26-Jul-2000  hubertf PACKAGE_DEPENDS_WITH_PATTERNS will soon be gone, and it was never
intended to be changed by users.
 1.32 21-Jul-2000  rh Sync description of REINSTALL w/ reality.
 1.31 20-Jul-2000  rh Note new NO_{SRC,BIN}_ON_{FTP,CDROM} variables.
 1.30 06-Jul-2000  hubertf add bin-install
 1.29 06-Jul-2000  hubertf Add entry for PKG_DEVELOPER
(There's much redundancy here with pkgsrc/mk/mk.conf.example ... :/)
 1.28 26-Apr-2000  tron branches: 1.28.4;
Document "USE_SSL".
 1.27 02-Feb-2000  hubertf document PACKAGE_DEPENDS_WITH_PATTERNS
 1.26 14-Jan-2000  jwise Document USE_JAVA
 1.25 07-Dec-1999  sakamoto Add LTCONFIG_OVERRIDE and LIBTOOL_OVERRIDE definitions.
 1.24 23-Nov-1999  dmcmahill identify RUN_DEPENDS as depricated
 1.23 22-Nov-1999  dmcmahill - Document the USE_FORTRAN variable used to indicate that a package needs
a fortran compiler to build.
- Document the PKG_FC variable used to control which fortran compiler is
used.
 1.22 31-Oct-1999  rh Document new behaviour of "update" target.
 1.21 07-Oct-1999  hubertf Add some help on when to use USE_X11BASE.
 1.20 12-Sep-1999  kleink branches: 1.20.2;
Use full month names with .Dd, as per mdoc.samples(7).
 1.19 31-Aug-1999  rh Remove bogus information about ${INSTALL_TARGET}.
 1.18 29-Aug-1999  rh Document new update target.
 1.17 24-Jul-1999  mjl Mention MASTER_SORT and MASTER_SORT_REGEXP.
 1.16 22-Jul-1999  lukem - document LOCALBASE, CROSSBASE and X11BASE
- xref mk.conf(5) correctly
- add a see also section
 1.15 10-Mar-1999  erh branches: 1.15.2;
Fix .Bl/.El imbalance.
 1.14 21-Feb-1999  hubertf Xref mk.conf(5), move per-package variables from the common section over
to the package-specific section, add section on how to set defaults for
package distfile repositories (MASTER_SITES_*), from mk.conf(5).
 1.13 17-Feb-1999  hubertf You do not want to set PREFIX manually, and there is no patch -C here
 1.12 30-Jan-1999  agc s/USE_X11/USE_X11BASE/g
s/BUILD_USES_X11/USE_X11/g
Note the changes in meaning of the two definitions. This should be much more
intuitive.
 1.11 26-Jan-1999  agc Document BUILD_USES_X11 definition.
 1.10 17-Sep-1998  agc Document REQ_FILE and MESSAGE_FILE definitions.
 1.9 17-Sep-1998  agc Document INSTALL_FILE and DEINSTALL_FILE definitions, to be set to the
names of any INSTALL or DEINSTALL scripts, respectively.
Also bring explanation of LIB_DEPENDS up to date.
Document USE_LIBTOOL.
 1.8 14-Sep-1998  garbled Document LDFLAGS in bsd.pkg.mk. Also, CFLAGS wasn't documented so I
threw that one in as well.
 1.7 28-Aug-1998  garbled Document use of NOT_FOR_ARCHS.
 1.6 26-Jul-1998  tv Add glob-style wildcards to ONLY_FOR_ARCHS.
 1.5 06-Jul-1998  agc Document LICENCE definition, and ACCEPTABLE_LICENCES.
 1.4 06-Jul-1998  agc Finish documenting automatic man page handling changes.
 1.3 18-Jun-1998  agc Update the package collection documentation to reflect the automatic
manual page handling changes. The explanations for the MAN<sect> and
CAT<sect> definitions, and MANLANG, have been left in place until all
occurrences have been deleted from the package Makefiles.
 1.2 09-Jun-1998  agc Modify the section on MOTIF variables to match reality - there are now
only two: USE_MOTIF and MOTIFLIB.
 1.1 05-Jun-1998  mrg add a packages(7) man page, cobbled from bsd.pkg.mk
 1.15.2.2 02-Feb-2000  he Pull up revision 1.27 (requested by hubertf):
Document PACKAGE_DEPENDS_WITH_PATTERNS switch.
 1.15.2.1 16-Dec-1999  he Pull up revisions 1.16-1.25 (requested by sakamoto):
Update to current state of package documentation.
 1.20.2.1 27-Dec-1999  wrstuden Pull up to last week's -current.
 1.28.4.10 20-May-2001  hubertf backout last - wrong branch
 1.28.4.9 20-May-2001  hubertf Some variables for bin-install
 1.28.4.8 30-Mar-2001  he Pull up revisions 1.34,1.38-1.39,1.41-1.49 (via patch, requested by wiz):
Update to current reality.
This syncs (almost) with version 1.49.
 1.28.4.7 25-Jan-2001  jhawk Pull up revision 1.40 (requested by hubertf):
Remove documentation of NOCLEANDEPENDS (now default); document
MAKEFILE, per PR 11866.
 1.28.4.6 16-Oct-2000  tv Pullup 1.37 [hubertf]:
Xref pkgsrc/Packages.txt
 1.28.4.5 11-Sep-2000  hubertf Document CHECK_SHLIBS
 1.28.4.4 23-Aug-2000  tron Pullup (approved by thorpej):

Document "USE_XAW" and "USE_XPM".

sharesrc/share/man/man7/packages.7 1.34 -> 1.35
 1.28.4.3 26-Jul-2000  hubertf Pull up rev. 1.33 to netbsd-1-5 branch, OK'd by thorpej.

> PACKAGE_DEPENDS_WITH_PATTERNS will soon be gone, and it was never
> intended to be changed by users.
 1.28.4.2 21-Jul-2000  rh Pull up rev. 1.30-1.32 to 1.5 branch (approved by thorpej):
add bin-install
Note new NO_{SRC,BIN}_ON_{FTP,CDROM} variables.
Sync description of REINSTALL w/ reality.
 1.28.4.1 13-Jul-2000  hubertf Pull up rev. 1.29 to 1.5 branch, OK'd by thorpej:
> Add entry for PKG_DEVELOPER
> (There's much redundancy here with pkgsrc/mk/mk.conf.example ... :/)
 1.7 07-Sep-2024  rillig man: use https URLs for www.NetBSD.org
 1.6 23-Mar-2010  wiz branches: 1.6.58;
Add "The pkgsrc developers" to guide authors.
 1.5 23-Mar-2010  jruoho Wrap the pkgsrc guide and its URL around .Rs/.Re.
 1.4 05-Sep-2007  rillig The layout of the website has changed. Fixed improper capitalization of
NetBSD.
 1.3 02-Mar-2007  wiz branches: 1.3.4;
Add another sentence, and reword an existing one. From reed@.
 1.2 02-Mar-2007  wiz Nd does not expand Nx. Weird. Found by reed@.
 1.1 02-Mar-2007  wiz Add simple pkgsrc(7) man page linking to pkg_add, pkg_delete, pkg_info
and the pkgsrc guide. Requested by Alan Barrett.
 1.3.4.1 06-Nov-2007  matt sync with HEAD
 1.6.58.1 02-Aug-2025  perseant Sync with HEAD
 1.40 21-Aug-2022  brook Create bootable images in ${RELEASEDIR}/${RELEASEMACHINEDIR}/binary/gzimg.

Release builds for arm platforms create compressed images in
${RELEASEDIR}/${RELEASEMACHINEDIR}/binary/gzimg. However, in some
cases, e.g., armv7.img.gz, they are not bootable. Consequently, boot
blocks must be manually installed in the images, which is an extra
barrier for testing systems or adopting NetBSD. This has prompted
creation of external repositories, e.g., armbsd.org, to host a
collection of bootable images. However, this does not ease the burden
on developers compiling their own systems; for them, manual
installation of boot blocks is still required.

For arm platforms, etc/etc.evbarm/Makefile.inc contains the commands
used to create system images. Because installboot(8) can write boot
blocks directly to system images, a loop through possible boards can
create a series of bootable images during the normal build process.

In the case of many arm platforms, installboot(8) uses U-Boot boot
blocks, which are not part of the NetBSD source code. Developers can,
however, install as many U-Boot boot blocks as desired, either in the
default location of /usr/pkg/share/u-boot or in a set of directories
pointed to by the U-Boot search path, the INSTALLBOOT_UBOOT_PATHS
environment variable. For each board with an available boot block, a
board-specific bootable image will be created in
${RELEASEDIR}/${RELEASEMACHINEDIR}/binary/gzimg. If a boot block is
not available, which is the typical situation currently, no additional
image will be created.

This facility creates opportunities to build bootable images for any
number of boards within the scope of a standard release build.
However, that is not required and will not occur without the
intervention of installing U-Boot boot blocks prior to the build.
 1.39 13-Jul-2020  jruoho Add the missing rescue(8) and tests(7) sets. XXX: this manual is somewhat
broken due to the differences in the archival formats used.
 1.38 26-Jul-2017  leot Document xetc.tgz installation set.

Thanks to <wiz> for the review!
 1.37 03-Jul-2017  wiz Remove workaround for ancient HTML generation code.
 1.36 03-Nov-2014  snj branches: 1.36.8;
bump date
 1.35 03-Nov-2014  snj fix cksum syntax, CDROM -> CD-ROM, give a specific example of a kernel set
rather than kern.tgz, add dd(1) xref for usb images
 1.34 07-Sep-2012  wiz branches: 1.34.10;
Fix typo.
 1.33 06-Sep-2012  riz Update release(7) for the recent iso -> images change.
 1.32 14-Jan-2012  jmcneill branches: 1.32.2; 1.32.4;
PR# install/44593: Please give release ISO's more meaningful names

Change release ISO filenames, what was once 'i386cd.iso' will now look
like 'NetBSD-5.99.60-i386.iso'.

ok snj@
 1.31 19-Sep-2009  snj branches: 1.31.6;
Sync with reality.
 1.30 15-Sep-2009  jnemeth bump date for previous
 1.29 15-Sep-2009  jnemeth mention the new modules.tgz set
 1.28 04-May-2009  wiz New sentence, new line. Use Aq instead of \*[Lt]\*[Gt].
 1.27 09-Apr-2009  joerg Don't use .Xo/.Xc to workaround ancient groff macro argument limit.
Reduce indentation a bit to make it more readable.
 1.26 11-Mar-2009  joerg Fix markup
 1.25 30-Apr-2008  martin branches: 1.25.4; 1.25.6; 1.25.8; 1.25.10;
Convert TNF licenses to new 2 clause variant
 1.24 30-Aug-2007  jnemeth branches: 1.24.6; 1.24.8;
update for iso-image-source
 1.23 09-Apr-2007  apb branches: 1.23.4;
Mention the .../iso directory and explain the difference between
it and the .../${MACHINE}/installation/cdrom directory. Discussed in
tech-install.
 1.22 01-Apr-2007  apb * Mention that CD-ROM releases don't include the NetBSD-<rel> directory.
* More consistent indentation.
 1.21 17-Jun-2006  reed branches: 1.21.4;
Fix typo or mispelling.
 1.20 20-Jun-2005  peter branches: 1.20.2;
Change all .Xr config 8 to .Xr config 1, following the recent move of
config from usr.sbin -> usr.bin.

Reviewed by wiz.
 1.19 16-Mar-2005  wiz Fix mdoc warning reported by Nicolas Joly in PR 29708.
 1.18 15-Jan-2005  fredb Sync with reality...

- - Clarify how to do multi-platform releases. README, SOURCE_DATE, and
"source" are placed at the root of the heirarchy. Call the heirarchies
in <machine> the "binary releases", to distinguish from the entire
release, which includes source.
- - Split sets are gone.
- - We can now do everything with "./build.sh". Tell how.

I proposed this on tech-install and tech-toolchain, and there were no
objections.
 1.17 04-Oct-2004  rumble Removed accidental repetitious words.
 1.16 13-Feb-2002  ross branches: 1.16.6;
Generate <>& symbolically. I'm avoiding .../dist/... directories for now.
 1.15 11-Feb-2002  wiz s/seperate/separate/
 1.14 21-Jan-2002  wiz Fix typos, and formatting fix.
 1.13 11-Sep-2001  wiz Drop superfluous .Pp.
 1.12 09-Apr-2001  wiz Improve reference to config 8, and some whitespace fixes.
 1.11 01-Nov-2000  tv Describe new shared-set layout: .../shared/$MACHINE_ARCH and .../shared/ALL.
 1.10 06-Oct-2000  hubertf Add description about the "source" dir of a release, based on what's there
for 1.4.2.
 1.9 05-Oct-2000  lukem remove security/
 1.8 11-Sep-2000  hubertf Add standalone "iso-image" target that can be run with DESTDIR and RELEASEDIR
set in src/etc after a "make release" in both "src" and "xsrc", to create a
ISO-image of the release in $RELEASEDIR/installation/cdrom.

Hook for architecture dependent pre/post-processing in etc/etc.*/Makefile.inc
are available as 'iso-image_md_post' and 'iso-image_md_pre', see
etc/etc.i386/Makefile.inc as an example. Might be useful for setting up
bootable CDs on alpha, sparc, ...

Reviewed by Todd Whitesel and Thomas Klausner.
 1.7 10-May-1999  is branches: 1.7.8;
Legalize INSTALL.{html,more,ps,txt}
 1.6 15-Mar-1999  garbled branches: 1.6.2;
First round of .Os cleanups. .Os is defined in the tmac.doc-common file,
so we shouldn't override it with versions in the manpages. Many more to
come.
 1.5 15-Aug-1998  mycroft Assign my copyrights to TNF.
 1.4 28-Apr-1998  fair Change occurrences of "UNIX" to .Ux or .At as appropriate.
 1.3 06-Feb-1998  perry macroize BSD, NetBSD, FreeBSD and misc cleanup
 1.2 10-Jan-1998  enami Fix a typo; s/accomodate/accommodate/
 1.1 25-Nov-1997  thorpej branches: 1.1.2;
Add a document describing the layout of a NetBSD release.
 1.1.2.2 25-Nov-1997  thorpej Pull up from trunk: document describing a NetBSD release.
 1.1.2.1 25-Nov-1997  thorpej file release.7 was added on branch netbsd-1-3 on 1997-11-25 05:29:16 +0000
 1.6.2.1 18-Jun-1999  perry pullup 1.6->1.7 (is): legalize INSTALL.{html,txt,ps,more}
 1.7.8.5 01-Nov-2000  tv Pullup 1.11 [tv]:
Describe new shared-set layout: .../shared/$MACHINE_ARCH and .../shared/ALL.
 1.7.8.4 06-Oct-2000  hubertf Pull up rev. 1.10 to netbsd-1-5 branch, OK'd by thorpej:

> Add description about the "source" dir of a release, based on what's there
> for 1.4.2.
 1.7.8.3 05-Oct-2000  lukem oops - wrong branch! revert previous
 1.7.8.2 05-Oct-2000  lukem remove security/
 1.7.8.1 01-Oct-2000  hubertf Pull up to netbsd-1-5 branch, OK'd by jhawk:

Revisions:
> cvs rdiff -r1.160 -r1.161 basesrc/etc/Makefile
> cvs rdiff -r1.23 -r1.24 basesrc/etc/etc.i386/Makefile.inc
> cvs rdiff -r1.7 -r1.8 sharesrc/share/man/man7/release.7

Log:
> Add standalone "iso-image" target that can be run with DESTDIR and RELEASEDIR
> set in src/etc after a "make release" in both "src" and "xsrc", to create a
> ISO-image of the release in $RELEASEDIR/installation/cdrom.
>
> Hook for architecture dependent pre/post-processing in etc/etc.*/Makefile.inc
> are available as 'iso-image_md_post' and 'iso-image_md_pre', see
> etc/etc.i386/Makefile.inc as an example. Might be useful for setting up
> bootable CDs on alpha, sparc, ...
>
> Reviewed by Todd Whitesel and Thomas Klausner.
 1.16.6.1 05-May-2005  riz Pull up revisions 1.17-1.18 (requested by fredb in ticket #1121):
Removed accidental repetitious words.

Sync with reality...

- - Clarify how to do multi-platform releases. README, SOURCE_DATE, and
"source" are placed at the root of the heirarchy. Call the heirarchies
in <machine> the "binary releases", to distinguish from the entire
release, which includes source.
- - Split sets are gone.
- - We can now do everything with "./build.sh". Tell how.
 1.20.2.1 19-Jun-2006  chap Sync with head.
 1.21.4.3 09-Oct-2009  sborrill Pull up the following revisions(s) (requested by snj in ticket #1365):
share/man/man7/release.7 revision 1.31 (via patch)
distrib/cdrom/hide-hfs.lst revision 1.5
distrib/mac68k/stand/Makefile revision 1.6 (via patch)
distrib/notes/common/main: revision 1.451
distrib/sets/Makefile: revision 1.70
distrib/sets/makesrctars: revision 1.37
distrib/sets/makesums: revision 1.16

Only generate SHA512 and MD5 checksums for releases.
 1.21.4.2 29-Sep-2007  xtraeme branches: 1.21.4.2.2;
Pull up following revision(s) (requested by jnemeth in ticket #864):
distrib/common/Makefile.bootcd: revision 1.9
distrib/common/Makefile.bootcd: revision 1.10
distrib/common/Makefile.bootcd: revision 1.11
doc/BUILDING.mdoc: revision 1.51
doc/BUILDING.mdoc: revision 1.52
doc/BUILDING.mdoc: revision 1.53
build.sh: revision 1.172
build.sh: revision 1.173
build.sh: revision 1.174
build.sh: revision 1.175
BUILDING: revision 1.64
BUILDING: revision 1.65
BUILDING: revision 1.66
share/man/man7/release.7: revision 1.23
share/man/man7/release.7: revision 1.24
Makefile: revision 1.248

Add an iso-dir=directory option. When combined with iso-image or
iso-image-source, it will cause directory to be added to the CD-ROM image.

Convert build.sh iso-dir=directory option to -C cddir as per jmmv@ on
source-changes.
 1.21.4.1 16-Apr-2007  bouyer branches: 1.21.4.1.2;
Pull up following revision(s) (requested by apb in ticket #573):
share/man/man8/sysinst.8: revision 1.1
distrib/sets/lists/man/mi: revision 1.987
share/man/man8/Makefile: revision 1.89
BUILDING: revision 1.62
share/man/man7/release.7: revision 1.22
doc/BUILDING.mdoc: revision 1.49
Improve documentation for "make iso-image" and release(7),
and add a rudimentary man page for sysinst(8).
 1.21.4.2.2.1 10-Oct-2009  sborrill Pull up the following revisions(s) (requested by snj in ticket #1365):
share/man/man7/release7: revision 1.31 (via patch)
distrib/cdrom/hide-hfs.lst: revision 1.5
distrib/mac68k/stand/Makefile: revision 1.6 (via patch)
distrib/notes/common/main: revision 1.451
distrib/sets/Makefile: revision 1.70
distrib/sets/makesrctars: revision 1.37
distrib/sets/makesums: revision 1.16

Only generate SHA512 and MD5 checksums for releases.
 1.21.4.1.2.1 30-Sep-2007  wrstuden Catch up w/ last night's netbsd-4
 1.23.4.1 06-Nov-2007  matt sync with HEAD
 1.24.8.1 18-May-2008  yamt sync with head.
 1.24.6.1 02-Jun-2008  mjf Sync with HEAD.
 1.25.10.1 21-Apr-2010  matt sync to netbsd-5
 1.25.8.1 04-Oct-2009  bouyer Pull up following revision(s) (requested by snj in ticket #1066):
distrib/notes/common/main: revision 1.451
share/man/man7/release.7: revision 1.31 via patch
distrib/mac68k/stand/Makefile: revision 1.6
distrib/sets/makesums: revision 1.16
distrib/sets/Makefile: revision 1.70
distrib/sets/makesrctars: revision 1.37
distrib/cdrom/hide-hfs.lst: revision 1.5
Sync release(7) with reality.
Only generate SHA512 and MD5 checksums for releases.
 1.25.6.1 13-May-2009  jym Sync with HEAD.

Third (and last) commit. See http://mail-index.netbsd.org/source-changes/2009/05/13/msg221222.html
 1.25.4.3 07-Nov-2014  msaitoh Pull up following revision(s) (requested by snj in ticket #1931):
share/man/man7/release.7: revision 1.32
distrib/common/Makefile.bootcd: revision 1.18
distrib/notes/macppc/prep.OPENFIRMWARE: revision 1.15
distrib/notes/sparc/install: revision 1.57
etc/Makefile: revision 1.394
distrib/notes/common/main: revision 1.484
PR# install/44593: Please give release ISO's more meaningful names
Change release ISO filenames, what was once 'i386cd.iso' will now look
like 'NetBSD-5.99.60-i386.iso'.
ok snj@
 1.25.4.2 05-Nov-2014  sborrill Apply patch (requested by snj in ticket 1930):
Install fully-populated .iso images in ${RELEASEDIR}/images instead
of ${RELEASEDIR}/iso
 1.25.4.1 04-Oct-2009  bouyer branches: 1.25.4.1.2; 1.25.4.1.6;
Pull up following revision(s) (requested by snj in ticket #1066):
distrib/notes/common/main: revision 1.451
share/man/man7/release.7: revision 1.31 via patch
distrib/mac68k/stand/Makefile: revision 1.6
distrib/sets/makesums: revision 1.16
distrib/sets/Makefile: revision 1.70
distrib/sets/makesrctars: revision 1.37
distrib/cdrom/hide-hfs.lst: revision 1.5
Sync release(7) with reality.
Only generate SHA512 and MD5 checksums for releases.
 1.25.4.1.6.2 07-Nov-2014  msaitoh Pull up following revision(s) (requested by snj in ticket #1931):
share/man/man7/release.7: revision 1.32
distrib/common/Makefile.bootcd: revision 1.18
distrib/notes/macppc/prep.OPENFIRMWARE: revision 1.15
distrib/notes/sparc/install: revision 1.57
etc/Makefile: revision 1.394
distrib/notes/common/main: revision 1.484
PR# install/44593: Please give release ISO's more meaningful names
Change release ISO filenames, what was once 'i386cd.iso' will now look
like 'NetBSD-5.99.60-i386.iso'.
ok snj@
 1.25.4.1.6.1 05-Nov-2014  sborrill Apply patch (requested by snj in ticket 1930):
Install fully-populated .iso images in ${RELEASEDIR}/images instead
of ${RELEASEDIR}/iso
 1.25.4.1.2.2 07-Nov-2014  msaitoh Pull up following revision(s) (requested by snj in ticket #1931):
share/man/man7/release.7: revision 1.32
distrib/common/Makefile.bootcd: revision 1.18
distrib/notes/macppc/prep.OPENFIRMWARE: revision 1.15
distrib/notes/sparc/install: revision 1.57
etc/Makefile: revision 1.394
distrib/notes/common/main: revision 1.484
PR# install/44593: Please give release ISO's more meaningful names
Change release ISO filenames, what was once 'i386cd.iso' will now look
like 'NetBSD-5.99.60-i386.iso'.
ok snj@
 1.25.4.1.2.1 05-Nov-2014  sborrill Apply patch (requested by snj in ticket 1930):
Install fully-populated .iso images in ${RELEASEDIR}/images instead
of ${RELEASEDIR}/iso
 1.31.6.2 30-Oct-2012  yamt sync with head
 1.31.6.1 17-Apr-2012  yamt sync with head
 1.32.4.1 01-Nov-2012  matt sync with netbsd-6-0-RELEASE.
 1.32.2.1 07-Sep-2012  bouyer Pull up following revision(s) (requested by riz in ticket #548):
doc/README.files: revision 1.5
share/man/man7/release.7: revision 1.33
share/man/man7/release.7: revision 1.34
Update release(7) for the recent iso -> images change.
Fix typo.
The "iso" directory never made it into this file, but now
that "iso" is "images", document it here for the edification of
folks browsing the download directories.
 1.34.10.1 14-Nov-2014  martin Pull up following revision(s) (requested by snj in ticket #226):
share/man/man7/release.7: revision 1.35
share/man/man7/release.7: revision 1.36
fix cksum syntax, CDROM -> CD-ROM, give a specific example of a kernel set
rather than kern.tgz, add dd(1) xref for usb images
bump date
 1.36.8.1 02-Sep-2019  martin Pull up following revision(s) (requested by sevan in ticket #1351):

share/man/man4/man4.amiga/grf.4: revision 1.7
share/man/man4/si.4: revision 1.11
share/man/man8/man8.sparc/boot.8: revision 1.32
share/man/man5/nsswitch.conf.5: revision 1.29
share/man/man5/mixerctl.conf.5: revision 1.7
share/man/man8/man8.vax/boot.8: revision 1.14
share/man/man4/man4.vax/dn.4: revision 1.12
share/man/man8/man8.vax/drtest.8: revision 1.16
share/man/man8/sysinst.8: revision 1.6
share/man/man4/ip.4: revision 1.37
share/man/man5/boot.cfg.5: revision 1.28
share/man/man1/cd.1: revision 1.10
share/man/man4/usb.4: revision 1.106
share/man/man4/man4.vax/ix.4: revision 1.17
share/man/man7/security.7: revision 1.15
share/man/man7/hier.7: revision 1.123
share/man/man8/afterboot.8: revision 1.58
share/man/man1/man1.x68k/bellctrl.1: revision 1.14
share/man/man4/se.4: revision 1.6
share/man/man4/utoppy.4: revision 1.7
share/man/man4/midi.4: revision 1.32
share/man/man4/cfb.4: revision 1.5
share/man/man4/man4.sparc/magma.4: revision 1.12
share/man/man4/audio.4: revision 1.80
share/man/man4/isic.4: revision 1.18
share/man/man1/cd.1: revision 1.7
share/man/man4/envsys.4: revision 1.51
share/man/man1/cd.1: revision 1.8
share/man/man1/cd.1: revision 1.9
share/man/man3/fast_divide32.3: revision 1.9
share/man/man4/pci.4: revision 1.97
share/man/man5/ranlib.5: revision 1.7
share/man/man3/__arraycount.3: revision 1.7
share/man/man4/isa.4: revision 1.46
share/man/man8/man8.atari/ahdilabel.8: revision 1.14
share/man/man4/chipsfb.4: revision 1.6
share/man/man8/man8.macppc/boot.8: revision 1.8
share/man/man5/passwd.5: revision 1.33
share/man/man8/man8.macppc/ofwboot.8: revision 1.14
share/man/man8/compat_linux.8: revision 1.38
share/man/man4/iop.4: revision 1.22
share/man/man4/ddb.4: revision 1.167
share/man/man4/termios.4: revision 1.37
share/man/man8/compat_freebsd.8: revision 1.18
share/man/man5/ar.5: revision 1.9
share/man/man7/release.7: revision 1.37
share/man/man5/core.5: revision 1.31
share/man/man4/ahd.4: revision 1.6
share/man/man4/man4.vax/ad.4: revision 1.12
share/man/man4/pppoe.4: revision 1.39
share/man/man5/locale.alias.5: revision 1.3
share/man/man8/man8.amiga/installboot.8: revision 1.23
share/man/man4/etherip.4: revision 1.8
share/man/man3/queue.3: revision 1.57
share/man/man5/genassym.cf.5: revision 1.13
share/man/man4/mpls.4: revision 1.10
share/man/man1/wait.1: revision 1.5
share/man/man5/capfile.5: revision 1.4
share/man/man4/man4.alpha/ttwopci.4: revision 1.6
share/man/man4/man4.atari/rtc.4: revision 1.8
share/man/man4/gpiosim.4: revision 1.6
share/man/man3/bitstring.3: revision 1.18
share/man/man4/isdntel.4: revision 1.8
share/man/man4/ai.4: revision 1.9
share/man/man8/man8.hppa/boot.8: revision 1.2
share/man/man4/uyurex.4: revision 1.6
share/man/man8/man8.alpha/mkbootimage.8: revision 1.9
share/man/man4/bpf.4: revision 1.56
share/man/man4/man4.amiga/mfcs.4: revision 1.8
share/man/man4/cmpci.4: revision 1.9
share/man/man8/man8.vax/format.8: revision 1.14
share/man/man8/compat_svr4.8: revision 1.27
share/man/man4/crypto.4: revision 1.26
share/man/man4/userconf.4: revision 1.13
share/man/man4/agp.4: revision 1.17
share/man/man9/man9.i386/bioscall.9: revision 1.10
share/man/man4/uftdi.4: revision 1.20
share/man/man4/radio.4: revision 1.13
share/man/man4/mfb.4: revision 1.5
share/man/man7/ascii.7: revision 1.8
share/man/man4/man4.vax/dl.4: revision 1.13
share/man/man4/ral.4: revision 1.12
share/man/man4/unix.4: revision 1.26
share/man/man4/edc.4: revision 1.12
share/man/man4/pim.4: revision 1.5
share/man/man8/compat_ultrix.8: revision 1.21
share/man/man4/dge.4: revision 1.11
share/man/man8/diskless.8: revision 1.32
share/man/man5/passwd.conf.5: revision 1.11
share/man/man8/man8.acorn26/boot26.8: revision 1.8
share/man/man4/man4.vax/hy.4: revision 1.12
share/man/man4/plip.4: revision 1.4
share/man/man4/sc.4: revision 1.8
share/man/man4/ec.4: revision 1.14
share/man/man4/man4.sgimips/giopci.4: revision 1.9
share/man/man7/sysctl.7: revision 1.114
share/man/man3/bits.3: revision 1.18
share/man/man4/we.4: revision 1.19
share/man/man8/compat_sunos.8: revision 1.21
share/man/man4/ip6.4: revision 1.31
share/man/man4/acpilid.4: revision 1.8
share/man/man4/man4.dreamcast/aica.4: revision 1.6
share/man/man4/mfi.4: revision 1.12
share/man/man4/ugen.4: revision 1.32
share/man/man4/jme.4: revision 1.7
share/man/man4/man4.sparc64/intro.4: revision 1.5
share/man/man4/zyd.4: revision 1.5
share/man/man4/gre.4: revision 1.45
share/man/man3/bitmap.3: revision 1.10
share/man/man4/man4.vax/cons.4: revision 1.12
share/man/man3/gcq.3: revision 1.4
share/man/man4/man4.hppa/pdc.4: revision 1.3
share/man/man4/multicast.4: revision 1.8
share/man/man4/man4.sparc/intro.4: revision 1.27
share/man/man4/ath.4: revision 1.32
share/man/man4/ym.4: revision 1.19
share/man/man3/iso646.3: revision 1.6
share/man/man4/btsco.4: revision 1.13
share/man/man4/man4.i386/ndis.4: revision 1.6
share/man/man4/pad.4: revision 1.6
share/man/man4/strip.4: revision 1.16
share/man/man8/man8.x86/boot.8: revision 1.12
share/man/man4/amr.4: revision 1.15
share/man/man4/ieee80211.4: revision 1.5
share/man/man4/options.4: revision 1.467
share/man/man5/link.5: revision 1.24
share/man/man8/man8.cobalt/boot.8: revision 1.10
share/man/man5/stab.5: revision 1.15
share/man/man3/tree.3: revision 1.12
share/man/man4/route.4: revision 1.31
share/man/man4/man4.sun3/leds.4: revision 1.13
share/man/man4/bluetooth.4: revision 1.20
share/man/man4/man4.i386/pcibios.4: revision 1.19
share/man/man5/veriexec.5: revision 1.8
share/man/man7/operator.7: revision 1.12
share/man/man4/man4.hp300/dcl.4: revision 1.13
share/man/man4/man4.i386/intro.4: revision 1.31
share/man/man5/ld.so.conf.5: revision 1.21
share/man/man8/man8.alpha/boot.8: revision 1.16
share/man/man4/bio.4: revision 1.13
share/man/man4/man4.sun2/leds.4: revision 1.10
share/man/man8/man8.x86/mbr.8: revision 1.4
share/man/man8/man8.mvme68k/boot.8: revision 1.9
share/man/man4/man4.alpha/ttwoga.4: revision 1.6
share/man/man4/ahc.4: revision 1.34

Direct reader to shell documentation generally, rather than csh(1)
specifically.

Mention variables OLDPWD and PWD.

Move the text that explains that cd(1) is a shell built-in to the very
beginning of the description where it can be seen prominently.

Improve formatting.

-

Remove workaround for ancient HTML generation code.
Use EXIT STATUS and .Ex.
 1.4 01-Jul-2012  wiz Remove weird markup.
 1.3 22-Jun-2012  christos PR/46602: Move the rfc6056 port randomization to the IP layer.
 1.2 24-Sep-2011  wiz branches: 1.2.2;
New sentence, new line. Do not Xr yourself. Add serial commas.
Remove superfluous Pp.
 1.1 24-Sep-2011  christos add new rfc6056.7, from vlad
 1.2.2.1 30-Oct-2012  yamt sync with head
 1.6 22-Mar-2010  joerg Use .In instead of .Aq Pa for header files.
 1.5 30-Apr-2008  martin Convert TNF licenses to new 2 clause variant
 1.4 01-Mar-2007  wiz branches: 1.4.10; 1.4.12;
Sort sections.
 1.3 10-Jun-2005  wiz Remove superfluous word, found by Jared Yanovich,
forwarded by jmc@openbsd.
 1.2 03-Jun-2005  wiz New sentence, new line. Add xrefs to csh and ksh.
From jmc@openbsd.
 1.1 07-May-2005  perry add a man page explaining how #! scripts work
 1.4.12.1 18-May-2008  yamt sync with head.
 1.4.10.1 02-Jun-2008  mjf Sync with HEAD.
 1.18 31-Oct-2024  gutteridge security.7: give example of a program with per-user-tmp issue
 1.17 30-Oct-2024  gutteridge security.7: note some programs won't work with per-user-tmp

Addresses a documentation aspect of PR kern/58438.
 1.16 10-Jan-2021  riastradh branches: 1.16.8;
Various entropy integration improvements.

- New /etc/security check for entropy in daily security report.

- New /etc/rc.d/entropy script runs (after random_seed and rndctl) to
check for entropy at boot -- in rc.conf, you can:

. set `entropy=check' to halt multiuser boot and enter single-user
mode if not enough entropy

. set `entropy=wait' to make multiuser boot wait until enough entropy

Default is to always boot without waiting -- and rely on other
channels like security report to alert the operator if there's a
problem.

- New man page entropy(7) discussing the higher-level concepts and
system integration with cross-references.

- New paragraph in afterboot(8) about entropy citing entropy(7) for
more details.

This change addresses many of the issues discussed in security/55659.
This is a first draft; happy to take improvements to the man pages and
scripted messages to improve clarity.

I considered changing motd to include an entropy warning with a
reference to the entropy(7) man page, but it's a little trickier:
- Not sure it's appropriate for all users to see at login rather than
users who have power to affect the entropy estimate (maybe it is,
just haven't decided).
- We only have a mechanism for changing once at boot; the message would
remain until next boot even if an operator adds enough entropy.
- The mechanism isn't really conducive to making a message appear
conditionally from boot to boot.
 1.15 03-Jul-2017  wiz Remove workaround for ancient HTML generation code.
 1.14 21-May-2016  christos branches: 1.14.8;
Mention MPROTECT issues
 1.13 14-Jun-2015  christos the data segment is not randomized.
 1.12 13-May-2015  shm 0 mappings are currently disabled on all architectures.
 1.11 18-Mar-2014  riastradh Merge riastradh-drm2 to HEAD.
 1.10 20-Jul-2013  wiz Use Mt for email addresses.
 1.9 15-Mar-2013  njoly branches: 1.9.4;
Fix a few file system paths to use Pa macro.
 1.8 30-Mar-2011  jruoho branches: 1.8.4; 1.8.10;
Add some random, but decent enough, reading material to SEE ALSO.
 1.7 20-Mar-2011  jruoho Now that this is a generic page, clarify the AUTHORS section a little.
 1.6 19-Mar-2011  wiz Remove duplicate word.
 1.5 18-Mar-2011  jruoho Remove xref to nonexistent option(4).
 1.4 18-Mar-2011  jruoho Note the previous also in the lead paragraph.
 1.3 18-Mar-2011  jruoho Note the 'fetch_pkg_vulnerabilities=YES' also here. In lack of a proper
name, put this under "administrative security".
 1.2 18-Mar-2011  jruoho Use .Ss for non-standard subtitles.
 1.1 18-Mar-2011  jruoho Move security(8) to the section 7. Discussed on source-changes a while back.
Should address PR # 35718 at least partially.
 1.8.10.2 20-Aug-2014  tls Rebase to HEAD as of a few days ago.
 1.8.10.1 23-Jun-2013  tls resync from head
 1.8.4.1 22-May-2014  yamt 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")
 1.9.4.1 23-Jul-2013  riastradh sync with HEAD
 1.14.8.1 02-Sep-2019  martin Pull up following revision(s) (requested by sevan in ticket #1351):

share/man/man4/man4.amiga/grf.4: revision 1.7
share/man/man4/si.4: revision 1.11
share/man/man8/man8.sparc/boot.8: revision 1.32
share/man/man5/nsswitch.conf.5: revision 1.29
share/man/man5/mixerctl.conf.5: revision 1.7
share/man/man8/man8.vax/boot.8: revision 1.14
share/man/man4/man4.vax/dn.4: revision 1.12
share/man/man8/man8.vax/drtest.8: revision 1.16
share/man/man8/sysinst.8: revision 1.6
share/man/man4/ip.4: revision 1.37
share/man/man5/boot.cfg.5: revision 1.28
share/man/man1/cd.1: revision 1.10
share/man/man4/usb.4: revision 1.106
share/man/man4/man4.vax/ix.4: revision 1.17
share/man/man7/security.7: revision 1.15
share/man/man7/hier.7: revision 1.123
share/man/man8/afterboot.8: revision 1.58
share/man/man1/man1.x68k/bellctrl.1: revision 1.14
share/man/man4/se.4: revision 1.6
share/man/man4/utoppy.4: revision 1.7
share/man/man4/midi.4: revision 1.32
share/man/man4/cfb.4: revision 1.5
share/man/man4/man4.sparc/magma.4: revision 1.12
share/man/man4/audio.4: revision 1.80
share/man/man4/isic.4: revision 1.18
share/man/man1/cd.1: revision 1.7
share/man/man4/envsys.4: revision 1.51
share/man/man1/cd.1: revision 1.8
share/man/man1/cd.1: revision 1.9
share/man/man3/fast_divide32.3: revision 1.9
share/man/man4/pci.4: revision 1.97
share/man/man5/ranlib.5: revision 1.7
share/man/man3/__arraycount.3: revision 1.7
share/man/man4/isa.4: revision 1.46
share/man/man8/man8.atari/ahdilabel.8: revision 1.14
share/man/man4/chipsfb.4: revision 1.6
share/man/man8/man8.macppc/boot.8: revision 1.8
share/man/man5/passwd.5: revision 1.33
share/man/man8/man8.macppc/ofwboot.8: revision 1.14
share/man/man8/compat_linux.8: revision 1.38
share/man/man4/iop.4: revision 1.22
share/man/man4/ddb.4: revision 1.167
share/man/man4/termios.4: revision 1.37
share/man/man8/compat_freebsd.8: revision 1.18
share/man/man5/ar.5: revision 1.9
share/man/man7/release.7: revision 1.37
share/man/man5/core.5: revision 1.31
share/man/man4/ahd.4: revision 1.6
share/man/man4/man4.vax/ad.4: revision 1.12
share/man/man4/pppoe.4: revision 1.39
share/man/man5/locale.alias.5: revision 1.3
share/man/man8/man8.amiga/installboot.8: revision 1.23
share/man/man4/etherip.4: revision 1.8
share/man/man3/queue.3: revision 1.57
share/man/man5/genassym.cf.5: revision 1.13
share/man/man4/mpls.4: revision 1.10
share/man/man1/wait.1: revision 1.5
share/man/man5/capfile.5: revision 1.4
share/man/man4/man4.alpha/ttwopci.4: revision 1.6
share/man/man4/man4.atari/rtc.4: revision 1.8
share/man/man4/gpiosim.4: revision 1.6
share/man/man3/bitstring.3: revision 1.18
share/man/man4/isdntel.4: revision 1.8
share/man/man4/ai.4: revision 1.9
share/man/man8/man8.hppa/boot.8: revision 1.2
share/man/man4/uyurex.4: revision 1.6
share/man/man8/man8.alpha/mkbootimage.8: revision 1.9
share/man/man4/bpf.4: revision 1.56
share/man/man4/man4.amiga/mfcs.4: revision 1.8
share/man/man4/cmpci.4: revision 1.9
share/man/man8/man8.vax/format.8: revision 1.14
share/man/man8/compat_svr4.8: revision 1.27
share/man/man4/crypto.4: revision 1.26
share/man/man4/userconf.4: revision 1.13
share/man/man4/agp.4: revision 1.17
share/man/man9/man9.i386/bioscall.9: revision 1.10
share/man/man4/uftdi.4: revision 1.20
share/man/man4/radio.4: revision 1.13
share/man/man4/mfb.4: revision 1.5
share/man/man7/ascii.7: revision 1.8
share/man/man4/man4.vax/dl.4: revision 1.13
share/man/man4/ral.4: revision 1.12
share/man/man4/unix.4: revision 1.26
share/man/man4/edc.4: revision 1.12
share/man/man4/pim.4: revision 1.5
share/man/man8/compat_ultrix.8: revision 1.21
share/man/man4/dge.4: revision 1.11
share/man/man8/diskless.8: revision 1.32
share/man/man5/passwd.conf.5: revision 1.11
share/man/man8/man8.acorn26/boot26.8: revision 1.8
share/man/man4/man4.vax/hy.4: revision 1.12
share/man/man4/plip.4: revision 1.4
share/man/man4/sc.4: revision 1.8
share/man/man4/ec.4: revision 1.14
share/man/man4/man4.sgimips/giopci.4: revision 1.9
share/man/man7/sysctl.7: revision 1.114
share/man/man3/bits.3: revision 1.18
share/man/man4/we.4: revision 1.19
share/man/man8/compat_sunos.8: revision 1.21
share/man/man4/ip6.4: revision 1.31
share/man/man4/acpilid.4: revision 1.8
share/man/man4/man4.dreamcast/aica.4: revision 1.6
share/man/man4/mfi.4: revision 1.12
share/man/man4/ugen.4: revision 1.32
share/man/man4/jme.4: revision 1.7
share/man/man4/man4.sparc64/intro.4: revision 1.5
share/man/man4/zyd.4: revision 1.5
share/man/man4/gre.4: revision 1.45
share/man/man3/bitmap.3: revision 1.10
share/man/man4/man4.vax/cons.4: revision 1.12
share/man/man3/gcq.3: revision 1.4
share/man/man4/man4.hppa/pdc.4: revision 1.3
share/man/man4/multicast.4: revision 1.8
share/man/man4/man4.sparc/intro.4: revision 1.27
share/man/man4/ath.4: revision 1.32
share/man/man4/ym.4: revision 1.19
share/man/man3/iso646.3: revision 1.6
share/man/man4/btsco.4: revision 1.13
share/man/man4/man4.i386/ndis.4: revision 1.6
share/man/man4/pad.4: revision 1.6
share/man/man4/strip.4: revision 1.16
share/man/man8/man8.x86/boot.8: revision 1.12
share/man/man4/amr.4: revision 1.15
share/man/man4/ieee80211.4: revision 1.5
share/man/man4/options.4: revision 1.467
share/man/man5/link.5: revision 1.24
share/man/man8/man8.cobalt/boot.8: revision 1.10
share/man/man5/stab.5: revision 1.15
share/man/man3/tree.3: revision 1.12
share/man/man4/route.4: revision 1.31
share/man/man4/man4.sun3/leds.4: revision 1.13
share/man/man4/bluetooth.4: revision 1.20
share/man/man4/man4.i386/pcibios.4: revision 1.19
share/man/man5/veriexec.5: revision 1.8
share/man/man7/operator.7: revision 1.12
share/man/man4/man4.hp300/dcl.4: revision 1.13
share/man/man4/man4.i386/intro.4: revision 1.31
share/man/man5/ld.so.conf.5: revision 1.21
share/man/man8/man8.alpha/boot.8: revision 1.16
share/man/man4/bio.4: revision 1.13
share/man/man4/man4.sun2/leds.4: revision 1.10
share/man/man8/man8.x86/mbr.8: revision 1.4
share/man/man8/man8.mvme68k/boot.8: revision 1.9
share/man/man4/man4.alpha/ttwoga.4: revision 1.6
share/man/man4/ahc.4: revision 1.34

Direct reader to shell documentation generally, rather than csh(1)
specifically.

Mention variables OLDPWD and PWD.

Move the text that explains that cd(1) is a shell built-in to the very
beginning of the description where it can be seen prominently.

Improve formatting.

-

Remove workaround for ancient HTML generation code.
Use EXIT STATUS and .Ex.
 1.16.8.1 02-Aug-2025  perseant Sync with HEAD
 1.9 29-Aug-2020  fcambus Fix a bunch of typos in various man pages.
 1.8 20-Jan-2020  nia when referring to the "user"/"operator"/"network manager": he -> they
 1.7 18-Mar-2014  riastradh branches: 1.7.26;
Merge riastradh-drm2 to HEAD.
 1.6 20-Jul-2013  wiz Use Mt for email addresses.
 1.5 09-Mar-2009  joerg branches: 1.5.6; 1.5.12; 1.5.16;
Fix preamble to match order set out by mdoc(7). Discussed with wiz.
 1.4 26-Feb-2009  wiz Drop trailing whitespace, fix xrefs in SEE ALSO.
 1.3 26-Feb-2009  christos - mention F_CLOSEM
- fix xrefs
 1.2 30-Apr-2008  martin branches: 1.2.6;
Convert TNF licenses to new 2 clause variant
 1.1 17-Feb-2003  wiz branches: 1.1.32; 1.1.34;
Add setuid(7), from Henry Spencer, converted to mdoc by me.
XXX: Improvements are welcome, in parts a bit out of date.
 1.1.34.1 18-May-2008  yamt sync with head.
 1.1.32.1 02-Jun-2008  mjf Sync with HEAD.
 1.2.6.1 13-May-2009  jym Sync with HEAD.

Third (and last) commit. See http://mail-index.netbsd.org/source-changes/2009/05/13/msg221222.html
 1.5.16.1 23-Jul-2013  riastradh sync with HEAD
 1.5.12.1 20-Aug-2014  tls Rebase to HEAD as of a few days ago.
 1.5.6.1 22-May-2014  yamt 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")
 1.7.26.1 08-Apr-2020  martin Merge changes from current as of 20200406
 1.28 17-Jul-2023  riastradh signal(7): Clarify semantics of SIGCHLD with SIG_IGN or SA_NOCLDWAIT.

The semantics is not just a nonportable hack for SysV compatibility;
it is enshrined in POSIX.

Related: PR 57527
 1.27 15-Jul-2023  riastradh signal(7): Clarify quirky SysV-inspired SIGCHLD semantics.

Suggest a portable alternative approach for detaching subprocesses.

Break wall of text into paragraphs while here.
 1.26 30-May-2021  dholland branches: 1.26.4;
signal.7: minor clarification. Bump date (to when I wrote the change)
 1.25 30-May-2018  uwe branches: 1.25.8;
Avoid widowed signal numbers.
 1.24 30-May-2018  uwe Shorten pleonastic "by the tty driver tty(4)".
 1.23 28-May-2018  wiz Add signal numbers in overview table.
They are already in the text, but this way they're easier to find.
 1.22 23-May-2018  wiz Add missing .El. Replace Ta outside its defined usage with No (no change
to text output).
 1.21 22-May-2018  kamil Minor update to signal(7)

Note that SIGCHLD is not just a child exit signal.
Note that SIGIOT is PDP-11 specific signal.

Sponsored by <The NetBSD Foundation>
 1.20 12-Jul-2016  wiz branches: 1.20.14;
Whitespace fixes, xref fixes, a bit more markup.
 1.19 09-Jul-2016  dholland bump up the copyright date since I practically rewrote the file
 1.18 09-Jul-2016  dholland Document all the signals properly. Please review.

Kick out the list of async-signal-safe functions (it is now in
sigaction(2)) because this is not a programmer-facing document.

XXX: if anyone knows definitively whether SIGEMT is actually used by
XXX: anything, please update the weasel words I put in.
 1.17 19-Jul-2014  roy Document that our use of pthread_mutex_unlock(3) is async-signal-safe
and as such can be used in a phtread_atfork(3) child handler.
 1.16 19-Jan-2011  uwe branches: 1.16.12; 1.16.22;
Consistently use .Dv to refer to signal names.
Fix column widths so that troff emits correctly aligned column names.
Use .Sy for column names.
 1.15 22-Mar-2010  joerg Use .In instead of .Aq Pa for header files.
 1.14 27-Feb-2009  christos better wording, from Anon Ymous
 1.13 26-Feb-2009  wiz Sort sections.
 1.12 26-Feb-2009  christos mention that sigcont cannot be blocked or ignored. from Anon Ymous
 1.11 30-Apr-2008  martin branches: 1.11.6;
Convert TNF licenses to new 2 clause variant
 1.10 28-Mar-2006  wiz branches: 1.10.20; 1.10.22;
Whitespace cleanup, fix xref section.
 1.9 28-Mar-2006  yamt mention values of each signals as errno(2) does.
 1.8 14-Jan-2005  jmmv Turn two commas into fulls stops for better readability.
 1.7 01-Jul-2004  kleink Make the spelling of reentrant match the rest of the system.
 1.6 13-Jun-2004  lha Add list of async-signal-safe functions
Approved by wiz
 1.5 26-Jun-2003  wiz Remove superfluous macro.
 1.4 04-May-2001  ross xref fpgetmask(3) and fpsetmask(3)
 1.3 31-Jul-2000  danw s/abort(2)/abort(3)/
 1.2 22-May-2000  jhawk style/grammar.
NetBSD -> .Nx
SIGPWR origin moved to HISTORY
 1.1 06-Oct-1999  jdolecek branches: 1.1.4;
Add signal(7) manpage, with list of signals available under NetBSD.
For now, it includes just the list with basic information about
each signal, some more general signal-related staff might be
added in the future.

Thanks to Soren S. Jorvang <soren@NetBSD.org> for his help.
 1.1.4.1 27-Dec-1999  wrstuden Pull up to last week's -current.
 1.10.22.1 18-May-2008  yamt sync with head.
 1.10.20.1 02-Jun-2008  mjf Sync with HEAD.
 1.11.6.1 13-May-2009  jym Sync with HEAD.

Third (and last) commit. See http://mail-index.netbsd.org/source-changes/2009/05/13/msg221222.html
 1.16.22.1 10-Aug-2014  tls Rebase.
 1.16.12.1 20-Aug-2014  tls Rebase to HEAD as of a few days ago.
 1.20.14.1 25-Jun-2018  pgoyette Sync with HEAD
 1.25.8.1 31-May-2021  cjep sync with head
 1.26.4.1 12-Aug-2023  martin Pull up following revision(s) (requested by riastradh in ticket #325):

share/man/man7/signal.7: revision 1.27
share/man/man7/signal.7: revision 1.28

signal(7): Clarify quirky SysV-inspired SIGCHLD semantics.

Suggest a portable alternative approach for detaching subprocesses.

Break wall of text into paragraphs while here.

signal(7): Clarify semantics of SIGCHLD with SIG_IGN or SA_NOCLDWAIT.

The semantics is not just a nonportable hack for SysV compatibility;
it is enshrined in POSIX.

Related: PR 57527
 1.17 21-Aug-2022  lukem Deprecate extsrc/, EXTSRCSRCDIR, MKEXTSRC

Remove support for building extsrc/:
1. Makefile: remove do-extsrc target.
2. build.sh: remove options -y and -Y extsrcdir.
3. distrib/sets: remove support for extsrc in various tools
including the options -L ext and -y, and the extsrc sets.
4. doc/BUILDING.mdoc: remove docs for extsrc/, EXTSRCSRCDIR, MKEXTSRC (etc)
5. bsd.own.mk and various Makefiles: remove support for extsrc/,
EXTSRCSRCDIR, MKEXTSRC.

As proposed on tech-kern and tech-userlevel on 2022-01-07
and followed up on 2022-08-21.
 1.16 14-May-2020  snj - prune src/gnu and src/sys/netsmb
- add src/sys/netcan
- remove bogus statement about location of reachover Makefiles
- tweak language
 1.15 23-Sep-2018  maxv Remove ISDN from the kernel. It has remained unmaintained for a long time,
is of poor quality, and is now an obstacle to MP-ification. It was removed
ten years ago from FreeBSD for the same reason.

This retires a big user of the mbuf API, and will ease maintenance of the
kernel.
 1.14 06-Sep-2018  maxv Replace netkey/ -> netipsec/, everything was moved into netipsec/.
 1.13 06-Sep-2018  maxv Remove the network ATM code.
 1.12 15-Jul-2018  maxv Retire ipkdb entirely. The option was removed from the config files
yesterday.

ok kamil christos
 1.11 15-Feb-2017  abhinav branches: 1.11.10; 1.11.12;
Fix spelling: s/alogorithms/algorithms
 1.10 21-May-2015  ozaki-r branches: 1.10.2; 1.10.4;
Remove description of netns/

Pointed out by Kamil Rytarowski
 1.9 27-Oct-2014  christos PR/49325: Henning Petersen: Add missing .El's.
 1.8 27-Oct-2014  wiz Add missing .El. From Henning Petersen in PR 49325.
 1.7 18-Oct-2014  snj src is too big these days to tolerate superfluous apostrophes. It's
"its", people!
 1.6 18-Mar-2014  riastradh branches: 1.6.4;
Merge riastradh-drm2 to HEAD.
 1.5 20-Jul-2013  wiz Use Mt for email addresses.
 1.4 25-Apr-2013  jdf branches: 1.4.2; 1.4.4;
Fix timestamp in the licence.
 1.3 25-Apr-2013  jdf Add licence.
 1.2 25-Apr-2013  wiz Fix mdoclint warnings.
XXX: licence missing, please add it.
 1.1 25-Apr-2013  jdf Commit the file src.7 describing the source layout of the NetBSD src tree.
Written by Elvira Khabirova and Mingzhe Wang (the sys/ part) in the scope of
Google Code-In 2012/2013.
 1.4.4.1 23-Jul-2013  riastradh sync with HEAD
 1.4.2.3 20-Aug-2014  tls Rebase to HEAD as of a few days ago.
 1.4.2.2 23-Jun-2013  tls resync from head
 1.4.2.1 25-Apr-2013  tls file src.7 was added on branch tls-maxphys on 2013-06-23 06:28:54 +0000
 1.6.4.2 22-May-2014  yamt 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")
 1.6.4.1 18-Mar-2014  yamt file src.7 was added on branch yamt-pagecache on 2014-05-22 11:37:51 +0000
 1.10.4.1 21-Apr-2017  bouyer Sync with HEAD
 1.10.2.1 20-Mar-2017  pgoyette Sync with HEAD
 1.11.12.1 10-Jun-2019  christos Sync with HEAD
 1.11.10.2 30-Sep-2018  pgoyette Ssync with HEAD
 1.11.10.1 28-Jul-2018  pgoyette Sync with HEAD
 1.6 07-Dec-2023  riastradh branches: 1.6.2;
stack(7): Fix diagram of non-main thread stacks.

Had stackaddr (pthread_attr_setstack parameter, lowest-numbered
virtual address of stack region) confused with stack base (where the
stack grows from, which is the highest-numbered virtual address on
machines where stack grows down).

PR pkg/57708

XXX pullup-10
 1.5 07-Dec-2023  riastradh stack(7): Minor clarifications and wording tweaks.

Suggested by pgoyette@ and uwe@.

PR pkg/57708

XXX pullup-10
 1.4 23-Nov-2023  riastradh stack(7): Consistently say `(in)accessible pages', not `... stack'.

PR pkg/57708

XXX pullup-10
 1.3 23-Nov-2023  riastradh stack(7): Clarify some wording and diagrams.

PR pkg/57708

XXX pullup-10
 1.2 23-Nov-2023  riastradh stack(7): Clarify thread stack guard vs program stack guard.

Just in case this confuses anyone dealing with PR pkg/57708.

XXX pullup-10
 1.1 23-Nov-2023  riastradh stack(7): New man page.

Should help with PR pkg/57708.

XXX pullup-10
 1.6.2.2 09-Dec-2023  martin Pull up following revision(s) (requested by riastradh in ticket #486):

distrib/sets/lists/man/mi: revision 1.1767
share/man/man7/Makefile: revision 1.38
share/man/man7/Makefile: revision 1.39
share/man/man7/stack.7: revision 1.1
share/man/man7/stack.7: revision 1.2
share/man/man7/stack.7: revision 1.3
share/man/man7/stack.7: revision 1.4
share/man/man7/stack.7: revision 1.5
share/man/man7/stack.7: revision 1.6

share/man/man7/Makefile: Split MAN on separate lines, and sort.
Makes sorting and merging changes easier.
No functional change intended.

Preparing for a new stack(7) in the service of PR pkg/57708.

stack(7): New man page.
Should help with PR pkg/57708.

stack(7): Clarify thread stack guard vs program stack guard.
Just in case this confuses anyone dealing with PR pkg/57708.

stack(7): Clarify some wording and diagrams.
PR pkg/57708

stack(7): Consistently say `(in)accessible pages', not `... stack'.
PR pkg/57708

share/man/man7/Makefile: Hook stack.7
stack(7): Minor clarifications and wording tweaks.
Suggested by pgoyette@ and uwe@.
PR pkg/57708

stack(7): Fix diagram of non-main thread stacks.
Had stackaddr (pthread_attr_setstack parameter, lowest-numbered
virtual address of stack region) confused with stack base (where the
stack grows from, which is the highest-numbered virtual address on
machines where stack grows down).
PR pkg/57708
 1.6.2.1 07-Dec-2023  martin file stack.7 was added on branch netbsd-10 on 2023-12-09 13:13:49 +0000
 1.7 08-Feb-2024  andvar s/sharable/shareable in comments and documentation.
 1.6 10-May-2011  jruoho Use .Ss.
 1.5 05-Feb-2007  rillig Mention the word "regular file" more clearly.

The term "append-only" directory was misleading.
 1.4 30-Jan-2004  wiz It's != Its, fix again. New sentence, new line.
 1.3 30-Jan-2004  christos more sticky explanations.
 1.2 30-Jan-2004  wiz Make internal section 7 too, use more markup, |fmt,
sort sections.
 1.1 30-Jan-2004  christos Add the sticky file in the proper section and add a history section for it
explaining what sticky means and meant on plain files.
 1.29 25-Mar-2019  maxv Remove compat_osf1, discussed on tech-kern@.
 1.28 29-Dec-2018  maxv Remove reference to compat_darwin (was retired a long time ago).
 1.27 29-Dec-2018  maxv Retire compat_ibcs2, as discussed on tech-kern@. FreeBSD did the same
recently.
 1.26 19-Dec-2018  maxv Remove compat_svr4 and compat_svr4_32, as discussed on tech-kern@ recently,
but also as discussed several times in the past.
 1.25 24-Apr-2017  wiz branches: 1.25.10; 1.25.12;
Use serial comma. Update a count.
 1.24 21-Apr-2017  christos Add some more text from FreeBSD.
 1.23 10-Jan-2014  wiz branches: 1.23.8;
whitespace.
 1.22 09-Jan-2014  dholland Clarify the behavior of the @machine and @machine_arch magic links
relative to uname output when running in emulations: the magic links
are *not* affected even though uname output changes.

(This means @machine magic links can be used for e.g. amd64 vs. i386
device nodes. There's also an @emul magic link for emulation.)

Noted by apb.
 1.21 02-Jun-2011  jruoho branches: 1.21.2; 1.21.8;
Use .Ss and -offset indent.
 1.20 26-Apr-2011  joerg branches: 1.20.2;
Remove PECOFF/Win32 emulation.
 1.19 01-Feb-2011  christos prettier markup
 1.18 01-Feb-2011  christos merge the two lists.
 1.17 26-Jun-2009  christos branches: 1.17.2;
document gid, rgid
 1.16 11-Mar-2009  joerg Fix markup
 1.15 30-Nov-2008  dholland branches: 1.15.2;
Bump date for mjf's Dec 4 2007 commit that corrected the description of
magiclinks and added @ruid.
 1.14 13-Sep-2008  reed branches: 1.14.2;
Fix spelling typo.
 1.13 04-Dec-2007  mjf branches: 1.13.6; 1.13.10;
Implement a new magic string for magic symlinks, @ruid, which exapnds to the
real user id of the process and use this magic string for per-user tmp.
This should fix PR/35687

Kernel parts reviewed by wrstuden@
 1.12 07-Feb-2007  wiz branches: 1.12.4;
Bump date for previous.
 1.11 05-Feb-2007  rillig Added a HISTORY section.
 1.10 04-Nov-2006  elad branches: 1.10.2;
Add "@uid" keyword translation, to translate effective user-id of the
process.
 1.9 06-Jul-2005  thorpej Document the new @emul magic symlink var as well as the new @{var} syntax.
 1.8 26-Jun-2005  wiz Bump date for new magic symlinks, and add uname(1) to SEE ALSO.
 1.7 23-Jun-2005  thorpej Implement expansion of special "magic" strings in symlinks into
system-specific values. Submitted by Chris Demetriou in Nov 1995 (!)
in PR kern/1781, modified only slighly by me.

This is enabled on a per-mount basis with the MNT_MAGICLINKS mount
flag. It can be enabled at mountroot() time by building the kernel
with the ROOTFS_MAGICLINKS option.

The following magic strings are supported by the implementation:

@machine value of MACHINE for the system
@machine_arch value of MACHINE_ARCH for the system
@hostname the system host name, as set with sethostname()
@domainname the system domain name, as set with setdomainname()
@kernel_ident the kernel config file name
@osrelease the releaes number of the OS
@ostype the name of the OS (always "NetBSD" for NetBSD)

Example usage:

mkdir /arch/i386/bin
mkdir /arch/sparc/bin
ln -s /arch/@machine_arch/bin /bin
 1.6 07-Aug-2003  agc branches: 1.6.6;
Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22309, verified by myself.
 1.5 07-Jul-2002  bjh21 Add lchflags() to the list of syscalls that act on symlinks.
 1.4 06-Mar-2002  wiz Make DESCRIPTION sections (mostly by renaming non-standard section headers).
[See bin/14591 for a reason why we should have them.]
 1.3 11-Sep-2001  wiz Punctuation fixes.
 1.2 11-Sep-2001  wiz Boring whitespace fixes.
 1.1 27-Sep-1999  jdolecek branches: 1.1.4;
Move symlink.7 to share/man/man7/, where it belongs
 1.1.4.1 27-Dec-1999  wrstuden Pull up to last week's -current.
 1.6.6.3 20-Jan-2006  riz Back out tickets 490, 559, and 560, which added "magic symlinks", at
the request of chs@ (thorpej@ concurs), as there is consensus that
this should be changed to a system-wide tunable, rather than a mount
option.
 1.6.6.2 29-Dec-2005  riz Pull up following revision(s) (requested by thorpej in ticket #560):
share/man/man7/symlink.7: revision 1.9
Document the new @emul magic symlink var as well as the new @{var}
syntax.
 1.6.6.1 29-Dec-2005  riz Pull up following revision(s) (requested by thorpej in ticket #490):
lib/libc/sys/mount.2: revision 1.33
sys/sys/systm.h: revision 1.179
sys/sys/fstypes.h: revision 1.4
include/mntopts.h: revision 1.6
sys/conf/newvers.sh: revision 1.41
sys/kern/vfs_syscalls.c: revision 1.223
sys/conf/files: revision 1.720
sys/kern/vfs_lookup.c: revision 1.61
share/man/man7/symlink.7: revision 1.7
sbin/mount/mount.8: revision 1.47
sys/kern/init_main.c: revision 1.248 via patch
share/man/man4/options.4: revision 1.280 via patch
Implement expansion of special "magic" strings in symlinks into
system-specific values. Submitted by Chris Demetriou in Nov 1995 (!)
in PR kern/1781, modified only slighly by me.
This is enabled on a per-mount basis with the MNT_MAGICLINKS mount
flag. It can be enabled at mountroot() time by building the kernel
with the ROOTFS_MAGICLINKS option.
The following magic strings are supported by the implementation:
@machine value of MACHINE for the system
@machine_arch value of MACHINE_ARCH for the system
@hostname the system host name, as set with sethostname()
@domainname the system domain name, as set with setdomainname()
@kernel_ident the kernel config file name
@osrelease the releaes number of the OS
@ostype the name of the OS (always "NetBSD" for NetBSD)
Example usage:
mkdir /arch/i386/bin
mkdir /arch/sparc/bin
ln -s /arch/@machine_arch/bin /bin
 1.10.2.2 01-Dec-2008  snj Pull up following revision(s) (requested by dholland in ticket #1244):
share/man/man7/symlink.7: revision 1.15 via patch
Bump date for mjf's Dec 4 2007 commit that corrected the description of
magiclinks and added @ruid.
 1.10.2.1 01-Dec-2008  snj Apply patch (requested by dholland in ticket #1244):
Refer to the magiclinks sysctl instead of ST_MAGICLINKS.
 1.12.4.1 09-Jan-2008  matt sync with HEAD
 1.13.10.1 24-Sep-2008  wrstuden Merge in changes between wrstuden-revivesa-base-2 and
wrstuden-revivesa-base-3.
 1.13.6.1 05-Oct-2008  mjf Sync with HEAD.
 1.14.2.1 02-Dec-2008  snj Pull up following revision(s) (requested by dholland in ticket #156):
share/man/man7/symlink.7: revision 1.15
Bump date for mjf's Dec 4 2007 commit that corrected the description of
magiclinks and added @ruid.
 1.15.2.1 13-May-2009  jym Sync with HEAD.

Third (and last) commit. See http://mail-index.netbsd.org/source-changes/2009/05/13/msg221222.html
 1.17.2.1 08-Feb-2011  bouyer Sync with HEAD
 1.20.2.1 23-Jun-2011  cherry Catchup with rmind-uvmplock merge.
 1.21.8.1 20-Aug-2014  tls Rebase to HEAD as of a few days ago.
 1.21.2.1 22-May-2014  yamt 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")
 1.23.8.1 26-Apr-2017  pgoyette Sync with HEAD
 1.25.12.1 10-Jun-2019  christos Sync with HEAD
 1.25.10.2 18-Jan-2019  pgoyette Synch with HEAD
 1.25.10.1 26-Dec-2018  pgoyette Sync with HEAD, resolve a few conflicts
 1.167 07-Mar-2024  gutteridge sysctl.7: simplify statements about net.inet6 variables
 1.166 14-Aug-2023  riastradh options(4), sysctl(7): Document options HEARTBEAT.
 1.165 18-Jun-2023  riastradh sysctl(7): Note nodev,nosuid requirement for user-mounted fs.

While here, tidy up language and markup a smidge.
 1.164 29-May-2023  gutteridge sysctl.7: be a little more descriptive about kern.osrevision

It's expressed as an integer, and is also returned as an integer type
should one retrieve it via sysctl(3) (as this man page already
correctly documents in the table above its description).
 1.163 16-Dec-2022  msaitoh Add new "kern.mbuf.nmbclusters_limit" sysctl.

- Used to know the upper limit of nmbclusters.
- It's read only.
 1.162 24-Oct-2022  knakahara Fix PR kern/57037

Be able to change the behavior sending parameter changing routing messages.
When set net.inet6.ip6.param_rt_msg=0, don't send parameter changing
routing messages.
When set net.inet6.ip6.param_rt_msg=1(default), send parameter changing
routing messages by RTM_NEWADDR.
 1.161 29-Aug-2022  knakahara Add sysctl entry to control to send routing message for RTM_DYNAMIC.

Some routing daemons require such routing message to keep coherency.

If we want to let kernel send such message, set net.inet.icmp.dynamic_rt_msg=1
for IPv4, net.inet6.icmp6.dynamic_rt_msg=1 for IPv6.
Default(=0) is the same as before, that is, not send such routing message.
 1.160 22-Aug-2022  knakahara Add sysctl entry to enable/disable to use path MTU discovery for icmpv6 reflecting.

If we want to use path MTU discovery for icmp reflecting set
net.inet6.icmp6.reflect_pmtu=1. Default(=0) is the same as before, that is,
use IPV6_MINMTU.
 1.159 12-Aug-2022  riastradh module(9), sysctl(7): Document kern.module.autounload_unsafe.
 1.158 09-Aug-2022  knakahara Add sysctl entry to improve interconnectivity to some VPN appliances, pointed out by seil-team@IIJ.

If we want to allow different identifier types on IDii and IDir, set
net.key.allow_different_idtype=1. Default(=0) is the same as before.
 1.157 25-Jul-2022  pgoyette kern.maxvnodes _can_ be lowered, but not below the number of currently
active vnodes.
 1.156 05-Dec-2021  msaitoh s/runable/runnable/
 1.155 21-Oct-2021  andvar fix various typos, mainly in comments, but also in man pages and log messages.
 1.154 28-Jul-2021  wiz Fix typos.
 1.153 27-Jul-2021  manu Tie the maximum file lock per unprivilegied uid to kern.maxfiles

This makes the limit simple to raise at run time. While there, document
that fcntl(2) and flock(2) may return ENOMEM when this limit is reached.
 1.152 13-Jul-2021  nia Swap encryption no longer experimental or default-off.
 1.151 17-Oct-2020  wiz Use Dv. Bump date for previous.
 1.150 17-Oct-2020  mlelstv Setting a socket buffer size stops autoscaling. Add a sysctl to
prevent this behaviour. The default is not changed.
 1.149 11-Sep-2020  roy sysctl: Adjust man page for new ARP sysctl ND settings
 1.148 13-Jul-2020  jruoho Xref rfc6056(7).
 1.147 13-Jun-2020  ad g/c vm.idlezero
 1.146 10-May-2020  riastradh Mark experimental-default-off knobs clearly as such.
 1.145 10-May-2020  riastradh Document vm.swap_encrypt.
 1.144 10-May-2020  riastradh Tweak kern.arandom documentation.
 1.143 01-May-2020  nia Update documentation of kern.arandom. It uses cprng_strong(9).
 1.142 16-Nov-2019  nia Document usage of KERN_ARND
 1.141 14-Nov-2019  jdolecek document vm.ubc_direct
 1.140 05-Aug-2019  maya Provide documentation for KERN_LWP.

PR lib/20108
 1.139 01-Jun-2019  kamil branches: 1.139.2;
Document KERN_PROC_CWD in sysctl(7)
 1.138 01-Mar-2019  christos Document kern.uidinfo.semcnt.
 1.137 05-Dec-2018  wiz Remove trailing whitespace. Remove comma for better readability.
 1.136 05-Dec-2018  christos As discussed in tech-kern:

- make sysctl kern.expose_address tri-state:
0: no access
1: access to processes with open /dev/kmem
2: access to everyone
defaults:
0: KASLR kernels
1: non-KASLR kernels

- improve efficiency by calling get_expose_address() per sysctl, not per
process.

- don't expose addresses for linux procfs

- welcome to 8.99.27, changes to fill_*proc ABI
 1.135 04-Nov-2018  christos - Introduce a new SO_RERROR socket option to explicitly turn on
receive overflow errors re-instating the default behavior to
silently ignore them as before 2018-03-19.
- Introduce a new kern.sooptions sysctl to control the default
behavior of socket options. Setting this to 0x4000 (SO_RERROR),
turns on receive overflow error reporting for all sockets.
- Change dhcpcd to turn on SO_RERROR on all its sockets.

As discussed in tech-net.
 1.134 30-Oct-2018  kre kern.boottime was changed from a struct timeval to a struct timespec
in January 2009 (the Christos' time merge, when time_t went to 64 bits).

sysctl needs to catch up. (So do other progs, which will happen, eventually,
but most of them are unaffected in any practical way.)

If you are running a system (NetBSD 6 or later) without this change, try
sysctl -nn kern.boottime
and marvel at the result (in theory, seconds.microseconds) most
probably being something like:
jinx$ sysctl -nn kern.boottime
1540801874.999995564
(There is a 1 in 1000 chance your system will have booted
in the interval [0 , 999999] nanoseconds after some second,
in which case this will not be observed. You should get
(almost) the same value after this change - just now it is as
it should be (there should now always be 9 digits after the '.').

On the other hand, if you're on a big-endian 64 bit host (running
64 bit sysctl) you would have always seen 0 for the microseconds field.
That should be fixed by this.

In sysctl(7) also document what we mean by "the time the system booted".

XXX Pullup -8
XXX Pullup -7
XXX Pullup -6 (oops, missed that one...)
 1.133 06-Oct-2018  wiz Fix some xrefs.
 1.132 05-Oct-2018  christos document kern.expose_address
 1.131 06-Sep-2018  maxv more netkey->netipsec
 1.130 02-Sep-2018  maxv well well well it's September now
 1.129 02-Sep-2018  maxv remove reference to ipnat
 1.128 18-Jun-2018  eadler branches: 1.128.2;
sysctl.7: fix speeling mistake
 1.127 05-May-2018  wiz Fix tab/macro order.
 1.126 05-May-2018  christos Document new PF_LOCAL sysctls.
 1.125 21-Apr-2018  wiz New sentence, new line.
 1.124 22-Feb-2018  sevan branches: 1.124.2;
Improve description of ddb.commandonenter.
 1.123 22-Feb-2018  sevan Document ddb.dumpstack sysctl
Remove the mention of ddb.onpanic=2 as that functionality was removed with the
introduction of ddb.dumpstack.

Heads up by <pgoyette>
 1.122 22-Feb-2018  sevan Sort ddb section in alphabetical order.
Bump date.
 1.121 11-Jan-2018  pgoyette kern.module.verbose is a boolean, not an integer. We had it right in the
text following the table, but the table itself was wrong.

Thanks to martin@ for pointing this out.
 1.120 28-Dec-2017  wiz Fix word.
 1.119 28-Dec-2017  wiz Remove Tn.
 1.118 28-Dec-2017  christos document ddb.panicstackframes
 1.117 30-Jul-2017  maxv Remove lurking reference to TCP_COMPAT_42.
 1.116 11-Jul-2017  wiz Fix a macro. Fix two tables.
 1.115 10-Jul-2017  joerg Document vm.guard_size and vm.thread_guard_size
 1.114 03-Jul-2017  wiz Remove workaround for ancient HTML generation code.
 1.113 25-Mar-2017  pgoyette branches: 1.113.4;
A couple more minor changes for readability.
 1.112 25-Mar-2017  pgoyette Improve some grammar, let verbs agree in number with their subjects.
 1.111 24-Mar-2017  pgoyette Document new proc.curproc.paxflags variable.
 1.110 12-Jan-2017  abhinav branches: 1.110.2;
Fix typo: s/currenly/currently
 1.109 11-Jan-2017  wiz New sentence, new line.

Remove trailing whitespace.
 1.108 09-Jan-2017  hubertf Document kern.sched sysctl variables.
 1.107 08-Jan-2017  wiz Fix display problem reported by kamil via abhinav.
 1.106 05-Jan-2017  wiz Use Fl for flags.
 1.105 01-Jan-2017  pgoyette Document kern.hist
 1.104 17-Nov-2016  pgoyette Document the previously-undocument kern.bufq node.
 1.103 12-Oct-2016  roy Document net.inet.ip.dad_count.
 1.102 31-May-2016  pgoyette branches: 1.102.2;
Add a new kern.messages sysctl to allow kernel message verbosity to be
altered after boot.

Fixes PR kern/46539 using patch submitted by Nat Sloss.
 1.101 25-May-2016  wiz Punctuation nit.
 1.100 25-May-2016  christos Document security.pax.mprotect.ptrace
 1.99 30-Mar-2016  ozaki-r Document arp sysctl removals
 1.98 30-Mar-2016  ozaki-r Document net.inet6.ip6.neighborgcthresh change
 1.97 13-Dec-2015  wiz Fix typo.
 1.96 13-Dec-2015  christos add addrctlpolicy
 1.95 23-Nov-2015  pgoyette Minor rephrasing for English grammar police.
 1.94 29-Sep-2015  wiz Reduce whitespace.
 1.93 24-Sep-2015  christos document new sysctls
 1.92 11-Jul-2015  wiz Add more formatting.
 1.91 11-Jul-2015  kamil Use more macros for symbolic constants

This change was suggested by <riastradh> in PR xsrc/49912
The change idea was approved by <wiz>
 1.90 11-Jul-2015  kamil Correct mandoc warnings and errors

This change should be no visible to users.
 1.89 11-Jul-2015  wiz Bump date for previous.
 1.88 11-Jul-2015  kamil Clean-up resources (sys/sys/resource.h) usage

Add vmemoryuse to login_cap(3)
Document vmemoryuse in login.conf(5)
Document proc.pid.rlimit.vmemoryuse and proc.pid.rlimit.maxlwp in sysctl(7)
Document SBSIZE, AS, VMEM and NTHR in share/doc/psd/05.sysman/1.6.t

Reviewed by <riastradh>
Approved by <pgoyette>

Tested by Dominik Bialy

Closes PR xsrc/49912
 1.87 27-May-2015  matt Change draft-ietf-tcpm-initcwnd-08.txt to RFC6928,
 1.86 13-Nov-2014  christos add log_unknown_network
 1.85 03-Aug-2014  apb BUILDINFO part 2: expose sysctl kern.buildinfo
 1.84 17-Jul-2014  njoly Add hw.ncpuonline documentation.
 1.83 13-Jun-2014  wiz Remove trailing whitespace.
 1.82 13-Jun-2014  joerg Add kern.pool for memory pool stats.
 1.81 30-May-2014  christos Explain ipsec.enabled better.
 1.80 30-May-2014  christos mention new ipsec sysctls.
 1.79 16-Dec-2013  wiz branches: 1.79.2;
New sentence, new line.
 1.78 15-Dec-2013  pgoyette Mention the new kern.module.autotime variable.
 1.77 27-Oct-2013  apb vfs.wapbl.flush_disk_cache is more about metadata than data, and
more about safety in the event of power loss than safety in the
event of a crash.
 1.76 10-Apr-2013  wiz New sentence, new line.
 1.75 10-Apr-2013  christos update init_win{,_local} to match recent changes.
 1.74 29-Nov-2012  christos document new reserved ports
 1.73 23-Jun-2012  christos branches: 1.73.2;
4 new sysctls to avoid ipv6 DoS attacks from OpenBSD
 1.72 22-Jun-2012  christos PR/46602: Move the rfc6056 port randomization to the IP layer.
 1.71 09-Jun-2012  wiz Drop trailing whitespace.
 1.70 09-Jun-2012  christos document kern.maxlwp and kern.uidinfo.*
 1.69 22-Mar-2012  wiz Fix whitespace nits. Suggested by Bug Hunting.
 1.68 03-Nov-2011  jym branches: 1.68.2; 1.68.6; 1.68.8;
Minor typo fix.
 1.67 24-Sep-2011  christos branches: 1.67.2;
update for rfc6056 from vlad.
 1.66 24-Sep-2011  christos mention the new kern.tty.qsize
 1.65 27-Aug-2011  christos add new arp logging sysctls
 1.64 23-Jun-2011  wiz Quote minus so it does not become a dash.
 1.63 23-Jun-2011  riz Attempt to improve the documentation of ddb.onpanic, from options(4).
 1.62 18-Mar-2011  jruoho Fix xref; security(8) -> security(7).
 1.61 02-Feb-2011  wiz Remove trailing whitespace.
 1.60 01-Feb-2011  christos merge the two lists.
 1.59 01-Feb-2011  christos Document the remaining vfs.generic sysctls.
 1.58 19-Jan-2011  wiz branches: 1.58.2;
Use St for POSIX references.
 1.57 19-Jan-2011  wiz file system consistency.
 1.56 19-Jan-2011  uwe Do some markup cleanup for the benefit of troff PostScript output.

- try to be more consistent with Va/Vt/Dv
- make the space in "... otherwise 0." non-paddable to prevent widow "0."
- consistently use -width "123456" for lists of nodes


TODO: There's still quite a bit of mess to clean up:

- tables of "n+1 level names" are indented (or not) inconsistently
- formatting of node names is inconsistent (normal vs literal)
- references to POSIX should use .St
- filesystem vs. file-system, our old time favorite!
- .Pq adds annoying extra space in troff output, do we really want to use it?
- etc.
 1.55 09-Jan-2011  wiz Fix It arguments. Also, let's assume it's 2011.
 1.54 09-Jan-2011  christos document the new wapbl sysctls.
 1.53 14-Dec-2010  jruoho Fix xref; module(4) -> module(7).
 1.52 11-Dec-2010  jruoho Point to module(9) instead of modctl(8).
 1.51 06-Aug-2010  jruoho Like with mqueue(3), create and remove the aio(3) sysctl nodes dynamically.
 1.50 31-Jul-2010  jruoho Use .Ss for subtitles.
 1.49 31-Jul-2010  jruoho Add kern.mqueue also to the big list of second-level nodes. Sort.
 1.48 28-Jul-2010  jruoho Get rid of SYSCTL_SETUP.

We want the sysctl variables also when mqueue(3) is loaded as a module.
 1.47 20-Apr-2010  wiz Make HTML-ready.
 1.46 20-Apr-2010  jruoho Document also kern.cryptodevallowsoft.
 1.45 20-Apr-2010  jruoho Document kern.usercrypto and kern.userasymcrypto.
 1.44 20-Apr-2010  jruoho Document kern.arandom, and remove kern.autonicetime and kern.autoniceval.

XXX: Although no sysctl variables exist for the last two, these are still
defined in <sys/sysctl.h> and <sys/systm.h>.
 1.43 20-Apr-2010  jruoho Add sublists to the security-tree.

In addition, some small fixes to spelling errors, wording, and markup.
 1.42 20-Apr-2010  jruoho Document the kern.module node.
 1.41 20-Apr-2010  jruoho Mark nine undocumented kern.x nodes/variables with XXX. The total amount of
undocumented variables is well over twenty in the kern-subtree alone.
 1.40 19-Apr-2010  jruoho Add sublists for the kern.coredump and kern.veriexec trees.
 1.39 19-Apr-2010  jruoho Sort the kern-subtree. Try to correct the differences between the list and
the descriptions. Mark several undocumented or unclear items with XXX.
 1.38 18-Apr-2010  jruoho Note kern.detachall.
 1.37 10-Apr-2010  jruoho Move the description of 'hw.acpi.supported_states' from sysctl(7) to acpi(4).
 1.36 25-Mar-2010  jruoho Mention the updated hz(9) here.
 1.35 23-Mar-2010  jruoho Fix the CTL_DDB definitions (DDBCTL_XXX, not DBCTL_XXX).
 1.34 23-Mar-2010  jruoho Document the following: ddb.maxwidth, ddb.tee_msgbuf, and ddb.commandonenter.
 1.33 22-Mar-2010  joerg Use .In instead of .Aq Pa for header files.
 1.32 21-Feb-2010  wiz Bump date for vm.user_va0_disable.
 1.31 21-Feb-2010  drochner rename the va0_disabled option and cpp conditional to "disable" as well,
for consistency, and document option and sysctl flag
 1.30 09-Jan-2010  snj It's "hw.acpi.supported_states", not "hw.acpi.support_states". From
rudolf on netbsd-docs@.
 1.29 07-Dec-2009  wiz Bump date for new sysctl.
 1.28 07-Dec-2009  christos PR/42243: Yasuoka Masahiko: Add "net.inet.icmp.bmcastecho" sysctl support,
to disable icmp replies to the broadcast address.
 1.27 05-Oct-2009  wiz Punctuation fix (separate punctuation from marked-up work to avoid it being
marked up as well).
 1.26 04-Oct-2009  elad Slightly restructure vfs level documentation.
 1.25 02-Oct-2009  elad Centralize documentation about exported sysctl variables in the relevant
secmodel's man-page.
 1.24 11-Sep-2009  wiz Bump date for previous.
 1.23 11-Sep-2009  apb Expose the kernel's boothowto(9) variable through the sysctl
kern.boothowto variable.

Part of the /etc/rc silent changes requested in PR 41946
and proposed in tech-userlevel.
 1.22 18-May-2009  snj Document PROC_PID_LIMIT_SBSIZE. From Greg A. Woods in PR lib/36463.
Wording is taken from getrlimit(2).
 1.21 09-Apr-2009  joerg groff is applying more than enough space between column, so don't
increase it even more. Do ensure that the columns are as large as the
largest value though. Do not indent the kern.* table as it can't fit
comfortable on the screen otherwise.
 1.20 01-Mar-2009  wiz Add missing Bl argument. Remove superfluous roff command.
 1.19 01-Mar-2009  christos PR/40937: matthew sporleder: document kern.timecounter in sysctl(7)
 1.18 21-Dec-2008  ad branches: 1.18.2;
-If non-zero, DDB will be entered when the kernel panics.
+If non-zero, DDB will be entered if the kernel panics.
 1.17 12-Nov-2008  ad Remove LKMs and switch to the module framework, pass 1.

Proposed on tech-kern@.
 1.16 07-Oct-2008  rmind branches: 1.16.2;
Mention few more changeable SysV IPC parameters, sync with reality.
 1.15 21-Sep-2008  wiz Describe hw.acpi_supported_states. Info from joerg.
 1.14 27-Dec-2007  elad branches: 1.14.4;
Update for PaX ASLR.
 1.13 25-Jun-2007  christos branches: 1.13.4;
man bits from anon ymous
 1.12 20-Jun-2007  christos - per socket keepalive settings
- settable connection establishment timeout
 1.11 13-Jun-2007  tnn net.inet.tcp.newreno is no more.
 1.10 17-May-2007  yamt remove net.inet6.ip6.rht0.
 1.9 22-Apr-2007  christos Disable processing of routing header type 0 packets since they can be used
of DoS attacks. Provide a sysctl to re-enable them (net.inet6.ip6.rht0).

Information from:
http://www.secdev.org/conf/IPv6_RH_security-csw07.pdf
 1.8 25-Mar-2007  liamjfoy Document net.inet.ip.hashsize to control the IPv4 Fast Forward hash table size
 1.7 23-Mar-2007  liamjfoy Document net.inet6.ip6.hashsize to control the IPv6 Fast Forward hash table
 1.6 12-Mar-2007  liamjfoy ip6.maxflows default value is 256 - document
 1.5 07-Mar-2007  liamjfoy Document net.inet6.ip6.maxflows for IPv6 Fast Forward
 1.4 02-Feb-2007  elad Some nits, paxctl(1) -> paxctl(8).
 1.3 23-Dec-2006  wiz Fix typo.
 1.2 23-Dec-2006  wiz New sentence, new line.
Reword: all .. will not .. -> no .. will ..
 1.1 04-Dec-2006  pavel Move the description of sysctl MIBs from sysctl.3 to a new manual page
sysctl.7. Remove the list of MIBs from sysctl.8 so we don't have to
maintain duplicate information, as proposed by YAMAMOTO Takashi on
tech-userlevel. Also remove references to header files from sysctl.8.

The numeric constants remain documented, they are still needed in some
cases. See the discussion on tech-userlevel. ("mib list in sysctl.8")

OK by YAMAMOTO Takashi.
 1.13.4.1 09-Jan-2008  matt sync with HEAD
 1.14.4.1 05-Oct-2008  mjf Sync with HEAD.
 1.16.2.2 18-May-2009  bouyer Pull up following revision(s) (requested by snj in ticket #765):
share/man/man7/sysctl.7: revision 1.22 via patch
Document PROC_PID_LIMIT_SBSIZE. From Greg A. Woods in PR lib/36463.
Wording is taken from getrlimit(2).
 1.16.2.1 02-Feb-2009  snj branches: 1.16.2.1.2;
Pull up following revision(s) (requested by ad in ticket #352):
share/man/man7/sysctl.7: revision 1.18
-If non-zero, DDB will be entered when the kernel panics.
+If non-zero, DDB will be entered if the kernel panics.
 1.16.2.1.2.1 18-May-2009  bouyer branches: 1.16.2.1.2.1.2;
Pull up following revision(s) (requested by snj in ticket #765):
share/man/man7/sysctl.7: revision 1.22 via patch
Document PROC_PID_LIMIT_SBSIZE. From Greg A. Woods in PR lib/36463.
Wording is taken from getrlimit(2).
 1.16.2.1.2.1.2.1 21-Apr-2010  matt sync to netbsd-5
 1.18.2.1 13-May-2009  jym Sync with HEAD.

Third (and last) commit. See http://mail-index.netbsd.org/source-changes/2009/05/13/msg221222.html
 1.58.2.1 08-Feb-2011  bouyer Sync with HEAD
 1.67.2.5 22-May-2014  yamt 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")
 1.67.2.4 16-Jan-2013  yamt sync with (a bit old) head
 1.67.2.3 30-Oct-2012  yamt sync with head
 1.67.2.2 17-Apr-2012  yamt sync with head
 1.67.2.1 10-Nov-2011  yamt sync with head
 1.68.8.1 08-Jul-2013  jdc Pull up revisions:
src/share/man/man7/sysctl.7 revision 1.73 via patch
src/sys/netinet6/icmp6.c revision 1.161 via patch
src/sys/netinet6/in6.c revision 1.161 via patch
src/sys/netinet6/in6_proto.c revision 1.97 via patch
src/sys/netinet6/in6_var.h revision 1.65 via patch
src/sys/netinet6/ip6_input.c revision 1.139 via patch
src/sys/netinet6/ip6_var.h revision 1.59 via patch
src/sys/netinet6/nd6.c revision 1.143 via patch
src/sys/netinet6/nd6.h revision 1.57 via patch
src/sys/netinet6/nd6_rtr.c revision 1.83 via patch
(requested by christos in ticket #905).
Patch by Loganaden Velvindron.

4 new sysctls to avoid ipv6 DoS attacks from OpenBSD
 1.68.6.1 08-Jul-2013  jdc Pull up revisions:
src/share/man/man7/sysctl.7 revision 1.73 via patch
src/sys/netinet6/icmp6.c revision 1.161 via patch
src/sys/netinet6/in6.c revision 1.161 via patch
src/sys/netinet6/in6_proto.c revision 1.97 via patch
src/sys/netinet6/in6_var.h revision 1.65 via patch
src/sys/netinet6/ip6_input.c revision 1.139 via patch
src/sys/netinet6/ip6_var.h revision 1.59 via patch
src/sys/netinet6/nd6.c revision 1.143 via patch
src/sys/netinet6/nd6.h revision 1.57 via patch
src/sys/netinet6/nd6_rtr.c revision 1.83 via patch
(requested by christos in ticket #905).
Patch by Loganaden Velvindron.

4 new sysctls to avoid ipv6 DoS attacks from OpenBSD
 1.68.2.1 08-Jul-2013  jdc Pull up revisions:
src/share/man/man7/sysctl.7 revision 1.73 via patch
src/sys/netinet6/icmp6.c revision 1.161 via patch
src/sys/netinet6/in6.c revision 1.161 via patch
src/sys/netinet6/in6_proto.c revision 1.97 via patch
src/sys/netinet6/in6_var.h revision 1.65 via patch
src/sys/netinet6/ip6_input.c revision 1.139 via patch
src/sys/netinet6/ip6_var.h revision 1.59 via patch
src/sys/netinet6/nd6.c revision 1.143 via patch
src/sys/netinet6/nd6.h revision 1.57 via patch
src/sys/netinet6/nd6_rtr.c revision 1.83 via patch
(requested by christos in ticket #905).
Patch by Loganaden Velvindron.

4 new sysctls to avoid ipv6 DoS attacks from OpenBSD
 1.73.2.3 20-Aug-2014  tls Rebase to HEAD as of a few days ago.
 1.73.2.2 23-Jun-2013  tls resync from head
 1.73.2.1 25-Feb-2013  tls resync with head
 1.79.2.1 10-Aug-2014  tls Rebase.
 1.102.2.4 26-Apr-2017  pgoyette Sync with HEAD
 1.102.2.3 20-Mar-2017  pgoyette Sync with HEAD
 1.102.2.2 07-Jan-2017  pgoyette Sync with HEAD. (Note that most of these changes are simply $NetBSD$
tag issues.)
 1.102.2.1 04-Nov-2016  pgoyette Sync with HEAD
 1.110.2.1 21-Apr-2017  bouyer Sync with HEAD
 1.113.4.3 02-Sep-2019  martin Pull up following revision(s) (requested by sevan in ticket #1351):

share/man/man4/man4.amiga/grf.4: revision 1.7
share/man/man4/si.4: revision 1.11
share/man/man8/man8.sparc/boot.8: revision 1.32
share/man/man5/nsswitch.conf.5: revision 1.29
share/man/man5/mixerctl.conf.5: revision 1.7
share/man/man8/man8.vax/boot.8: revision 1.14
share/man/man4/man4.vax/dn.4: revision 1.12
share/man/man8/man8.vax/drtest.8: revision 1.16
share/man/man8/sysinst.8: revision 1.6
share/man/man4/ip.4: revision 1.37
share/man/man5/boot.cfg.5: revision 1.28
share/man/man1/cd.1: revision 1.10
share/man/man4/usb.4: revision 1.106
share/man/man4/man4.vax/ix.4: revision 1.17
share/man/man7/security.7: revision 1.15
share/man/man7/hier.7: revision 1.123
share/man/man8/afterboot.8: revision 1.58
share/man/man1/man1.x68k/bellctrl.1: revision 1.14
share/man/man4/se.4: revision 1.6
share/man/man4/utoppy.4: revision 1.7
share/man/man4/midi.4: revision 1.32
share/man/man4/cfb.4: revision 1.5
share/man/man4/man4.sparc/magma.4: revision 1.12
share/man/man4/audio.4: revision 1.80
share/man/man4/isic.4: revision 1.18
share/man/man1/cd.1: revision 1.7
share/man/man4/envsys.4: revision 1.51
share/man/man1/cd.1: revision 1.8
share/man/man1/cd.1: revision 1.9
share/man/man3/fast_divide32.3: revision 1.9
share/man/man4/pci.4: revision 1.97
share/man/man5/ranlib.5: revision 1.7
share/man/man3/__arraycount.3: revision 1.7
share/man/man4/isa.4: revision 1.46
share/man/man8/man8.atari/ahdilabel.8: revision 1.14
share/man/man4/chipsfb.4: revision 1.6
share/man/man8/man8.macppc/boot.8: revision 1.8
share/man/man5/passwd.5: revision 1.33
share/man/man8/man8.macppc/ofwboot.8: revision 1.14
share/man/man8/compat_linux.8: revision 1.38
share/man/man4/iop.4: revision 1.22
share/man/man4/ddb.4: revision 1.167
share/man/man4/termios.4: revision 1.37
share/man/man8/compat_freebsd.8: revision 1.18
share/man/man5/ar.5: revision 1.9
share/man/man7/release.7: revision 1.37
share/man/man5/core.5: revision 1.31
share/man/man4/ahd.4: revision 1.6
share/man/man4/man4.vax/ad.4: revision 1.12
share/man/man4/pppoe.4: revision 1.39
share/man/man5/locale.alias.5: revision 1.3
share/man/man8/man8.amiga/installboot.8: revision 1.23
share/man/man4/etherip.4: revision 1.8
share/man/man3/queue.3: revision 1.57
share/man/man5/genassym.cf.5: revision 1.13
share/man/man4/mpls.4: revision 1.10
share/man/man1/wait.1: revision 1.5
share/man/man5/capfile.5: revision 1.4
share/man/man4/man4.alpha/ttwopci.4: revision 1.6
share/man/man4/man4.atari/rtc.4: revision 1.8
share/man/man4/gpiosim.4: revision 1.6
share/man/man3/bitstring.3: revision 1.18
share/man/man4/isdntel.4: revision 1.8
share/man/man4/ai.4: revision 1.9
share/man/man8/man8.hppa/boot.8: revision 1.2
share/man/man4/uyurex.4: revision 1.6
share/man/man8/man8.alpha/mkbootimage.8: revision 1.9
share/man/man4/bpf.4: revision 1.56
share/man/man4/man4.amiga/mfcs.4: revision 1.8
share/man/man4/cmpci.4: revision 1.9
share/man/man8/man8.vax/format.8: revision 1.14
share/man/man8/compat_svr4.8: revision 1.27
share/man/man4/crypto.4: revision 1.26
share/man/man4/userconf.4: revision 1.13
share/man/man4/agp.4: revision 1.17
share/man/man9/man9.i386/bioscall.9: revision 1.10
share/man/man4/uftdi.4: revision 1.20
share/man/man4/radio.4: revision 1.13
share/man/man4/mfb.4: revision 1.5
share/man/man7/ascii.7: revision 1.8
share/man/man4/man4.vax/dl.4: revision 1.13
share/man/man4/ral.4: revision 1.12
share/man/man4/unix.4: revision 1.26
share/man/man4/edc.4: revision 1.12
share/man/man4/pim.4: revision 1.5
share/man/man8/compat_ultrix.8: revision 1.21
share/man/man4/dge.4: revision 1.11
share/man/man8/diskless.8: revision 1.32
share/man/man5/passwd.conf.5: revision 1.11
share/man/man8/man8.acorn26/boot26.8: revision 1.8
share/man/man4/man4.vax/hy.4: revision 1.12
share/man/man4/plip.4: revision 1.4
share/man/man4/sc.4: revision 1.8
share/man/man4/ec.4: revision 1.14
share/man/man4/man4.sgimips/giopci.4: revision 1.9
share/man/man7/sysctl.7: revision 1.114
share/man/man3/bits.3: revision 1.18
share/man/man4/we.4: revision 1.19
share/man/man8/compat_sunos.8: revision 1.21
share/man/man4/ip6.4: revision 1.31
share/man/man4/acpilid.4: revision 1.8
share/man/man4/man4.dreamcast/aica.4: revision 1.6
share/man/man4/mfi.4: revision 1.12
share/man/man4/ugen.4: revision 1.32
share/man/man4/jme.4: revision 1.7
share/man/man4/man4.sparc64/intro.4: revision 1.5
share/man/man4/zyd.4: revision 1.5
share/man/man4/gre.4: revision 1.45
share/man/man3/bitmap.3: revision 1.10
share/man/man4/man4.vax/cons.4: revision 1.12
share/man/man3/gcq.3: revision 1.4
share/man/man4/man4.hppa/pdc.4: revision 1.3
share/man/man4/multicast.4: revision 1.8
share/man/man4/man4.sparc/intro.4: revision 1.27
share/man/man4/ath.4: revision 1.32
share/man/man4/ym.4: revision 1.19
share/man/man3/iso646.3: revision 1.6
share/man/man4/btsco.4: revision 1.13
share/man/man4/man4.i386/ndis.4: revision 1.6
share/man/man4/pad.4: revision 1.6
share/man/man4/strip.4: revision 1.16
share/man/man8/man8.x86/boot.8: revision 1.12
share/man/man4/amr.4: revision 1.15
share/man/man4/ieee80211.4: revision 1.5
share/man/man4/options.4: revision 1.467
share/man/man5/link.5: revision 1.24
share/man/man8/man8.cobalt/boot.8: revision 1.10
share/man/man5/stab.5: revision 1.15
share/man/man3/tree.3: revision 1.12
share/man/man4/route.4: revision 1.31
share/man/man4/man4.sun3/leds.4: revision 1.13
share/man/man4/bluetooth.4: revision 1.20
share/man/man4/man4.i386/pcibios.4: revision 1.19
share/man/man5/veriexec.5: revision 1.8
share/man/man7/operator.7: revision 1.12
share/man/man4/man4.hp300/dcl.4: revision 1.13
share/man/man4/man4.i386/intro.4: revision 1.31
share/man/man5/ld.so.conf.5: revision 1.21
share/man/man8/man8.alpha/boot.8: revision 1.16
share/man/man4/bio.4: revision 1.13
share/man/man4/man4.sun2/leds.4: revision 1.10
share/man/man8/man8.x86/mbr.8: revision 1.4
share/man/man8/man8.mvme68k/boot.8: revision 1.9
share/man/man4/man4.alpha/ttwoga.4: revision 1.6
share/man/man4/ahc.4: revision 1.34

Direct reader to shell documentation generally, rather than csh(1)
specifically.

Mention variables OLDPWD and PWD.

Move the text that explains that cd(1) is a shell built-in to the very
beginning of the description where it can be seen prominently.

Improve formatting.

-

Remove workaround for ancient HTML generation code.
Use EXIT STATUS and .Ex.
 1.113.4.2 22-Mar-2018  martin Pull up following revision(s) (requested by sevan in ticket #574):
share/man/man7/sysctl.7: revision 1.121,1.122,1.124 (via patch)

kern.module.verbose is a boolean, not an integer. We had it right in the
text following the table, but the table itself was wrong.
Thanks to martin@ for pointing this out.

Sort ddb section in alphabetical order.

Bump date.
Improve description of ddb.commandonenter.
 1.113.4.1 24-Jul-2017  snj Pull up following revision(s) (requested by joerg in ticket #125):
share/man/man7/sysctl.7: revision 1.115
Document vm.guard_size and vm.thread_guard_size
 1.124.2.8 26-Dec-2018  pgoyette Sync with HEAD, resolve a few conflicts
 1.124.2.7 26-Nov-2018  pgoyette Sync with HEAD, resolve a couple of conflicts
 1.124.2.6 20-Oct-2018  pgoyette Sync with head
 1.124.2.5 30-Sep-2018  pgoyette Ssync with HEAD
 1.124.2.4 06-Sep-2018  pgoyette Sync with HEAD

Resolve a couple of conflicts (result of the uimin/uimax changes)
 1.124.2.3 25-Jun-2018  pgoyette Sync with HEAD
 1.124.2.2 21-May-2018  pgoyette Sync with HEAD
 1.124.2.1 22-Apr-2018  pgoyette Sync with HEAD
 1.128.2.2 13-Apr-2020  martin Mostly merge changes from HEAD upto 20200411
 1.128.2.1 10-Jun-2019  christos Sync with HEAD
 1.139.2.2 07-Sep-2021  martin Pull up following revision(s) (requested by manu in ticket #1343):

share/man/man7/sysctl.7: revision 1.153
sys/kern/vfs_lockf.c: revision 1.74
lib/libc/sys/fcntl.2: revision 1.46
lib/libc/sys/flock.2: revision 1.23

Tie the maximum file lock per unprivilegied uid to kern.maxfiles

This makes the limit simple to raise at run time. While there, document
that fcntl(2) and flock(2) may return ENOMEM when this limit is reached.
 1.139.2.1 18-Nov-2019  martin Pull up following revision(s) (requested by nia in ticket #440):

share/man/man7/sysctl.7: revision 1.142

Document usage of KERN_ARND
 1.10 25-Feb-2013  jmmv Provide Kyua instructions in tests(7) when MKKYUA!=no.

I was first going to do this by doing automatic replacements of special
macros within the tests.7 file, but that turned out to be too complex
and confusing.

Instead, just rename the previous tests.7 to tests.atf.7 and add a new
tests.kyua.7 file. Choose which one to install as tests(7) depending on
the MKKYUA knob.
 1.9 11-Mar-2012  njoly branches: 1.9.2;
Use Lk macro instead of Pa when dealing with URLs, to produce links
with HTML output. And while here update some dead URL links.
First part of PR/29238.
 1.8 05-Aug-2011  jmmv branches: 1.8.2;
Rename the _atf user to _tests. The _atf name will get obsoleted if/when
we migrate to Kyua (atf v2), so it's better to use a generic name that does
not depend on the specific implementation. Also, this user has not gone
out yet into any stable release, so we can easily rename it.

Suggested by jruoho@.
 1.7 16-Jun-2011  wiz New sentence, new line.
 1.6 16-Jun-2011  njoly typo (hieararchy -> hierarchy).
 1.5 16-Jun-2011  njoly Add fstype and unprivileged-user tests configuration variables
description. Fix PR/45038.
 1.4 07-Nov-2010  jmmv branches: 1.4.4;
Document configuration changes in tests(7); unprivileged-user is now set
out of the box and is set in 'common.conf', not 'NetBSD.conf'.
 1.3 26-Jun-2010  wiz Grammar fix; remove indefinite article from Nd; don't Xr itself, use Nm.
 1.2 26-Jun-2010  jmmv Move testing instructions from afterboot(8) to tests(7) and change the
former to only provide a link to the latter.
 1.1 26-Jun-2010  jmmv Add the tests(7) manual page, which describes why and how to run the
test suite and how to configure it.
 1.4.4.1 23-Jun-2011  cherry Catchup with rmind-uvmplock merge.
 1.8.2.2 22-May-2014  yamt 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")
 1.8.2.1 17-Apr-2012  yamt sync with head
 1.9.2.1 23-Jun-2013  tls resync from head
 1.8 27-Aug-2023  rillig tests.*.7: use https URLs, fix grammar
 1.7 30-Jul-2015  jnemeth typo from Timo Buhrmester
 1.6 13-Jul-2014  mbalmer Add a missing word; found by Maxime Villard, thanks!
 1.5 21-May-2014  wiz branches: 1.5.2;
Bump date for previous.
 1.4 20-May-2014  gdt Explain that tests should be run as root, and that in theory it's ok
to run them multiuser.

Discussed on current-users with in put from martin@ and gson@.
 1.3 18-Mar-2014  riastradh branches: 1.3.2;
Merge riastradh-drm2 to HEAD.
 1.2 20-Jul-2013  wiz Use Mt for email addresses.
 1.1 25-Feb-2013  jmmv branches: 1.1.4; 1.1.6;
Provide Kyua instructions in tests(7) when MKKYUA!=no.

I was first going to do this by doing automatic replacements of special
macros within the tests.7 file, but that turned out to be too complex
and confusing.

Instead, just rename the previous tests.7 to tests.atf.7 and add a new
tests.kyua.7 file. Choose which one to install as tests(7) depending on
the MKKYUA knob.
 1.1.6.1 23-Jul-2013  riastradh sync with HEAD
 1.1.4.3 20-Aug-2014  tls Rebase to HEAD as of a few days ago.
 1.1.4.2 23-Jun-2013  tls resync from head
 1.1.4.1 25-Feb-2013  tls file tests.atf.7 was added on branch tls-maxphys on 2013-06-23 06:28:54 +0000
 1.3.2.1 10-Aug-2014  tls Rebase.
 1.5.2.2 22-May-2014  yamt 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")
 1.5.2.1 21-May-2014  yamt file tests.atf.7 was added on branch yamt-pagecache on 2014-05-22 11:37:51 +0000
 1.8 27-Aug-2023  rillig tests.*.7: use https URLs, fix grammar
 1.7 30-Jul-2015  jnemeth typo from Timo Buhrmester
 1.6 27-Oct-2014  christos PR/49325: Henning Petersen: Add missing .El's.
 1.5 27-Oct-2014  wiz Add missing .El. From Henning Petersen in PR 49325.
 1.4 02-Jun-2014  gdt Add test environment considerations from tests.atf.7.

Bump date in an attempt to avoid provoking wizd(1).
 1.3 18-Mar-2014  riastradh branches: 1.3.2; 1.3.4;
Merge riastradh-drm2 to HEAD.
 1.2 20-Jul-2013  wiz Use Mt for email addresses.
 1.1 25-Feb-2013  jmmv branches: 1.1.4; 1.1.6;
Provide Kyua instructions in tests(7) when MKKYUA!=no.

I was first going to do this by doing automatic replacements of special
macros within the tests.7 file, but that turned out to be too complex
and confusing.

Instead, just rename the previous tests.7 to tests.atf.7 and add a new
tests.kyua.7 file. Choose which one to install as tests(7) depending on
the MKKYUA knob.
 1.1.6.1 23-Jul-2013  riastradh sync with HEAD
 1.1.4.3 20-Aug-2014  tls Rebase to HEAD as of a few days ago.
 1.1.4.2 23-Jun-2013  tls resync from head
 1.1.4.1 25-Feb-2013  tls file tests.kyua.7 was added on branch tls-maxphys on 2013-06-23 06:28:54 +0000
 1.3.4.2 22-May-2014  yamt 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")
 1.3.4.1 18-Mar-2014  yamt file tests.kyua.7 was added on branch yamt-pagecache on 2014-05-22 11:37:51 +0000
 1.3.2.1 10-Aug-2014  tls Rebase.
 1.5 02-Apr-2020  roy branches: 1.5.2;
Add _dhcpcd entries.
 1.4 28-Feb-2020  kim Fix .Dt to match installed section
 1.3 26-Feb-2020  uwe Make .Bl -width match the actual .It usage.
 1.2 26-Feb-2020  wiz Fix Xr section numbers.
 1.1 26-Feb-2020  riastradh Draft man pages for the standard users and groups.

These are currently listed in order of uid because I went through
src/etc/group and src/etc/master.passwd line by line, and sorting any
other way after the fact -- like lexicographically, how it should be
-- was kinda inconvenient.

Feel free to sort, add information, add historical references,
correct any mistakes, &c., so that these remain living documents
describing NetBSD's standard users and groups and practices around
them.
 1.5.2.2 08-Apr-2020  martin Merge changes from current as of 20200406
 1.5.2.1 02-Apr-2020  martin file users.7 was added on branch phil-wifi on 2020-04-08 14:07:22 +0000

RSS XML Feed