CVS commit: src/share/man/man5

[Luke Mewburn]

Module Name:src
Committed By:   lukem
Date:   Sat Jul 22 18:49:40 UTC 2023

Modified Files:
src/share/man/man5: mk.conf.5

Log Message:
mk.conf(5): tweak BUILDID and option. sort MKKDEBUG

Clarify BUILDID behaviour with OBJMACHINE, and remove unnecessary sentence.
Use option not flag; option may include a flag with an argument.
Sort MKKDEBUG before MKKERBEROS4.


To generate a diff of this commit:
cvs rdiff -u -r1.106 -r1.107 src/share/man/man5/mk.conf.5

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

Modified files:

Index: src/share/man/man5/mk.conf.5
diff -u src/share/man/man5/mk.conf.5:1.106 src/share/man/man5/mk.conf.5:1.107
--- src/share/man/man5/mk.conf.5:1.106	Wed Jul  5 16:40:34 2023
+++ src/share/man/man5/mk.conf.5	Sat Jul 22 18:49:40 2023
@@ -1,4 +1,4 @@
-.\"	$NetBSD: mk.conf.5,v 1.106 2023/07/05 16:40:34 lukem Exp $
+.\"	$NetBSD: mk.conf.5,v 1.107 2023/07/22 18:49:40 lukem Exp $
 .\"
 .\"  Copyright (c) 1999-2023 The NetBSD Foundation, Inc.
 .\"  All rights reserved.
@@ -27,7 +27,7 @@
 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 .\" POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd July 5, 2023
+.Dd July 22, 2023
 .Dt MK.CONF 5
 .Os
 .\" turn off hyphenation
@@ -134,12 +134,13 @@ targets.
 Identifier for the build.
 If set, this should be a short string that is suitable for use as
 part of a file or directory name.
-The identifier will be appended to
-object directory names, and can be consulted in the
-.Xr make 1
-configuration file in order to set additional build parameters,
-such as compiler flags.
-It will also be used as part of the kernel version string,
+The identifier will be appended to object directory names; if
+.Sy OBJMACHINE
+is also set, then
+.Pa \&. Ns Sy BUILDID
+is appended after
+.Pa \&. Ns Sy MACHINE .
+The identifier will also be used as part of the kernel version string,
 which can be shown by
 .Dq Li uname \-v .
 .DFLTu
@@ -203,7 +204,7 @@ space-separated paths.
 .DFLTu
 .
 .It Sy CONFIGOPTS
-Additional flags to
+Additional options to
 .Xr config 1
 when building kernels.
 .DFLTu
@@ -219,7 +220,7 @@ rather than explicitly set.
 not
 .Sy COPTS ,
 should be used for
-compiler flags that select CPU-related options.
+compiler options that select CPU-related options.
 .Pp
 .Em Note :
 .Sy CFLAGS
@@ -293,7 +294,7 @@ This variable should be used in conjunct
 .Sy HAVE_GCC
 or
 .Sy HAVE_LLVM
-setting to control the compiler flags.
+setting to control the compiler options.
 .Pp
 .Em Note :
 This variable is not yet used in as many places as it should be.
@@ -2422,13 +2423,13 @@ Obsolete.
 .It Sy MKEXTSRC
 Obsolete.
 .
-.It Sy MKKERBEROS4
-Obsolete.
-.
 .It Sy MKKDEBUG
 Use
 .Sy MKDEBUGKERNEL .
 .
+.It Sy MKKERBEROS4
+Obsolete.
+.
 .It Sy MKLLD
 Obsolete.
 .

CVS commit: src/share/man/man5

[Luke Mewburn]

Module Name:src
Committed By:   lukem
Date:   Sat Jul 22 18:49:40 UTC 2023

Modified Files:
src/share/man/man5: mk.conf.5

Log Message:
mk.conf(5): tweak BUILDID and option. sort MKKDEBUG

Clarify BUILDID behaviour with OBJMACHINE, and remove unnecessary sentence.
Use option not flag; option may include a flag with an argument.
Sort MKKDEBUG before MKKERBEROS4.


To generate a diff of this commit:
cvs rdiff -u -r1.106 -r1.107 src/share/man/man5/mk.conf.5

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

CVS commit: src/share/man/man5

[Rin Okuyama]

Module Name:src
Committed By:   rin
Date:   Wed Jun 14 02:28:41 UTC 2023

Modified Files:
src/share/man/man5: mk.conf.5

Log Message:
Fix previous. Patch mistakenly applied somehow...


To generate a diff of this commit:
cvs rdiff -u -r1.104 -r1.105 src/share/man/man5/mk.conf.5

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

Modified files:

Index: src/share/man/man5/mk.conf.5
diff -u src/share/man/man5/mk.conf.5:1.104 src/share/man/man5/mk.conf.5:1.105
--- src/share/man/man5/mk.conf.5:1.104	Wed Jun 14 01:16:28 2023
+++ src/share/man/man5/mk.conf.5	Wed Jun 14 02:28:41 2023
@@ -1,4 +1,4 @@
-.\"	$NetBSD: mk.conf.5,v 1.104 2023/06/14 01:16:28 rin Exp $
+.\"	$NetBSD: mk.conf.5,v 1.105 2023/06/14 02:28:41 rin Exp $
 .\"
 .\"  Copyright (c) 1999-2023 The NetBSD Foundation, Inc.
 .\"  All rights reserved.
@@ -747,12 +747,6 @@ will be installed.
 .NODEF NODOC
 .NOVAR MKSHARE=no
 .DFLTy
-.Pp
-.Em Note :
-see also
-.Pa src/sys/rump/README.compileopts
-for variables used during the build of the
-.Xr rump 3 .
 .
 .It Sy MKDTB
 .YorN
@@ -773,12 +767,6 @@ on other platforms.
 .YorN
 Indicates whether the Device Tree Compiler (dtc) will be built and installed.
 .DFLTy
-.Pp
-.Em Note :
-see also
-.Pa src/sys/rump/README.compileopts
-for variables used during the build of the
-.Xr rump 3 .
 .
 .It Sy MKDTRACE
 .YorN
@@ -1534,6 +1522,12 @@ Indicates whether the
 headers, libraries, and programs are to be installed.
 .NOVAR COVERITY_TOP_CONFIG No is defined
 .DFLTy
+.Pp
+.Em Note :
+see also
+.Pa src/sys/rump/README.compileopts
+for variables used during the build of the
+.Xr rump 3 .
 .
 .It Sy MKSANITIZER
 .YorN

CVS commit: src/share/man/man5

[Rin Okuyama]

Module Name:src
Committed By:   rin
Date:   Wed Jun 14 02:28:41 UTC 2023

Modified Files:
src/share/man/man5: mk.conf.5

Log Message:
Fix previous. Patch mistakenly applied somehow...


To generate a diff of this commit:
cvs rdiff -u -r1.104 -r1.105 src/share/man/man5/mk.conf.5

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

CVS commit: src/share/man/man5

[Rin Okuyama]

Module Name:src
Committed By:   rin
Date:   Wed Jun 14 01:16:28 UTC 2023

Modified Files:
src/share/man/man5: mk.conf.5

Log Message:
Cite src/sys/rump/README.compileopts as a reference for MKRUMP.


To generate a diff of this commit:
cvs rdiff -u -r1.103 -r1.104 src/share/man/man5/mk.conf.5

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

Modified files:

Index: src/share/man/man5/mk.conf.5
diff -u src/share/man/man5/mk.conf.5:1.103 src/share/man/man5/mk.conf.5:1.104
--- src/share/man/man5/mk.conf.5:1.103	Sun Jun 11 20:33:46 2023
+++ src/share/man/man5/mk.conf.5	Wed Jun 14 01:16:28 2023
@@ -1,4 +1,4 @@
-.\"	$NetBSD: mk.conf.5,v 1.103 2023/06/11 20:33:46 lukem Exp $
+.\"	$NetBSD: mk.conf.5,v 1.104 2023/06/14 01:16:28 rin Exp $
 .\"
 .\"  Copyright (c) 1999-2023 The NetBSD Foundation, Inc.
 .\"  All rights reserved.
@@ -27,7 +27,7 @@
 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 .\" POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd June 11, 2023
+.Dd June 14, 2023
 .Dt MK.CONF 5
 .Os
 .\" turn off hyphenation
@@ -747,6 +747,12 @@ will be installed.
 .NODEF NODOC
 .NOVAR MKSHARE=no
 .DFLTy
+.Pp
+.Em Note :
+see also
+.Pa src/sys/rump/README.compileopts
+for variables used during the build of the
+.Xr rump 3 .
 .
 .It Sy MKDTB
 .YorN
@@ -767,6 +773,12 @@ on other platforms.
 .YorN
 Indicates whether the Device Tree Compiler (dtc) will be built and installed.
 .DFLTy
+.Pp
+.Em Note :
+see also
+.Pa src/sys/rump/README.compileopts
+for variables used during the build of the
+.Xr rump 3 .
 .
 .It Sy MKDTRACE
 .YorN

CVS commit: src/share/man/man5

[Rin Okuyama]

Module Name:src
Committed By:   rin
Date:   Wed Jun 14 01:16:28 UTC 2023

Modified Files:
src/share/man/man5: mk.conf.5

Log Message:
Cite src/sys/rump/README.compileopts as a reference for MKRUMP.


To generate a diff of this commit:
cvs rdiff -u -r1.103 -r1.104 src/share/man/man5/mk.conf.5

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

Re: CVS commit: src/share/man/man5

[Luke Mewburn]

On 23-06-11 15:38, Valery Ushakov wrote:
  | On Sun, Jun 11, 2023 at 22:19:42 +1000, Luke Mewburn wrote:
  | > My goal is to get the mk.conf(5) up to date and correct, and more usable.
  | > I intend to remove the duplication in BUILDING and bsd.README
  | > and refer back to mk.conf(5) to avoid the copypasta, with some updated
  | > boilerplate in BUILDING to describe how to find the referenced manual 
pages
  | > within BUILDING if you're not on an NetBSD system.
  | 
  | That would be very nice, thanks.

I've made some more improvements to mk.conf(5).

I've now removed all the variables in BUILDING that are in mk.conf(5)
and added more cross references to mk.conf(5) from BUILDING,
including instructions how to find the source for the manual page
(because you might be on a non NetBSD-current host) and where the
manual pages are online.

Next stop, cleaning up share/mk/bsd.README ...

CVS commit: src/share/man/man5

[Luke Mewburn]

Module Name:src
Committed By:   lukem
Date:   Sun Jun 11 20:33:46 UTC 2023

Modified Files:
src/share/man/man5: mk.conf.5

Log Message:
mk.conf(5): more variables from BUILDING and build.sh

Add more variables from build.sh, BUILDING, and various
Makefile's documentation:
CDEXTRA CONFIGOPTS KERNARCHDIR KERNCONFDIR
KERNOBJDIR KERNSRCDIR LOCALTIME

Default sentences now consistently end with ".".
Consistency tweaks in "otherwise".
Editorial tweaks.


To generate a diff of this commit:
cvs rdiff -u -r1.102 -r1.103 src/share/man/man5/mk.conf.5

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

Modified files:

Index: src/share/man/man5/mk.conf.5
diff -u src/share/man/man5/mk.conf.5:1.102 src/share/man/man5/mk.conf.5:1.103
--- src/share/man/man5/mk.conf.5:1.102	Sun Jun 11 10:44:33 2023
+++ src/share/man/man5/mk.conf.5	Sun Jun 11 20:33:46 2023
@@ -1,4 +1,4 @@
-.\"	$NetBSD: mk.conf.5,v 1.102 2023/06/11 10:44:33 lukem Exp $
+.\"	$NetBSD: mk.conf.5,v 1.103 2023/06/11 20:33:46 lukem Exp $
 .\"
 .\"  Copyright (c) 1999-2023 The NetBSD Foundation, Inc.
 .\"  All rights reserved.
@@ -62,7 +62,7 @@ and the default value of each variable.
 ..
 .de DFLTn
 .DFLT
-.Dq no
+.Dq no .
 ..
 .de DFLTu
 .DFLT
@@ -70,7 +70,7 @@ Unset.
 ..
 .de DFLTy
 .DFLT
-.Dq yes
+.Dq yes .
 ..
 .de NODEF
 .Pp
@@ -107,7 +107,7 @@ The real path to the object directory tr
 .Nx
 source tree.
 .DFLT
-.Dq Pa /usr/obj
+.Dq Pa /usr/obj .
 .
 .It Sy BSDSRCDIR
 The real path to the
@@ -116,14 +116,18 @@ source tree, if
 .Sy NETBSDSRCDIR
 isn't defined.
 .DFLT
-.Dq Pa /usr/src
+.Dq Pa /usr/src .
 .
 .It Sy BUILD
 If defined,
 .Sq "make install"
-checks that the targets in the source directories are up-to-date and
+checks that the
+.Xr make 1
+targets in the source directories are up-to-date and
 re-makes them if they are out of date, instead of blindly trying to install
-out of date or non-existent targets.
+out of date or non-existent
+.Xr make 1
+targets.
 .DFLTu
 .
 .It Sy BUILDID
@@ -177,6 +181,33 @@ documentation of
 .Fl frandom-seed .
 .DFLTu
 .
+.It Sy CDEXTRA
+A space-separated list of files or directories that will be
+added to the CD-ROM image that may be create by the
+.Sy build.sh
+.Dq iso-image
+or
+.Dq iso-image-source
+operations.
+Files will be added to the root of the CD-ROM image,
+whereas directories will be copied recursively.
+If relative paths are specified, they will be converted to
+absolute paths before being used.
+.Em Note :
+If using
+.Sy build.sh ,
+multiple paths may be specified via multiple
+.Fl C
+options, or via a single option whose argument contains multiple
+space-separated paths.
+.DFLTu
+.
+.It Sy CONFIGOPTS
+Additional flags to
+.Xr config 1
+when building kernels.
+.DFLTu
+.
 .It Sy COPTS
 Extra options for the C compiler.
 Should be appended to (e.g.,
@@ -234,11 +265,13 @@ will provide a default of
 .Sy .OBJDIR )
 unless run in
 .Sq expert
-mode.
+mode with the
+.Fl E
+option.
 .DFLT
 Empty string if
 .Sy USETOOLS=yes ;
-unset otherwise.
+otherwise unset.
 .
 .It Sy EXTERNAL_TOOLCHAIN
 If defined, this variable indicates the root directory of
@@ -283,12 +316,25 @@ option of
 .DFLTu
 .
 .It Sy INSTALLWORLDDIR
-Location for the top-level
-.Dq make installworld
+Directory for the top-level
+.Xr make 1
+.Dq installworld
 target to install to.
 If specified, must be an absolute path.
 .DFLT
-.Dq /
+.Dq Pa / .
+.
+.It Sy KERNARCHDIR
+Directory under
+.Sy KERNSRCDIR
+containing the machine dependent kernel sources.
+.DFLT
+.Dq Pa arch/ Ns Sy MACHINE .
+.
+.It Sy KERNCONFDIR
+Directory containing the kernel configuration files.
+.DFLT
+.Dq Sy KERNSRCDIR Ns Pa / Ns Sy KERNARCHDIR Ns Pa /conf .
 .
 .It Sy KERNEL_DIR Pq No experimental
 .YorN
@@ -321,6 +367,38 @@ The
 option is a work-in-progress, and is highly experimental.
 It is also subject to change without notice.
 .DFLTn
+.
+.It Sy KERNOBJDIR
+Directory for kernel builds.
+For example, the kernel
+.Sy GENERIC
+will be compiled in
+.Sy KERNOBJDIR Ns Pa /GENERIC .
+.DFLT
+.Dq Sy MAKEOBJDIRPREFIX Ns Pa / Ns Sy KERNSRCDIR Ns Pa / Ns Sy KERNARCHDIR Ns Pa /compile
+if it exists or the
+.Xr make 1
+.Dq obj
+target is being made;
+otherwise
+.Dq Sy KERNSRCDIR Ns Pa / Ns Sy KERNARCHDIR Ns Pa /compile .
+.
+.It Sy KERNSRCDIR
+Directory at the top of the kernel source.
+.DFLT
+.Dq Sy NETBSDSRCDIR Ns Pa /sys .
+.
+.It Sy LOCALTIME
+The name of the
+.Xr tzfile 5
+timezone file in the directory
+.Pa /usr/share/zoneinfo
+to symbolically link
+.Sy DESTDIR Ns Pa /etc/localtime
+to.
+.DFLT
+.Dq UTC .
+.
 .It Sy MAKEVERBOSE
 Level of verbosity of status messages.
 Supported values:
@@ -356,7 +434,7 @@ are traced through use of the
 flag.
 .El
 .DFLT
-2
+.Sy 2 .
 .
 .It Sy MKAMDGPUFIRMWARE
 .YorN
@@ -365,7 +443,8 @@ Indicates whether to install the
 directory, which is necessary for the
 .Xr amdgpu 4
 AMD RADEON GPU video driver.
-.DFLTy
+.DFLT
+.Dq yes
 on
 .Sy i386
 and
@@ -505,7 +584,8 @@ 

CVS commit: src/share/man/man5

[Luke Mewburn]

Module Name:src
Committed By:   lukem
Date:   Sun Jun 11 20:33:46 UTC 2023

Modified Files:
src/share/man/man5: mk.conf.5

Log Message:
mk.conf(5): more variables from BUILDING and build.sh

Add more variables from build.sh, BUILDING, and various
Makefile's documentation:
CDEXTRA CONFIGOPTS KERNARCHDIR KERNCONFDIR
KERNOBJDIR KERNSRCDIR LOCALTIME

Default sentences now consistently end with ".".
Consistency tweaks in "otherwise".
Editorial tweaks.


To generate a diff of this commit:
cvs rdiff -u -r1.102 -r1.103 src/share/man/man5/mk.conf.5

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

Re: CVS commit: src/share/man/man5

[Valery Ushakov]

On Sun, Jun 11, 2023 at 22:19:42 +1000, Luke Mewburn wrote:

>   | I'm not sure what do you mean.  The difference between .Ss and .Sh is
>   | only the indent:
> 
> Ahh, you're right, I misspoke. Tired brain when working on the commit.
> 
> IMHO, they both suffer from lack of blank line there, where personally I
> would prefer the blank line, especially before a list, and especially
> for .Ss because its indent is only 2 in from the main paragraph. But I'm
> not considering an mdoc change for that any time soon.
[...]
> For me, having a para before it and the outdented heading makes the BSDOBJDIR
> "pop" more in a quick eyeball scan, plus easier section searching.
> 
> YMMV.

I guess my own preference is half-way, with .Ss, but with the extra
text you added to prevent the .Bl from blending in with the heading.
.Sh ALL CAPS HEADING pokes out to the left margin and has a bit too
much visual gravity, and so, IMHO, also distracts a bit from the
all-caps variables in the list.  But as there are only three such
headings, it's not really that important (if there were more, my
preference towards .Ss Normal Case would be much stronger).  But
that's not my yak to shave... :)

I was just reacting to that confusing statement in the commit message.
mdoc has enough urban legends and cargo cult around it...


> My goal is to get the mk.conf(5) up to date and correct, and more usable.
> I intend to remove the duplication in BUILDING and bsd.README
> and refer back to mk.conf(5) to avoid the copypasta, with some updated
> boilerplate in BUILDING to describe how to find the referenced manual pages
> within BUILDING if you're not on an NetBSD system.

That would be very nice, thanks.


-uwe

Re: CVS commit: src/share/man/man5

[Luke Mewburn]

On 23-06-11 14:14, Valery Ushakov wrote:
  | On Sun, Jun 11, 2023 at 10:44:33 +, Luke Mewburn wrote:
  | 
  | > Module Name:  src
  | > Committed By: lukem
  | > Date: Sun Jun 11 10:44:33 UTC 2023
  | > 
  | > Modified Files:
  | >   src/share/man/man5: mk.conf.5
  | > 
  | > Log Message:
  | [...]
  | > Change sub headings to headings; it's easier to read.
  | > (I don't know why mdoc doesn't allow blank lines around .Ss)
  | 
  | I'm not sure what do you mean.  The difference between .Ss and .Sh is
  | only the indent:
  | 
  | 8<[ .Ss ]8<
  |  ...
  |  the system.
  | 
  |NetBSD System Variables
  |  Listed below are the mk.conf variables that may be set that affect the
  |  ...
  | 8<8<
  | 
  | vs.
  | 
  | 8<[ .Sh ]8<
  |  ...
  |  the system.
  | 
  | NetBSD System Variables
  |  Listed below are the mk.conf variables that may be set that affect the
  |  ...
  | 8<8<
  | 
  | Both have a blank line before and no blank line after.

Ahh, you're right, I misspoke. Tired brain when working on the commit.

IMHO, they both suffer from lack of blank line there, where personally I
would prefer the blank line, especially before a list, and especially
for .Ss because its indent is only 2 in from the main paragraph. But I'm
not considering an mdoc change for that any time soon.

Compare:

8<[ old ]8<
DESCRIPTION
 The mk.conf file overrides various parameters used during the build of
 the system.

 Listed below are the mk.conf variables that may be set, the values to
 which each may be set, a brief description of what each variable does,
 and a reference to relevant manual pages.

   NetBSD System variables
 BSDOBJDIR   The real path to the object directory tree for the NetBSD
 source tree.
8<8<

vs using .Sh (for outdenting) and a textual para before:

8<[ new ]8<
DESCRIPTION
 The mk.conf file overrides various parameters used during the build of
 the system.

NETBSD SYSTEM VARIABLES
 Listed below are the mk.conf variables that may be set that affect the
 NetBSD NetBSD system build, the values to which each may be set, a brief
 description of what each variable does, references to relevant manual
 pages, notes (including any interaction with build.sh), and the default
 value of each variable.

 BSDOBJDIR   The real path to the object directory tree for the NetBSD
 source tree.
8<8<

For me, having a para before it and the outdented heading makes the BSDOBJDIR
"pop" more in a quick eyeball scan, plus easier section searching.

YMMV.


My goal is to get the mk.conf(5) up to date and correct, and more usable.
I intend to remove the duplication in BUILDING and bsd.README
and refer back to mk.conf(5) to avoid the copypasta, with some updated
boilerplate in BUILDING to describe how to find the referenced manual pages
within BUILDING if you're not on an NetBSD system.


Luke.

Re: CVS commit: src/share/man/man5

[Valery Ushakov]

On Sun, Jun 11, 2023 at 10:44:33 +, Luke Mewburn wrote:

> Module Name:  src
> Committed By: lukem
> Date: Sun Jun 11 10:44:33 UTC 2023
> 
> Modified Files:
>   src/share/man/man5: mk.conf.5
> 
> Log Message:
[...]
> Change sub headings to headings; it's easier to read.
> (I don't know why mdoc doesn't allow blank lines around .Ss)

I'm not sure what do you mean.  The difference between .Ss and .Sh is
only the indent:

8<[ .Ss ]8<
 ...
 the system.

   NetBSD System Variables
 Listed below are the mk.conf variables that may be set that affect the
 ...
8<8<

vs.

8<[ .Sh ]8<
 ...
 the system.

NetBSD System Variables
 Listed below are the mk.conf variables that may be set that affect the
 ...
8<8<

Both have a blank line before and no blank line after.

-uwe

CVS commit: src/share/man/man5

[Luke Mewburn]

Module Name:src
Committed By:   lukem
Date:   Sun Jun 11 10:44:33 UTC 2023

Modified Files:
src/share/man/man5: mk.conf.5

Log Message:
mk.conf(5): add remaining vars from BUILDING

Add more variables from BUILDING:
INSTALLBOOT_BOARDS INSTALLWORLDDIR NOCLEANDIR
NODISTRIBDIRS NOINCLUDES.

Add build.sh related notes (from BUILDING).

Clarify "target" as "target architecture" where appropriate
(versus a make target where that's obvious from context.)

Move all obsolete and deprecated variables to
new "OBSOLETE VARIABLES" section at the end.

Add some per-variable editorial improvements from BUILDING.

Change sub headings to headings; it's easier to read.
(I don't know why mdoc doesn't allow blank lines around .Ss)


To generate a diff of this commit:
cvs rdiff -u -r1.101 -r1.102 src/share/man/man5/mk.conf.5

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

Modified files:

Index: src/share/man/man5/mk.conf.5
diff -u src/share/man/man5/mk.conf.5:1.101 src/share/man/man5/mk.conf.5:1.102
--- src/share/man/man5/mk.conf.5:1.101	Mon Jun  5 22:35:20 2023
+++ src/share/man/man5/mk.conf.5	Sun Jun 11 10:44:33 2023
@@ -1,4 +1,4 @@
-.\"	$NetBSD: mk.conf.5,v 1.101 2023/06/05 22:35:20 lukem Exp $
+.\"	$NetBSD: mk.conf.5,v 1.102 2023/06/11 10:44:33 lukem Exp $
 .\"
 .\"  Copyright (c) 1999-2023 The NetBSD Foundation, Inc.
 .\"  All rights reserved.
@@ -27,7 +27,7 @@
 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 .\" POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd June 5, 2023
+.Dd June 11, 2023
 .Dt MK.CONF 5
 .Os
 .\" turn off hyphenation
@@ -41,14 +41,20 @@
 The
 .Nm
 file overrides various parameters used during the build of the system.
-.Pp
+.
+.Sh NETBSD SYSTEM VARIABLES
+.
 Listed below are the
 .Nm
-variables that may be set, the values to which each may be set,
-a brief description of what each variable does, and a reference to
-relevant manual pages.
-.
-.Ss NetBSD System variables
+variables that may be set that affect the
+.Nx NetBSD
+system build,
+the values to which each may be set,
+a brief description of what each variable does,
+references to relevant manual pages,
+notes (including any interaction with
+.Sy build.sh ) ,
+and the default value of each variable.
 .
 .de DFLT
 .Pp
@@ -190,12 +196,15 @@ should never be set in
 .Nm .
 .
 .It Sy CPUFLAGS
-Additional flags passed to the compiler/assembler to select
+Additional options passed to the compiler/assembler to select
 CPU instruction set options, CPU tuning options, etc.
+.Pp
+.Em Note :
 Such options should not be specified in
 .Sy COPTS ,
 because some parts of the build process need to override
 CPU-related compiler options.
+.DFLTu
 .
 .It Sy DESTDIR
 Directory to contain the built
@@ -205,13 +214,15 @@ If set, special options are passed to th
 prevent their default use of the host system's
 .Sy /usr/include , /usr/lib ,
 and so forth.
-This pathname should
+This pathname must be an absolute path, and should
 .Em not
 end with a slash
 .Pq /
-character (for installation into the system's root directory, set
+character.
+(For installation into the system's root directory, set
 .Sy DESTDIR
-to an empty string).
+to an empty string, not to
+.Dq / ) .
 The directory must reside on a file system which supports long file
 names and hard links.
 .Pp
@@ -223,7 +234,7 @@ will provide a default of
 .Sy .OBJDIR )
 unless run in
 .Sq expert
-mode
+mode.
 .DFLT
 Empty string if
 .Sy USETOOLS=yes ;
@@ -257,8 +268,27 @@ Expect the exact semantics of this varia
 term as parts of the cross-compile framework continue to be cleaned up.
 .DFLTu
 .
-.It Sy EXTSRCSRCDIR
-Obsolete.
+.It Sy INSTALLBOOT_BOARDS
+A list of
+.Sy evbarm
+boards to create bootable images for.
+If corresponding U-Boot packages are installed,
+bootable images are created as part of a release.
+See the
+.Bk -words
+.Fl o Sy board= Ns Ar name
+.Ek
+option of
+.Xr installboot 8 .
+.DFLTu
+.
+.It Sy INSTALLWORLDDIR
+Location for the top-level
+.Dq make installworld
+target to install to.
+If specified, must be an absolute path.
+.DFLT
+.Dq /
 .
 .It Sy KERNEL_DIR Pq No experimental
 .YorN
@@ -303,17 +333,17 @@ are shown.
 Brief messages are shown describing what is being done,
 but the actual commands executed by
 .Xr make 1
-are not displayed.
+are not shown.
 .It 2
 Descriptive messages are shown as above (prefixed with a
 .Sq # ) ,
 and ordinary commands performed by
 .Xr make 1
-are displayed.
+are shown.
 .It 3
 In addition to the above, all commands performed by
 .Xr make 1
-are displayed, even if they would ordinarily have been hidden
+are shown, even if they would ordinarily have been hidden
 through use of the
 .Dq \&@
 prefix in the relevant makefile.
@@ -371,10 +401,6 @@ as the tests rely on ATF and cannot be b
 .NOVAR MKCXX=no
 .DFLTy
 .
-.It Sy MKBFD
-Obsolete, use
-.Sy MKBINUTILS .
-.
 .It Sy MKBINUTILS
 .YorN
 Indicates whether any of the binutils tools or 

CVS commit: src/share/man/man5

[Luke Mewburn]

Module Name:src
Committed By:   lukem
Date:   Sun Jun 11 10:44:33 UTC 2023

Modified Files:
src/share/man/man5: mk.conf.5

Log Message:
mk.conf(5): add remaining vars from BUILDING

Add more variables from BUILDING:
INSTALLBOOT_BOARDS INSTALLWORLDDIR NOCLEANDIR
NODISTRIBDIRS NOINCLUDES.

Add build.sh related notes (from BUILDING).

Clarify "target" as "target architecture" where appropriate
(versus a make target where that's obvious from context.)

Move all obsolete and deprecated variables to
new "OBSOLETE VARIABLES" section at the end.

Add some per-variable editorial improvements from BUILDING.

Change sub headings to headings; it's easier to read.
(I don't know why mdoc doesn't allow blank lines around .Ss)


To generate a diff of this commit:
cvs rdiff -u -r1.101 -r1.102 src/share/man/man5/mk.conf.5

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

CVS commit: src/share/man/man5

[Luke Mewburn]

Module Name:src
Committed By:   lukem
Date:   Mon Jun  5 22:35:20 UTC 2023

Modified Files:
src/share/man/man5: mk.conf.5

Log Message:
mk.conf(5): editorial

MKDTB and MKPIE are .YorN.
MKX11=yes wants MKINET6=yes.
MKLINKLIB deserves a dash list (like bsd.README).

Expand per bsd.README: MKSTATICPIC, MKUNPRIVED,
MKX11, MKZFS, USE_LIBCSANITIZER, USE_SSP

Change the width of the variable lists to 14n (from 15n)
so that when the lists are rendered and then left aligned,
the column is 16 characters (aka 2 tabs) which makes
copypasta to bsd.README easier.


To generate a diff of this commit:
cvs rdiff -u -r1.100 -r1.101 src/share/man/man5/mk.conf.5

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

Modified files:

Index: src/share/man/man5/mk.conf.5
diff -u src/share/man/man5/mk.conf.5:1.100 src/share/man/man5/mk.conf.5:1.101
--- src/share/man/man5/mk.conf.5:1.100	Sun Jun  4 20:04:52 2023
+++ src/share/man/man5/mk.conf.5	Mon Jun  5 22:35:20 2023
@@ -1,4 +1,4 @@
-.\"	$NetBSD: mk.conf.5,v 1.100 2023/06/04 20:04:52 lukem Exp $
+.\"	$NetBSD: mk.conf.5,v 1.101 2023/06/05 22:35:20 lukem Exp $
 .\"
 .\"  Copyright (c) 1999-2023 The NetBSD Foundation, Inc.
 .\"  All rights reserved.
@@ -27,7 +27,7 @@
 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 .\" POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd June 4, 2023
+.Dd June 5, 2023
 .Dt MK.CONF 5
 .Os
 .\" turn off hyphenation
@@ -92,7 +92,7 @@ or
 .Dq no .
 ..
 .
-.Bl -tag -width 15n
+.Bl -tag -width 14n
 .
 .\" These entries are sorted alphabetically.
 .
@@ -644,6 +644,7 @@ will be installed.
 .DFLTy
 .
 .It Sy MKDTB
+.YorN
 Indicates whether the devicetree blobs will be built and installed.
 .DFLTy
 on
@@ -843,6 +844,13 @@ Has no effect on most platforms.
 .YorN
 Indicates whether INET6 (IPv6) infrastructure
 (libraries and support programs) will be built and installed.
+.Pp
+.Em Note :
+.Sy MKINET6
+must not be set to
+.Dq no
+if
+.Sy MKX11!=no .
 .DFLTy
 .
 .It Sy MKINFO
@@ -954,22 +962,32 @@ Indicates if libstdc++ will be built and
 .YorN
 Indicates whether all of the shared library infrastructure
 will be built and installed.
+.Pp
 If
 .Dq no ,
 prevents:
+.Bl -dash -compact
+.It
 installation of the
 .Sy *.a
-libraries,
+libraries
+.It
 installation of the
 .Sy *_pic.a
-libraries on PIC systems,
+libraries on PIC systems
+.It
 building of
 .Sy *.a
-libraries on PIC systems,
-or
+libraries on PIC systems
+.It
 installation of
 .Sy .so
-symlinks on ELF systems.
+symlinks on ELF systems
+.El
+.Pp
+I.e, only install the shared library (and the
+.Pa .so.major
+symlink on ELF).
 .NODEF NOLINKLIB
 .Pp
 If
@@ -1244,6 +1262,7 @@ on
 on other platforms.
 .
 .It Sy MKPIE
+.YorN
 Indicates whether Position Independent Executables (PIE)
 will be built and installed.
 .NODEF NOPIE
@@ -1448,6 +1467,8 @@ will be built and installed.
 .YorN
 Indicates whether support for static PIE binaries
 will be built and installed.
+These binaries use a special support in crt0.o for
+resolving relative relocations and require linker support.
 .DFLTy
 on
 .Sy i386
@@ -1528,6 +1549,8 @@ The contents of
 .Pa METALOG
 is used during the generation of the distribution tar files to ensure
 that the appropriate file ownership is stored.
+This allows a non-root
+.Sq "make install" .
 .DFLTn
 .
 .It Sy MKUPDATE
@@ -1541,7 +1564,14 @@ phase if the destination files are up-to
 .It Sy MKX11
 .YorN
 Indicates whether X11 will be built and installed from
-.Sy X11SRCDIR .
+.Sy X11SRCDIR ,
+and whether the X sets will be created.
+.Pp
+.Em Note :
+If
+.Dq yes ,
+requires
+.Sy MKINET6=yes .
 .DFLTn
 .
 .It Sy MKX11FONTS
@@ -1549,6 +1579,7 @@ Indicates whether X11 will be built and 
 If
 .Dq no ,
 do not build and install the X fonts.
+The xfont set is still created but will be empty.
 .Pp
 Only used if
 .Sy MKX11=yes .
@@ -1616,6 +1647,9 @@ Indicates whether the YP (NIS) infrastru
 .YorN
 Indicates whether the ZFS kernel module and the utilities and
 libraries used to manage the ZFS system are to be built and installed.
+.Pp
+.Em Note :
+ZFS requires 64-bit atomic operations .
 .DFLTy
 on
 .Sy aarch64 ,
@@ -1823,9 +1857,17 @@ Supported values:
 .Bl -tag -width undefined
 .It undefined
 Enables the micro-UBSan in the user mode (uUBSan)
-undefined behaviour sanitizer, with
+undefined behaviour sanitizer.
+The code is shared with the kernel mode variation (kUBSan).
+The runtime runtime differs from the UBSan available in
+.Sy MKSANITIZER .
+The runtime is stripped down from C++ features,
+and is invoked with
 .Li -fsanitize=no-vptr
 as that sanitizer is not supported.
+The runtime configuration is restricted to the
+.Ev LIBC_UBSAN
+environment variable, that is designed to be safe for hardening.
 .El
 .Pp
 The value of
@@ -1912,7 +1954,8 @@ This is mutually exclusive to
 Indicates whether GCC stack-smashing protection (SSP) support,
 which detects stack overflows and aborts the program,
 is enabled.
-This 

CVS commit: src/share/man/man5

[Luke Mewburn]

Module Name:src
Committed By:   lukem
Date:   Mon Jun  5 22:35:20 UTC 2023

Modified Files:
src/share/man/man5: mk.conf.5

Log Message:
mk.conf(5): editorial

MKDTB and MKPIE are .YorN.
MKX11=yes wants MKINET6=yes.
MKLINKLIB deserves a dash list (like bsd.README).

Expand per bsd.README: MKSTATICPIC, MKUNPRIVED,
MKX11, MKZFS, USE_LIBCSANITIZER, USE_SSP

Change the width of the variable lists to 14n (from 15n)
so that when the lists are rendered and then left aligned,
the column is 16 characters (aka 2 tabs) which makes
copypasta to bsd.README easier.


To generate a diff of this commit:
cvs rdiff -u -r1.100 -r1.101 src/share/man/man5/mk.conf.5

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

CVS commit: src/share/man/man5

[Luke Mewburn]

Module Name:src
Committed By:   lukem
Date:   Sun Jun  4 20:04:52 UTC 2023

Modified Files:
src/share/man/man5: mk.conf.5

Log Message:
mk.conf(5): add more from BUILDING and bsd.README

Add from BUILDING or bsd.README:
BUILDINFO, BUILDSEED, EXTERNAL_TOOLCHAIN, MKCROSSGDB,
MKREPRO_TIMESTAMP, TOOLCHAIN_MISSING, X11SRCDIR

Clarify BUILDID.
Improve MKDEBUG, MKOBJ, MKX11, NETBSDSRCDIR, USETOOLS,
Consistent Note: formatting.


To generate a diff of this commit:
cvs rdiff -u -r1.99 -r1.100 src/share/man/man5/mk.conf.5

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

Modified files:

Index: src/share/man/man5/mk.conf.5
diff -u src/share/man/man5/mk.conf.5:1.99 src/share/man/man5/mk.conf.5:1.100
--- src/share/man/man5/mk.conf.5:1.99	Sat Jun  3 11:13:40 2023
+++ src/share/man/man5/mk.conf.5	Sun Jun  4 20:04:52 2023
@@ -1,4 +1,4 @@
-.\"	$NetBSD: mk.conf.5,v 1.99 2023/06/03 11:13:40 lukem Exp $
+.\"	$NetBSD: mk.conf.5,v 1.100 2023/06/04 20:04:52 lukem Exp $
 .\"
 .\"  Copyright (c) 1999-2023 The NetBSD Foundation, Inc.
 .\"  All rights reserved.
@@ -27,7 +27,7 @@
 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 .\" POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd June 3, 2023
+.Dd June 4, 2023
 .Dt MK.CONF 5
 .Os
 .\" turn off hyphenation
@@ -94,7 +94,7 @@ or
 .
 .Bl -tag -width 15n
 .
-.\" These entries are sorted alphabetically
+.\" These entries are sorted alphabetically.
 .
 .It Sy BSDOBJDIR
 The real path to the object directory tree for the
@@ -122,11 +122,53 @@ out of date or non-existent targets.
 .
 .It Sy BUILDID
 Identifier for the build.
+If set, this should be a short string that is suitable for use as
+part of a file or directory name.
 The identifier will be appended to
 object directory names, and can be consulted in the
 .Xr make 1
 configuration file in order to set additional build parameters,
 such as compiler flags.
+It will also be used as part of the kernel version string,
+which can be shown by
+.Dq Li uname \-v .
+.DFLTu
+.
+.It Sy BUILDINFO
+Optional multi-line string containing information about the build.
+This will appear in
+.Sy DESTDIR Ns Pa /etc/release ,
+and it will be stored in the
+.Va buildinfo
+variable in any kernels that are built.
+When such kernels are booted, the
+.Xr sysctl 7
+.Va kern.buildinfo
+variable will report this value.
+The string may contain backslash escape sequences, such as
+.Dq "\e\e"
+(representing a backslash character)
+and
+.Dq "\en"
+(representing a newline).
+.DFLTu
+.
+.It Sy BUILDSEED
+.Xr g++ 1
+uses random numbers when compiling C++ code.
+This variable seeds the
+.Xr g++ 1
+random number generator using
+.Fl frandom-seed
+with this value.
+By default, it is set to
+.Do NetBSD-( Ns Em majorversion ) Dc .
+Using a fixed value causes C++ binaries to be the same when
+built from the same sources, resulting in identical (reproducible) builds.
+Additional information is available in the
+.Xr g++ 1
+documentation of
+.Fl frandom-seed .
 .DFLTu
 .
 .It Sy COPTS
@@ -134,13 +176,15 @@ Extra options for the C compiler.
 Should be appended to (e.g.,
 .Sy COPTS+=-g ) ,
 rather than explicitly set.
-Note that
+.Pp
+.Em Note :
 .Sy CPUFLAGS ,
 not
 .Sy COPTS ,
 should be used for
 compiler flags that select CPU-related options.
-Also note that
+.Pp
+.Em Note :
 .Sy CFLAGS
 should never be set in
 .Nm .
@@ -185,6 +229,34 @@ Empty string if
 .Sy USETOOLS=yes ;
 unset otherwise.
 .
+.It Sy EXTERNAL_TOOLCHAIN
+If defined, this variable indicates the root directory of
+an external toolchain which will be used to build the tree.
+For example, if a platform is a
+.Sy TOOLCHAIN_MISSING
+platform,
+.Sy EXTERNAL_TOOLCHAIN
+can be used to re-enable the cross-compile framework.
+.Pp
+If
+.Sy EXTERNAL_TOOLCHAIN
+is defined, act as
+.Sy MKGCC=no ,
+since the external version of the compiler may not be
+able to build the library components of the in-tree compiler.
+.Pp
+This variable should be used in conjunction with an appropriate
+.Sy HAVE_GCC
+or
+.Sy HAVE_LLVM
+setting to control the compiler flags.
+.Pp
+.Em Note :
+This variable is not yet used in as many places as it should be.
+Expect the exact semantics of this variable to change in the short
+term as parts of the cross-compile framework continue to be cleaned up.
+.DFLTu
+.
 .It Sy EXTSRCSRCDIR
 Obsolete.
 .
@@ -456,6 +528,11 @@ is compiled with support for
 .In complex.h .
 .DFLTy
 .
+.It Sy MKCROSSGDB
+.YorN
+Create a cross-gdb as a host tool.
+.DFLTn
+.
 .It Sy MKCRYPTO
 Obsolete.
 .
@@ -499,7 +576,13 @@ and acts as
 .
 .It Sy MKDEBUG
 .YorN
-Indicates whether separate debugging symbols should be installed into
+Indicates whether debug information should be generated for
+all userland binaries.
+The result is collected as an additional
+.Sy debug.tgz
+and
+.Sy xdebug.tgz
+set and installed in
 .Sy DESTDIR Ns Pa /usr/libdata/debug .
 .NODEF NODEBUG
 .DFLTn
@@ -510,10 +593,14 @@ Indicates whether 

CVS commit: src/share/man/man5

[Luke Mewburn]

Module Name:src
Committed By:   lukem
Date:   Sun Jun  4 20:04:52 UTC 2023

Modified Files:
src/share/man/man5: mk.conf.5

Log Message:
mk.conf(5): add more from BUILDING and bsd.README

Add from BUILDING or bsd.README:
BUILDINFO, BUILDSEED, EXTERNAL_TOOLCHAIN, MKCROSSGDB,
MKREPRO_TIMESTAMP, TOOLCHAIN_MISSING, X11SRCDIR

Clarify BUILDID.
Improve MKDEBUG, MKOBJ, MKX11, NETBSDSRCDIR, USETOOLS,
Consistent Note: formatting.


To generate a diff of this commit:
cvs rdiff -u -r1.99 -r1.100 src/share/man/man5/mk.conf.5

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

CVS commit: src/share/man/man5

[Luke Mewburn]

Module Name:src
Committed By:   lukem
Date:   Sat Jun  3 11:13:41 UTC 2023

Modified Files:
src/share/man/man5: mk.conf.5

Log Message:
mk.conf: fix the year


To generate a diff of this commit:
cvs rdiff -u -r1.98 -r1.99 src/share/man/man5/mk.conf.5

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

Modified files:

Index: src/share/man/man5/mk.conf.5
diff -u src/share/man/man5/mk.conf.5:1.98 src/share/man/man5/mk.conf.5:1.99
--- src/share/man/man5/mk.conf.5:1.98	Thu Jun  1 21:58:05 2023
+++ src/share/man/man5/mk.conf.5	Sat Jun  3 11:13:40 2023
@@ -1,4 +1,4 @@
-.\"	$NetBSD: mk.conf.5,v 1.98 2023/06/01 21:58:05 lukem Exp $
+.\"	$NetBSD: mk.conf.5,v 1.99 2023/06/03 11:13:40 lukem Exp $
 .\"
 .\"  Copyright (c) 1999-2023 The NetBSD Foundation, Inc.
 .\"  All rights reserved.
@@ -27,7 +27,7 @@
 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 .\" POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd June 1, 2022
+.Dd June 3, 2023
 .Dt MK.CONF 5
 .Os
 .\" turn off hyphenation

CVS commit: src/share/man/man5

[Luke Mewburn]

Module Name:src
Committed By:   lukem
Date:   Sat Jun  3 11:13:41 UTC 2023

Modified Files:
src/share/man/man5: mk.conf.5

Log Message:
mk.conf: fix the year


To generate a diff of this commit:
cvs rdiff -u -r1.98 -r1.99 src/share/man/man5/mk.conf.5

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

CVS commit: src/share/man/man5

[Luke Mewburn]

Module Name:src
Committed By:   lukem
Date:   Thu Jun  1 21:58:05 UTC 2023

Modified Files:
src/share/man/man5: mk.conf.5

Log Message:
mk.conf(5): update to reality

- Document:
MKAMDGPUFIRMWARE, MKARGON2, MKARZERO, MKBSDGREP,
MKCOMPATMODULES, MKCOMPATTESTS, MKCOMPATX11, MKCXX,
MKDEPINCLUDES, MKDTB, MKDTC, MKFIRMWARE, MKGROFF,
MKGROFFHTMLDOC, MKLIBCSANITIZER, MKLIBCXX, MKLIBSTDCXX,
MKLLVM, MKLLVMRT, MKMAKEMANDB, MKMANDOC, MKNSD,
MKRADEONFIRMWARE, MKRELRO, MKSANITIZER, MKSLJIT,
MKSTATICPIE, MKTEGRAFIRMWARE, MKTPM, MKUNBOUND,
MKXORG_SERVER, NETBSD_OFFICIAL_RELEASE,
USE_LIBCSANITIZER, USE_PIGZGZIP, USE_SANITIZER,
USE_XZ_SETS, X11MOTIFPATH
- Document obsolete/deprecated:
EXTSRCSRCDIR, MKBFD, MKCRYPTO, MKEXTSRC, MKKDEBUG,
MKKERBEROS4, MKLLD, MKLLDB, MKMCLINKER, MKPERFUSE,
MKTOOLSDEBUG, SHAREDSTRINGS, USE_COMBINE
- Fix defaults: MKLINT=no MKPICINSTALL=no USE_SKEY=no
- Expand upon defaults that are platform specific.
- Sort variable entries.
- If a NOxxx variable disables a variable, describe it.
- Layout of each variable: supported values, description,
  any other variables that change this variable, optional note,
  default value.
- Consistent double quotes around default strings (even paths).
- Consistent "will be" instead of "is" or "are".
- Sort order of internal macro definitions.
- Add NODEF and NOVAR macros.
- Oxford comma and semi-colons where appropriate.
- Fix mandoc -Tlint.


To generate a diff of this commit:
cvs rdiff -u -r1.97 -r1.98 src/share/man/man5/mk.conf.5

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

Modified files:

Index: src/share/man/man5/mk.conf.5
diff -u src/share/man/man5/mk.conf.5:1.97 src/share/man/man5/mk.conf.5:1.98
--- src/share/man/man5/mk.conf.5:1.97	Sat Jul  9 08:27:35 2022
+++ src/share/man/man5/mk.conf.5	Thu Jun  1 21:58:05 2023
@@ -1,6 +1,6 @@
-.\"	$NetBSD: mk.conf.5,v 1.97 2022/07/09 08:27:35 nia Exp $
+.\"	$NetBSD: mk.conf.5,v 1.98 2023/06/01 21:58:05 lukem Exp $
 .\"
-.\"  Copyright (c) 1999-2003 The NetBSD Foundation, Inc.
+.\"  Copyright (c) 1999-2023 The NetBSD Foundation, Inc.
 .\"  All rights reserved.
 .\"
 .\"  This code is derived from software contributed to The NetBSD Foundation
@@ -27,7 +27,7 @@
 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 .\" POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd July 9, 2022
+.Dd June 1, 2022
 .Dt MK.CONF 5
 .Os
 .\" turn off hyphenation
@@ -50,16 +50,14 @@ relevant manual pages.
 .
 .Ss NetBSD System variables
 .
-.de YorN
-Can be set to
-.Dq yes
-or
-.Dq no .
-..
 .de DFLT
 .Pp
 .Em Default :
 ..
+.de DFLTn
+.DFLT
+.Dq no
+..
 .de DFLTu
 .DFLT
 Unset.
@@ -68,44 +66,51 @@ Unset.
 .DFLT
 .Dq yes
 ..
-.de DFLTn
-.DFLT
+.de NODEF
+.Pp
+Forced to
+.Dq no
+if
+.Sy \\$*
+is defined,
+usually in the Makefile before any
+.Xr make 1
+.Cm \&.include
+directives.
+..
+.de NOVAR
+.Pp
+Forced to
 .Dq no
+if
+.Sy \\$* .
+..
+.de YorN
+Can be set to
+.Dq yes
+or
+.Dq no .
 ..
-.Bl -tag -width MKDYNAMICROOT
 .
-.It Sy NETBSDSRCDIR
-The path to the top level of the
-.Nx
-sources.
-If
-.Xr make 1
-is run from within the
-.Nx
-source tree, the default is the top
-level of that tree (as determined by the presence of
-.Pa build.sh
-and
-.Pa tools/ ) ,
-otherwise
-.Sy BSDSRCDIR
-will be used.
+.Bl -tag -width 15n
+.
+.\" These entries are sorted alphabetically
 .
 .It Sy BSDOBJDIR
-The real path to the
-.Sq obj
-tree for the
+The real path to the object directory tree for the
 .Nx
 source tree.
 .DFLT
-.Pa /usr/obj
+.Dq Pa /usr/obj
 .
 .It Sy BSDSRCDIR
 The real path to the
 .Nx
-source tree.
+source tree, if
+.Sy NETBSDSRCDIR
+isn't defined.
 .DFLT
-.Pa /usr/src
+.Dq Pa /usr/src
 .
 .It Sy BUILD
 If defined,
@@ -165,24 +170,25 @@ character (for installation into the sys
 to an empty string).
 The directory must reside on a file system which supports long file
 names and hard links.
-.DFLT
-Empty string if
-.Sy USETOOLS
-is
-.Dq yes ;
-unset otherwise.
 .Pp
 .Em Note :
 .Sy build.sh
 will provide a default of
-.Pa destdir. Ns Sy MACHINE
+.Dq Pa destdir . Ns Sy MACHINE
 (in the top-level
 .Sy .OBJDIR )
 unless run in
 .Sq expert
 mode
+.DFLT
+Empty string if
+.Sy USETOOLS=yes ;
+unset otherwise.
+.
+.It Sy EXTSRCSRCDIR
+Obsolete.
 .
-.It Sy KERNEL_DIR No Pq experimental
+.It Sy KERNEL_DIR Pq No experimental
 .YorN
 Indicates if a top-level directory
 .Sy /netbsd/
@@ -216,7 +222,7 @@ It is also subject to change without not
 .It Sy MAKEVERBOSE
 Level of verbosity of status messages.
 Supported values:
-.Bl -tag -width xxx
+.Bl -tag -width 2n
 .It 0
 No descriptive messages or commands executed by
 .Xr make 1
@@ -250,18 +256,57 @@ flag.
 .DFLT
 2
 .
+.It Sy MKAMDGPUFIRMWARE
+.YorN
+Indicates whether to install the
+.Pa /libdata/firmware/amdgpu
+directory, which is necessary for the
+.Xr amdgpu 4
+AMD RADEON GPU video driver.
+.DFLTy
+on

CVS commit: src/share/man/man5

[Luke Mewburn]

Module Name:src
Committed By:   lukem
Date:   Thu Jun  1 21:58:05 UTC 2023

Modified Files:
src/share/man/man5: mk.conf.5

Log Message:
mk.conf(5): update to reality

- Document:
MKAMDGPUFIRMWARE, MKARGON2, MKARZERO, MKBSDGREP,
MKCOMPATMODULES, MKCOMPATTESTS, MKCOMPATX11, MKCXX,
MKDEPINCLUDES, MKDTB, MKDTC, MKFIRMWARE, MKGROFF,
MKGROFFHTMLDOC, MKLIBCSANITIZER, MKLIBCXX, MKLIBSTDCXX,
MKLLVM, MKLLVMRT, MKMAKEMANDB, MKMANDOC, MKNSD,
MKRADEONFIRMWARE, MKRELRO, MKSANITIZER, MKSLJIT,
MKSTATICPIE, MKTEGRAFIRMWARE, MKTPM, MKUNBOUND,
MKXORG_SERVER, NETBSD_OFFICIAL_RELEASE,
USE_LIBCSANITIZER, USE_PIGZGZIP, USE_SANITIZER,
USE_XZ_SETS, X11MOTIFPATH
- Document obsolete/deprecated:
EXTSRCSRCDIR, MKBFD, MKCRYPTO, MKEXTSRC, MKKDEBUG,
MKKERBEROS4, MKLLD, MKLLDB, MKMCLINKER, MKPERFUSE,
MKTOOLSDEBUG, SHAREDSTRINGS, USE_COMBINE
- Fix defaults: MKLINT=no MKPICINSTALL=no USE_SKEY=no
- Expand upon defaults that are platform specific.
- Sort variable entries.
- If a NOxxx variable disables a variable, describe it.
- Layout of each variable: supported values, description,
  any other variables that change this variable, optional note,
  default value.
- Consistent double quotes around default strings (even paths).
- Consistent "will be" instead of "is" or "are".
- Sort order of internal macro definitions.
- Add NODEF and NOVAR macros.
- Oxford comma and semi-colons where appropriate.
- Fix mandoc -Tlint.


To generate a diff of this commit:
cvs rdiff -u -r1.97 -r1.98 src/share/man/man5/mk.conf.5

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

CVS commit: src/share/man/man5

[David H. Gutteridge]

Module Name:src
Committed By:   gutteridge
Date:   Thu Dec 29 22:41:36 UTC 2022

Modified Files:
src/share/man/man5: link.5

Log Message:
link.5: fix some spelling and grammar


To generate a diff of this commit:
cvs rdiff -u -r1.24 -r1.25 src/share/man/man5/link.5

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

Modified files:

Index: src/share/man/man5/link.5
diff -u src/share/man/man5/link.5:1.24 src/share/man/man5/link.5:1.25
--- src/share/man/man5/link.5:1.24	Mon Jul  3 21:30:59 2017
+++ src/share/man/man5/link.5	Thu Dec 29 22:41:36 2022
@@ -1,4 +1,4 @@
-.\"	$NetBSD: link.5,v 1.24 2017/07/03 21:30:59 wiz Exp $
+.\"	$NetBSD: link.5,v 1.25 2022/12/29 22:41:36 gutteridge Exp $
 .\"
 .\" Copyright (c) 1996 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -76,7 +76,7 @@ by convention accessible by the reserved
 .Em _GLOBAL_OFFSET_TABLE_ .
 The exact mechanism used for this is machine dependent, usually a machine
 register is reserved for the purpose.
-The rational behind this construct is to generate code that is
+The rationale behind this construct is to generate code that is
 independent of the actual load address.
 Only the values contained in the Global Offset Table may need
 updating at run-time depending on the load addresses of the various
@@ -99,7 +99,7 @@ Whenever
 .Em _DYNAMIC
 is relocated to 0, there is no need to invoke the run-time link-editor.
 If this symbol is non-zero, it points at a data structure from
-which the location of the necessary relocation- and symbol information
+which the location of the necessary relocation and symbol information
 can be derived.
 This is most notably used by the start-up module,
 .Em crt0 .
@@ -380,7 +380,7 @@ The
 .Fa rt_symbol
 structure is used to keep track of run-time allocated commons
 and data items copied from shared objects.
-These items are kept on linked list and is exported through the
+These items are kept in a linked list which is exported through the
 .Fa dd_cc
 field in the
 .Fa so_debug

CVS commit: src/share/man/man5

[David H. Gutteridge]

Module Name:src
Committed By:   gutteridge
Date:   Thu Dec 29 22:41:36 UTC 2022

Modified Files:
src/share/man/man5: link.5

Log Message:
link.5: fix some spelling and grammar


To generate a diff of this commit:
cvs rdiff -u -r1.24 -r1.25 src/share/man/man5/link.5

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

CVS commit: src/share/man/man5

[Jan Schaumann]

Module Name:src
Committed By:   jschauma
Date:   Tue Nov 29 14:15:01 UTC 2022

Modified Files:
src/share/man/man5: protocols.5

Log Message:
be more specific about what /etc/protocols describes

The reference to the "DARPA Internet" seems not quite up to date in 2022,
so moving that to the HISTORY section.


To generate a diff of this commit:
cvs rdiff -u -r1.7 -r1.8 src/share/man/man5/protocols.5

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

Modified files:

Index: src/share/man/man5/protocols.5
diff -u src/share/man/man5/protocols.5:1.7 src/share/man/man5/protocols.5:1.8
--- src/share/man/man5/protocols.5:1.7	Thu Aug  7 10:31:17 2003
+++ src/share/man/man5/protocols.5	Tue Nov 29 14:15:01 2022
@@ -1,4 +1,4 @@
-.\"	$NetBSD: protocols.5,v 1.7 2003/08/07 10:31:17 agc Exp $
+.\"	$NetBSD: protocols.5,v 1.8 2022/11/29 14:15:01 jschauma Exp $
 .\"
 .\" Copyright (c) 1983, 1991, 1993
 .\"	The Regents of the University of California.  All rights reserved.
@@ -29,7 +29,7 @@
 .\"
 .\" @(#)protocols.5	8.1 (Berkeley) 6/5/93
 .\"
-.Dd June 5, 1993
+.Dd November 27, 2022
 .Dt PROTOCOLS 5
 .Os
 .Sh NAME
@@ -38,9 +38,9 @@
 .Sh DESCRIPTION
 The
 .Nm protocols
-file contains information regarding the known protocols used in the
-.Tn DARPA
-Internet.  For each protocol a single line should be present
+file contains information regarding the assigned protocol numbers
+used by IPv4 and IPv6 to identify the next level protocol.
+For each protocol a single line should be present
 with the following information:
 .Bd -unfilled -offset indent
 official protocol name
@@ -68,10 +68,23 @@ file resides in
 .El
 .Sh SEE ALSO
 .Xr getprotoent 3
+.Rs
+.%R RFC 2780
+.%D March 2000
+.%T "IANA Allocation Guidelines For Values In the \
+Internet Protocol and Related Headers"
+.Re
+.Rs
+.%R RFC 5237
+.%D February 2008
+.%T "IANA Allocation Guidelines for the Protocol Field"
+.Re
 .Sh HISTORY
 The
 .Nm
 file format appeared in
-.Bx 4.2 .
+.Bx 4.2 ,
+describing the "known protocols used in the DARPA
+Internet".
 .Sh BUGS
 A name server should be used instead of a static file.

CVS commit: src/share/man/man5

[Jan Schaumann]

Module Name:src
Committed By:   jschauma
Date:   Tue Nov 29 14:15:01 UTC 2022

Modified Files:
src/share/man/man5: protocols.5

Log Message:
be more specific about what /etc/protocols describes

The reference to the "DARPA Internet" seems not quite up to date in 2022,
so moving that to the HISTORY section.


To generate a diff of this commit:
cvs rdiff -u -r1.7 -r1.8 src/share/man/man5/protocols.5

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

CVS commit: src/share/man/man5

[Christos Zoulas]

Module Name:src
Committed By:   christos
Date:   Fri Oct 21 18:21:56 UTC 2022

Modified Files:
src/share/man/man5: printcap.5

Log Message:
Explain when the filters are used.


To generate a diff of this commit:
cvs rdiff -u -r1.27 -r1.28 src/share/man/man5/printcap.5

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

Modified files:

Index: src/share/man/man5/printcap.5
diff -u src/share/man/man5/printcap.5:1.27 src/share/man/man5/printcap.5:1.28
--- src/share/man/man5/printcap.5:1.27	Sun Apr 22 06:18:47 2012
+++ src/share/man/man5/printcap.5	Fri Oct 21 14:21:56 2022
@@ -1,4 +1,4 @@
-.\"	$NetBSD: printcap.5,v 1.27 2012/04/22 10:18:47 wiz Exp $
+.\"	$NetBSD: printcap.5,v 1.28 2022/10/21 18:21:56 christos Exp $
 .\"
 .\" Copyright (c) 1983, 1991, 1993
 .\"	The Regents of the University of California.  All rights reserved.
@@ -29,7 +29,7 @@
 .\"
 .\" @(#)printcap.5	8.2 (Berkeley) 12/11/93
 .\"
-.Dd April 5, 2012
+.Dd October 21, 2022
 .Dt PRINTCAP 5
 .Os
 .Sh NAME
@@ -148,7 +148,11 @@ to process files for various printer typ
 The pipeline is not set up for remote printers specified via
 .Sy rm
 unless the local host is the same as the remote printer host
-given.
+given or
+.Xr lpd 8
+is run with the
+.Fl r
+flag.
 The filters selected depend on the flags passed to
 .Xr lpr 1 .
 The pipeline set up is:

CVS commit: src/share/man/man5

[Christos Zoulas]

Module Name:src
Committed By:   christos
Date:   Fri Oct 21 18:21:56 UTC 2022

Modified Files:
src/share/man/man5: printcap.5

Log Message:
Explain when the filters are used.


To generate a diff of this commit:
cvs rdiff -u -r1.27 -r1.28 src/share/man/man5/printcap.5

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

CVS commit: src/share/man/man5

[Nia Alarie]

Module Name:src
Committed By:   nia
Date:   Sat Jul  9 08:27:35 UTC 2022

Modified Files:
src/share/man/man5: mk.conf.5

Log Message:
mk.conf(5): we default to USE_SSP=yes these days.


To generate a diff of this commit:
cvs rdiff -u -r1.96 -r1.97 src/share/man/man5/mk.conf.5

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

Modified files:

Index: src/share/man/man5/mk.conf.5
diff -u src/share/man/man5/mk.conf.5:1.96 src/share/man/man5/mk.conf.5:1.97
--- src/share/man/man5/mk.conf.5:1.96	Mon Jun  6 10:56:28 2022
+++ src/share/man/man5/mk.conf.5	Sat Jul  9 08:27:35 2022
@@ -1,4 +1,4 @@
-.\"	$NetBSD: mk.conf.5,v 1.96 2022/06/06 10:56:28 nia Exp $
+.\"	$NetBSD: mk.conf.5,v 1.97 2022/07/09 08:27:35 nia Exp $
 .\"
 .\"  Copyright (c) 1999-2003 The NetBSD Foundation, Inc.
 .\"  All rights reserved.
@@ -27,7 +27,7 @@
 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 .\" POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd December 20, 2021
+.Dd July 9, 2022
 .Dt MK.CONF 5
 .Os
 .\" turn off hyphenation
@@ -1073,7 +1073,7 @@ Indicates whether GCC stack-smashing pro
 which detects stack overflows and aborts the program,
 is enabled.
 This imposes some performance penalty.
-.DFLTn
+.DFLTy
 .
 .It Sy USE_YP
 .YorN

CVS commit: src/share/man/man5

[Nia Alarie]

Module Name:src
Committed By:   nia
Date:   Sat Jul  9 08:27:35 UTC 2022

Modified Files:
src/share/man/man5: mk.conf.5

Log Message:
mk.conf(5): we default to USE_SSP=yes these days.


To generate a diff of this commit:
cvs rdiff -u -r1.96 -r1.97 src/share/man/man5/mk.conf.5

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

CVS commit: src/share/man/man5

[Nia Alarie]

Module Name:src
Committed By:   nia
Date:   Sun May 29 08:15:47 UTC 2022

Modified Files:
src/share/man/man5: mk.conf.5

Log Message:
Document MKPPP


To generate a diff of this commit:
cvs rdiff -u -r1.93 -r1.94 src/share/man/man5/mk.conf.5

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

Modified files:

Index: src/share/man/man5/mk.conf.5
diff -u src/share/man/man5/mk.conf.5:1.93 src/share/man/man5/mk.conf.5:1.94
--- src/share/man/man5/mk.conf.5:1.93	Sat May 28 14:31:12 2022
+++ src/share/man/man5/mk.conf.5	Sun May 29 08:15:47 2022
@@ -1,4 +1,4 @@
-.\"	$NetBSD: mk.conf.5,v 1.93 2022/05/28 14:31:12 nia Exp $
+.\"	$NetBSD: mk.conf.5,v 1.94 2022/05/29 08:15:47 nia Exp $
 .\"
 .\"  Copyright (c) 1999-2003 The NetBSD Foundation, Inc.
 .\"  All rights reserved.
@@ -27,7 +27,7 @@
 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 .\" POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd May 27, 2022
+.Dd May 29, 2022
 .Dt MK.CONF 5
 .Os
 .\" turn off hyphenation
@@ -806,6 +806,20 @@ utility is not installed as
 Indicates whether Postfix is built.
 .DFLTy
 .
+.It Sy MKPPP
+.YorN
+Indicates whether the Point-to-Point Protocol daemon
+.Xr pppd 8 ,
+as well as related utilities
+.Xr chat 8 ,
+.Xr pppdump 8 ,
+and
+.Xr pppstats 8
+will be built and installed.
+This option has no effect on PPPoE (Point-to-Point over Ethernet) support,
+but rather only affects serial links.
+.DFLTy
+.
 .It Sy MKPROFILE
 .YorN
 Indicates whether profiled libraries

CVS commit: src/share/man/man5

[Nia Alarie]

Module Name:src
Committed By:   nia
Date:   Sun May 29 08:15:47 UTC 2022

Modified Files:
src/share/man/man5: mk.conf.5

Log Message:
Document MKPPP


To generate a diff of this commit:
cvs rdiff -u -r1.93 -r1.94 src/share/man/man5/mk.conf.5

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

CVS commit: src/share/man/man5

[Nia Alarie]

Module Name:src
Committed By:   nia
Date:   Fri May 27 09:25:08 UTC 2022

Modified Files:
src/share/man/man5: mk.conf.5

Log Message:
Document MKLFS


To generate a diff of this commit:
cvs rdiff -u -r1.90 -r1.91 src/share/man/man5/mk.conf.5

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

Modified files:

Index: src/share/man/man5/mk.conf.5
diff -u src/share/man/man5/mk.conf.5:1.90 src/share/man/man5/mk.conf.5:1.91
--- src/share/man/man5/mk.conf.5:1.90	Thu May 26 14:24:42 2022
+++ src/share/man/man5/mk.conf.5	Fri May 27 09:25:08 2022
@@ -1,4 +1,4 @@
-.\"	$NetBSD: mk.conf.5,v 1.90 2022/05/26 14:24:42 uwe Exp $
+.\"	$NetBSD: mk.conf.5,v 1.91 2022/05/27 09:25:08 nia Exp $
 .\"
 .\"  Copyright (c) 1999-2003 The NetBSD Foundation, Inc.
 .\"  All rights reserved.
@@ -573,6 +573,17 @@ infrastructure
 (libraries and support programs) is built and installed.
 .DFLTy
 .
+.It Sy MKLFS
+.YorN
+Indicates whether the log-structured file system (LFS) programs
+are built and installed, i.e.
+.Xr newfs_lfs 8 ,
+.Xr mount_lfs 8 ,
+.Xr dumplfs 8 ,
+etc.
+.DFLTy
+.
+.
 .It Sy MKLINKLIB
 .YorN
 Indicates whether all of the shared library infrastructure is built.

CVS commit: src/share/man/man5

[Nia Alarie]

Module Name:src
Committed By:   nia
Date:   Fri May 27 09:25:08 UTC 2022

Modified Files:
src/share/man/man5: mk.conf.5

Log Message:
Document MKLFS


To generate a diff of this commit:
cvs rdiff -u -r1.90 -r1.91 src/share/man/man5/mk.conf.5

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

CVS commit: src/share/man/man5

[Valeriy E. Ushakov]

Module Name:src
Committed By:   uwe
Date:   Thu May 26 14:24:42 UTC 2022

Modified Files:
src/share/man/man5: mk.conf.5

Log Message:
mk.conf(5): Don't make "experimental" comment stand out.


To generate a diff of this commit:
cvs rdiff -u -r1.89 -r1.90 src/share/man/man5/mk.conf.5

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

CVS commit: src/share/man/man5

[Valeriy E. Ushakov]

Module Name:src
Committed By:   uwe
Date:   Thu May 26 14:24:42 UTC 2022

Modified Files:
src/share/man/man5: mk.conf.5

Log Message:
mk.conf(5): Don't make "experimental" comment stand out.


To generate a diff of this commit:
cvs rdiff -u -r1.89 -r1.90 src/share/man/man5/mk.conf.5

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

Modified files:

Index: src/share/man/man5/mk.conf.5
diff -u src/share/man/man5/mk.conf.5:1.89 src/share/man/man5/mk.conf.5:1.90
--- src/share/man/man5/mk.conf.5:1.89	Thu May 26 06:33:03 2022
+++ src/share/man/man5/mk.conf.5	Thu May 26 14:24:42 2022
@@ -1,4 +1,4 @@
-.\"	$NetBSD: mk.conf.5,v 1.89 2022/05/26 06:33:03 nia Exp $
+.\"	$NetBSD: mk.conf.5,v 1.90 2022/05/26 14:24:42 uwe Exp $
 .\"
 .\"  Copyright (c) 1999-2003 The NetBSD Foundation, Inc.
 .\"  All rights reserved.
@@ -182,7 +182,7 @@ unless run in
 .Sq expert
 mode
 .
-.It Sy KERNEL_DIR (EXPERIMENTAL)
+.It Sy KERNEL_DIR No Pq experimental
 .YorN
 Indicates if a top-level directory
 .Sy /netbsd/

CVS commit: src/share/man/man5

[Nia Alarie]

Module Name:src
Committed By:   nia
Date:   Thu May 26 06:33:03 UTC 2022

Modified Files:
src/share/man/man5: mk.conf.5

Log Message:
Document some more build options. Delint.


To generate a diff of this commit:
cvs rdiff -u -r1.88 -r1.89 src/share/man/man5/mk.conf.5

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

Modified files:

Index: src/share/man/man5/mk.conf.5
diff -u src/share/man/man5/mk.conf.5:1.88 src/share/man/man5/mk.conf.5:1.89
--- src/share/man/man5/mk.conf.5:1.88	Wed May 25 21:25:47 2022
+++ src/share/man/man5/mk.conf.5	Thu May 26 06:33:03 2022
@@ -1,4 +1,4 @@
-.\"	$NetBSD: mk.conf.5,v 1.88 2022/05/25 21:25:47 nia Exp $
+.\"	$NetBSD: mk.conf.5,v 1.89 2022/05/26 06:33:03 nia Exp $
 .\"
 .\"  Copyright (c) 1999-2003 The NetBSD Foundation, Inc.
 .\"  All rights reserved.
@@ -27,7 +27,7 @@
 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 .\" POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd May 23, 2022
+.Dd May 26, 2022
 .Dt MK.CONF 5
 .Os
 .\" turn off hyphenation
@@ -406,7 +406,7 @@ will be included in the build toolchain.
 .
 .It Sy MKDHCPD
 .YorN
-Indicates whether 
+Indicates whether
 .Xr dhcpd 8
 will be built and installed.
 .DFLTy
@@ -643,7 +643,7 @@ Indicates whether the mDNS (Multicast DN
 .It Sy MKMROUITNG
 .YorN
 Indicates whether multicast routing applications will be built and
-installed, i.e. 
+installed, i.e.
 .Xr map-mbone 8 ,
 .Xr mrinfo 8 ,
 .Xr mrouted 8 ,
@@ -660,6 +660,14 @@ Indicates whether Native Language System
 built and installed.
 .DFLTy
 .
+.It Sy MKNOUVEAUFIRMWARE
+.YorN
+Indicates whether to install the
+.Pa /libdata/firmware/nouveau
+directory, which is necessary for the nvidia DRM driver.
+.DFLT
+Platform dependent.
+.
 .It Sy MKNPF
 .YorN
 Indicates whether the NPF packet filter is to be built and installed.
@@ -751,7 +759,8 @@ used to generate shared libraries.
 .It Sy MKPIE
 Indicates whether Position Independent Executables (PIE)
 are built and installed.
-.DFLTn
+.DFLT
+Platform dependent.
 .
 .It Sy MKPIGZGZIP
 .YorN
@@ -788,6 +797,24 @@ two builds from the same source tree wil
 results.
 .DFLTn
 .
+.It Sy MKRADEONFIRMWARE
+.YorN
+Indicates whether to install the
+.Pa /libdata/firmware/radeon
+directory, which is necessary for the radeon DRM driver.
+.DFLT
+Platform dependent.
+.
+.It Sy MKRELRO
+If
+.Dq partial ,
+set the non-PLT GOT to read-only.
+If
+.Dq full ,
+also force immediate symbol binding.
+.DFLT
+Platform dependent.
+.
 .It Sy MKRUMP
 .YorN
 Indicates whether the

CVS commit: src/share/man/man5

[Nia Alarie]

Module Name:src
Committed By:   nia
Date:   Thu May 26 06:33:03 UTC 2022

Modified Files:
src/share/man/man5: mk.conf.5

Log Message:
Document some more build options. Delint.


To generate a diff of this commit:
cvs rdiff -u -r1.88 -r1.89 src/share/man/man5/mk.conf.5

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

CVS commit: src/share/man/man5

[Frederic Cambus]

Module Name:src
Committed By:   fcambus
Date:   Fri Apr 15 16:30:09 UTC 2022

Modified Files:
src/share/man/man5: boot.cfg.5

Log Message:
boot.cfg.5: banner can span up to 12 lines, and not 10 like stated.

For the record, the value is set by the BOOTCFG_MAXBANNER macro defined
in sys/lib/libsa/bootcfg.h.


To generate a diff of this commit:
cvs rdiff -u -r1.31 -r1.32 src/share/man/man5/boot.cfg.5

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

Modified files:

Index: src/share/man/man5/boot.cfg.5
diff -u src/share/man/man5/boot.cfg.5:1.31 src/share/man/man5/boot.cfg.5:1.32
--- src/share/man/man5/boot.cfg.5:1.31	Tue Nov 24 07:46:46 2020
+++ src/share/man/man5/boot.cfg.5	Fri Apr 15 16:30:09 2022
@@ -1,4 +1,4 @@
-.\"	$NetBSD: boot.cfg.5,v 1.31 2020/11/24 07:46:46 kim Exp $
+.\"	$NetBSD: boot.cfg.5,v 1.32 2022/04/15 16:30:09 fcambus Exp $
 .\"
 .\" Copyright (c) 2007 Stephen Borrill
 .\" All rights reserved.
@@ -65,7 +65,7 @@ using multiple entries.
 .It Sy banner
 The text from banner lines is displayed instead of the standard welcome text
 by the boot loader.
-Up to 10 lines can be defined.
+Up to 12 lines can be defined.
 No special character sequences are recognised, so to specify a blank line, a
 banner line with no value should be given.
 .It Sy clear

CVS commit: src/share/man/man5

[Frederic Cambus]

Module Name:src
Committed By:   fcambus
Date:   Fri Apr 15 16:30:09 UTC 2022

Modified Files:
src/share/man/man5: boot.cfg.5

Log Message:
boot.cfg.5: banner can span up to 12 lines, and not 10 like stated.

For the record, the value is set by the BOOTCFG_MAXBANNER macro defined
in sys/lib/libsa/bootcfg.h.


To generate a diff of this commit:
cvs rdiff -u -r1.31 -r1.32 src/share/man/man5/boot.cfg.5

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

CVS commit: src/share/man/man5

[Alexander Nasonov]

Module Name:src
Committed By:   alnsn
Date:   Sun Feb 20 14:43:39 UTC 2022

Modified Files:
src/share/man/man5: rc.conf.5

Log Message:
Document critical_filesystems_zfs.


To generate a diff of this commit:
cvs rdiff -u -r1.191 -r1.192 src/share/man/man5/rc.conf.5

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

Modified files:

Index: src/share/man/man5/rc.conf.5
diff -u src/share/man/man5/rc.conf.5:1.191 src/share/man/man5/rc.conf.5:1.192
--- src/share/man/man5/rc.conf.5:1.191	Sun Feb 20 10:49:17 2022
+++ src/share/man/man5/rc.conf.5	Sun Feb 20 14:43:39 2022
@@ -1,4 +1,4 @@
-.\"	$NetBSD: rc.conf.5,v 1.191 2022/02/20 10:49:17 alnsn Exp $
+.\"	$NetBSD: rc.conf.5,v 1.192 2022/02/20 14:43:39 alnsn Exp $
 .\"
 .\" Copyright (c) 1996 Matthew R. Green
 .\" All rights reserved.
@@ -321,6 +321,17 @@ where the
 prefix means that it is not an error if the file system is not
 present in
 .Xr fstab 5 .
+.It Sy critical_filesystems_zfs
+A string.
+Mount non-legacy ZFS file systems right after mounting local
+file systems listed in
+.Sy critical_filesystems_local
+variable.
+An entry can be prefixed with
+.Ql "OPTIONAL:"
+which means that it is not an error if the file system is not present
+among available ZFS datasets.
+The default is ''.
 .It Sy fsck_flags
 A string.
 A file system is checked with

CVS commit: src/share/man/man5

[Alexander Nasonov]

Module Name:src
Committed By:   alnsn
Date:   Sun Feb 20 14:43:39 UTC 2022

Modified Files:
src/share/man/man5: rc.conf.5

Log Message:
Document critical_filesystems_zfs.


To generate a diff of this commit:
cvs rdiff -u -r1.191 -r1.192 src/share/man/man5/rc.conf.5

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

CVS commit: src/share/man/man5

[Alexander Nasonov]

Module Name:src
Committed By:   alnsn
Date:   Sun Feb 20 10:49:17 UTC 2022

Modified Files:
src/share/man/man5: rc.conf.5

Log Message:
Document zfs variable.


To generate a diff of this commit:
cvs rdiff -u -r1.190 -r1.191 src/share/man/man5/rc.conf.5

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

CVS commit: src/share/man/man5

[Alexander Nasonov]

Module Name:src
Committed By:   alnsn
Date:   Sun Feb 20 10:49:17 UTC 2022

Modified Files:
src/share/man/man5: rc.conf.5

Log Message:
Document zfs variable.


To generate a diff of this commit:
cvs rdiff -u -r1.190 -r1.191 src/share/man/man5/rc.conf.5

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

Modified files:

Index: src/share/man/man5/rc.conf.5
diff -u src/share/man/man5/rc.conf.5:1.190 src/share/man/man5/rc.conf.5:1.191
--- src/share/man/man5/rc.conf.5:1.190	Fri Jan 15 15:18:32 2021
+++ src/share/man/man5/rc.conf.5	Sun Feb 20 10:49:17 2022
@@ -1,4 +1,4 @@
-.\"	$NetBSD: rc.conf.5,v 1.190 2021/01/15 15:18:32 riastradh Exp $
+.\"	$NetBSD: rc.conf.5,v 1.191 2022/02/20 10:49:17 alnsn Exp $
 .\"
 .\" Copyright (c) 1996 Matthew R. Green
 .\" All rights reserved.
@@ -55,7 +55,7 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.Dd September 11, 2020
+.Dd February 20, 2022
 .Dt RC.CONF 5
 .Os
 .Sh NAME
@@ -416,6 +416,9 @@ RAIDframe disk devices.
 See
 .Xr raidctl 8
 for additional details.
+.It Sy zfs
+Boolean value.
+Configures ZFS storage pools and ZFS file systems.
 .El
 .Ss One-time actions to perform or programs to run on boot-up
 .Bl -tag -width net_interfaces

CVS commit: src/share/man/man5

[Christos Zoulas]

Module Name:src
Committed By:   christos
Date:   Mon Nov 15 17:41:20 UTC 2021

Modified Files:
src/share/man/man5: acct.5

Log Message:
Explain the state of ASU and ACOMPAT.


To generate a diff of this commit:
cvs rdiff -u -r1.9 -r1.10 src/share/man/man5/acct.5

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

CVS commit: src/share/man/man5

[Christos Zoulas]

Module Name:src
Committed By:   christos
Date:   Mon Nov 15 17:41:20 UTC 2021

Modified Files:
src/share/man/man5: acct.5

Log Message:
Explain the state of ASU and ACOMPAT.


To generate a diff of this commit:
cvs rdiff -u -r1.9 -r1.10 src/share/man/man5/acct.5

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

Modified files:

Index: src/share/man/man5/acct.5
diff -u src/share/man/man5/acct.5:1.9 src/share/man/man5/acct.5:1.10
--- src/share/man/man5/acct.5:1.9	Fri Dec 22 03:00:20 2006
+++ src/share/man/man5/acct.5	Mon Nov 15 12:41:20 2021
@@ -1,4 +1,4 @@
-.\"	$NetBSD: acct.5,v 1.9 2006/12/22 08:00:20 ad Exp $
+.\"	$NetBSD: acct.5,v 1.10 2021/11/15 17:41:20 christos Exp $
 .\"
 .\" Copyright (c) 1991, 1993
 .\"	The Regents of the University of California.  All rights reserved.
@@ -29,7 +29,7 @@
 .\"
 .\" @(#)acct.5	8.1 (Berkeley) 6/5/93
 .\"
-.Dd December 22, 2006
+.Dd November 15, 2021
 .Dt ACCT 5
 .Os
 .Sh NAME
@@ -92,16 +92,36 @@ is saved in the field
 and its status is saved by setting one of more of the following flags in
 .Fa ac_flag :
 .Dv AFORK ,
-.Dv ACORE
+.Dv ACORE ,
 and
-.Dv ASIG .
+.Dv AXSIG .
 .Pp
 The
 .Dv ASU
-and
+flag is not recorded anymore because with the switch to
+.Xr kauth 9 ,
+the superuser model is optional and passing the affected process to every
+authorization call in order to record
+.Dv ASU
+in
+.Fa p_acflag ,
+would require many source changes and would not reflect reality because
+the authorization decision might not have been done based on the 
+.Xr secmodel_suser 9 
+model.
+.Pp
+The
+.Dv ACOMPAT
+flag was never recorded in
+.Nx ;
+we could consider setting when the a process is running under emulation,
+but this is not currently done.
+.Pp
+Both the
+.Dv ASU
+and the
 .Dv ACOMPAT
-flags are no longer recorded by the system, but are retained for source
-compatibility.
+flags are retained for source compatibility.
 .Sh SEE ALSO
 .Xr lastcomm 1 ,
 .Xr acct 2 ,

CVS commit: src/share/man/man5

[Nia Alarie]

Module Name:src
Committed By:   nia
Date:   Tue Oct 12 11:08:14 UTC 2021

Modified Files:
src/share/man/man5: passwd.conf.5

Log Message:
passwd.conf.5: document using argon2


To generate a diff of this commit:
cvs rdiff -u -r1.11 -r1.12 src/share/man/man5/passwd.conf.5

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

Modified files:

Index: src/share/man/man5/passwd.conf.5
diff -u src/share/man/man5/passwd.conf.5:1.11 src/share/man/man5/passwd.conf.5:1.12
--- src/share/man/man5/passwd.conf.5:1.11	Mon Jul  3 21:30:59 2017
+++ src/share/man/man5/passwd.conf.5	Tue Oct 12 11:08:14 2021
@@ -1,4 +1,4 @@
-.\"	$NetBSD: passwd.conf.5,v 1.11 2017/07/03 21:30:59 wiz Exp $
+.\"	$NetBSD: passwd.conf.5,v 1.12 2021/10/12 11:08:14 nia Exp $
 .\"
 .\" Copyright 1997 Niels Provos 
 .\" All rights reserved.
@@ -28,7 +28,7 @@
 .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
 .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd December 3, 2010
+.Dd October 12, 2021
 .Dt PASSWD.CONF 5
 .Os
 .Sh NAME
@@ -59,19 +59,34 @@ Some fields and their possible values th
 The cipher to use for local passwords.
 .Pp
 Possible values are:
+.Dq argon2d, ,
+.Dq argon2i, ,
+.Dq argon2id, ,
 .Dq old ,
 .Dq newsalt, ,
 .Dq md5 ,
 .Dq sha1, ,
 and
 .Dq blowfish, .
+.Pp
+For
+.Dq argon2d ,
+.Dq argon2i ,
+and
+.Dq argon2id ,
+optional hardness parameters can be specified as described in the
+manual for
+.Xr pwhash 1 .
+.Pp
 For
 .Dq newsalt
 the value of rounds is a 24-bit integer with a minimum of 7250 rounds.
+.Pp
 For
 .Dq sha1
 the value of rounds is a 32-bit integer, 0 means use the default
 of 24680.
+.Pp
 For
 .Dq blowfish
 the value can be between 4 and 31.

CVS commit: src/share/man/man5

[Nia Alarie]

Module Name:src
Committed By:   nia
Date:   Tue Oct 12 11:08:14 UTC 2021

Modified Files:
src/share/man/man5: passwd.conf.5

Log Message:
passwd.conf.5: document using argon2


To generate a diff of this commit:
cvs rdiff -u -r1.11 -r1.12 src/share/man/man5/passwd.conf.5

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

re: CVS commit: src/share/man/man5

[matthew green]

> Note that `entropy' is not an `rcvar' the way upsdriver is (if your

ah!  i missed this, and wasn't really even thinking about
more than foo and foo_flags.  thanks!


.mrg.

Re: CVS commit: src/share/man/man5

[Valery Ushakov]

On Sat, Jan 16, 2021 at 14:46:46 +1100, matthew green wrote:

> > Log Message:
> > Tweak wording for consistency: `if empty or not set', not `if unset'.
> 
> is this correct?
> 
> rc complains if unset or not set (ie, if "$foo" is zero length):
> 
> /etc/rc.d/upsdriver: WARNING: $upsdriver is not set properly - see rc.conf(5).

What Taylor said.  The above warning reflects the status of
checkyesnox() that checks that the value is yes/true/1 or no/false/0.

-uwe

Re: CVS commit: src/share/man/man5

[Taylor R Campbell]

> Date: Sat, 16 Jan 2021 14:46:46 +1100
> from: matthew green 
> 
> > Log Message:
> > Tweak wording for consistency: `if empty or not set', not `if unset'.
> 
> is this correct?
> 
> rc complains if unset or not set (ie, if "$foo" is zero length):
> 
> /etc/rc.d/upsdriver: WARNING: $upsdriver is not set properly - see rc.conf(5).

The allowed settings are:

entropy=check
entropy=wait
entropy=""

Note that `entropy' is not an `rcvar' the way upsdriver is (if your
/etc/rc.d/upsdriver is pkgsrc/sysutils/ups-nut/files/upsdriver.sh).
Compare, e.g., `domainname' or `hostname' in rc.conf(5).

re: CVS commit: src/share/man/man5

[matthew green]

> Log Message:
> Tweak wording for consistency: `if empty or not set', not `if unset'.

is this correct?

rc complains if unset or not set (ie, if "$foo" is zero length):

/etc/rc.d/upsdriver: WARNING: $upsdriver is not set properly - see rc.conf(5).


.mrg.

CVS commit: src/share/man/man5

[Andreas Gustafsson]

Module Name:src
Committed By:   gson
Date:   Mon Sep 16 12:57:10 UTC 2019

Modified Files:
src/share/man/man5: mk.conf.5

Log Message:
MKZFS is no longer the default on i386; it was disabled in 2015 in
bsd.own.mk 1.846.


To generate a diff of this commit:
cvs rdiff -u -r1.78 -r1.79 src/share/man/man5/mk.conf.5

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

Modified files:

Index: src/share/man/man5/mk.conf.5
diff -u src/share/man/man5/mk.conf.5:1.78 src/share/man/man5/mk.conf.5:1.79
--- src/share/man/man5/mk.conf.5:1.78	Wed Feb 20 17:48:31 2019
+++ src/share/man/man5/mk.conf.5	Mon Sep 16 12:57:10 2019
@@ -1,4 +1,4 @@
-.\"	$NetBSD: mk.conf.5,v 1.78 2019/02/20 17:48:31 wiz Exp $
+.\"	$NetBSD: mk.conf.5,v 1.79 2019/09/16 12:57:10 gson Exp $
 .\"
 .\"  Copyright (c) 1999-2003 The NetBSD Foundation, Inc.
 .\"  All rights reserved.
@@ -27,7 +27,7 @@
 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 .\" POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd February 19, 2019
+.Dd September 16, 2019
 .Dt MK.CONF 5
 .Os
 .\" turn off hyphenation
@@ -852,7 +852,7 @@ Indicates whether the YP (NIS) infrastru
 Indicates whether the ZFS kernel module and the utilities and
 libraries used to manage the ZFS system are to be built.
 .DFLTy
-on i386 and amd64,
+on amd64,
 .Dq no
 on other architectures.
 .

CVS commit: src/share/man/man5

[Andreas Gustafsson]

Module Name:src
Committed By:   gson
Date:   Mon Sep 16 12:57:10 UTC 2019

Modified Files:
src/share/man/man5: mk.conf.5

Log Message:
MKZFS is no longer the default on i386; it was disabled in 2015 in
bsd.own.mk 1.846.


To generate a diff of this commit:
cvs rdiff -u -r1.78 -r1.79 src/share/man/man5/mk.conf.5

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

CVS commit: src/share/man/man5

[David H. Gutteridge]

Module Name:src
Committed By:   gutteridge
Date:   Sun Sep 15 21:04:40 UTC 2019

Modified Files:
src/share/man/man5: fstab.5

Log Message:
fstab.5: add mention of zfs


To generate a diff of this commit:
cvs rdiff -u -r1.44 -r1.45 src/share/man/man5/fstab.5

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

CVS commit: src/share/man/man5

[David H. Gutteridge]

Module Name:src
Committed By:   gutteridge
Date:   Sun Sep 15 21:04:40 UTC 2019

Modified Files:
src/share/man/man5: fstab.5

Log Message:
fstab.5: add mention of zfs


To generate a diff of this commit:
cvs rdiff -u -r1.44 -r1.45 src/share/man/man5/fstab.5

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

Modified files:

Index: src/share/man/man5/fstab.5
diff -u src/share/man/man5/fstab.5:1.44 src/share/man/man5/fstab.5:1.45
--- src/share/man/man5/fstab.5:1.44	Sat Oct  6 13:09:53 2018
+++ src/share/man/man5/fstab.5	Sun Sep 15 21:04:40 2019
@@ -1,4 +1,4 @@
-.\"	$NetBSD: fstab.5,v 1.44 2018/10/06 13:09:53 jmcneill Exp $
+.\"	$NetBSD: fstab.5,v 1.45 2019/09/15 21:04:40 gutteridge Exp $
 .\"
 .\" Copyright (c) 1980, 1989, 1991, 1993
 .\"	The Regents of the University of California.  All rights reserved.
@@ -29,7 +29,7 @@
 .\"
 .\" @(#)fstab.5	8.1 (Berkeley) 6/5/93
 .\"
-.Dd October 6, 2018
+.Dd September 15, 2019
 .Dt FSTAB 5
 .Os
 .Sh NAME
@@ -173,6 +173,8 @@ an efficient memory file system.
 a user and group re-mapping file system.
 .It Em union
 a translucent file system.
+.It Em zfs
+a ZFS file system.
 .El
 .Pp
 The fourth field,

CVS commit: src/share/man/man5

[Sevan Janiyan]

Module Name:src
Committed By:   sevan
Date:   Mon Sep  9 00:21:03 UTC 2019

Modified Files:
src/share/man/man5: utmp.5

Log Message:
wtmp was actually arount in v2
https://www.tuhs.org/Archive/Distributions/Research/1972_stuff/unix_2nd_edition_manual.pdf
via Ingo Schwarze 


To generate a diff of this commit:
cvs rdiff -u -r1.17 -r1.18 src/share/man/man5/utmp.5

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

CVS commit: src/share/man/man5

[Sevan Janiyan]

Module Name:src
Committed By:   sevan
Date:   Mon Sep  9 00:21:03 UTC 2019

Modified Files:
src/share/man/man5: utmp.5

Log Message:
wtmp was actually arount in v2
https://www.tuhs.org/Archive/Distributions/Research/1972_stuff/unix_2nd_edition_manual.pdf
via Ingo Schwarze 


To generate a diff of this commit:
cvs rdiff -u -r1.17 -r1.18 src/share/man/man5/utmp.5

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

Modified files:

Index: src/share/man/man5/utmp.5
diff -u src/share/man/man5/utmp.5:1.17 src/share/man/man5/utmp.5:1.18
--- src/share/man/man5/utmp.5:1.17	Sun Sep  1 19:04:59 2019
+++ src/share/man/man5/utmp.5	Mon Sep  9 00:21:03 2019
@@ -1,4 +1,4 @@
-.\"	$NetBSD: utmp.5,v 1.17 2019/09/01 19:04:59 sevan Exp $
+.\"	$NetBSD: utmp.5,v 1.18 2019/09/09 00:21:03 sevan Exp $
 .\"
 .\" Copyright (c) 1980, 1991, 1993
 .\"	The Regents of the University of California.  All rights reserved.
@@ -29,7 +29,7 @@
 .\"
 .\" @(#)utmp.5	8.2 (Berkeley) 3/17/94
 .\"
-.Dd September 1, 2019
+.Dd September 9, 2019
 .Dt UTMP 5
 .Os
 .Sh NAME
@@ -215,7 +215,7 @@ file format appeared in
 The
 .Nm wtmp
 file format appeared in
-.At v3 .
+.At v2 .
 The
 .Nm lastlog
 file format appeared in

CVS commit: src/share/man/man5

[Sevan Janiyan]

Module Name:src
Committed By:   sevan
Date:   Mon Sep  9 00:14:55 UTC 2019

Modified Files:
src/share/man/man5: core.5

Log Message:
core(5) was in v1
https://www.bell-labs.com/usr/dmr/www/man51.pdf
via Ingo Schwarze 


To generate a diff of this commit:
cvs rdiff -u -r1.31 -r1.32 src/share/man/man5/core.5

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

Modified files:

Index: src/share/man/man5/core.5
diff -u src/share/man/man5/core.5:1.31 src/share/man/man5/core.5:1.32
--- src/share/man/man5/core.5:1.31	Mon Jul  3 21:30:59 2017
+++ src/share/man/man5/core.5	Mon Sep  9 00:14:55 2019
@@ -1,4 +1,4 @@
-.\"	$NetBSD: core.5,v 1.31 2017/07/03 21:30:59 wiz Exp $
+.\"	$NetBSD: core.5,v 1.32 2019/09/09 00:14:55 sevan Exp $
 .\"
 .\" Copyright (c) 2002 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -56,7 +56,7 @@
 .\"
 .\" @(#)core.5	8.3 (Berkeley) 12/11/93
 .\"
-.Dd March 27, 2017
+.Dd September 9, 2019
 .Dt CORE 5
 .Os
 .Sh NAME
@@ -384,7 +384,7 @@ Size of the segment, not including this 
 A
 .Nm core
 file format appeared in
-.At v6 .
+.At v1 .
 The
 .Nx
 a.out core file format was introduced in

CVS commit: src/share/man/man5

[Sevan Janiyan]

Module Name:src
Committed By:   sevan
Date:   Mon Sep  9 00:14:55 UTC 2019

Modified Files:
src/share/man/man5: core.5

Log Message:
core(5) was in v1
https://www.bell-labs.com/usr/dmr/www/man51.pdf
via Ingo Schwarze 


To generate a diff of this commit:
cvs rdiff -u -r1.31 -r1.32 src/share/man/man5/core.5

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

CVS commit: src/share/man/man5

[Sevan Janiyan]

Module Name:src
Committed By:   sevan
Date:   Sun Sep  1 19:04:59 UTC 2019

Modified Files:
src/share/man/man5: utmp.5

Log Message:
utmp(5) was present in v1
https://www.bell-labs.com/usr/dmr/www/man51.pdf
Earliest version of wtmp I could find was in v3
https://minnie.tuhs.org/cgi-bin/utree.pl?file=V3/man/man5/wtmp.5


To generate a diff of this commit:
cvs rdiff -u -r1.16 -r1.17 src/share/man/man5/utmp.5

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

Modified files:

Index: src/share/man/man5/utmp.5
diff -u src/share/man/man5/utmp.5:1.16 src/share/man/man5/utmp.5:1.17
--- src/share/man/man5/utmp.5:1.16	Mon Mar 22 18:58:32 2010
+++ src/share/man/man5/utmp.5	Sun Sep  1 19:04:59 2019
@@ -1,4 +1,4 @@
-.\"	$NetBSD: utmp.5,v 1.16 2010/03/22 18:58:32 joerg Exp $
+.\"	$NetBSD: utmp.5,v 1.17 2019/09/01 19:04:59 sevan Exp $
 .\"
 .\" Copyright (c) 1980, 1991, 1993
 .\"	The Regents of the University of California.  All rights reserved.
@@ -29,7 +29,7 @@
 .\"
 .\" @(#)utmp.5	8.2 (Berkeley) 3/17/94
 .\"
-.Dd May 14, 2003
+.Dd September 1, 2019
 .Dt UTMP 5
 .Os
 .Sh NAME
@@ -210,10 +210,12 @@ file.
 .Sh HISTORY
 A
 .Nm utmp
-and
+file format appeared in
+.At v1 .
+The
 .Nm wtmp
 file format appeared in
-.At v6 .
+.At v3 .
 The
 .Nm lastlog
 file format appeared in

CVS commit: src/share/man/man5

[Sevan Janiyan]

Module Name:src
Committed By:   sevan
Date:   Sun Sep  1 19:04:59 UTC 2019

Modified Files:
src/share/man/man5: utmp.5

Log Message:
utmp(5) was present in v1
https://www.bell-labs.com/usr/dmr/www/man51.pdf
Earliest version of wtmp I could find was in v3
https://minnie.tuhs.org/cgi-bin/utree.pl?file=V3/man/man5/wtmp.5


To generate a diff of this commit:
cvs rdiff -u -r1.16 -r1.17 src/share/man/man5/utmp.5

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

CVS commit: src/share/man/man5

[Sevan Janiyan]

Module Name:src
Committed By:   sevan
Date:   Sun Sep  1 18:57:05 UTC 2019

Modified Files:
src/share/man/man5: passwd.5

Log Message:
passwd(5) was in v1
https://www.bell-labs.com/usr/dmr/www/man51.pdf


To generate a diff of this commit:
cvs rdiff -u -r1.33 -r1.34 src/share/man/man5/passwd.5

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

Modified files:

Index: src/share/man/man5/passwd.5
diff -u src/share/man/man5/passwd.5:1.33 src/share/man/man5/passwd.5:1.34
--- src/share/man/man5/passwd.5:1.33	Mon Jul  3 21:30:59 2017
+++ src/share/man/man5/passwd.5	Sun Sep  1 18:57:05 2019
@@ -1,4 +1,4 @@
-.\"	$NetBSD: passwd.5,v 1.33 2017/07/03 21:30:59 wiz Exp $
+.\"	$NetBSD: passwd.5,v 1.34 2019/09/01 18:57:05 sevan Exp $
 .\"
 .\" Copyright (c) 1988, 1991, 1993
 .\"	The Regents of the University of California.  All rights reserved.
@@ -52,7 +52,7 @@
 .\"
 .\" @(#)passwd.5	8.1 (Berkeley) 6/5/93
 .\"
-.Dd April 5, 2012
+.Dd September 1, 2019
 .Dt PASSWD 5
 .Os
 .Sh NAME
@@ -401,7 +401,7 @@ BEGIN { FS = ":"}
 A
 .Nm
 file format appeared in
-.At v6 .
+.At v1 .
 .Pp
 The
 .Tn NIS

CVS commit: src/share/man/man5

[Sevan Janiyan]

Module Name:src
Committed By:   sevan
Date:   Sun Sep  1 18:57:05 UTC 2019

Modified Files:
src/share/man/man5: passwd.5

Log Message:
passwd(5) was in v1
https://www.bell-labs.com/usr/dmr/www/man51.pdf


To generate a diff of this commit:
cvs rdiff -u -r1.33 -r1.34 src/share/man/man5/passwd.5

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

Re: CVS commit: src/share/man/man5

[Roy Marples]

On 03/10/2012 10:45, Alan Barrett wrote:

The single instance dhcpcd already accepts messages

dhcpcd #start dhcpcd up
dhcpcd -x bgeo # Stop dhcpcd on the bge0 interface
dhcpcd -n iwi0 # Restart dhcpcd on the iwi0 interface

Works just fine.


Can this be combined with something like denyinterfaces * in
dhcpcd.conf to mean start dhcpcd, but don't actually do anything on
any interfaces, and then later send a message to mean start 
actually

doing something on the bge0 interface?  And then can we make
ifconfig_bge0=dhcpcd send a suitable message?


Yes, and this already works.
The only problem is that dhcpcd starts AFTER the network script and I 
don't know how to go about changing that.

The other issue is that /var is required to be mounted rw.

However, you don't gain anything from setting dhcpcd=YES and 
ifconfig_bge0=dhcp because dhcpcd is permissive by default.


Some people would like interfaces to do nothing by default, until
explicitly configured with either use dhcp or use these static
settings.


These same people can still do this. At no point am I stopping them 
from doing this.
I am just encouraging the use of dhcpcd.conf to allow or restrict 
interfaces instead of rc.conf

But is that the real problem? You *want* to use rc.conf. If so, why?

Thanks

Roy

PS, reply to me directly please as I'm not subbed to this list.

Re: CVS commit: src/share/man/man5

[Izumi Tsutsui]

 Modified Files:
   src/share/man/man5: ifconfig.if.5 rc.conf.5
 
 Log Message:
 Discourage the use of ifconfig_bge0=dhcp and prefer setting dhcpcd=YES
 in rc.conf(5) instead.

It would be worth to also note about dhcpcd(8) (instead of dhclient(8))
in afterboot(8) and src/distrib/notes/common/postinstall.

---
Izumi Tsutsui

Re: CVS commit: src/share/man/man5

[Roy Marples]

On 02/10/2012 16:58, Izumi Tsutsui wrote:

Modified Files:
src/share/man/man5: ifconfig.if.5 rc.conf.5

Log Message:
Discourage the use of ifconfig_bge0=dhcp and prefer setting 
dhcpcd=YES

in rc.conf(5) instead.


It would be worth to also note about dhcpcd(8) (instead of 
dhclient(8))

in afterboot(8) and src/distrib/notes/common/postinstall.

---
Izumi Tsutsui



Modified, thanks.

re: CVS commit: src/share/man/man5

[matthew green]

 Committed By: roy
 Date: Tue Oct  2 09:18:59 UTC 2012
 
 Modified Files:
   src/share/man/man5: ifconfig.if.5 rc.conf.5
 
 Log Message:
 Discourage the use of ifconfig_bge0=dhcp and prefer setting dhcpcd=YES
 in rc.conf(5) instead.

can you explain why?

i actually really like that dhcpcd (can) run on a per-interface basis,
and that i can control all this easily from rc.conf.

thanks.


.mrg.

Re: re: CVS commit: src/share/man/man5

[Pierre Pronchery]

On Wed, 03 Oct 2012 08:23:39 +1000, matthew green wrote:

 Committed By:roy Date:   Tue Oct  2 09:18:59 UTC 
2012
 
 Modified Files:
  src/share/man/man5: ifconfig.if.5 rc.conf.5
 
 Log Message:
 Discourage the use of ifconfig_bge0=dhcp and prefer setting dhcpcd=YES
 in rc.conf(5) instead.
 
 can you explain why?
 
 i actually really like that dhcpcd (can) run on a per-interface basis,
 and that i can control all this easily from rc.conf.

Yes, I need this too. Doing this I noticed that dhcpcd-gtk cannot control 
dhcpcd in this case though :(

-- 
khorben

re: CVS commit: src/share/man/man5

[Roy Marples]

On 02/10/2012 23:23, matthew green wrote:

Committed By:   roy
Date:   Tue Oct  2 09:18:59 UTC 2012

Modified Files:
src/share/man/man5: ifconfig.if.5 rc.conf.5

Log Message:
Discourage the use of ifconfig_bge0=dhcp and prefer setting 
dhcpcd=YES

in rc.conf(5) instead.


can you explain why?

i actually really like that dhcpcd (can) run on a per-interface 
basis,

and that i can control all this easily from rc.conf.


You can control dhcpcd on a per interface basis in dhcpcd.conf as well.
When running as single daemon you get the following benefits:
* Interface addition/removal support
* Intelligent routing preference if 1 interface connected to the same 
subnet or more than one default gateway present

* dhcpcd-dbus and thus dhcpcd-gtk support

None of these may be attractive to you personally, but this simple 
change would cut out about 80% of the support requests I get and that's 
quite attractive to me.


Thanks

Roy

Re: CVS commit: src/share/man/man5

[Christos Zoulas]

In article 5646969d27e506c74bfd96e9ba791...@mail.marples.name,
Roy Marples  r...@marples.name wrote:
On 02/10/2012 23:23, matthew green wrote:
 Committed By:   roy
 Date:   Tue Oct  2 09:18:59 UTC 2012

 Modified Files:
 src/share/man/man5: ifconfig.if.5 rc.conf.5

 Log Message:
 Discourage the use of ifconfig_bge0=dhcp and prefer setting 
 dhcpcd=YES
 in rc.conf(5) instead.

 can you explain why?

 i actually really like that dhcpcd (can) run on a per-interface 
 basis,
 and that i can control all this easily from rc.conf.

You can control dhcpcd on a per interface basis in dhcpcd.conf as well.
When running as single daemon you get the following benefits:
* Interface addition/removal support
* Intelligent routing preference if 1 interface connected to the same 
subnet or more than one default gateway present
* dhcpcd-dbus and thus dhcpcd-gtk support

None of these may be attractive to you personally, but this simple 
change would cut out about 80% of the support requests I get and that's 
quite attractive to me.

Can't we have the best of both worlds by allowing dhcpcd to receive messages
to configure interfaces as rc parses interface configurations? Then we can
have still one instance, but not requiring to mention the interfaces in the
configuration file?

christos

re: CVS commit: src/share/man/man5

[Roy Marples]

None of these may be attractive to you personally, but this simple
change would cut out about 80% of the support requests I get and 
that's

quite attractive to me.


Can't we have the best of both worlds by allowing dhcpcd to receive 
messages
to configure interfaces as rc parses interface configurations? Then we 
can
have still one instance, but not requiring to mention the interfaces 
in the

configuration file?


The single instance dhcpcd already accepts messages

dhcpcd #start dhcpcd up
dhcpcd -x bgeo # Stop dhcpcd on the bge0 interface
dhcpcd -n iwi0 # Restart dhcpcd on the iwi0 interface

Works just fine.

However, you don't gain anything from setting dhcpcd=YES and 
ifconfig_bge0=dhcp because dhcpcd is permissive by default.


Thanks

Roy

PS, reply to me directly please as I'm not subbed to this list.

Re: CVS commit: src/share/man/man5

[Christos Zoulas]

In article 4eb84f56.6060...@netbsd.org,
Marc Balmer  mbal...@netbsd.org wrote:
Am 07.11.11 21:01, schrieb Joerg Sonnenberger:
 On Mon, Nov 07, 2011 at 02:27:03PM +0200, Jukka Ruohonen wrote:
 On Mon, Nov 07, 2011 at 10:20:38AM +0100, Joerg Sonnenberger wrote:
 The majority of interesting programs already have USE_FORT=yes.

 But USE_FORT is not the same thing as USE_SSP.
 
 It is stronger.

How so?  Please explain the difference.

man ssp, /_FORTIFY/

christos

Re: CVS commit: src/share/man/man5

[Matthias Scheler]

On Mon, Nov 07, 2011 at 06:51:58AM +0200, Jukka Ruohonen wrote:
 On Sun, Nov 06, 2011 at 10:34:48PM +, Matthias Scheler wrote:
  Module Name:src
  Committed By:   tron
  Date:   Sun Nov  6 22:34:48 UTC 2011
  
  Modified Files:
  src/share/man/man5: mk.conf.5
  
  Log Message:
  Stack-smash protection is not enabled by default, at least not for
  the complete source-tree.
  
  Pointed out by bch on current-users mailing list.
 
 Wasn't there an explicit decision to enable it by default?

Yes, for kernel builds.

Kind regards

-- 
Matthias Scheler  http://zhadum.org.uk/

Re: CVS commit: src/share/man/man5

[Marc Balmer]

Am 07.11.11 09:24, schrieb Matthias Scheler:
 On Mon, Nov 07, 2011 at 06:51:58AM +0200, Jukka Ruohonen wrote:
 On Sun, Nov 06, 2011 at 10:34:48PM +, Matthias Scheler wrote:
 Module Name:src
 Committed By:   tron
 Date:   Sun Nov  6 22:34:48 UTC 2011

 Modified Files:
 src/share/man/man5: mk.conf.5

 Log Message:
 Stack-smash protection is not enabled by default, at least not for
 the complete source-tree.

 Pointed out by bch on current-users mailing list.

 Wasn't there an explicit decision to enable it by default?
 
 Yes, for kernel builds.

What was the reason to not enable it for userland?

Re: CVS commit: src/share/man/man5

[Joerg Sonnenberger]

On Mon, Nov 07, 2011 at 09:59:54AM +0100, Marc Balmer wrote:
 Am 07.11.11 09:24, schrieb Matthias Scheler:
  On Mon, Nov 07, 2011 at 06:51:58AM +0200, Jukka Ruohonen wrote:
  On Sun, Nov 06, 2011 at 10:34:48PM +, Matthias Scheler wrote:
  Module Name:  src
  Committed By: tron
  Date: Sun Nov  6 22:34:48 UTC 2011
 
  Modified Files:
src/share/man/man5: mk.conf.5
 
  Log Message:
  Stack-smash protection is not enabled by default, at least not for
  the complete source-tree.
 
  Pointed out by bch on current-users mailing list.
 
  Wasn't there an explicit decision to enable it by default?
  
  Yes, for kernel builds.
 
 What was the reason to not enable it for userland?

The majority of interesting programs already have USE_FORT=yes.

Joerg

Re: CVS commit: src/share/man/man5

[Joerg Sonnenberger]

On Mon, Nov 07, 2011 at 02:27:03PM +0200, Jukka Ruohonen wrote:
 On Mon, Nov 07, 2011 at 10:20:38AM +0100, Joerg Sonnenberger wrote:
  The majority of interesting programs already have USE_FORT=yes.
 
 But USE_FORT is not the same thing as USE_SSP.

It is stronger.

Joerg

Re: CVS commit: src/share/man/man5

[Marc Balmer]

Am 07.11.11 21:01, schrieb Joerg Sonnenberger:
 On Mon, Nov 07, 2011 at 02:27:03PM +0200, Jukka Ruohonen wrote:
 On Mon, Nov 07, 2011 at 10:20:38AM +0100, Joerg Sonnenberger wrote:
 The majority of interesting programs already have USE_FORT=yes.

 But USE_FORT is not the same thing as USE_SSP.
 
 It is stronger.

How so?  Please explain the difference.

Re: CVS commit: src/share/man/man5

[Joerg Sonnenberger]

On Mon, Nov 07, 2011 at 10:36:22PM +0100, Marc Balmer wrote:
 Am 07.11.11 21:01, schrieb Joerg Sonnenberger:
  On Mon, Nov 07, 2011 at 02:27:03PM +0200, Jukka Ruohonen wrote:
  On Mon, Nov 07, 2011 at 10:20:38AM +0100, Joerg Sonnenberger wrote:
  The majority of interesting programs already have USE_FORT=yes.
 
  But USE_FORT is not the same thing as USE_SSP.
  
  It is stronger.
 
 How so?  Please explain the difference.

Read bsd.README.

Joerg

Re: CVS commit: src/share/man/man5

[Jukka Ruohonen]

On Sun, Nov 06, 2011 at 10:34:48PM +, Matthias Scheler wrote:
 Module Name:  src
 Committed By: tron
 Date: Sun Nov  6 22:34:48 UTC 2011
 
 Modified Files:
   src/share/man/man5: mk.conf.5
 
 Log Message:
 Stack-smash protection is not enabled by default, at least not for
 the complete source-tree.
 
 Pointed out by bch on current-users mailing list.

Wasn't there an explicit decision to enable it by default?

- Jukka.

Re: CVS commit: src/share/man/man5

[Thomas Klausner]

On Sat, May 15, 2010 at 03:53:42PM +, Jukka Ruohonen wrote:
 Module Name:  src
 Committed By: jruoho
 Date: Sat May 15 15:53:42 UTC 2010
 
 Modified Files:
   src/share/man/man5: veriexec.5
 
 Log Message:
 Minor markup improvements.

The version before your change was how .An was intended to be used:
.An First Author
.An Second Author
.An Third Author

That's also the reason why .An makes a line break by default.

I'm not saying you must revert this, just to give you some
perspective.
 Thomas

CVS commit: src/share/man/man5

[Jukka Ruohonen]

Module Name:src
Committed By:   jruoho
Date:   Tue Mar  2 07:26:47 UTC 2010

Modified Files:
src/share/man/man5: mk.conf.5

Log Message:
Catch up with the changes to SSP on x86.


To generate a diff of this commit:
cvs rdiff -u -r1.50 -r1.51 src/share/man/man5/mk.conf.5

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

Modified files:

Index: src/share/man/man5/mk.conf.5
diff -u src/share/man/man5/mk.conf.5:1.50 src/share/man/man5/mk.conf.5:1.51
--- src/share/man/man5/mk.conf.5:1.50	Tue Sep 29 23:56:34 2009
+++ src/share/man/man5/mk.conf.5	Tue Mar  2 07:26:47 2010
@@ -1,4 +1,4 @@
-.\	$NetBSD: mk.conf.5,v 1.50 2009/09/29 23:56:34 tsarna Exp $
+.\	$NetBSD: mk.conf.5,v 1.51 2010/03/02 07:26:47 jruoho Exp $
 .\
 .\  Copyright (c) 1999-2003 The NetBSD Foundation, Inc.
 .\  All rights reserved.
@@ -829,8 +829,9 @@
 which detects stack overflows and aborts the program,
 is enabled.
 This imposes some performance penalty.
-.DFLTn
-.
+.DFLTy
+on i386 and amd64, otherwise
+.Dq no .
 .It Sy USE_YP
 .YorN
 Indicates whether YP (NIS) support is

CVS commit: src/share/man/man5

[Jukka Ruohonen]

Module Name:src
Committed By:   jruoho
Date:   Tue Mar  2 07:26:47 UTC 2010

Modified Files:
src/share/man/man5: mk.conf.5

Log Message:
Catch up with the changes to SSP on x86.


To generate a diff of this commit:
cvs rdiff -u -r1.50 -r1.51 src/share/man/man5/mk.conf.5

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

CVS commit: src/share/man/man5

[Thomas Klausner]

Module Name:src
Committed By:   wiz
Date:   Fri Feb  5 17:23:47 UTC 2010

Modified Files:
src/share/man/man5: daily.conf.5 security.conf.5

Log Message:
Mark up PKGDB_DIR with Dv (same as in pkg_install.conf).


To generate a diff of this commit:
cvs rdiff -u -r1.26 -r1.27 src/share/man/man5/daily.conf.5
cvs rdiff -u -r1.36 -r1.37 src/share/man/man5/security.conf.5

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

CVS commit: src/share/man/man5

[Julio M. Merino Vidal]

Module Name:src
Committed By:   jmmv
Date:   Tue Jan 19 22:08:52 UTC 2010

Modified Files:
src/share/man/man5: daily.conf.5 security.conf.5

Log Message:
Document the new package-related maintenance options and security checks
in daily.conf and security.conf.


To generate a diff of this commit:
cvs rdiff -u -r1.24 -r1.25 src/share/man/man5/daily.conf.5
cvs rdiff -u -r1.33 -r1.34 src/share/man/man5/security.conf.5

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

CVS commit: src/share/man/man5

[Thomas Klausner]

Module Name:src
Committed By:   wiz
Date:   Wed Jan 20 07:33:25 UTC 2010

Modified Files:
src/share/man/man5: security.conf.5

Log Message:
Remove trailing whitespace.


To generate a diff of this commit:
cvs rdiff -u -r1.34 -r1.35 src/share/man/man5/security.conf.5

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.