Index: head/share/man/man3/tree.3
===================================================================
--- head/share/man/man3/tree.3	(revision 301590)
+++ head/share/man/man3/tree.3	(revision 301591)
@@ -1,604 +1,606 @@
 .\"	$OpenBSD: tree.3,v 1.7 2002/06/12 01:09:20 provos Exp $
 .\"
 .\" Copyright 2002 Niels Provos <provos@citi.umich.edu>
 .\" All rights reserved.
 .\"
 .\" Redistribution and use in source and binary forms, with or without
 .\" modification, are permitted provided that the following conditions
 .\" are met:
 .\" 1. Redistributions of source code must retain the above copyright
 .\"    notice, this list of conditions and the following disclaimer.
 .\" 2. Redistributions in binary form must reproduce the above copyright
 .\"    notice, this list of conditions and the following disclaimer in the
 .\"    documentation and/or other materials provided with the distribution.
 .\" 3. All advertising materials mentioning features or use of this software
 .\"    must display the following acknowledgement:
 .\"      This product includes software developed by Niels Provos.
 .\" 4. The name of the author may not be used to endorse or promote products
 .\"    derived from this software without specific prior written permission.
 .\"
 .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
 .\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
 .\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
 .\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
 .\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
 .\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
 .\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
 .\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
 .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
 .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 .\"
 .\" $FreeBSD$
 .\"
 .Dd January 24, 2015
 .Dt TREE 3
 .Os
 .Sh NAME
 .Nm SPLAY_PROTOTYPE ,
 .Nm SPLAY_GENERATE ,
 .Nm SPLAY_ENTRY ,
 .Nm SPLAY_HEAD ,
 .Nm SPLAY_INITIALIZER ,
 .Nm SPLAY_ROOT ,
 .Nm SPLAY_EMPTY ,
 .Nm SPLAY_NEXT ,
 .Nm SPLAY_MIN ,
 .Nm SPLAY_MAX ,
 .Nm SPLAY_FIND ,
 .Nm SPLAY_LEFT ,
 .Nm SPLAY_RIGHT ,
 .Nm SPLAY_FOREACH ,
 .Nm SPLAY_INIT ,
 .Nm SPLAY_INSERT ,
 .Nm SPLAY_REMOVE ,
 .Nm RB_PROTOTYPE ,
 .Nm RB_PROTOTYPE_STATIC ,
 .Nm RB_PROTOTYPE_INSERT ,
 .Nm RB_PROTOTYPE_INSERT_COLOR ,
 .Nm RB_PROTOTYPE_REMOVE ,
 .Nm RB_PROTOTYPE_REMOVE_COLOR ,
 .Nm RB_PROTOTYPE_FIND ,
 .Nm RB_PROTOTYPE_NFIND ,
 .Nm RB_PROTOTYPE_NEXT ,
 .Nm RB_PROTOTYPE_PREV ,
 .Nm RB_PROTOTYPE_MINMAX ,
 .Nm RB_GENERATE ,
 .Nm RB_GENERATE_STATIC ,
 .Nm RB_GENERATE_INSERT ,
 .Nm RB_GENERATE_INSERT_COLOR ,
 .Nm RB_GENERATE_REMOVE ,
 .Nm RB_GENERATE_REMOVE_COLOR ,
 .Nm RB_GENERATE_FIND ,
 .Nm RB_GENERATE_NFIND ,
 .Nm RB_GENERATE_NEXT ,
 .Nm RB_GENERATE_PREV ,
 .Nm RB_GENERATE_MINMAX ,
 .Nm RB_ENTRY ,
 .Nm RB_HEAD ,
 .Nm RB_INITIALIZER ,
 .Nm RB_ROOT ,
 .Nm RB_EMPTY ,
 .Nm RB_NEXT ,
 .Nm RB_PREV ,
 .Nm RB_MIN ,
 .Nm RB_MAX ,
 .Nm RB_FIND ,
 .Nm RB_NFIND ,
 .Nm RB_LEFT ,
 .Nm RB_RIGHT ,
 .Nm RB_PARENT ,
 .Nm RB_FOREACH ,
 .Nm RB_FOREACH_FROM ,
 .Nm RB_FOREACH_SAFE ,
 .Nm RB_FOREACH_REVERSE ,
 .Nm RB_FOREACH_REVERSE_FROM ,
 .Nm RB_FOREACH_REVERSE_SAFE ,
 .Nm RB_INIT ,
 .Nm RB_INSERT ,
 .Nm RB_REMOVE
 .Nd "implementations of splay and red-black trees"
 .Sh SYNOPSIS
 .In sys/tree.h
 .Fn SPLAY_PROTOTYPE NAME TYPE FIELD CMP
 .Fn SPLAY_GENERATE NAME TYPE FIELD CMP
 .Fn SPLAY_ENTRY TYPE
 .Fn SPLAY_HEAD HEADNAME TYPE
 .Ft "struct TYPE *"
 .Fn SPLAY_INITIALIZER "SPLAY_HEAD *head"
 .Fn SPLAY_ROOT "SPLAY_HEAD *head"
 .Ft bool
 .Fn SPLAY_EMPTY "SPLAY_HEAD *head"
 .Ft "struct TYPE *"
 .Fn SPLAY_NEXT NAME "SPLAY_HEAD *head" "struct TYPE *elm"
 .Ft "struct TYPE *"
 .Fn SPLAY_MIN NAME "SPLAY_HEAD *head"
 .Ft "struct TYPE *"
 .Fn SPLAY_MAX NAME "SPLAY_HEAD *head"
 .Ft "struct TYPE *"
 .Fn SPLAY_FIND NAME "SPLAY_HEAD *head" "struct TYPE *elm"
 .Ft "struct TYPE *"
 .Fn SPLAY_LEFT "struct TYPE *elm" "SPLAY_ENTRY NAME"
 .Ft "struct TYPE *"
 .Fn SPLAY_RIGHT "struct TYPE *elm" "SPLAY_ENTRY NAME"
 .Fn SPLAY_FOREACH VARNAME NAME "SPLAY_HEAD *head"
 .Ft void
 .Fn SPLAY_INIT "SPLAY_HEAD *head"
 .Ft "struct TYPE *"
 .Fn SPLAY_INSERT NAME "SPLAY_HEAD *head" "struct TYPE *elm"
 .Ft "struct TYPE *"
 .Fn SPLAY_REMOVE NAME "SPLAY_HEAD *head" "struct TYPE *elm"
 .Fn RB_PROTOTYPE NAME TYPE FIELD CMP
 .Fn RB_PROTOTYPE_STATIC NAME TYPE FIELD CMP
 .Fn RB_PROTOTYPE_INSERT NAME TYPE ATTR
 .Fn RB_PROTOTYPE_INSERT_COLOR NAME TYPE ATTR
 .Fn RB_PROTOTYPE_REMOVE NAME TYPE ATTR
 .Fn RB_PROTOTYPE_REMOVE_COLOR NAME TYPE ATTR
 .Fn RB_PROTOTYPE_FIND NAME TYPE ATTR
 .Fn RB_PROTOTYPE_NFIND NAME TYPE ATTR
 .Fn RB_PROTOTYPE_NEXT NAME TYPE ATTR
 .Fn RB_PROTOTYPE_PREV NAME TYPE ATTR
 .Fn RB_PROTOTYPE_MINMAX NAME TYPE ATTR
 .Fn RB_GENERATE NAME TYPE FIELD CMP
 .Fn RB_GENERATE_STATIC NAME TYPE FIELD CMP
 .Fn RB_GENERATE_INSERT NAME TYPE FIELD CMP ATTR
 .Fn RB_GENERATE_INSERT_COLOR NAME TYPE FIELD ATTR
 .Fn RB_GENERATE_REMOVE NAME TYPE FIELD ATTR
 .Fn RB_GENERATE_REMOVE_COLOR NAME TYPE FIELD ATTR
 .Fn RB_GENERATE_FIND NAME TYPE FIELD CMP ATTR
 .Fn RB_GENERATE_NFIND NAME TYPE FIELD CMP ATTR
 .Fn RB_GENERATE_NEXT NAME TYPE FIELD ATTR
 .Fn RB_GENERATE_PREV NAME TYPE FIELD ATTR
 .Fn RB_GENERATE_MINMAX NAME TYPE FIELD ATTR
 .Fn RB_ENTRY TYPE
 .Fn RB_HEAD HEADNAME TYPE
 .Fn RB_INITIALIZER "RB_HEAD *head"
 .Ft "struct TYPE *"
 .Fn RB_ROOT "RB_HEAD *head"
 .Ft "bool"
 .Fn RB_EMPTY "RB_HEAD *head"
 .Ft "struct TYPE *"
 .Fn RB_NEXT NAME "RB_HEAD *head" "struct TYPE *elm"
 .Ft "struct TYPE *"
 .Fn RB_PREV NAME "RB_HEAD *head" "struct TYPE *elm"
 .Ft "struct TYPE *"
 .Fn RB_MIN NAME "RB_HEAD *head"
 .Ft "struct TYPE *"
 .Fn RB_MAX NAME "RB_HEAD *head"
 .Ft "struct TYPE *"
 .Fn RB_FIND NAME "RB_HEAD *head" "struct TYPE *elm"
 .Ft "struct TYPE *"
 .Fn RB_NFIND NAME "RB_HEAD *head" "struct TYPE *elm"
 .Ft "struct TYPE *"
 .Fn RB_LEFT "struct TYPE *elm" "RB_ENTRY NAME"
 .Ft "struct TYPE *"
 .Fn RB_RIGHT "struct TYPE *elm" "RB_ENTRY NAME"
 .Ft "struct TYPE *"
 .Fn RB_PARENT "struct TYPE *elm" "RB_ENTRY NAME"
 .Fn RB_FOREACH VARNAME NAME "RB_HEAD *head"
 .Fn RB_FOREACH_FROM "VARNAME" "NAME" "POS_VARNAME"
 .Fn RB_FOREACH_SAFE "VARNAME" "NAME" "RB_HEAD *head" "TEMP_VARNAME"
 .Fn RB_FOREACH_REVERSE VARNAME NAME "RB_HEAD *head"
 .Fn RB_FOREACH_REVERSE_FROM "VARNAME" "NAME" "POS_VARNAME"
 .Fn RB_FOREACH_REVERSE_SAFE "VARNAME" "NAME" "RB_HEAD *head" "TEMP_VARNAME"
 .Ft void
 .Fn RB_INIT "RB_HEAD *head"
 .Ft "struct TYPE *"
 .Fn RB_INSERT NAME "RB_HEAD *head" "struct TYPE *elm"
 .Ft "struct TYPE *"
 .Fn RB_REMOVE NAME "RB_HEAD *head" "struct TYPE *elm"
 .Sh DESCRIPTION
 These macros define data structures for different types of trees:
 splay trees and red-black trees.
 .Pp
 In the macro definitions,
 .Fa TYPE
 is the name tag of a user defined structure that must contain a field of type
 .Vt SPLAY_ENTRY ,
 or
 .Vt RB_ENTRY ,
 named
 .Fa ENTRYNAME .
 The argument
 .Fa HEADNAME
 is the name tag of a user defined structure that must be declared
 using the macros
 .Fn SPLAY_HEAD ,
 or
 .Fn RB_HEAD .
 The argument
 .Fa NAME
 has to be a unique name prefix for every tree that is defined.
 .Pp
 The function prototypes are declared with
 .Fn SPLAY_PROTOTYPE ,
 .Fn RB_PROTOTYPE ,
 or
 .Fn RB_PROTOTYPE_STATIC .
 The function bodies are generated with
 .Fn SPLAY_GENERATE ,
 .Fn RB_GENERATE ,
 or
 .Fn RB_GENERATE_STATIC .
 See the examples below for further explanation of how these macros are used.
 .Sh SPLAY TREES
 A splay tree is a self-organizing data structure.
 Every operation on the tree causes a splay to happen.
 The splay moves the requested
 node to the root of the tree and partly rebalances it.
 .Pp
 This has the benefit that request locality causes faster lookups as
 the requested nodes move to the top of the tree.
 On the other hand, every lookup causes memory writes.
 .Pp
 The Balance Theorem bounds the total access time for
 .Ar m
 operations and
 .Ar n
 inserts on an initially empty tree as
 .Fn O "\*[lp]m + n\*[rp]lg n" .
 The
 amortized cost for a sequence of
 .Ar m
 accesses to a splay tree is
 .Fn O "lg n" .
 .Pp
 A splay tree is headed by a structure defined by the
 .Fn SPLAY_HEAD
 macro.
 A
 structure is declared as follows:
 .Bd -ragged -offset indent
 .Fn SPLAY_HEAD HEADNAME TYPE
 .Va head ;
 .Ed
 .Pp
 where
 .Fa HEADNAME
 is the name of the structure to be defined, and struct
 .Fa TYPE
 is the type of the elements to be inserted into the tree.
 .Pp
 The
 .Fn SPLAY_ENTRY
 macro declares a structure that allows elements to be connected in the tree.
 .Pp
 In order to use the functions that manipulate the tree structure,
 their prototypes need to be declared with the
 .Fn SPLAY_PROTOTYPE
 macro,
 where
 .Fa NAME
 is a unique identifier for this particular tree.
 The
 .Fa TYPE
 argument is the type of the structure that is being managed
 by the tree.
 The
 .Fa FIELD
 argument is the name of the element defined by
 .Fn SPLAY_ENTRY .
 .Pp
 The function bodies are generated with the
 .Fn SPLAY_GENERATE
 macro.
 It takes the same arguments as the
 .Fn SPLAY_PROTOTYPE
 macro, but should be used only once.
 .Pp
 Finally,
 the
 .Fa CMP
 argument is the name of a function used to compare tree nodes
 with each other.
 The function takes two arguments of type
 .Vt "struct TYPE *" .
 If the first argument is smaller than the second, the function returns a
 value smaller than zero.
 If they are equal, the function returns zero.
 Otherwise, it should return a value greater than zero.
 The compare
 function defines the order of the tree elements.
 .Pp
 The
 .Fn SPLAY_INIT
 macro initializes the tree referenced by
 .Fa head .
 .Pp
 The splay tree can also be initialized statically by using the
 .Fn SPLAY_INITIALIZER
 macro like this:
 .Bd -ragged -offset indent
 .Fn SPLAY_HEAD HEADNAME TYPE
 .Va head
 =
 .Fn SPLAY_INITIALIZER &head ;
 .Ed
 .Pp
 The
 .Fn SPLAY_INSERT
 macro inserts the new element
 .Fa elm
 into the tree.
 .Pp
 The
 .Fn SPLAY_REMOVE
 macro removes the element
 .Fa elm
 from the tree pointed by
 .Fa head .
 .Pp
 The
 .Fn SPLAY_FIND
 macro can be used to find a particular element in the tree.
 .Bd -literal -offset indent
 struct TYPE find, *res;
 find.key = 30;
 res = SPLAY_FIND(NAME, head, &find);
 .Ed
 .Pp
 The
 .Fn SPLAY_ROOT ,
 .Fn SPLAY_MIN ,
 .Fn SPLAY_MAX ,
 and
 .Fn SPLAY_NEXT
 macros can be used to traverse the tree:
 .Bd -literal -offset indent
 for (np = SPLAY_MIN(NAME, &head); np != NULL; np = SPLAY_NEXT(NAME, &head, np))
 .Ed
 .Pp
 Or, for simplicity, one can use the
 .Fn SPLAY_FOREACH
 macro:
 .Bd -ragged -offset indent
 .Fn SPLAY_FOREACH np NAME head
 .Ed
 .Pp
 The
 .Fn SPLAY_EMPTY
 macro should be used to check whether a splay tree is empty.
 .Sh RED-BLACK TREES
 A red-black tree is a binary search tree with the node color as an
 extra attribute.
 It fulfills a set of conditions:
 .Bl -enum -offset indent
 .It
 Every search path from the root to a leaf consists of the same number of
 black nodes.
 .It
 Each red node (except for the root) has a black parent.
 .It
 Each leaf node is black.
 .El
 .Pp
 Every operation on a red-black tree is bounded as
 .Fn O "lg n" .
 The maximum height of a red-black tree is
 .Fn 2lg "n + 1" .
 .Pp
 A red-black tree is headed by a structure defined by the
 .Fn RB_HEAD
 macro.
 A
 structure is declared as follows:
 .Bd -ragged -offset indent
 .Fn RB_HEAD HEADNAME TYPE
 .Va head ;
 .Ed
 .Pp
 where
 .Fa HEADNAME
 is the name of the structure to be defined, and struct
 .Fa TYPE
 is the type of the elements to be inserted into the tree.
 .Pp
 The
 .Fn RB_ENTRY
 macro declares a structure that allows elements to be connected in the tree.
 .Pp
 In order to use the functions that manipulate the tree structure,
 their prototypes need to be declared with the
 .Fn RB_PROTOTYPE
 or
 .Fn RB_PROTOTYPE_STATIC
 macro,
 where
 .Fa NAME
 is a unique identifier for this particular tree.
 The
 .Fa TYPE
 argument is the type of the structure that is being managed
 by the tree.
 The
 .Fa FIELD
 argument is the name of the element defined by
 .Fn RB_ENTRY .
 Individual prototypes can be declared with
 .Fn RB_PROTOTYPE_INSERT ,
 .Fn RB_PROTOTYPE_INSERT_COLOR ,
 .Fn RB_PROTOTYPE_REMOVE ,
 .Fn RB_PROTOTYPE_REMOVE_COLOR ,
 .Fn RB_PROTOTYPE_FIND ,
 .Fn RB_PROTOTYPE_NFIND ,
 .Fn RB_PROTOTYPE_NEXT ,
 .Fn RB_PROTOTYPE_PREV ,
 and
 .Fn RB_PROTOTYPE_MINMAX
-in case not all functions are required.  The individual prototype macros expect
+in case not all functions are required.
+The individual prototype macros expect
 .Fa NAME ,
 .Fa TYPE ,
 and
 .Fa ATTR
-arguments.  The
+arguments.
+The
 .Fa ATTR
 argument must be empty for global functions or
 .Fa static
 for static functions.
 .Pp
 The function bodies are generated with the
 .Fn RB_GENERATE
 or
 .Fn RB_GENERATE_STATIC
 macro.
 These macros take the same arguments as the
 .Fn RB_PROTOTYPE
 and
 .Fn RB_PROTOTYPE_STATIC
 macros, but should be used only once.
 As an alternative individual function bodies are generated with the
 .Fn RB_GENERATE_INSERT ,
 .Fn RB_GENERATE_INSERT_COLOR ,
 .Fn RB_GENERATE_REMOVE ,
 .Fn RB_GENERATE_REMOVE_COLOR ,
 .Fn RB_GENERATE_FIND ,
 .Fn RB_GENERATE_NFIND ,
 .Fn RB_GENERATE_NEXT ,
 .Fn RB_GENERATE_PREV ,
 and
 .Fn RB_GENERATE_MINMAX
 macros.
 .Pp
 Finally,
 the
 .Fa CMP
 argument is the name of a function used to compare tree nodes
 with each other.
 The function takes two arguments of type
 .Vt "struct TYPE *" .
 If the first argument is smaller than the second, the function returns a
 value smaller than zero.
 If they are equal, the function returns zero.
 Otherwise, it should return a value greater than zero.
 The compare
 function defines the order of the tree elements.
 .Pp
 The
 .Fn RB_INIT
 macro initializes the tree referenced by
 .Fa head .
 .Pp
 The red-black tree can also be initialized statically by using the
 .Fn RB_INITIALIZER
 macro like this:
 .Bd -ragged -offset indent
 .Fn RB_HEAD HEADNAME TYPE
 .Va head
 =
 .Fn RB_INITIALIZER &head ;
 .Ed
 .Pp
 The
 .Fn RB_INSERT
 macro inserts the new element
 .Fa elm
 into the tree.
 .Pp
 The
 .Fn RB_REMOVE
 macro removes the element
 .Fa elm
 from the tree pointed by
 .Fa head .
 .Pp
 The
 .Fn RB_FIND
 and
 .Fn RB_NFIND
 macros can be used to find a particular element in the tree.
 .Bd -literal -offset indent
 struct TYPE find, *res;
 find.key = 30;
 res = RB_FIND(NAME, head, &find);
 .Ed
 .Pp
 The
 .Fn RB_ROOT ,
 .Fn RB_MIN ,
 .Fn RB_MAX ,
 .Fn RB_NEXT ,
 and
 .Fn RB_PREV
 macros can be used to traverse the tree:
 .Pp
 .Dl "for (np = RB_MIN(NAME, &head); np != NULL; np = RB_NEXT(NAME, &head, np))"
 .Pp
 Or, for simplicity, one can use the
 .Fn RB_FOREACH
 or
 .Fn RB_FOREACH_REVERSE
 macro:
 .Bd -ragged -offset indent
 .Fn RB_FOREACH np NAME head
 .Ed
 .Pp
 The macros
 .Fn RB_FOREACH_SAFE
 and
 .Fn RB_FOREACH_REVERSE_SAFE
 traverse the tree referenced by head
 in a forward or reverse direction respectively,
 assigning each element in turn to np.
 However, unlike their unsafe counterparts,
 they permit both the removal of np
 as well as freeing it from within the loop safely
 without interfering with the traversal.
 .Pp
 Both
 .Fn RB_FOREACH_FROM
 and
 .Fn RB_FOREACH_REVERSE_FROM
 may be used to continue an interrupted traversal
 in a forward or reverse direction respectively.
 The head pointer is not required.
 The pointer to the node from where to resume the traversal
 should be passed as their last argument,
 and will be overwritten to provide safe traversal.
 .Pp
 The
 .Fn RB_EMPTY
 macro should be used to check whether a red-black tree is empty.
 .Sh NOTES
 Trying to free a tree in the following way is a common error:
 .Bd -literal -offset indent
 SPLAY_FOREACH(var, NAME, head) {
 	SPLAY_REMOVE(NAME, head, var);
 	free(var);
 }
 free(head);
 .Ed
 .Pp
 Since
 .Va var
 is freed, the
 .Fn FOREACH
 macro refers to a pointer that may have been reallocated already.
 Proper code needs a second variable.
 .Bd -literal -offset indent
 for (var = SPLAY_MIN(NAME, head); var != NULL; var = nxt) {
 	nxt = SPLAY_NEXT(NAME, head, var);
 	SPLAY_REMOVE(NAME, head, var);
 	free(var);
 }
 .Ed
 .Pp
 Both
 .Fn RB_INSERT
 and
 .Fn SPLAY_INSERT
 return
 .Dv NULL
 if the element was inserted in the tree successfully, otherwise they
 return a pointer to the element with the colliding key.
 .Pp
 Accordingly,
 .Fn RB_REMOVE
 and
 .Fn SPLAY_REMOVE
 return the pointer to the removed element otherwise they return
 .Dv NULL
 to indicate an error.
 .Sh SEE ALSO
 .Xr queue 3
 .Sh AUTHORS
 The author of the tree macros is
 .An Niels Provos .
Index: head/share/man/man4/man4.arm/cgem.4
===================================================================
--- head/share/man/man4/man4.arm/cgem.4	(revision 301590)
+++ head/share/man/man4/man4.arm/cgem.4	(revision 301591)
@@ -1,296 +1,298 @@
 .\"
 .\" Copyright (c) 2014 Thomas Skibo <thomasskibo@yahoo.com>
 .\" All rights reserved.
 .\"
 .\" Redistribution and use in source and binary forms, with or without
 .\" modification, are permitted provided that the following conditions
 .\" are met:
 .\" 1. Redistributions of source code must retain the above copyright
 .\"    notice, this list of conditions and the following disclaimer.
 .\" 2. The name of the author may not be used to endorse or promote products
 .\"    derived from this software without specific prior written permission.
 .\"
 .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
 .\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
 .\" $FreeBSD$
 .\"
 .Dd August 26, 2014
 .Dt CGEM 4
 .Os
 .Sh NAME
 .Nm cgem
 .Nd "Cadence GEM Gigabit Ethernet driver"
 .Sh SYNOPSIS
 To compile this driver into the kernel,
 place the following lines in your
 kernel configuration file:
 .Bd -ragged -offset indent
 .Cd "device ether"
 .Cd "device miibus"
 .Cd "device cgem"
 .Ed
 .Sh DESCRIPTION
 The
 .Nm
 driver provides support for the Cadence GEM (Gigabit Ethernet MAC).
 The Cadence GEM is used in some SoC (System on a Chip) devices such as
 the Xilinx Zynq-7000 and the Atmel SAMA5D3.
 .Pp
 The
 .Nm
 driver supports the following media types:
 .Bl -tag -width ".Cm 10baseT/UTP"
 .It Cm autoselect
 Enable autoselection of the media type and options.
 The user can manually override
 the autoselected mode using
 .Xr ifconfig 8
 or by adding media options to
 .Xr rc.conf 5 .
 .It Cm 10baseT/UTP
 Set 10Mbps operation.
 The
 .Xr ifconfig 8
 .Cm mediaopt
 option can also be used to select either
 .Cm full-duplex
 or
 .Cm half-duplex
 modes.
 .It Cm 100baseTX
 Set 100Mbps (Fast Ethernet) operation.
 The
 .Xr ifconfig 8
 .Cm mediaopt
 option can also be used to select either
 .Cm full-duplex
 or
 .Cm half-duplex
 modes.
 .It Cm 1000baseT
 Set 1000Mbps (Gigabit Ethernet) operation over twisted pair.
 The GEM supports 1000Mbps in
 .Cm full-duplex
 mode only.
 .El
 .Pp
 The
 .Nm
 driver supports the following media options:
 .Bl -tag -width ".Cm full-duplex"
 .It Cm full-duplex
 Force full-duplex operation.
 .It Cm half-duplex
 Force half-duplex operation.
 .El
 .Pp
 The driver provides support for TCP/UDP/IP checksum offloading (although
 disabled by default).
 The device and driver also support 1536-byte frames for VLANs (vlanmtu).
 .Sh SYSCTL VARIABLES
 The following variables are available as both
 .Xr sysctl 8
 variables and
 .Xr loader 8
 tunables:
 .Bl -tag -width "xxxxxxxx"
 .It Va dev.cgem.%d.rxbufs
 The number of receive buffers allocated to the hardware.
 The default value is 256.
 The maximum value is 511.
 If this number is increased while the interface is UP, it will not
 take effect until the next packet is received.
 If this number is decreased while the interface is UP, buffers will
 not be immediately removed from the receive buffer ring but the
 number of buffers will decrease as packets are received until it
 reaches the new value.
 .It Va dev.cgem.%d.rxhangwar
 This tunable enables a work-around to recover from receive hangs.
 The default value is 1.
 Set to 0 to disable the work-around.
 .El
 .Pp
 The following read-only variables are available as
 .Xr sysctl 8
 variables:
 .Bl -tag -width "xxxxxxxx"
 .It Va dev.cgem.%d._rxoverruns
 This variable counts the number of receive packet buffer overrun interrupts.
 .It Va dev.cgem.%d._rxnobufs
 This variable counts the number of interrupts due to the GEM buffer ring
 going empty.
 .It Va dev.cgem.%d._rxdmamapfails
 This variable is the number of times bus_dmamap_load_mbuf_sg(9) failed in
 the receive path.
 .It Va dev.cgem.%d._txfull
 The number of times the GEM's transmit ring was full.
 .It Va dev.cgem.%d._txdmamapfails
 This variable is the number of times bus_dmamap_load_mbuf_sg(9) failed in
 the transmit path.
 .It Va dev.cgem.%d._txdefrags
 This variable is the number of times the driver needed to call m_defrag(9)
 because a packet queued for transmit had too many DMA segments.
 .It Va dev.cgem.%d._txdefragfails
 This variable is the number of times
 .Xr m_defrag 9
 failed.
 .It Va dev.cgem.%d.stats.*
 The following variables are useful MAC counters supplied by the hardware:
 .It Va dev.cgem.%d.stats.tx_bytes
 A 64-bit counter of the number of bytes transmitted in frames without error.
 .It Va dev.cgem.%d.stats.tx_frames
 Counter of frames transmitted without error excluding pause frames.
 .It Va dev.cgem.%d.stats.tx_frames_bcast
 Counter of broadcast frames transmitted without error excluding
 pause frames.
 .It Va dev.cgem.%d.stats.tx_frames_multi
 Counter of multicast frames transmitted without error excluding
 pause frames.
 .It Va dev.cgem.%d.stats.tx_frames_pause
 Counter of pause frames transmitted without error.
 .It Va dev.cgem.%d.stats.tx_frames_64b
 Counter of 64 byte frames transmitted without error.
 .It Va dev.cgem.%d.stats.tx_frames_65to127b
 Counter of 65 to 127 byte frames transmitted without error.
 .It Va dev.cgem.%d.stats.tx_frames_128to255b
 Counter of 128 to 255 byte frames transmitted without error.
 .It Va dev.cgem.%d.stats.tx_frames_256to511b
 Counter of 256 to 511 byte frames transmitted without error.
 .It Va dev.cgem.%d.stats.tx_frames_512to1023b
 Counter of 512 to 1023 byte frames transmitted without error.
 .It Va dev.cgem.%d.stats.tx_frames_1024to1536b
 Counter of 1024 to 1536 byte frames transmitted without error.
 .It Va dev.cgem.%d.stats.tx_under_runs
 Counter of frames not transmitted due to a transmit underrun.
 .It Va dev.cgem.%d.stats.tx_single_collisn
 Counter of frames experiencing a single collision before being successfully
 transmitted.
 .It Va dev.cgem.%d.stats.tx_multi_collisn
 Counter of frames experiencing between 2 and 15 collisions before
 being successfully transmitted.
 .It Va dev.cgem.%d.stats.tx_excsv_collisn
 Counter of frames that failed to transmit because they experienced 16
 collisions.
 .It Va dev.cgem.%d.stats.tx_late_collisn
 Counter of frames that experienced a late collision.
 .It Va dev.cgem.%d.stats.tx_deferred_frames
 Counter of frames experiencing deferral due to carrier sense being
 active on their first attempt at transmission.
 .It Va dev.cgem.%d.stats.tx_carrier_sense_errs
 Counter of frames transmitted where carrier sense was not seen during
 transmission or where carrier sense was deasserted after being asserted
 in a transmit frame without collision.
 .It Va dev.cgem.%d.stats.rx_bytes
 A 64-bit counter of bytes received without error excluding pause
 frames.
 .It Va dev.cgem.%d.stats.rx_frames
 Counter of frames received without error excluding pause frames.
 .It Va dev.cgem.%d.stats.rx_frames_bcast
 Counter of broadcast frames receive without error excluding pause frames.
 .It Va dev.cgem.%d.stats.rx_frames_multi
 Counter of multicast frames receive without error excluding pause frames.
 .It Va dev.cgem.%d.stats.rx_frames_pause
 Counter of pause frames recevied without error.
 .It Va dev.cgem.%d.stats.rx_frames_64b
 Counter of 64-byte frames received without error.
 .It Va dev.cgem.%d.stats.rx_frames_65to127b
 Counter of 65 to 127 byte frames received without error.
 .It Va dev.cgem.%d.stats.rx_frames_128to255b
 Counter of 128 to 255 byte frames received without error.
 .It Va dev.cgem.%d.stats.rx_frames_256to511b
 Counter of 256 to 511 byte frames received without error.
 .It Va dev.cgem.%d.stats.rx_frames_512to1023b
 Counter of 512 to 1023 byte frames received without error.
 .It Va dev.cgem.%d.stats.rx_frames_1024to1536b
 Counter of 1024 to 1536 byte frames received without error.
 .It Va dev.cgem.%d.stats.rx_frames_undersize
 Counter of frames received less than 64 bytes in length that
 do not also have either a CRC error or an alignment error.
 .It Va dev.cgem.%d.stats.rx_frames_oversize
 Counter of frames received exceeding 1536 bytes and do not also have either
 a CRC error or an alignment error.
 .It Va dev.cgem.%d.stats.rx_frames_jabber
 Counter of frames received exceeding 1536 bytes and also have either a CRC
 error, an alignment error, or a receive symbol error.
 .It Va dev.cgem.%d.stats.rx_frames_fcs_errs
 Counter of frames received with a bad CRC and are between 64
 and 1536 bytes.
 .It Va dev.cgem.%d.stats.rx_frames_length_errs
 Counter of frames received that are shorter than that extracted
 from the length field.
 .It Va dev.cgem.%d.stats.rx_symbol_errs
 Counter of receive symbol errors.
 .It Va dev.cgem.%d.stats.rx_align_errs
 Counter of received frames that are not an integral number of bytes.
 .It Va dev.cgem.%d.stats.rx_resource_errs
 Counter of frames successfully receive by the MAC but could not be
 copied to memory because no receive buffer was available.
 .It Va dev.cgem.%d.stats.rx_overrun_errs
 Counter of frames that are address recognized but were not copied
 to memory due to a receive overrun.
 .It Va dev.cgem.%d.stats.rx_frames_ip_hdr_csum_errs
 Counter of frames discarded due to an incorrect IP header checksum when
 checksum offloading is enabled.
 .It Va dev.cgem.%d.stats.rx_frames_tcp_csum_errs
 Counter of frames discarded due to an incorrect TCP checksum when
 checksum offloading is enabled.
 .It Va dev.cgem.%d.stats.rx_frames_udp_csum_errs
 Counter of frames discarded due to an incorrect UDP checksum when
 checksum offloading is enabled.
 .El
 .Sh SEE ALSO
 .Xr miibus 4 ,
 .Xr ifconfig 8
 .Rs
 .%T "Zynq-7000 SoC Technical Reference Manual (Xilinx doc UG585)"
 .%U http://www.xilinx.com/support/documentation/user_guides/\:ug585-Zynq-7000-TRM.pdf
 .Re
 .Sh HISTORY
 The
 .Nm
 device driver first appeared in
 .Fx 10.0 .
 .Sh AUTHORS
 The
 .Nm
 driver and this manual page was written by
 .An Thomas Skibo Aq Mt thomasskibo@yahoo.com .
 .Sh BUGS
 The GEM can perform TCP/UDP/IP checksum offloading.
 However, when transmit checksum offloading is enabled, the GEM generates and
 replaces checksums for all packets it transmits.
 In a system that is forwarding packets, the device could potentially correct
 the checksum of packet that was corrupted in transit.
 For this reason, checksum offloading is disabled by default but can be
 enabled using ifconfig(8).
 .Pp
 When receive checksum offloading is enabled, the device will discard packets
 with bad TCP/UDP/IP checksums.
 The bad packets will not be counted in any
 .Xr netstat 1
-statistics.  There are
+statistics.
+There are
 .Xr sysctl 8
 variables that count
 packets discarded by the hardware (see below).
 .Pp
 The GEM used in the Zynq-7000 has a bug such that  the receiver can
-potentially freeze up under a high load.  The issue is described in sec. 16.7
+potentially freeze up under a high load.
+The issue is described in sec. 16.7
 "Known Issues" of the Zynq-7000 SoC Technical Reference Manual (Xilinx
 UG585 v1.7).
 The
 .Nm
 driver implements the work-around suggested in the manual.
 If the bug does not exist in other versions of this device, the
 work-around can be disabled by setting the dev.cgem.%d.rxhangwar
 .Xr sysctl 8
 variable to 0.
Index: head/share/man/man4/man4.arm/mge.4
===================================================================
--- head/share/man/man4/man4.arm/mge.4	(revision 301590)
+++ head/share/man/man4/man4.arm/mge.4	(revision 301591)
@@ -1,158 +1,160 @@
 .\"
 .\" Copyright (c) 2008 Semihalf, Rafal Jaworowski
 .\"
 .\" All rights reserved.
 .\"
 .\" Redistribution and use in source and binary forms, with or without
 .\" modification, are permitted provided that the following conditions
 .\" are met:
 .\" 1. Redistributions of source code must retain the above copyright
 .\"    notice, this list of conditions and the following disclaimer.
 .\" 2. Redistributions in binary form must reproduce the above copyright
 .\"    notice, this list of conditions and the following disclaimer in the
 .\"    documentation and/or other materials provided with the distribution.
 .\"
 .\" THIS SOFTWARE IS PROVIDED BY THE DEVELOPERS ``AS IS'' AND ANY EXPRESS OR
 .\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
 .\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
 .\" IN NO EVENT SHALL THE DEVELOPERS BE LIABLE FOR ANY DIRECT, INDIRECT,
 .\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
 .\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
 .\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
 .\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
 .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
 .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 .\"
 .\" $FreeBSD$
 .\"
 .Dd November 27, 2008
 .Dt MGE 4
 .Os
 .Sh NAME
 .Nm mge
 .Nd "Marvell Gigabit Ethernet device driver"
 .Sh SYNOPSIS
 To compile this driver into the kernel, place the following lines in your
 kernel configuration file:
 .Bd -ragged -offset indent
 .Cd "device mge"
 .Cd "device miibus"
 .Ed
 .Sh DESCRIPTION
 The
 .Nm
 driver provides support for gigabit Ethernet controller integrated in Marvell
 system-on-chip devices.
 .Pp
 The
 .Nm
 driver supports the following media types:
 .Bl -tag -width xxxxxxxxxxxxxxxxxxxx
 .It autoselect
 Enable autoselection of the media type and options
 .It 10baseT/UTP
 Set 10Mbps operation
 .It 100baseTX
 Set 100Mbps operation
 .It 1000baseT
 Set 1000baseT operation
 .El
 .Pp
 The
 .Nm
 driver supports the following media options:
 .Bl -tag -width xxxxxxxxxxxxxxxxxxxx
 .It full-duplex
 Set full duplex operation
 .El
 .Pp
 The
 .Nm
 driver supports polled operation when the system is configured with
 DEVICE_POLLING kernel option, see
 .Xr polling 4
 for more details.
 .Pp
 The
 .Nm
 driver supports reception and transmission of extended frames
 for
 .Xr vlan 4 .
 This capability of
 .Nm
 can be controlled by means of the
 .Cm vlanmtu
 parameter
 to
 .Xr ifconfig 8 .
 .Pp
 The
 .Nm
 driver supports interrupts coalescing (IC) so that raising a transmit/receive
 frame interrupt is delayed, if possible, until a threshold-defined period of
-time has elapsed. The following sysctls regulate this behaviour (separately
-for each path):
+time has elapsed.
+The following sysctls regulate this behaviour (separately for each path):
 .Bl -tag -width indent
 .It Va dev.mge.X.int_coal.rx_time
 .It Va dev.mge.X.int_coal.tx_time
 .Pp
 Value of 0 disables IC on the given path, value greater than zero corresponds
 to a real time period and is expressed in units equivalent to 64 ticks of the
-MGE clock.  Maximum allowed value depends on MGE hardware revision. User
-provided values larger than supported will be trimmed to the maximum
-supported. More details are available in the reference manual of the device.
+MGE clock.
+Maximum allowed value depends on MGE hardware revision.
+User provided values larger than supported will be trimmed to the maximum
+supported.
+More details are available in the reference manual of the device.
 .El
 .Sh HARDWARE
 Gigabit Ethernet controllers built into the following Marvell systems-on-chip
 are known to work with the
 .Nm
 driver:
 .Pp
 .Bl -bullet -compact
 .It
 Orion 88F5182
 .It
 Orion 88F5281
 .It
 Kirkwood 88F6281 (MGE V2)
 .It
 Discovery MV78100 (MGE V2)
 .El
 .Pp
 There are also Marvell system controllers for PowerPC processors, which
 include a variation of this gigabit Ethernet module integrated on chip, and
 they should also work with the
 .Nm
 driver, but this wasn't tested:
 .Pp
 .Bl -bullet -compact
 .It
 MV64430
 .It
 MV64460, MV64461, MV64462
 .El
 .Sh SEE ALSO
 .Xr altq 4 ,
 .Xr arp 4 ,
 .Xr miibus 4 ,
 .Xr netintro 4 ,
 .Xr ng_ether 4 ,
 .Xr polling 4 ,
 .Xr vlan 4 ,
 .Xr ifconfig 8
 .Sh HISTORY
 The
 .Nm
 device driver first appeared in
 .Fx 8.0 .
 .Sh AUTHORS
 .An -nosplit
 The base version of
 .Nm
 device driver was written by
 .An Grzegorz Bernacki.
 It has been extended with advanced features (polling, interrupt coalescing,
 multicast, h/w checksum calculation etc.) by
 .An Piotr Ziecik .
 This manual page was written by
 .An Rafal Jaworowski .
Index: head/share/man/man5/devfs.rules.5
===================================================================
--- head/share/man/man5/devfs.rules.5	(revision 301590)
+++ head/share/man/man5/devfs.rules.5	(revision 301591)
@@ -1,127 +1,128 @@
 .\" Copyright (c) 2004 Roland Smith <rsmith@xs4all.nl>
 .\" All rights reserved.
 .\"
 .\" Redistribution and use in source and binary forms, with or without
 .\" modification, are permitted provided that the following conditions
 .\" are met:
 .\" 1. Redistributions of source code must retain the above copyright
 .\"    notice, this list of conditions and the following disclaimer.
 .\" 2. Redistributions in binary form must reproduce the above copyright
 .\"    notice, this list of conditions and the following disclaimer in the
 .\"    documentation and/or other materials provided with the distribution.
 .\"
 .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
 .\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
 .\" $FreeBSD$
 .\"
 .Dd February 21, 2010
 .Dt DEVFS.RULES 5
 .Os
 .Sh NAME
 .Nm devfs.rules
 .Nd devfs configuration information
 .Sh DESCRIPTION
 The
 .Nm
 file provides an easy way to create and apply
 .Xr devfs 8
 rules, even for devices that are not available at boot.
 .Pp
 For devices available at boot, see
 .Xr devfs.conf 5 .
 .Pp
 The format of this file is simple.
 Empty lines and lines beginning with a hash sign
 .Pq Ql #
 are ignored.
 A line between brackets denotes the start of a ruleset.
 In the brackets should be the name of the ruleset and its number,
 separated by an equal sign.
 .Pp
 Other lines are rule specifications as documented in
 .Xr devfs 8 ,
 in the section
 .Sx "Rule Specification" .
 These lines are prepended with
 .Dq Li rule
 and are passed to
 .Xr devfs 8
 by the startup scripts of the system.
 It is important to put path elements that contain
 .Xr glob 3
 special characters between quotes.
 .Pp
 Rulesets should have a unique name and number.
 .Pp
 All rules that follow a ruleset declaration belong to that ruleset, until a
 new ruleset is started.
 .Pp
 One custom ruleset has to be enabled in
 .Pa /etc/rc.conf ,
 otherwise it will not be applied to the
 .Pa /dev
 file system by the default system startup process.
 For example, to enable a
 .Dq Li localrules
 ruleset for the
 .Pa /dev
 file system, you would have to use something like this in your
 .Pa rc.conf
 file:
 .Bd -literal -offset indent
 devfs_system_ruleset="localrules"
 .Ed
 .Sh FILES
 .Bl -tag -compact -width Pa
 .It Pa /etc/defaults/devfs.rules
 Default
 .Nm
 configuration file.
 .It Pa /etc/devfs.rules
 Local
 .Nm
-configuration file. Rulesets in here override those in
+configuration file.
+Rulesets in here override those in
 .Pa /etc/defaults/devfs.rules
 with the same ruleset number, otherwise the two files are effectively merged.
 .El
 .Sh EXAMPLES
 To make all the partitions of
 .Xr da 4
 devices readable and writable by their owner and the
 .Dq Li usb
 group, the following rule may be used:
 .Pp
 .Dl "[localrules=10]"
 .Dl "add path 'da*s*' mode 0660 group usb"
 .Pp
 The first line declares and starts a new ruleset, with the name
 .Va localrules
 and the number 10.
 .Pp
 To give
 .Xr usbconfig 8
 and
 .Xr libusb 3
 enabled applications permission to all usb devices for their owner and the
 .Dq Li usb
 group, a similar rule may be used:
 .Pp
 .Dl "add path 'usb/*' mode 0660 group usb"
 .Sh SEE ALSO
 .Xr glob 3 ,
 .Xr devfs 5 ,
 .Xr devfs.conf 5 ,
 .Xr devfs 8
 .Sh AUTHORS
 This manual page was written by
 .An Roland Smith Aq Mt rsmith@xs4all.nl .
Index: head/share/man/man5/nandfs.5
===================================================================
--- head/share/man/man5/nandfs.5	(revision 301590)
+++ head/share/man/man5/nandfs.5	(revision 301591)
@@ -1,131 +1,132 @@
 .\"
 .\" Copyright (c) 2010 Semihalf
 .\" All rights reserved.
 .\"
 .\" Redistribution and use in source and binary forms, with or without
 .\" modification, are permitted provided that the following conditions
 .\" are met:
 .\" 1. Redistributions of source code must retain the above copyright
 .\"    notice, this list of conditions and the following disclaimer.
 .\" 2. Redistributions in binary form must reproduce the above copyright
 .\"    notice, this list of conditions and the following disclaimer in the
 .\"    documentation and/or other materials provided with the distribution.
 .\"
 .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
 .\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
 .\" $FreeBSD$
 .\"
 .Dd Nov 11, 2010
 .Dt NANDFS 5
 .Os
 .Sh NAME
 .Nm nandfs
 .Nd NAND Flash file system
 .Sh SYNOPSIS
 To compile support for the
 .Nm ,
 place the following in your kernel configuration file:
 .Bd -ragged -offset indent
 .Cd "options NANDFS"
 .Ed
 .Pp
 Even though the NAND FS can be used with any storage media, it has been
 optimized and designed towards NAND Flash devices, so typically the following
 driver is used:
 .Bd -ragged -offset indent
 .Cd "device nand"
 .Ed
 .Sh DESCRIPTION
 The
 .Nm
 driver enables
 .Fx
 with support for NAND-oriented file system.
 .Pp
 It is a log-structured style file system with the following major features and
 characteristics:
 .Bl -bullet
 .It
 Hard links, symbolic links support
 .It
 Block journaling
 .It
 Copy-On-Write
 .It
 Snapshots (continuous, taken automatically, simultaneously mountable)
 .It
 Quick crash recovery at mount time
 .It
 64-bit data structures; supports many files, large files and volumes
 .It
 POSIX file permissions
 .It
 Checksum / ECC
 .El
 .Sh EXAMPLES
 The most common usage is mounting the file system:
 .Pp
 .Dl "mount -t nandfs /dev/<gnandN> /mnt"
 .Pp
 or:
 .Dl "mount_nandfs /dev/<gnandN> /mnt"
 .Pp
 where
 .Ar gnandN
 is the GEOM device representing a Flash partition (slice) containing the
 .Nm
 structure, and
 .Pa /mnt
 is a mount point.
 .Pp
 It is possible to define an entry in
 .Pa /etc/fstab
 for the
 .Nm :
 .Bd -literal
 /dev/gnand0		/flash	nandfs		rw	0	0
 .Ed
 .Pp
 This will mount a
 .Nm
 partition at the specified mount point during system boot.
 .Sh SEE ALSO
 .Xr gnand 4 ,
 .Xr nand 4 ,
 .Xr mount_nandfs 8 ,
 .Xr nandfs 8 ,
 .Xr nandsim 8 ,
 .Xr nandtool 8 ,
 .Xr umount_nandfs 8
 .Sh HISTORY
 The NAND FS concepts are based on NILFS principles and initial implementation
-was derived from early read-only NILFS NetBSD code. Since then the NAND FS
+was derived from early read-only NILFS NetBSD code.
+Since then the NAND FS
 code diverged significantly and is by no means compatible with NILFS.
 .Pp
 The NAND Flash file system first appeared in
 .Fx 10.0 .
 .Sh AUTHORS
 .An -nosplit
 The NAND FS was written by
 .An Grzegorz Bernacki
 with the help of
 .An Mateusz Guzik ,
 based on the NetBSD code created by
 .An Reinoud Zandijk .
 Additional help and support by
 .An Lukasz Plachno ,
 .An Jan Sieka
 and
 .An Lukasz Wojcik .
 This manual page was written by
 .An Rafal Jaworowski .
Index: head/share/man/man5/quota.user.5
===================================================================
--- head/share/man/man5/quota.user.5	(revision 301590)
+++ head/share/man/man5/quota.user.5	(revision 301591)
@@ -1,129 +1,130 @@
 .\" Copyright (c) 2001	Nik Clayton
 .\"
 .\" Redistribution and use in source and binary forms, with or without
 .\" modification, are permitted provided that the following conditions
 .\" are met:
 .\" 1. Redistributions of source code must retain the above copyright
 .\"    notice, this list of conditions and the following disclaimer.
 .\" 2. Redistributions in binary form must reproduce the above copyright
 .\"    notice, this list of conditions and the following disclaimer in the
 .\"    documentation and/or other materials provided with the distribution.
 .\"
 .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
 .\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
 .\" $FreeBSD$
 .\"
 .Dd October 30, 2007
 .Dt QUOTA.USER 5
 .Os
 .Sh NAME
 .Nm quota.user , quota.group
 .Nd per file system quota database
 .Sh DESCRIPTION
 Each file system with active quotas should contain a
 .Pa quota.user
 and
 .Pa quota.group
 file in the file system root.
 These files are created by
 .Xr quotacheck 8 ,
 and should be edited with
 .Xr edquota 8 .
 It is possible to specify a different location and file name with the
 .Dq Li userquota
 and
 .Dq Li groupquota
 options in the
 .Xr fstab 5
 file.
 .Pp
 The data files contain the following information:
 .Pp
 .Bl -bullet -offset indent -compact
 .It
 Current block usage
 .It
 Current number of files
 .It
 Soft block limit
 .It
 Soft file limit
 .It
 Hard block limit
 .It
 Hard file limit
 .It
 Block grace time remaining if over the soft limit
 .It
 File grace time remaining if over the soft limit
 .El
 .Pp
 See
 .Xr edquota 8
 for an explanation on the various limits and grace periods.
 .Pp
 During normal quota operations the
 .Xr quotactl 2
 interface is used to query or set quota information and the kernel
 will maintain the data files as needed.
 If quotas are disabled on
 a file system, but marked as having quotas enabled in
 .Xr fstab 5 ,
 then the quota data files will be used directly.
 .Pp
 The data files are stored as an array of
 .Dq Li struct dqblk
 structures, as defined in
 .In ufs/ufs/quota.h ,
 and indexed by UID or GID.
 The data files will be written as a sparse file if possible.
 Data is only maintained for ids that have either non-zero usage or
 non-zero quota limits.
 If an attempt is made to access data for an id that would exist past the
 end of the current data file, a quota structure with all values set
 to zero will be created, and the data file extended as needed.
 The
 .Xr quotacheck 8
 utility will truncate the data files to the minimum size needed
 to store the highest id with either non-zero file usage or
 non-zero quota limits.
 .Pp
-The data record for id 0 has special meaning.  If the
+The data record for id 0 has special meaning.
+If the
 .Dq Dv dqb_btime
 or
 .Dq Dv dbq_itime
 fields are non-zero, they are used to indicate the grace period on
 that file system for users who have exceeded their soft limit.
 These times can be set by
 .Xr edquota 8
 with the
 .Fl t
 flag.
 If no explicit grace period has been set with
 .Xr edquota 8 ,
 then the default value of 7 days will be used.
 The default values are defined by
 .Dv MAX_DQ_TIME
 and
 .Dv MAX_IQ_TIME
 in
 .In ufs/ufs/quota.h .
 .Sh SEE ALSO
 .Xr quota 1 ,
 .Xr quotactl 2 ,
 .Xr fstab 5 ,
 .Xr edquota 8 ,
 .Xr quotacheck 8 ,
 .Xr quotaoff 8 ,
 .Xr quotaon 8 ,
 .Xr repquota 8
Index: head/share/man/man5/rc.conf.5
===================================================================
--- head/share/man/man5/rc.conf.5	(revision 301590)
+++ head/share/man/man5/rc.conf.5	(revision 301591)
@@ -1,4679 +1,4683 @@
 .\" Copyright (c) 1995
 .\"	Jordan K. Hubbard
 .\"
 .\" Redistribution and use in source and binary forms, with or without
 .\" modification, are permitted provided that the following conditions
 .\" are met:
 .\" 1. Redistributions of source code must retain the above copyright
 .\"    notice, this list of conditions and the following disclaimer.
 .\" 2. Redistributions in binary form must reproduce the above copyright
 .\"    notice, this list of conditions and the following disclaimer in the
 .\"    documentation and/or other materials provided with the distribution.
 .\"
 .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND
 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
 .\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR BE LIABLE
 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
 .\" $FreeBSD$
 .\"
 .Dd June 8, 2016
 .Dt RC.CONF 5
 .Os
 .Sh NAME
 .Nm rc.conf
 .Nd system configuration information
 .Sh DESCRIPTION
 The file
 .Nm
 contains descriptive information about the local host name, configuration
 details for any potential network interfaces and which services should be
 started up at system initial boot time.
 In new installations, the
 .Nm
 file is generally initialized by the system installation utility.
 .Pp
 The purpose of
 .Nm
 is not to run commands or perform system startup actions
 directly.
 Instead, it is included by the
 various generic startup scripts in
 .Pa /etc
 which conditionalize their
 internal actions according to the settings found there.
 .Pp
 The
 .Pa /etc/rc.conf
 file is included from the file
 .Pa /etc/defaults/rc.conf ,
 which specifies the default settings for all the available options.
 Options need only be specified in
 .Pa /etc/rc.conf
 when the system administrator wishes to override these defaults.
 The file
 .Pa /etc/rc.conf.local
 is used to override settings in
 .Pa /etc/rc.conf
 for historical reasons.
 .Pp
 In addition to
 .Pa /etc/rc.conf.local
 you can also place smaller configuration files for each
 .Xr rc 8
 script in the
 .Pa /etc/rc.conf.d
 directory or
 .Ao Ar dir Ac Ns Pa /rc.conf.d
 directories specified in
 .Va local_startup ,
 which will be included by the
 .Va load_rc_config
 function.
 For jail configurations you could use the file
 .Pa /etc/rc.conf.d/jail
 to store jail specific configuration options.
 If
 .Va local_startup
 contains
 .Pa /usr/local/etc/rc.d
 and
 .Pa /opt/conf ,
 .Pa /usr/local/rc.conf.d/jail
 and
 .Pa /opt/conf/rc.conf.d/jail
 will be loaded.
 If
 .Ao Ar dir Ac Ns Pa /rc.conf.d/ Ns Ao Ar name Ac
 is a directory,
 all of files in the directory will be loaded.
 Also see the
 .Va rc_conf_files
 variable below.
 .Pp
 Options are set with
 .Dq Ar name Ns Li = Ns Ar value
 assignments that use
 .Xr sh 1
 syntax.
 The following list provides a name and short description for each
 variable that can be set in the
 .Nm
 file:
 .Bl -tag -width indent-two
 .It Va rc_debug
 .Pq Vt bool
 If set to
 .Dq Li YES ,
 enable output of debug messages from rc scripts.
 This variable can be helpful in diagnosing mistakes when
 editing or integrating new scripts.
 Beware that this produces copious output to the terminal and
 .Xr syslog 3 .
 .It Va rc_info
 .Pq Vt bool
 If set to
 .Dq Li NO ,
 disable informational messages from the rc scripts.
 Informational messages are displayed when
 a condition that is not serious enough to warrant a warning or
 an error occurs.
 .It Va rc_startmsgs
 .Pq Vt bool
 If set to
 .Dq Li YES ,
 show
 .Dq Starting foo:
 when faststart is used (e.g., at boot time).
 .It Va early_late_divider
 .Pq Vt str
 The name of the script that should be used as the
 delimiter between the
 .Dq early
 and
 .Dq late
 stages of the boot process.
 The early stage should contain all the services needed to
 get the disks (local or remote) mounted so that the late
 stage can include scripts contained in the directories
 listed in the
 .Va local_startup
 variable (see below).
 Thus, the two likely candidates for this value are
 .Pa mountcritlocal
 for the typical system, and
 .Pa mountcritremote
 if the system needs remote file
 systems mounted to get access to the
 .Va local_startup
 directories; for example when
 .Pa /usr/local
 is NFS mounted.
 For
 .Pa rc.conf
 within a
 .Xr jail 8
 .Pa NETWORKING
 is likely to be an appropriate value.
 Extreme care should be taken when changing this value,
 and before changing it one should ensure that there are
 adequate provisions to recover from a failed boot
 (such as physical contact with the machine,
 or reliable remote console access).
 .It Va always_force_depends
 .Pq Vt bool
 Various
 .Pa rc.d
 scripts use the force_depend function to check whether required
 services are already running, and to start them if necessary.
 By default during boot time this check is bypassed if the
 required service is enabled in
 .Pa /etc/rc.conf[.local] .
 Setting this option will bypass that check at boot time and
 always test whether or not the service is actually running.
 Enabling this option is likely to increase your boot time if
 services are enabled that utilize the force_depend check.
 .It Ao Ar name Ac Ns Va _chroot
 .Pq Vt str
 .Xr chroot
 to this directory before running the service.
 .It Ao Ar name Ac Ns Va _user
 .Pq Vt str
 Run the service under this user account.
 .It Ao Ar name Ac Ns Va _group
 .Pq Vt str
-Run the chrooted service under this system group. Unlike the _user
+Run the chrooted service under this system group.
+Unlike the _user
 setting, this setting has no effect if the service is not chrooted.
 .It Ao Ar name Ac Ns Va _fib
 .Pq Vt int
 The
 .Xr setfib 1
 value to run the service under.
 .It Ao Ar name Ac Ns Va _nice
 .Pq Vt int
 The
 .Xr nice 1
 value to run the service under.
 .It Va apm_enable
 .Pq Vt bool
 If set to
 .Dq Li YES ,
 enable support for Automatic Power Management with
 the
 .Xr apm 8
 command.
 .It Va apmd_enable
 .Pq Vt bool
 Run
 .Xr apmd 8
 to handle APM event from userland.
 This also enables support for APM.
 .It Va apmd_flags
 .Pq Vt str
 If
 .Va apmd_enable
 is set to
 .Dq Li YES ,
 these are the flags to pass to the
 .Xr apmd 8
 daemon.
 .It Va devd_enable
 .Pq Vt bool
 Run
 .Xr devd 8
 to handle device added, removed or unknown events from the kernel.
 .It Va ddb_enable
 .Pq Vt bool
 Run
 .Xr ddb 8
 to install
 .Xr ddb 4
 scripts at boot time.
 .It Va ddb_config
 .Pq Vt str
 Configuration file for
 .Xr ddb 8 .
 Default
 .Pa /etc/ddb.conf .
 .It Va kld_list
 .Pq Vt str
 A list of kernel modules to load right after the local
 disks are mounted.
 Loading modules at this point in the boot process is
 much faster than doing it via
 .Pa /boot/loader.conf
 for those modules not necessary for mounting local disk.
 .It Va kldxref_enable
 .Pq Vt bool
 Set to
 .Dq Li NO
 by default.
 Set to
 .Dq Li YES
 to automatically rebuild
 .Pa linker.hints
 files with
 .Xr kldxref 8
 at boot time.
 .It Va kldxref_clobber
 .Pq Vt bool
 Set to
 .Dq Li NO
 by default.
 If
 .Va kldxref_enable
 is true,
 setting to
 .Dq Li YES
 will overwrite existing
 .Pa linker.hints
 files at boot time.
 Otherwise,
 only missing
 .Pa linker.hints
 files are generated.
 .It Va kldxref_module_path
 .Pq Vt str
 Empty by default.
 A semi-colon
 .Pq Ql \&;
 delimited list of paths containing
 .Xr kld 4
 modules.
 If empty,
 the contents of the
 .Va kern.module_path
 .Xr sysctl 8
 are used.
 .It Va powerd_enable
 .Pq Vt bool
 If set to
 .Dq Li YES ,
 enable the system power control facility with the
 .Xr powerd 8
 daemon.
 .It Va powerd_flags
 .Pq Vt str
 If
 .Va powerd_enable
 is set to
 .Dq Li YES ,
 these are the flags to pass to the
 .Xr powerd 8
 daemon.
 .It Va tmpmfs
 Controls the creation of a
 .Pa /tmp
 memory file system.
 Always happens if set to
 .Dq Li YES
 and never happens if set to
 .Dq Li NO .
 If set to anything else, a memory file system is created if
 .Pa /tmp
 is not writable.
 .It Va tmpsize
 Controls the size of a created
 .Pa /tmp
 memory file system.
 .It Va tmpmfs_flags
 Extra options passed to the
 .Xr mdmfs 8
 utility when the memory file system for
 .Pa /tmp
 is created.
 The default is
 .Dq Li "-S" ,
 which inhibits the use of softupdates on
 .Pa /tmp
 so that file system space is freed without delay
 after file truncation or deletion.
 See
 .Xr mdmfs 8
 for other options you can use in
 .Va tmpmfs_flags .
 .It Va varmfs
 Controls the creation of a
 .Pa /var
 memory file system.
 Always happens if set to
 .Dq Li YES
 and never happens if set to
 .Dq Li NO .
 If set to anything else, a memory file system is created if
 .Pa /var
 is not writable.
 .It Va varsize
 Controls the size of a created
 .Pa /var
 memory file system.
 .It Va varmfs_flags
 Extra options passed to the
 .Xr mdmfs 8
 utility when the memory file system for
 .Pa /var
 is created.
 The default is
 .Dq Li "-S" ,
 which inhibits the use of softupdates on
 .Pa /var
 so that file system space is freed without delay
 after file truncation or deletion.
 See
 .Xr mdmfs 8
 for other options you can use in
 .Va varmfs_flags .
 .It Va populate_var
 Controls the automatic population of the
 .Pa /var
 file system.
 Always happens if set to
 .Dq Li YES
 and never happens if set to
 .Dq Li NO .
 If set to anything else, a memory file system is created if
 .Pa /var
 is not writable.
 Note that this process requires access to certain commands in
 .Pa /usr
 before
 .Pa /usr
 is mounted on normal systems.
 .It Va cleanvar_enable
 .Pq Vt bool
 Clean the
 .Pa /var
 directory.
 .It Va local_startup
 .Pq Vt str
 List of directories to search for startup script files.
 .It Va script_name_sep
 .Pq Vt str
 The field separator to use for breaking down the list of startup script files
 into individual filenames.
 The default is a space.
 It is not necessary to change this unless there are startup scripts with names
 containing spaces.
 .It Va hostapd_enable
 .Pq Vt bool
 Set to
 .Dq Li YES
 to start
 .Xr hostapd 8
 at system boot time.
 .It Va hostname
 .Pq Vt str
 The fully qualified domain name (FQDN) of this host on the network.
 This should almost certainly be set to something meaningful, even if
 there is no network connection.
 If
 .Xr dhclient 8
 is used to set the hostname via DHCP,
 this variable should be set to an empty string.
 If this value remains unset when the system is done booting
 your console login will display the default hostname of
 .Dq Amnesiac .
 .It Va nisdomainname
 .Pq Vt str
 The NIS domain name of this host, or
 .Dq Li NO
 if NIS is not used.
 .It Va dhclient_program
 .Pq Vt str
 Path to the DHCP client program
 .Pa ( /sbin/dhclient ,
 the
 .Ox
 DHCP client,
 is the default).
 .It Va dhclient_flags
 .Pq Vt str
 Additional flags to pass to the DHCP client program.
 For the
 .Ox
 DHCP client, see the
 .Xr dhclient 8
 manpage for a description of the command line options available.
 .It Va dhclient_flags_ Ns Aq Ar iface
 Additional flags to pass to the DHCP client program running on
 .Ar iface
 only.
 When specified, this variable overrides
 .Va dhclient_flags .
 .It Va background_dhclient
 .Pq Vt bool
 Set to
 .Dq Li YES
 to start the DHCP client in background.
 This can cause trouble with applications depending on
 a working network, but it will provide a faster startup
 in many cases.
 .It Va background_dhclient_ Ns Aq Ar iface
 When specified, this variable overrides the
 .Va background_dhclient
 variable for interface
 .Ar iface
 only.
 .It Va synchronous_dhclient
 .Pq Vt bool
 Set to
 .Dq Li YES
 to start
 .Xr dhclient 8
 synchronously at startup.
 This behavior can be overridden on a per-interface basis by replacing
 the
 .Dq Li DHCP
 keyword in the
 .Va ifconfig_ Ns Aq Ar interface
 variable with
 .Dq Li SYNCDHCP
 or
 .Dq Li NOSYNCDHCP .
 .It Va defaultroute_delay
 .Pq Vt int
 When set to a positive value, wait up to this long after configuring
 DHCP interfaces at startup to give the interfaces time to receive a lease.
 .It Va firewall_enable
 .Pq Vt bool
 Set to
 .Dq Li YES
 to load firewall rules at startup.
 If the kernel was not built with
 .Cd "options IPFIREWALL" ,
 the
 .Pa ipfw.ko
 kernel module will be loaded.
 See also
 .Va ipfilter_enable .
 .It Va firewall_script
 .Pq Vt str
 This variable specifies the full path to the firewall script to run.
 The default is
 .Pa /etc/rc.firewall .
 .It Va firewall_type
 .Pq Vt str
 Names the firewall type from the selection in
 .Pa /etc/rc.firewall ,
 or the file which contains the local firewall ruleset.
 Valid selections from
 .Pa /etc/rc.firewall
 are:
 .Pp
 .Bl -tag -width ".Li simple" -compact
 .It Li open
 unrestricted IP access
 .It Li closed
 all IP services disabled, except via
 .Dq Li lo0
 .It Li client
 basic protection for a workstation
 .It Li simple
 basic protection for a LAN.
 .El
 .Pp
 If a filename is specified, the full path
 must be given.
 .It Va firewall_quiet
 .Pq Vt bool
 Set to
 .Dq Li YES
 to disable the display of firewall rules on the console during boot.
 .It Va firewall_logging
 .Pq Vt bool
 Set to
 .Dq Li YES
 to enable firewall event logging.
 This is equivalent to the
 .Dv IPFIREWALL_VERBOSE
 kernel option.
 .It Va firewall_logif
 .Pq Vt bool
 Set to
 .Dq Li YES
 to create pseudo interface
 .Li ipfw0
 for logging.
 For more details, see
 .Xr ipfw 8
 manual page.
 .It Va firewall_flags
 .Pq Vt str
 Flags passed to
 .Xr ipfw 8
 if
 .Va firewall_type
 specifies a filename.
 .It Va firewall_coscripts
 .Pq Vt str
 List of executables and/or rc scripts to run after firewall starts/stops.
 Default is empty.
 .\" ----- firewall_nat_enable setting --------------------------------
 .It Va firewall_nat_enable
 .Pq Vt bool
 The
 .Xr ipfw 8
 equivalent of
 .Va natd_enable .
 Setting this to
 .Dq Li YES
 enables kernel NAT.
 .Va firewall_enable
 must also be set to
 .Dq Li YES .
 .It Va firewall_nat_interface
 .Pq Vt str
 The
 .Xr ipfw 8
 equivalent of
 .Va natd_interface .
 This is the name of the public interface or IP address on which
 kernel NAT should run.
 .It Va firewall_nat_flags
 .Pq Vt str
 Additional configuration parameters for kernel NAT should be placed here.
 .It Va dummynet_enable
 .Pq Vt bool
 Setting this to
 .Dq Li YES
 will automatically load the
 .Xr dummynet 4
 module if
 .Va firewall_enable
 is also set to
 .Dq Li YES .
 .\" -------------------------------------------------------------------
 .It Va natd_program
 .Pq Vt str
 Path to
 .Xr natd 8 .
 .It Va natd_enable
 .Pq Vt bool
 Set to
 .Dq Li YES
 to enable
 .Xr natd 8 .
 .Va firewall_enable
 must also be set to
 .Dq Li YES ,
 and
 .Xr divert 4
 sockets must be enabled in the kernel.
 If the kernel was not built with
 .Cd "options IPDIVERT" ,
 the
 .Pa ipdivert.ko
 kernel module will be loaded.
 .It Va natd_interface
 .Pq Vt str
 This is the name of the public interface on which
 .Xr natd 8
 should run.
 The interface may be given as an interface name or as an IP address.
 .It Va natd_flags
 .Pq Vt str
 Additional
 .Xr natd 8
 flags should be placed here.
 The
 .Fl n
 or
 .Fl a
 flag is automatically added with the above
 .Va natd_interface
 as an argument.
 .\" ----- ipfilter_enable setting --------------------------------
 .It Va ipfilter_enable
 .Pq Vt bool
 Set to
 .Dq Li NO
 by default.
 Setting this to
 .Dq Li YES
 enables
 .Xr ipf 8
 packet filtering.
 .Pp
 Typical usage will require putting
 .Bd -literal
 ipfilter_enable="YES"
 ipnat_enable="YES"
 ipmon_enable="YES"
 ipfs_enable="YES"
 .Ed
 .Pp
 into
 .Pa /etc/rc.conf
 and editing
 .Pa /etc/ipf.rules
 and
 .Pa /etc/ipnat.rules
 appropriately.
 .Pp
 Note that
 .Va ipfilter_enable
 and
 .Va ipnat_enable
 can be enabled independently.
 .Va ipmon_enable
 and
 .Va ipfs_enable
 both require at least one of
 .Va ipfilter_enable
 and
 .Va ipnat_enable
 to be enabled.
 .Pp
 Having
 .Bd -literal
 options IPFILTER
 options IPFILTER_LOG
 options IPFILTER_DEFAULT_BLOCK
 .Ed
 .Pp
 in the kernel configuration file is a good idea, too.
 .\" ----- ipfilter_program setting ------------------------------
 .It Va ipfilter_program
 .Pq Vt str
 Path to
 .Xr ipf 8
 (default
 .Pa /sbin/ipf ) .
 .\" ----- ipfilter_rules setting --------------------------------
 .It Va ipfilter_rules
 .Pq Vt str
 Set to
 .Pa /etc/ipf.rules
 by default.
 This variable contains the name of the filter rule definition file.
 The file is expected to be readable for the
 .Xr ipf 8
 command to execute.
 .\" ----- ipv6_ipfilter_rules setting ---------------------------
 .It Va ipv6_ipfilter_rules
 .Pq Vt str
 Set to
 .Pa /etc/ipf6.rules
 by default.
 This variable contains the IPv6 filter rule definition file.
 The file is expected to be readable for the
 .Xr ipf 8
 command to execute.
 .\" ----- ipfilter_flags setting --------------------------------
 .It Va ipfilter_flags
 .Pq Vt str
 Empty by default.
 This variable contains flags passed to the
 .Xr ipf 8
 program.
 .\" ----- ipnat_enable setting ----------------------------------
 .It Va ipnat_enable
 .Pq Vt bool
 Set to
 .Dq Li NO
 by default.
 Set it to
 .Dq Li YES
 to enable
 .Xr ipnat 8
 network address translation.
 See
 .Va ipfilter_enable
 for a detailed discussion.
 .\" ----- ipnat_program setting ---------------------------------
 .It Va ipnat_program
 .Pq Vt str
 Path to
 .Xr ipnat 8
 (default
 .Pa /sbin/ipnat ) .
 .\" ----- ipnat_rules setting -----------------------------------
 .It Va ipnat_rules
 .Pq Vt str
 Set to
 .Pa /etc/ipnat.rules
 by default.
 This variable contains the name of the file
 holding the network address translation definition.
 This file is expected to be readable for the
 .Xr ipnat 8
 command to execute.
 .\" ----- ipnat_flags setting -----------------------------------
 .It Va ipnat_flags
 .Pq Vt str
 Empty by default.
 This variable contains flags passed to the
 .Xr ipnat 8
 program.
 .\" ----- ipmon_enable setting ----------------------------------
 .It Va ipmon_enable
 .Pq Vt bool
 Set to
 .Dq Li NO
 by default.
 Set it to
 .Dq Li YES
 to enable
 .Xr ipmon 8
 monitoring (logging
 .Xr ipf 8
 and
 .Xr ipnat 8
 events).
 Setting this variable needs setting
 .Va ipfilter_enable
 or
 .Va ipnat_enable
 too.
 See
 .Va ipfilter_enable
 for a detailed discussion.
 .\" ----- ipmon_program setting ---------------------------------
 .It Va ipmon_program
 .Pq Vt str
 Path to
 .Xr ipmon 8
 (default
 .Pa /sbin/ipmon ) .
 .\" ----- ipmon_flags setting -----------------------------------
 .It Va ipmon_flags
 .Pq Vt str
 Set to
 .Dq Li -Ds
 by default.
 This variable contains flags passed to the
 .Xr ipmon 8
 program.
 Another typical example would be
 .Dq Fl D Pa /var/log/ipflog
 to have
 .Xr ipmon 8
 log directly to a file bypassing
 .Xr syslogd 8 .
 Make sure to adjust
 .Pa /etc/newsyslog.conf
 in such case like this:
 .Bd -literal
 /var/log/ipflog  640  10  100  *  Z  /var/run/ipmon.pid
 .Ed
 .\" ----- ipfs_enable setting -----------------------------------
 .It Va ipfs_enable
 .Pq Vt bool
 Set to
 .Dq Li NO
 by default.
 Set it to
 .Dq Li YES
 to enable
 .Xr ipfs 8
 saving the filter and NAT state tables during shutdown
 and reloading them during startup again.
 Setting this variable needs setting
 .Va ipfilter_enable
 or
 .Va ipnat_enable
 to
 .Dq Li YES
 too.
 See
 .Va ipfilter_enable
 for a detailed discussion.
 Note that if
 .Va kern_securelevel
 is set to 3,
 .Va ipfs_enable
 cannot be used
 because the raised securelevel will prevent
 .Xr ipfs 8
 from saving the state tables at shutdown time.
 .\" ----- ipfs_program setting ----------------------------------
 .It Va ipfs_program
 .Pq Vt str
 Path to
 .Xr ipfs 8
 (default
 .Pa /sbin/ipfs ) .
 .\" ----- ipfs_flags setting ------------------------------------
 .It Va ipfs_flags
 .Pq Vt str
 Empty by default.
 This variable contains flags passed to the
 .Xr ipfs 8
 program.
 .\" ----- end of added ipf hook ---------------------------------
 .It Va pf_enable
 .Pq Vt bool
 Set to
 .Dq Li NO
 by default.
 Setting this to
 .Dq Li YES
 enables
 .Xr pf 4
 packet filtering.
 .Pp
 Typical usage will require putting
 .Pp
 .Dl pf_enable="YES"
 .Pp
 into
 .Pa /etc/rc.conf
 and editing
 .Pa /etc/pf.conf
 appropriately.
 Adding
 .Pp
 .Dl "device pf"
 .Pp
 builds support for
 .Xr pf 4
 into the kernel, otherwise the
 kernel module will be loaded.
 .It Va pf_rules
 .Pq Vt str
 Path to
 .Xr pf 4
 ruleset configuration file
 (default
 .Pa /etc/pf.conf ) .
 .It Va pf_program
 .Pq Vt str
 Path to
 .Xr pfctl 8
 (default
 .Pa /sbin/pfctl ) .
 .It Va pf_flags
 .Pq Vt str
 If
 .Va pf_enable
 is set to
 .Dq Li YES ,
 these flags are passed to the
 .Xr pfctl 8
 program when loading the ruleset.
 .It Va pflog_enable
 .Pq Vt bool
 Set to
 .Dq Li NO
 by default.
 Setting this to
 .Dq Li YES
 enables
 .Xr pflogd 8
 which logs packets from the
 .Xr pf 4
 packet filter.
 .It Va pflog_logfile
 .Pq Vt str
 If
 .Va pflog_enable
 is set to
 .Dq Li YES
 this controls where
 .Xr pflogd 8
 stores the logfile
 (default
 .Pa /var/log/pflog ) .
 Check
 .Pa /etc/newsyslog.conf
 to adjust logfile rotation for this.
 .It Va pflog_program
 .Pq Vt str
 Path to
 .Xr pflogd 8
 (default
 .Pa /sbin/pflogd ) .
 .It Va pflog_flags
 .Pq Vt str
 Empty by default.
 This variable contains additional flags passed to the
 .Xr pflogd 8
 program.
 .It Va pflog_instances
 .Pq Vt str
 If logging to more than one
 .Xr pflog 4
 interface is desired,
 .Va pflog_instances
 is set to the list of
 .Xr pflogd 8
-instances that should be started at system boot time. If
+instances that should be started at system boot time.
+If
 .Va pflog_instances
 is set, for each whitespace-seperated
 .Ar element
 in the list,
 .Ao Ar element Ac Ns Va _dev
 and
 .Ao Ar element Ac Ns Va _logfile
 elements are assumed to exist.
 .Ao Ar element Ac Ns Va _dev
 must contain the
 .Xr pflog 4
 interface to be watched by the named
 .Xr pflogd 8
 instance.
 .Ao Ar element Ac Ns Va _logfile
 must contain the name of the logfile that will be used by the
 .Xr pflogd 8
 instance.
 .It Va ftpproxy_enable
 .Pq Vt bool
 Set to
 .Dq Li NO
 by default.
 Setting this to
 .Dq Li YES
 enables
 .Xr ftp-proxy 8
 which supports the
 .Xr pf 4
 packet filter in translating ftp connections.
 .It Va ftpproxy_flags
 .Pq Vt str
 Empty by default.
 This variable contains additional flags passed to the
 .Xr ftp-proxy 8
 program.
 .It Va ftpproxy_instances
 .Pq Vt str
-Empty by default. If multiple instances of
+Empty by default.
+If multiple instances of
 .Xr ftp-proxy 8
 are desired at boot time,
 .Va ftpproxy_instances
-should contain a whitespace-seperated list of instance names. For each
+should contain a whitespace-seperated list of instance names.
+For each
 .Ar element
 in the list, a variable named
 .Ao Ar element Ac Ns Va _flags
 should be defined, containing the command-line flags to be passed to the
 .Xr ftp-proxy 8
 instance.
 .It Va pfsync_enable
 .Pq Vt bool
 Set to
 .Dq Li NO
 by default.
 Setting this to
 .Dq Li YES
 enables exposing
 .Xr pf 4
 state changes to other hosts over the network by means of
 .Xr pfsync 4 .
 The
 .Va pfsync_syncdev
 variable
 must also be set then.
 .It Va pfsync_syncdev
 .Pq Vt str
 Empty by default.
 This variable specifies the name of the network interface
 .Xr pfsync 4
 should operate through.
 It must be set accordingly if
 .Va pfsync_enable
 is set to
 .Dq Li YES .
 .It Va pfsync_syncpeer
 .Pq Vt str
 Empty by default.
 This variable is optional.
 By default, state change messages are sent out on the synchronisation
 interface using IP multicast packets.
 The protocol is IP protocol 240, PFSYNC, and the multicast group used is
 224.0.0.240.
 When a peer address is specified using the
 .Va pfsync_syncpeer
 option, the peer address is used as a destination for the pfsync
 traffic, and the traffic can then be protected using
 .Xr ipsec 4 .
 See the
 .Xr pfsync 4
 manpage for more details about using
 .Xr ipsec 4
 with
 .Xr pfsync 4
 interfaces.
 .It Va pfsync_ifconfig
 .Pq Vt str
 Empty by default.
 This variable can contain additional options to be passed to the
 .Xr ifconfig 8
 command used to set up
 .Xr pfsync 4 .
 .It Va tcp_extensions
 .Pq Vt bool
 Set to
 .Dq Li YES
 by default.
 Setting this to
 .Dq Li NO
 disables certain TCP options as described by
 .Rs
 .%T "RFC 1323"
 .Re
 Setting this to
 .Dq Li NO
 might help remedy such problems with connections as randomly hanging
 or other weird behavior.
 Some network devices are known
 to be broken with respect to these options.
 .It Va log_in_vain
 .Pq Vt int
 Set to 0 by default.
 The
 .Xr sysctl 8
 variables,
 .Va net.inet.tcp.log_in_vain
 and
 .Va net.inet.udp.log_in_vain ,
 as described in
 .Xr tcp 4
 and
 .Xr udp 4 ,
 are set to the given value.
 .It Va tcp_keepalive
 .Pq Vt bool
 Set to
 .Dq Li YES
 by default.
 Setting to
 .Dq Li NO
 will disable probing idle TCP connections to verify that the
 peer is still up and reachable.
 .It Va tcp_drop_synfin
 .Pq Vt bool
 Set to
 .Dq Li NO
 by default.
 Setting to
 .Dq Li YES
 will cause the kernel to ignore TCP frames that have both
 the SYN and FIN flags set.
 This prevents OS fingerprinting, but may
 break some legitimate applications.
 .It Va icmp_drop_redirect
 .Pq Vt bool
 Set to
 .Dq Li NO
 by default.
 Setting to
 .Dq Li YES
 will cause the kernel to ignore ICMP REDIRECT packets.
 Refer to
 .Xr icmp 4
 for more information.
 .It Va icmp_log_redirect
 .Pq Vt bool
 Set to
 .Dq Li NO
 by default.
 Setting to
 .Dq Li YES
 will cause the kernel to log ICMP REDIRECT packets.
 Note that
 the log messages are not rate-limited, so this option should only be used
 for troubleshooting networks.
 Refer to
 .Xr icmp 4
 for more information.
 .It Va icmp_bmcastecho
 .Pq Vt bool
 Set to
 .Dq Li YES
 to respond to broadcast or multicast ICMP ping packets.
 Refer to
 .Xr icmp 4
 for more information.
 .It Va ip_portrange_first
 .Pq Vt int
 If not set to
 .Dq Li NO ,
 this is the first port in the default portrange.
 Refer to
 .Xr ip 4
 for more information.
 .It Va ip_portrange_last
 .Pq Vt int
 If not set to
 .Dq Li NO ,
 this is the last port in the default portrange.
 Refer to
 .Xr ip 4
 for more information.
 .It Va network_interfaces
 .Pq Vt str
 Set to the list of network interfaces to configure on this host or
 .Dq Li AUTO
 (the default) for all current interfaces.
 Setting the
 .Va network_interfaces
 variable to anything other than the default is deprecated.
 Interfaces that the administrator wishes to store configuration for,
 but not start at boot should be configured with the
 .Dq Li NOAUTO
 keyword in their
 .Va ifconfig_ Ns Aq Ar interface
 variables as described below.
 .Pp
 An
 .Va ifconfig_ Ns Aq Ar interface
 variable is also assumed to exist for each value of
 .Ar interface .
 When an interface name contains any of the characters
 .Dq Li .-/+
 they are translated to
 .Dq Li _
 before lookup.
 The variable can contain arguments to
 .Xr ifconfig 8 ,
 as well as special case-insensitive keywords described below.
 Such keywords are removed before passing the value to
 .Xr ifconfig 8
 while the order of the other arguments is preserved.
 .Pp
 It is possible to add IP alias entries using
 .Xr ifconfig 8
 syntax with the address family keyword such as
 .Li inet .
 Assuming that the interface in question was
 .Li ed0 ,
 it might look something like this:
 .Bd -literal
 ifconfig_ed0_alias0="inet 127.0.0.253 netmask 0xffffffff"
 ifconfig_ed0_alias1="inet 127.0.0.254 netmask 0xffffffff"
 .Ed
 .Pp
 It also possible to configure multiple IP addresses in Classless
 Inter-Domain Routing
 .Pq CIDR
 address notation,
 whose each address component can be a range like
 .Li inet 192.0.2.5-23/24
 or
 .Li inet6 2001:db8:1-f::1/64 .
 This notation allows address and prefix length part only,
 not the other address modifiers.
 Note that the maximum number of the generated addresses from a range
 specification is limited to an integer value specified in
 .Va netif_ipexpand_max
 in
 .Xr rc.conf 5
 because a small typo can unexpectedly generate a large number of addresses.
 The default value is
 .Li 2048 .
 It can be increased by adding the following line into
 .Xr rc.conf 5 :
 .Bd -literal
 netif_ipexpand_max="4096"
 .Ed
 .Pp
 In the case of
 .Li 192.0.2.5-23/24 ,
 the address 192.0.2.5 will be configured with the
 netmask /24 and the addresses 192.0.2.6 to 192.0.2.23 with
 the non-conflicting netmask /32 as explained in the
 .Xr ifconfig 8
 alias section.
 Note that this special netmask handling is only for
 .Li inet ,
 not for the other address families such as
 .Li inet6 .
 .Pp
 With the interface in question being
 .Li ed0 ,
 an example could look like:
 .Bd -literal
 ifconfig_ed0_alias2="inet 192.0.2.129/27"
 ifconfig_ed0_alias3="inet 192.0.2.1-5/28"
 .Ed
 .Pp
 and so on.
 .Pp
 Note that
 .Va ipv4_addrs_ Ns Aq Ar interface
 variable was supported for IPv4 CIDR address notation.
 It is now deprecated because the functionality was integrated into
 .Va ifconfig_ Ns Ao Ar interface Ac Ns Va _alias Ns Aq Ar n
 though
 .Va ipv4_addrs_ Ns Aq Ar interface
 is still supported for backward compatibility.
 .Pp
 For each
 .Va ifconfig_ Ns Ao Ar interface Ac Ns Va _alias Ns Aq Ar n
 entry with an address family keyword,
 its contents are passed to
 .Xr ifconfig 8 .
 Execution stops at the first unsuccessful access, so if
 something like this is present:
 .Bd -literal
 ifconfig_ed0_alias0="inet 127.0.0.251 netmask 0xffffffff"
 ifconfig_ed0_alias1="inet 127.0.0.252 netmask 0xffffffff"
 ifconfig_ed0_alias2="inet 127.0.0.253 netmask 0xffffffff"
 ifconfig_ed0_alias4="inet 127.0.0.254 netmask 0xffffffff"
 .Ed
 .Pp
 Then note that alias4 would
 .Em not
 be added since the search would
 stop with the missing
 .Dq Li alias3
 entry.
 Because of this difficult to manage behavior,
 there is
 .Va ifconfig_ Ns Ao Ar interface Ac Ns Va _aliases
 variable, which has the same functionality as
 .Va ifconfig_ Ns Ao Ar interface Ac Ns Va _alias Ns Aq Ar n
 and can have all of entries in a variable like the following:
 .Bd -literal
 ifconfig_ed0_aliases="\\
 	inet 127.0.0.251 netmask 0xffffffff \\
 	inet 127.0.0.252 netmask 0xffffffff \\
 	inet 127.0.0.253 netmask 0xffffffff \\
 	inet 127.0.0.254 netmask 0xffffffff"
 .Ed
 .Pp
 It also supports CIDR notation.
 .Pp
 If the
 .Pa /etc/start_if. Ns Aq Ar interface
 file is present, it is read and executed by the
 .Xr sh 1
 interpreter
 before configuring the interface as specified in the
 .Va ifconfig_ Ns Aq Ar interface
 and
 .Va ifconfig_ Ns Ao Ar interface Ac Ns Va _alias Ns Aq Ar n
 variables.
 .Pp
 If a
 .Va vlans_ Ns Aq Ar interface
 variable is set,
 a
 .Xr vlan 4
 interface will be created for each item in the list with the
 .Ar vlandev
 argument set to
 .Ar interface .
 If a vlan interface's name is a number,
 then that number is used as the vlan tag and the new vlan interface is
 named
 .Ar interface . Ns Ar tag .
 Otherwise,
 the vlan tag must be specified via a
 .Va vlan
 parameter in the
 .Va create_args_ Ns Aq Ar interface
 variable.
 .Pp
 To create a vlan device named
 .Li em0.101
 on
 .Li em0
 with the vlan tag 101 and the optional the IPv4 address 192.0.2.1/24:
 .Bd -literal
 vlans_em0="101"
 ifconfig_em0_101="inet 192.0.2.1/24"
 .Ed
 .Pp
 To create a vlan device named
 .Li myvlan
 on
 .Li em0
 with the vlan tag 102:
 .Bd -literal
 vlans_em0="myvlan"
 create_args_myvlan="vlan 102"
 .Ed
 .Pp
 If a
 .Va wlans_ Ns Aq Ar interface
 variable is set,
 an
 .Xr wlan 4
 interface will be created for each item in the list with the
 .Ar wlandev
 argument set to
 .Ar interface .
 Further wlan cloning arguments may be passed to the
 .Xr ifconfig 8
 .Cm create
 command by setting the
 .Va create_args_ Ns Aq Ar interface
 variable.
 One or more
 .Xr wlan 4
 devices must be created for each wireless devices as of
 .Fx 8.0 .
 Debugging flags for
 .Xr wlan 4
 devices as set by
 .Xr wlandebug 8
 may be specified with an
 .Va wlandebug_ Ns Aq Ar interface
 variable.
 The contents of this variable will be passed directly to
 .Xr wlandebug 8 .
 .Pp
 If the
 .Va ifconfig_ Ns Aq Ar interface
 contains the keyword
 .Dq Li NOAUTO
 then the interface will not be configured
 at boot or by
 .Pa /etc/pccard_ether
 when
 .Va network_interfaces
 is set to
 .Dq Li AUTO .
 .Pp
 It is possible to bring up an interface with DHCP by adding
 .Dq Li DHCP
 to the
 .Va ifconfig_ Ns Aq Ar interface
 variable.
 For instance, to initialize the
 .Li ed0
 device via DHCP,
 it is possible to use something like:
 .Bd -literal
 ifconfig_ed0="DHCP"
 .Ed
 .Pp
 If you want to configure your wireless interface with
 .Xr wpa_supplicant 8
 for use with WPA, EAP/LEAP or WEP, you need to add
 .Dq Li WPA
 to the
 .Va ifconfig_ Ns Aq Ar interface
 variable.
 .Pp
 On the other hand, if you want to configure your wireless interface with
 .Xr hostapd 8 ,
 you need to add
 .Dq Li HOSTAP
 to the
 .Va ifconfig_ Ns Aq Ar interface
 variable.
 .Xr hostapd 8
 will use the settings from
 .Pa /etc/hostapd- Ns Ao Ar interface Ac Ns .conf
 .Pp
 Finally, you can add
 .Xr ifconfig 8
 options in this variable, in addition to the
 .Pa /etc/start_if. Ns Aq Ar interface
 file.
 For instance, to configure an
 .Xr ath 4
 wireless device in station mode with an address obtained
 via DHCP, using WPA authentication and 802.11b mode, it is
 possible to use something like:
 .Bd -literal
 wlans_ath0="wlan0"
 ifconfig_wlan0="DHCP WPA mode 11b"
 .Ed
 .Pp
 In addition to the
 .Va ifconfig_ Ns Aq Ar interface
 form, a fallback variable
 .Va ifconfig_DEFAULT
 may be configured.
 It will be used for all interfaces with no
 .Va ifconfig_ Ns Aq Ar interface
 variable.
 This is intended to replace the no longer supported
 .Va pccard_ifconfig
 variable.
 .Pp
 It is also possible to rename an interface by doing:
 .Bd -literal
 ifconfig_ed0_name="net0"
 ifconfig_net0="inet 192.0.2.1 netmask 0xffffff00"
 .Ed
 .It Va ipv6_enable
 .Pq Vt bool
 This variable is deprecated.
 Use
 .Va ifconfig_ Ns Ao Ar interface Ac Ns _ipv6
 and
 .Va ipv6_activate_all_interfaces
 if necessary.
 .Pp
 If the variable is
 .Dq Li YES ,
 .Dq Li inet6 accept_rtadv
 is added to all of
 .Va ifconfig_ Ns Ao Ar interface Ac Ns _ipv6
 and the
 .Va ipv6_activate_all_interfaces
 is defined as
 .Dq Li YES .
 .It Va ipv6_prefer
 .Pq Vt bool
 This variable is deprecated.
 Use
 .Va ip6addrctl_policy
 instead.
 .Pp
 If the variable is
 .Dq Li YES ,
 the default address selection policy table set by
 .Xr ip6addrctl 8
 will be IPv6-preferred.
 .Pp
 If the variable is
 .Dq Li NO ,
 the default address selection policy table set by
 .Xr ip6addrctl 8
 will be IPv4-preferred.
 .It Va ipv6_activate_all_interfaces
 .Pq Vt bool
 This controls initial configuration on IPv6-capable
 interfaces with no corresponding
 .Va ifconfig_ Ns Ao Ar interface Ac Ns _ipv6
 variable.
 Note that it is not always necessary to set this variable to
 .Dq YES
 to use IPv6 functionality on
 .Fx .
 In most cases, just configuring
 .Va ifconfig_ Ns Ao Ar interface Ac Ns _ipv6
 variables works.
 .Pp
 If the variable is
 .Dq Li NO ,
 all interfaces which do not have a corresponding
 .Va ifconfig_ Ns Ao Ar interface Ac Ns _ipv6
 variable will be marked as
 .Dq Li IFDISABLED
 at creation.
 This means that all of IPv6 functionality on that interface
 is completely disabled to enforce a security policy.
 If the variable is set to
 .Dq YES ,
 the flag will be cleared on all of the interfaces.
 .Pp
 In most cases, just defining an
 .Va ifconfig_ Ns Ao Ar interface Ac Ns _ipv6
 for an IPv6-capable interface should be sufficient.
 However, if an interface is added dynamically
 .Pq by some tunneling protocols such as PPP, for example ,
 it is often difficult to define the variable in advance.
 In such a case, configuring the
 .Dq Li IFDISABLED
 flag can be disabled by setting this variable to
 .Dq YES .
 .Pp
 For more details of the
 .Dq Li IFDISABLED
 flag and keywords
 .Dq Li inet6 ifdisabled ,
 see
 .Xr ifconfig 8 .
 .Pp
 Default is
 .Dq Li NO .
 .It Va ipv6_privacy
 .Pq Vt bool
 If the variable is
 .Dq Li YES
 privacy addresses will be generated for each IPv6
 interface as described in RFC 4941.
 .It Va ipv6_network_interfaces
 .Pq Vt str
 This is the IPv6 equivalent of
 .Va network_interfaces .
 Normally manual configuration of this variable is not needed.
 .It Va ipv6_cpe_wanif
 .Pq Vt str
 If the variable is set to an interface name,
 the
 .Xr ifconfig 8
 options
 .Dq inet6 -no_radr accept_rtadv
 will be added to the specified interface automatically before evaluating
 .Va ifconfig_ Ns Ao Ar interface Ac Ns _ipv6 ,
 and two
 .Xr sysctl 8
 variables
 .Va net.inet6.ip6.rfc6204w3
 and
 .Va net.inet6.ip6.no_radr
 will be set to 1.
 .Pp
 This means the specified interface will accept ICMPv6 Router
 Advertisement messages on that link and add the discovered
 routers into the Default Router List.
 While the other interfaces can still accept RA messages if the
 .Dq inet6 accept_rtadv
 option is specified, adding
 routes into the Default Router List will be disabled by
 .Dq inet6 no_radr
 option by default.
 See
 .Xr ifconfig 8
 for more details.
 .Pp
 Note that ICMPv6 Router Advertisement messages will be
 accepted even when
 .Va net.inet6.ip6.forwarding
 is 1
 .Pq packet forwarding is enabled
 when
 .Va net.inet6.ip6.rfc6204w3
 is set to 1.
 .Pp
 Default is
 .Dq Li NO .
 .It Va ifconfig_ Ns Ao Ar interface Ac Ns _ipv6
 .Pq Vt str
 IPv6 functionality on an interface should be configured by
 .Va ifconfig_ Ns Ao Ar interface Ac Ns _ipv6 ,
 instead of setting ifconfig parameters in
 .Va ifconfig_ Ns Aq Ar interface .
 If this variable is empty, all of IPv6 configurations on the
 specified interface by other variables such as
 .Va ipv6_prefix_ Ns Ao Ar interface Ac
 will be ignored.
 .Pp
 Aliases should be set by
 .Va ifconfig_ Ns Ao Ar interface Ac Ns Va _alias Ns Aq Ar n
 with
 .Dq Li inet6
 keyword.
 For example:
 .Bd -literal
 ifconfig_ed0_ipv6="inet6 2001:db8:1::1 prefixlen 64"
 ifconfig_ed0_alias0="inet6 2001:db8:2::1 prefixlen 64"
 .Ed
 .Pp
 Interfaces that have an
 .Dq Li inet6 accept_rtadv
 keyword in
 .Va ifconfig_ Ns Ao Ar interface Ac Ns _ipv6
 setting will be automatically configured by SLAAC
 .Pq StateLess Address AutoConfiguration
 described in
 .Rs
 .%T "RFC 4862"
 .Re
 .Pp
 Note that a link-local address will be automatically configured in
 addition to the configured global-scope addresses because the IPv6
 specifications require it on each link.
 The address is calculated from the MAC address by using an algorithm
 defined in
 .Rs
 .%T "RFC 4862"
 .%O "Section 5.3"
 .Re
 .Pp
 If only a link-local address is needed on the interface,
 the following configuration can be used:
 .Bd -literal
 ifconfig_ed0_ipv6="inet6 auto_linklocal"
 .Ed
 .Pp
 A link-local address can also be configured manually.
 This is useful for the default router address of an IPv6 router
 so that it does not change when the network interface
 card is replaced.
 For example:
 .Bd -literal
 ifconfig_ed0_ipv6="inet6 fe80::1 prefixlen 64"
 .Ed
 .It Va ipv6_prefix_ Ns Aq Ar interface
 .Pq Vt str
 If one or more prefixes are defined in
 .Va ipv6_prefix_ Ns Aq Ar interface
 addresses based on each prefix and the EUI-64 interface index will be
 configured on that interface.
 Note that this variable will be ignored when
 .Va ifconfig_ Ns Ao Ar interface Ac Ns _ipv6
 is empty.
 .Pp
 For example, the following configuration
 .Bd -literal
 ipv6_prefix_ed0="2001:db8:1:0 2001:db8:2:0"
 .Ed
 .Pp
 is equivalent to the following:
 .Bd -literal
 ifconfig_ed0_alias0="inet6 2001:db8:1:: eui64 prefixlen 64"
 ifconfig_ed0_alias1="inet6 2001:db8:1:: prefixlen 64 anycast"
 ifconfig_ed0_alias2="inet6 2001:db8:2:: eui64 prefixlen 64"
 ifconfig_ed0_alias3="inet6 2001:db8:2:: prefixlen 64 anycast"
 .Ed
 .Pp
 These Subnet-Router anycast addresses will be added only when
 .Va ipv6_gateway_enable
 is YES.
 .It Va ipv6_default_interface
 .Pq Vt str
 If not set to
 .Dq Li NO ,
 this is the default output interface for scoped addresses.
 This works only with ipv6_gateway_enable="NO".
 .It Va ip6addrctl_enable
 .Pq Vt bool
 This variable is to enable configuring default address selection policy table
 .Pq RFC 3484 .
 The table can be specified in another variable
 .Va ip6addrctl_policy .
 For
 .Va ip6addrctl_policy
 the following keywords can be specified:
 .Dq Li ipv4_prefer ,
 .Dq Li ipv6_prefer ,
 or
 .Dq Li AUTO .
 .Pp
 If
 .Dq Li ipv4_prefer
 or
 .Dq Li ipv6_prefer
 is specified,
 .Xr ip6addrctl 8
 installs a pre-defined policy table described in Section 2.1
 .Pq IPv6-preferred
 or 10.3
 .Pq IPv4-preferred
 of RFC 3484.
 .Pp
 If
 .Dq Li AUTO
 is specified, it attempts to read a file
 .Pa /etc/ip6addrctl.conf
 first.
 If this file is found,
 .Xr ip6addrctl 8
 reads and installs it.
 If not found, a policy is automatically set
 according to
 .Va ipv6_activate_all_interfaces
 variable; if the variable is set to
 .Dq Li YES
 the IPv6-preferred one is used.
 Otherwise IPv4-preferred.
 .Pp
 The default value of
 .Va ip6addrctl_enable
 and
 .Va ip6addrctl_policy
 are
 .Dq Li YES
 and
 .Dq Li AUTO ,
 respectively.
 .It Va cloned_interfaces
 .Pq Vt str
 Set to the list of clonable network interfaces to create on this host.
 Further cloning arguments may be passed to the
 .Xr ifconfig 8
 .Cm create
 command for each interface by setting the
 .Va create_args_ Ns Aq Ar interface
 variable.
 If an interface name is specified with
 .Dq :sticky
 keyword,
 the interface will not be destroyed even when
 .Pa rc.d/netif
 script is invoked with
 .Dq stop
 argument.
 This is useful when reconfiguring the interface without destroying it.
 Entries in
 .Va cloned_interfaces
 are automatically appended to
 .Va network_interfaces
 for configuration.
 .It Va cloned_interfaces_sticky
 .Pq Vt bool
 This variable is to globally enable functionality of
 .Dq :sticky
 keyword in
 .Va cloned_interfaces
 for all interfaces.
 The default value is
 .Dq NO .
 Even if this variable is specified to
 .Dq YES ,
 .Dq :nosticky
 keyword can be used to override it on per interface basis.
 .It Va gif_interfaces
 .Pq Vt str
 This variable is deprecated in favor of
 .Va cloned_interfaces .
 Set to the list of
 .Xr gif 4
 tunnel interfaces to configure on this host.
 A
 .Va gifconfig_ Ns Aq Ar interface
 variable is assumed to exist for each value of
 .Ar interface .
 The value of this variable is used to configure the link layer of the
 tunnel according to the syntax of the
 .Cm tunnel
 option to
 .Xr ifconfig 8 .
 Additionally, this option ensures that each listed interface is created
 via the
 .Cm create
 option to
 .Xr ifconfig 8
 before attempting to configure it.
 .It Va sppp_interfaces
 .Pq Vt str
 Set to the list of
 .Xr sppp 4
 interfaces to configure on this host.
 A
 .Va spppconfig_ Ns Aq Ar interface
 variable is assumed to exist for each value of
 .Ar interface .
 Each interface should also be configured by a general
 .Va ifconfig_ Ns Aq Ar interface
 setting.
 Refer to
 .Xr spppcontrol 8
 for more information about available options.
 .It Va ppp_enable
 .Pq Vt bool
 If set to
 .Dq Li YES ,
 run the
 .Xr ppp 8
 daemon.
 .It Va ppp_profile
 .Pq Vt str
 The name of the profile to use from
 .Pa /etc/ppp/ppp.conf .
 Also used for per-profile overrides of
 .Va ppp_mode
 and
 .Va ppp_nat ,
 and
 .Va ppp_ Ns Ao Ar profile Ac Ns _unit .
 When the profile name contains any of the characters
 .Dq Li .-/+
 they are translated to
 .Dq Li _
 for the proposes of the override variable names.
 .It Va ppp_mode
 .Pq Vt str
 Mode in which to run the
 .Xr ppp 8
 daemon.
 .It Va ppp_ Ns Ao Ar profile Ac Ns _mode
 .Pq Vt str
 Overrides the global
 .Va ppp_mode
 for
 .Ar profile .
 Accepted modes are
 .Dq Li auto ,
 .Dq Li ddial ,
 .Dq Li direct
 and
 .Dq Li dedicated .
 See the manual for a full description.
 .It Va ppp_nat
 .Pq Vt bool
 If set to
 .Dq Li YES ,
 enables network address translation.
 Used in conjunction with
 .Va gateway_enable
 allows hosts on private network addresses access to the Internet using
 this host as a network address translating router.
 .It Va ppp_ Ns Ao Ar profile Ac Ns _nat
 .Pq Vt str
 Overrides the global
 .Va ppp_nat
 for
 .Ar profile .
 .It Va ppp_ Ns Ao Ar profile Ac Ns _unit
 .Pq Vt int
 Set the unit number to be used for this profile.
 See the manual description of
 .Fl unit Ns Ar N
 for details.
 .It Va ppp_user
 .Pq Vt str
 The name of the user under which
 .Xr ppp 8
 should be started.
 By
 default,
 .Xr ppp 8
 is started as
 .Dq Li root .
 .It Va rc_conf_files
 .Pq Vt str
 This option is used to specify a list of files that will override
 the settings in
 .Pa /etc/defaults/rc.conf .
 The files will be read in the order in which they are specified and should
 include the full path to the file.
 By default, the files specified are
 .Pa /etc/rc.conf
 and
 .Pa /etc/rc.conf.local
 .It Va zfs_enable
 .Pq Vt bool
 If set to
 .Dq Li YES ,
 .Pa /etc/rc.d/zfs
 will attempt to automatically mount ZFS file systems and initialize ZFS volumes
 (ZVOLs).
 .It Va gptboot_enable
 .Pq Vt bool
 If set to
 .Dq Li YES ,
 .Pa /etc/rc.d/gptboot
 will log if the system successfully (or not) booted from a GPT partition,
 which had the
 .Ar bootonce
 attribute set using
 .Xr gpart 8
 utility.
 .It Va gbde_autoattach_all
 .Pq Vt bool
 If set to
 .Dq Li YES ,
 .Pa /etc/rc.d/gbde
 will attempt to automatically initialize your .bde devices in
 .Pa /etc/fstab .
 .It Va gbde_devices
 .Pq Vt str
 List the devices that the script should try to attach,
 or
 .Dq Li AUTO .
 .It Va gbde_lockdir
 .Pq Vt str
 The directory where the
 .Xr gbde 4
 lockfiles are located.
 The default lockfile directory is
 .Pa /etc .
 .Pp
 The lockfile for each individual
 .Xr gbde 4
 device can be overridden by setting the variable
 .Va gbde_lock_ Ns Aq Ar device ,
 where
 .Ar device
 is the encrypted device without the
 .Dq Pa /dev/
 and
 .Dq Pa .bde
 parts.
 .It Va gbde_attach_attempts
 .Pq Vt int
 Number of times to attempt attaching to a
 .Xr gbde 4
 device, i.e., how many times the user is asked for the pass-phrase.
 Default is 3.
 .It Va geli_devices
 .Pq Vt str
 List of devices to automatically attach on boot.
 Note that .eli devices from
 .Pa /etc/fstab
 are automatically appended to this list.
 .It Va geli_tries
 .Pq Vt int
 Number of times user is asked for the pass-phrase.
 If empty, it will be taken from
 .Va kern.geom.eli.tries
 sysctl variable.
 .It Va geli_default_flags
 .Pq Vt str
 Default flags to use by
 .Xr geli 8
 when configuring disk encryption.
 Flags can be configured for every device separately by defining
 .Va geli_ Ns Ao Ar device Ac Ns Va _flags
 variable.
 .It Va geli_autodetach
 .Pq Vt str
 Specifies if GELI devices should be marked for detach on last close after
 file systems are mounted.
 Default is
 .Dq Li YES .
 This can be changed for every device separately by defining
 .Va geli_ Ns Ao Ar device Ac Ns Va _autodetach
 variable.
 .It Va root_rw_mount
 .Pq Vt bool
 Set to
 .Dq Li YES
 by default.
 After the file systems are checked at boot time, the root file system
 is remounted as read-write if this is set to
 .Dq Li YES .
 Diskless systems that mount their root file system from a read-only remote
 NFS share should set this to
 .Dq Li NO
 in their
 .Pa rc.conf .
 .It Va fsck_y_enable
 .Pq Vt bool
 If set to
 .Dq Li YES ,
 .Xr fsck 8
 will be run with the
 .Fl y
 flag if the initial preen
 of the file systems fails.
 .It Va background_fsck
 .Pq Vt bool
 If set to
 .Dq Li YES ,
 the system will attempt to run
 .Xr fsck 8
 in the background where possible.
 .It Va background_fsck_delay
 .Pq Vt int
 The amount of time in seconds to sleep before starting a background
 .Xr fsck 8 .
 It defaults to sixty seconds to allow large applications such as
 the X server to start before disk I/O bandwidth is monopolized by
 .Xr fsck 8 .
 If set to a negative number, the background file system check will be
 delayed indefinitely to allow the administrator to run it at a more
 convenient time.
 For example it may be run from
 .Xr cron 8
 by adding a line like
 .Pp
 .Dl "0 4 * * * root /etc/rc.d/bgfsck forcestart"
 .Pp
 to
 .Pa /etc/crontab .
 .It Va netfs_types
 .Pq Vt str
 List of file system types that are network-based.
 This list should generally not be modified by end users.
 Use
 .Va extra_netfs_types
 instead.
 .It Va extra_netfs_types
 .Pq Vt str
 If set to something other than
 .Dq Li NO
 (the default),
 this variable extends the list of file system types
 for which automatic mounting at startup by
 .Xr rc 8
 should be delayed until the network is initialized.
 It should contain
 a whitespace-separated list of network file system descriptor pairs,
 each consisting of a file system type as passed to
 .Xr mount 8
 and a human-readable, one-word description,
 joined with a colon
 .Pq Ql \&: .
 Extending the default list in this way is only necessary
 when third party file system types are used.
 .It Va syslogd_enable
 .Pq Vt bool
 If set to
 .Dq Li YES ,
 run the
 .Xr syslogd 8
 daemon.
 .It Va syslogd_program
 .Pq Vt str
 Path to
 .Xr syslogd 8
 (default
 .Pa /usr/sbin/syslogd ) .
 .It Va syslogd_flags
 .Pq Vt str
 If
 .Va syslogd_enable
 is set to
 .Dq Li YES ,
 these are the flags to pass to
 .Xr syslogd 8 .
 .It Va inetd_enable
 .Pq Vt bool
 If set to
 .Dq Li YES ,
 run the
 .Xr inetd 8
 daemon.
 .It Va inetd_program
 .Pq Vt str
 Path to
 .Xr inetd 8
 (default
 .Pa /usr/sbin/inetd ) .
 .It Va inetd_flags
 .Pq Vt str
 If
 .Va inetd_enable
 is set to
 .Dq Li YES ,
 these are the flags to pass to
 .Xr inetd 8 .
 .It Va hastd_enable
 .Pq Vt bool
 If set to
 .Dq Li YES ,
 run the
 .Xr hastd 8
 daemon.
 .It Va hastd_program
 .Pq Vt str
 Path to
 .Xr hastd 8
 (default
 .Pa /sbin/hastd ) .
 .It Va hastd_flags
 .Pq Vt str
 If
 .Va hastd_enable
 is set to
 .Dq Li YES ,
 these are the flags to pass to
 .Xr hastd 8 .
 .It Va local_unbound_enable
 .Pq Vt bool
 If set to
 .Dq Li YES ,
 run the
 .Xr unbound 8
 daemon as a local caching resolver.
 .It Va kdc_enable
 .Pq Vt bool
 Set to
 .Dq Li YES
 to start a Kerberos 5 authentication server
 at boot time.
 .It Va kdc_program
 .Pq Vt str
 If
 .Va kdc_enable
 is set to
 .Dq Li YES
 this is the path to Kerberos 5 Authentication Server.
 .It Va kdc_flags
 .Pq Vt str
 Empty by default.
 This variable contains additional flags to be passed to the Kerberos 5
 authentication server.
 .It Va kadmind_enable
 .Pq Vt bool
 Set to
 .Dq Li YES
 to start
 .Xr kadmind 8 ,
 the Kerberos 5 Administration Daemon; set to
 .Dq Li NO
 on a slave server.
 .It Va kadmind_program
 .Pq Vt str
 If
 .Va kadmind_enable
 is set to
 .Dq Li YES
 this is the path to Kerberos 5 Administration Daemon.
 .It Va kpasswdd_enable
 .Pq Vt bool
 Set to
 .Dq Li YES
 to start
 .Xr kpasswdd 8 ,
 the Kerberos 5 Password-Changing Daemon; set to
 .Dq Li NO
 on a slave server.
 .It Va kpasswdd_program
 .Pq Vt str
 If
 .Va kpasswdd_enable
 is set to
 .Dq Li YES
 this is the path to Kerberos 5 Password-Changing Daemon.
 .It Va kfd_enable
 .Pq Vt bool
 Set to
 .Dq Li YES
 to start
 .Xr kfd 8 ,
 the Kerberos 5 ticket forwarding daemon, at the boot time.
 .It Va kfd_program
 .Pq Vt str
 Path to
 .Xr kfd 8
 (default
 .Pa /usr/libexec/kfd ) .
 .It Va rwhod_enable
 .Pq Vt bool
 If set to
 .Dq Li YES ,
 run the
 .Xr rwhod 8
 daemon at boot time.
 .It Va rwhod_flags
 .Pq Vt str
 If
 .Va rwhod_enable
 is set to
 .Dq Li YES ,
 these are the flags to pass to it.
 .It Va amd_enable
 .Pq Vt bool
 If set to
 .Dq Li YES ,
 run the
 .Xr amd 8
 daemon at boot time.
 .It Va amd_flags
 .Pq Vt str
 If
 .Va amd_enable
 is set to
 .Dq Li YES ,
 these are the flags to pass to it.
 See the
 .Xr amd 8
 manpage for more information.
 .It Va amd_map_program
 .Pq Vt str
 If set,
 the specified program is run to get the list of
 .Xr amd 8
 maps.
 For example, if the
 .Xr amd 8
 maps are stored in NIS, one can set this to
 run
 .Xr ypcat 1
 to get a list of
 .Xr amd 8
 maps from the
 .Pa amd.master
 NIS map.
 .It Va update_motd
 .Pq Vt bool
 If set to
 .Dq Li YES ,
 .Pa /etc/motd
 will be updated at boot time to reflect the kernel release
 being run.
 If set to
 .Dq Li NO ,
 .Pa /etc/motd
 will not be updated.
 .It Va nfs_client_enable
 .Pq Vt bool
 If set to
 .Dq Li YES ,
 run the NFS client daemons at boot time.
 .It Va nfs_access_cache
 .Pq Vt int
 If
 .Va nfs_client_enable
 is set to
 .Dq Li YES ,
 this can be set to
 .Dq Li 0
 to disable NFS ACCESS RPC caching, or to the number of seconds for which
 NFS ACCESS
 results should be cached.
 A value of 2-10 seconds will substantially reduce network
 traffic for many NFS operations.
 .It Va nfs_server_enable
 .Pq Vt bool
 If set to
 .Dq Li YES ,
 run the NFS server daemons at boot time.
 .It Va nfs_server_flags
 .Pq Vt str
 If
 .Va nfs_server_enable
 is set to
 .Dq Li YES ,
 these are the flags to pass to the
 .Xr nfsd 8
 daemon.
 .It Va nfsv4_server_enable
 .Pq Vt bool
 If
 .Va nfs_server_enable
 is set to
 .Dq Li YES
 and
 .Va nfsv4_server_enable
 are set to
 .Dq Li YES ,
 enable the server for NFSv4 as well as NFSv2 and NFSv3.
 .It Va nfsuserd_enable
 .Pq Vt bool
 If
 .Va nfsuserd_enable
 is set to
 .Dq Li YES ,
 run the nfsuserd daemon, which is needed for NFSv4 in order
 to map between user/group names vs uid/gid numbers.
 If
 .Va nfsv4_server_enable
 is set to
 .Dq Li YES ,
 this will be forced enabled.
 .It Va nfsuserd_flags
 .Pq Vt str
 If
 .Va nfsuserd_enable
 is set to
 .Dq Li YES ,
 these are the flags to pass to the
 .Xr nfsuserd 8
 daemon.
 .It Va nfscbd_enable
 .Pq Vt bool
 If
 .Va nfscbd_enable
 is set to
 .Dq Li YES ,
 run the nfscbd daemon, which enables callbacks/delegations for the NFSv4 client.
 .It Va nfscbd_flags
 .Pq Vt str
 If
 .Va nfscbd_enable
 is set to
 .Dq Li YES ,
 these are the flags to pass to the
 .Xr nfscbd 8
 daemon.
 .It Va mountd_enable
 .Pq Vt bool
 If set to
 .Dq Li YES ,
 and no
 .Va nfs_server_enable
 is set, start
 .Xr mountd 8 ,
 but not
 .Xr nfsd 8
 daemon.
 It is commonly needed to run CFS without real NFS used.
 .It Va mountd_flags
 .Pq Vt str
 If
 .Va mountd_enable
 is set to
 .Dq Li YES ,
 these are the flags to pass to the
 .Xr mountd 8
 daemon.
 .It Va weak_mountd_authentication
 .Pq Vt bool
 If set to
 .Dq Li YES ,
 allow services like PCNFSD to make non-privileged mount
 requests.
 .It Va nfs_reserved_port_only
 .Pq Vt bool
 If set to
 .Dq Li YES ,
 provide NFS services only on a secure port.
 .It Va nfs_bufpackets
 .Pq Vt int
 If set to a number, indicates the number of packets worth of
 socket buffer space to reserve on an NFS client.
 The kernel default is typically 4.
 Using a higher number may be
 useful on gigabit networks to improve performance.
 The minimum value is
 2 and the maximum is 64.
 .It Va rpc_lockd_enable
 .Pq Vt bool
 If set to
 .Dq Li YES
 and also an NFS server or client, run
 .Xr rpc.lockd 8
 at boot time.
 .It Va rpc_lockd_flags
 .Pq Vt str
 If
 .Va rpc_lockd_enable
 is set to
 .Dq Li YES ,
 these are the flags to pass to the
 .Xr rpc.lockd 8
 daemon.
 .It Va rpc_statd_enable
 .Pq Vt bool
 If set to
 .Dq Li YES
 and also an NFS server or client, run
 .Xr rpc.statd 8
 at boot time.
 .It Va rpc_statd_flags
 .Pq Vt str
 If
 .Va rpc_statd_enable
 is set to
 .Dq Li YES ,
 these are the flags to pass to the
 .Xr rpc.statd 8
 daemon.
 .It Va rpcbind_program
 .Pq Vt str
 Path to
 .Xr rpcbind 8
 (default
 .Pa /usr/sbin/rpcbind ) .
 .It Va rpcbind_enable
 .Pq Vt bool
 If set to
 .Dq Li YES ,
 run the
 .Xr rpcbind 8
 service at boot time.
 .It Va rpcbind_flags
 .Pq Vt str
 If
 .Va rpcbind_enable
 is set to
 .Dq Li YES ,
 these are the flags to pass to the
 .Xr rpcbind 8
 daemon.
 .It Va keyserv_enable
 .Pq Vt bool
 If set to
 .Dq Li YES ,
 run the
 .Xr keyserv 8
 daemon on boot for running Secure RPC.
 .It Va keyserv_flags
 .Pq Vt str
 If
 .Va keyserv_enable
 is set to
 .Dq Li YES ,
 these are the flags to pass to
 .Xr keyserv 8
 daemon.
 .It Va pppoed_enable
 .Pq Vt bool
 If set to
 .Dq Li YES ,
 run the
 .Xr pppoed 8
 daemon at boot time to provide PPP over Ethernet services.
 .It Va pppoed_ Ns Aq Ar provider
 .Pq Vt str
 .Xr pppoed 8
 listens to requests to this
 .Ar provider
 and ultimately runs
 .Xr ppp 8
 with a
 .Ar system
 argument of the same name.
 .It Va pppoed_flags
 .Pq Vt str
 Additional flags to pass to
 .Xr pppoed 8 .
 .It Va pppoed_interface
 .Pq Vt str
 The network interface to run
 .Xr pppoed 8
 on.
 This is mandatory when
 .Va pppoed_enable
 is set to
 .Dq Li YES .
 .It Va timed_enable
 .Pq Vt bool
 If set to
 .Dq Li YES ,
 run the
 .Xr timed 8
 service at boot time.
 This command is intended for networks of
 machines where a consistent
 .Dq "network time"
 for all hosts must be established.
 This is often useful in large NFS
 environments where time stamps on files are expected to be consistent
 network-wide.
 .It Va timed_flags
 .Pq Vt str
 If
 .Va timed_enable
 is set to
 .Dq Li YES ,
 these are the flags to pass to the
 .Xr timed 8
 service.
 .It Va ntpdate_enable
 .Pq Vt bool
 If set to
 .Dq Li YES ,
 run
 .Xr ntpdate 8
 at system startup.
 This command is intended to
 synchronize the system clock only
 .Em once
 from some standard reference.
 .It Va ntpdate_config
 .Pq Vt str
 Configuration file for
 .Xr ntpdate 8 .
 Default
 .Pa /etc/ntp.conf .
 .It Va ntpdate_hosts
 .Pq Vt str
 A whitespace-separated list of NTP servers to synchronize with at startup.
 The default is to use the servers listed in
 .Va ntpdate_config ,
 if that file exists.
 .It Va ntpdate_program
 .Pq Vt str
 Path to
 .Xr ntpdate 8
 (default
 .Pa /usr/sbin/ntpdate ) .
 .It Va ntpdate_flags
 .Pq Vt str
 If
 .Va ntpdate_enable
 is set to
 .Dq Li YES ,
 these are the flags to pass to the
 .Xr ntpdate 8
 command (typically a hostname).
 .It Va ntpd_enable
 .Pq Vt bool
 If set to
 .Dq Li YES ,
 run the
 .Xr ntpd 8
 command at boot time.
 .It Va ntpd_program
 .Pq Vt str
 Path to
 .Xr ntpd 8
 (default
 .Pa /usr/sbin/ntpd ) .
 .It Va ntpd_config
 .Pq Vt str
 Path to
 .Xr ntpd 8
 configuration file.
 Default
 .Pa /etc/ntp.conf .
 .It Va ntpd_flags
 .Pq Vt str
 If
 .Va ntpd_enable
 is set to
 .Dq Li YES ,
 these are the flags to pass to the
 .Xr ntpd 8
 daemon.
 .It Va ntpd_sync_on_start
 .Pq Vt bool
 If set to
 .Dq Li YES ,
 .Xr ntpd 8
 is run with the
 .Fl g
 flag, which syncs the system's clock on startup.
 See
 .Xr ntpd 8
 for more information regarding the
 .Fl g
 option.
 This is a preferred alternative to using
 .Xr ntpdate 8
 or specifying the
 .Va ntpdate_enable
 variable.
 .It Va nis_client_enable
 .Pq Vt bool
 If set to
 .Dq Li YES ,
 run the
 .Xr ypbind 8
 service at system boot time.
 .It Va nis_client_flags
 .Pq Vt str
 If
 .Va nis_client_enable
 is set to
 .Dq Li YES ,
 these are the flags to pass to the
 .Xr ypbind 8
 service.
 .It Va nis_ypldap_enable
 .Pq Vt bool
 If set to
 .Dq Li YES ,
 run the
 .Xr ypldap 8
 daemon at system boot time.
 .It Va nis_ypldap_flags
 .Pq Vt str
 If
 .Va nis.ypldap_enable
 is set to
 .Dq Li YES ,
 these are the flags to pass to the
 .Xr ypldap 8
 daemon.
 .It Va nis_ypset_enable
 .Pq Vt bool
 If set to
 .Dq Li YES ,
 run the
 .Xr ypset 8
 daemon at system boot time.
 .It Va nis_ypset_flags
 .Pq Vt str
 If
 .Va nis_ypset_enable
 is set to
 .Dq Li YES ,
 these are the flags to pass to the
 .Xr ypset 8
 daemon.
 .It Va nis_server_enable
 .Pq Vt bool
 If set to
 .Dq Li YES ,
 run the
 .Xr ypserv 8
 daemon at system boot time.
 .It Va nis_server_flags
 .Pq Vt str
 If
 .Va nis_server_enable
 is set to
 .Dq Li YES ,
 these are the flags to pass to the
 .Xr ypserv 8
 daemon.
 .It Va nis_ypxfrd_enable
 .Pq Vt bool
 If set to
 .Dq Li YES ,
 run the
 .Xr rpc.ypxfrd 8
 daemon at system boot time.
 .It Va nis_ypxfrd_flags
 .Pq Vt str
 If
 .Va nis_ypxfrd_enable
 is set to
 .Dq Li YES ,
 these are the flags to pass to the
 .Xr rpc.ypxfrd 8
 daemon.
 .It Va nis_yppasswdd_enable
 .Pq Vt bool
 If set to
 .Dq Li YES ,
 run the
 .Xr rpc.yppasswdd 8
 daemon at system boot time.
 .It Va nis_yppasswdd_flags
 .Pq Vt str
 If
 .Va nis_yppasswdd_enable
 is set to
 .Dq Li YES ,
 these are the flags to pass to the
 .Xr rpc.yppasswdd 8
 daemon.
 .It Va rpc_ypupdated_enable
 .Pq Vt bool
 If set to
 .Dq Li YES ,
 run the
 .Nm rpc.ypupdated
 daemon at system boot time.
 .It Va bsnmpd_enable
 .Pq Vt bool
 If set to
 .Dq Li YES ,
 run the
 .Xr bsnmpd 1
 daemon at system boot time.
 Be sure to understand the security implications of running SNMP daemon
 on your host.
 .It Va bsnmpd_flags
 .Pq Vt str
 If
 .Va bsnmpd_enable
 is set to
 .Dq Li YES ,
 these are the flags to pass to the
 .Xr bsnmpd 1
 daemon.
 .It Va defaultrouter
 .Pq Vt str
 If not set to
 .Dq Li NO ,
 create a default route to this host name or IP address
 (use an IP address if this router is also required to get to the
 name server!).
 .It Va ipv6_defaultrouter
 .Pq Vt str
 The IPv6 equivalent of
 .Va defaultrouter .
 .It Va static_arp_pairs
 .Pq Vt str
 Set to the list of static ARP pairs that are to be added at system
 boot time.
 For each whitespace separated
 .Ar element
 in the value, a
 .Va static_arp_ Ns Aq Ar element
 variable is assumed to exist whose contents will later be passed to a
 .Dq Nm arp Cm -S
 operation.
 For example
 .Bd -literal
 static_arp_pairs="gw"
 static_arp_gw="192.168.1.1 00:01:02:03:04:05"
 .Ed
 .It Va static_ndp_pairs
 .Pq Vt str
 Set to the list of static NDP pairs that are to be added at system
 boot time.
 For each whitespace separated
 .Ar element
 in the value, a
 .Va static_ndp_ Ns Aq Ar element
 variable is assumed to exist whose contents will later be passed to a
 .Dq Nm ndp Cm -s
 operation.
 For example
 .Bd -literal
 static_ndp_pairs="gw"
 static_ndp_gw="2001:db8:3::1 00:01:02:03:04:05"
 .Ed
 .It Va static_routes
 .Pq Vt str
 Set to the list of static routes that are to be added at system
 boot time.
 If not set to
 .Dq Li NO
 then for each whitespace separated
 .Ar element
 in the value, a
 .Va route_ Ns Aq Ar element
 variable is assumed to exist
 whose contents will later be passed to a
 .Dq Nm route Cm add
 operation.
 For example:
 .Bd -literal
 static_routes="ext mcast:gif0 gif0local:gif0"
 route_ext="-net 10.0.0.0/24 -gateway 192.168.0.1"
 route_mcast="-net 224.0.0.0/4 -iface gif0"
 route_gif0local="-host 169.254.1.1 -iface lo0"
 .Ed
 .Pp
 When an
 .Ar element
 is in the form of
 .Li name:ifname ,
 the route is specific to the interface
 .Li ifname .
 .It Va ipv6_static_routes
 .Pq Vt str
 The IPv6 equivalent of
 .Va static_routes .
 If not set to
 .Dq Li NO
 then for each whitespace separated
 .Ar element
 in the value, a
 .Va ipv6_route_ Ns Aq Ar element
 variable is assumed to exist
 whose contents will later be passed to a
 .Dq Nm route Cm add Fl inet6
 operation.
 .It Va natm_static_routes
 .Pq Vt str
 The
 .Xr natmip 4
 equivalent of
 .Va static_routes .
 If not empty then for each whitespace separated
 .Ar element
 in the value, a
 .Va route_ Ns Aq Ar element
 variable is assumed to exist whose contents will later be passed to a
 .Dq Nm atmconfig Cm natm Cm add
 operation.
 .It Va gateway_enable
 .Pq Vt bool
 If set to
 .Dq Li YES ,
 configure host to act as an IP router, e.g.\& to forward packets
 between interfaces.
 .It Va ipv6_gateway_enable
 .Pq Vt bool
 The IPv6 equivalent of
 .Va gateway_enable .
 .It Va routed_enable
 .Pq Vt bool
 If set to
 .Dq Li YES ,
 run a routing daemon of some sort, based on the
 settings of
 .Va routed_program
 and
 .Va routed_flags .
 .It Va route6d_enable
 .Pq Vt bool
 The IPv6 equivalent of
 .Va routed_enable .
 If set to
 .Dq Li YES ,
 run a routing daemon of some sort, based on the
 settings of
 .Va route6d_program
 and
 .Va route6d_flags .
 .It Va routed_program
 .Pq Vt str
 If
 .Va routed_enable
 is set to
 .Dq Li YES ,
 this is the name of the routing daemon to use.
 .It Va route6d_program
 .Pq Vt str
 The IPv6 equivalent of
 .Va routed_program .
 .It Va routed_flags
 .Pq Vt str
 If
 .Va routed_enable
 is set to
 .Dq Li YES ,
 these are the flags to pass to the routing daemon.
 .It Va route6d_flags
 .Pq Vt str
 The IPv6 equivalent of
 .Va routed_flags .
 .It Va mroute6d_enable
 .Pq Vt bool
 If set to
 .Dq Li YES ,
 run the IPv6 multicast routing daemon.
 .Pp
 Note that multicast routing daemons are no longer included in the
 .Fx
 base system, however, both
 .Xr mrouted 8
 and
 .Xr pim6dd 8
 may be installed from the
 .Fx
 Ports Collection.
 .It Va mroute6d_flags
 .Pq Vt str
 If
 .Va mroute6d_enable
 is set to
 .Dq Li YES ,
 these are the flags passed to the IPv6 multicast routing daemon.
 .It Va mroute6d_program
 .Pq Vt str
 If
 .Va mroute6d_enable
 is set to
 .Dq Li YES ,
 this is the path to the IPv6 multicast routing daemon.
 .It Va rtadvd_enable
 .Pq Vt bool
 If set to
 .Dq Li YES ,
 run the
 .Xr rtadvd 8
 daemon at boot time.
 The
 .Xr rtadvd 8
 utility sends ICMPv6 Router Advertisement messages to
 the interfaces specified in
 .Va rtadvd_interfaces .
 This should only be enabled with great care.
 You may want to fine-tune
 .Xr rtadvd.conf 5 .
 .It Va rtadvd_interfaces
 .Pq Vt str
 If
 .Va rtadvd_enable
 is set to
 .Dq Li YES
 this is the list of interfaces to use.
 .It Va arpproxy_all
 .Pq Vt bool
 If set to
 .Dq Li YES ,
 enable global proxy ARP.
 .It Va forward_sourceroute
 .Pq Vt bool
 If set to
 .Dq Li YES
 and
 .Va gateway_enable
 is also set to
 .Dq Li YES ,
 source-routed packets are forwarded.
 .It Va accept_sourceroute
 .Pq Vt bool
 If set to
 .Dq Li YES ,
 the system will accept source-routed packets directed at it.
 .It Va rarpd_enable
 .Pq Vt bool
 If set to
 .Dq Li YES ,
 run the
 .Xr rarpd 8
 daemon at system boot time.
 .It Va rarpd_flags
 .Pq Vt str
 If
 .Va rarpd_enable
 is set to
 .Dq Li YES ,
 these are the flags to pass to the
 .Xr rarpd 8
 daemon.
 .It Va bootparamd_enable
 .Pq Vt bool
 If set to
 .Dq Li YES ,
 run the
 .Xr bootparamd 8
 daemon at system boot time.
 .It Va bootparamd_flags
 .Pq Vt str
 If
 .Va bootparamd_enable
 is set to
 .Dq Li YES ,
 these are the flags to pass to the
 .Xr bootparamd 8
 daemon.
 .It Va stf_interface_ipv4addr
 .Pq Vt str
 If not set to
 .Dq Li NO ,
 this is the local IPv4 address for 6to4 (IPv6 over IPv4 tunneling
 interface).
 Specify this entry to enable the 6to4 interface.
 .It Va stf_interface_ipv4plen
 .Pq Vt int
 Prefix length for 6to4 IPv4 addresses, to limit peer address range.
 An effective value is 0-31.
 .It Va stf_interface_ipv6_ifid
 .Pq Vt str
 IPv6 interface ID for
 .Xr stf 4 .
 This can be set to
 .Dq Li AUTO .
 .It Va stf_interface_ipv6_slaid
 .Pq Vt str
 IPv6 Site Level Aggregator for
 .Xr stf 4 .
 .It Va ipv6_ipv4mapping
 .Pq Vt bool
 If set to
 .Dq Li YES
 this enables IPv4 mapped IPv6 address communication (like
 .Li ::ffff:a.b.c.d ) .
 .It Va rtsold_enable
 .Pq Vt bool
 Set to
 .Dq Li YES
 to enable the
 .Xr rtsold 8
 daemon to send ICMPv6 Router Solicitation messages.
 .It Va rtsold_flags
 .Pq Vt str
 If
 .Va rtsold_enable
 is set to
 .Dq Li YES ,
 these are the flags to pass to
 .Xr rtsold 8 .
 .It Va rtsol_flags
 .Pq Vt str
 For interfaces configured with the
 .Dq Li inet6 accept_rtadv
 keyword, these are the flags to pass to
 .Xr rtsol 8 .
 .Pp
 Note that
 .Va rtsold_enable
 is mutually exclusive to
 .Va rtsol_flags ;
 .Va rtsold_enable
 takes precedence.
 .It Va atm_enable
 .Pq Vt bool
 Set to
 .Dq Li YES
 to enable the configuration of ATM interfaces at system boot time.
 For all of the ATM variables described below, please refer to the
 .Xr atm 8
 manual page for further details on the available command parameters.
 Also refer to the files in
 .Pa /usr/share/examples/atm
 for more detailed configuration information.
 .It Va atm_load
 .Pq Vt str
 This is a list of physical ATM interface drivers to load.
 Typical values are
 .Dq Li hfa_pci
 and/or
 .Dq Li hea_pci .
 .It Va atm_netif_ Ns Aq Ar intf
 .Pq Vt str
 For the ATM physical interface
 .Ar intf ,
 this variable defines the name prefix and count for the ATM network
 interfaces to be created.
 The value will be passed as the parameters of an
 .Dq Nm atm Cm "set netif" Ar intf
 command.
 .It Va atm_sigmgr_ Ns Aq Ar intf
 .Pq Vt str
 For the ATM physical interface
 .Ar intf ,
 this variable defines the ATM signalling manager to be used.
 The value will be passed as the parameters of an
 .Dq Nm atm Cm attach Ar intf
 command.
 .It Va atm_prefix_ Ns Aq Ar intf
 .Pq Vt str
 For the ATM physical interface
 .Ar intf ,
 this variable defines the NSAP prefix for interfaces using a UNI signalling
 manager.
 If set to
 .Dq Li ILMI ,
 the prefix will automatically be set via the
 .Xr ilmid 8
 daemon.
 Otherwise, the value will be passed as the parameters of an
 .Dq Nm atm Cm "set prefix" Ar intf
 command.
 .It Va atm_macaddr_ Ns Aq Ar intf
 .Pq Vt str
 For the ATM physical interface
 .Ar intf ,
 this variable defines the MAC address for interfaces using a UNI signalling
 manager.
 If set to
 .Dq Li NO ,
 the hardware MAC address contained in the ATM interface card will be used.
 Otherwise, the value will be passed as the parameters of an
 .Dq Nm atm Cm "set mac" Ar intf
 command.
 .It Va atm_arpserver_ Ns Aq Ar netif
 .Pq Vt str
 For the ATM network interface
 .Ar netif ,
 this variable defines the ATM address for a host which is to provide ATMARP
 service.
 This variable is only applicable to interfaces using a UNI signalling
 manager.
 If set to
 .Dq Li local ,
 this host will become an ATMARP server.
 The value will be passed as the parameters of an
 .Dq Nm atm Cm "set arpserver" Ar netif
 command.
 .It Va atm_scsparp_ Ns Aq Ar netif
 .Pq Vt bool
 If set to
 .Dq Li YES ,
 SCSP/ATMARP service for the network interface
 .Ar netif
 will be initiated using the
 .Xr scspd 8
 and
 .Xr atmarpd 8
 daemons.
 This variable is only applicable if
 .Va atm_arpserver_ Ns Aq Ar netif
 is set to
 .Dq Li local .
 .It Va atm_pvcs
 .Pq Vt str
 Set to the list of ATM PVCs to be added at system
 boot time.
 For each whitespace separated
 .Ar element
 in the value, an
 .Va atm_pvc_ Ns Aq Ar element
 variable is assumed to exist.
 The value of each of these variables
 will be passed as the parameters of an
 .Dq Nm atm Cm "add pvc"
 command.
 .It Va atm_arps
 .Pq Vt str
 Set to the list of permanent ATM ARP entries to be added
 at system boot time.
 For each whitespace separated
 .Ar element
 in the value, an
 .Va atm_arp_ Ns Aq Ar element
 variable is assumed to exist.
 The value of each of these variables
 will be passed as the parameters of an
 .Dq Nm atm Cm "add arp"
 command.
 .It Va natm_interfaces
 .Pq Vt str
 Set to the list of
 .Xr natm 4
 interfaces that will also be used for HARP through
 .Xr harp 4 .
 If this list is not empty all interfaces in the list will be brought up
 with
 .Xr ifconfig 8
 and
 .Xr harp 4
 will be loaded.
 For this to work the interface drivers must be either compiled into the
 kernel or must reside on the root partition.
 .It Va keybell
 .Pq Vt str
 The keyboard bell sound.
 Set to
 .Dq Li normal ,
 .Dq Li visual ,
 .Dq Li off ,
 or
 .Dq Li NO
 if the default behavior is desired.
 For details, refer to the
 .Xr kbdcontrol 1
 manpage.
 .It Va keyboard
 .Pq Vt str
 If set to a non-null string, the virtual console's keyboard input is
 set to this device.
 .It Va keymap
 .Pq Vt str
 If set to
 .Dq Li NO ,
 no keymap is installed, otherwise the value is used to install
 the keymap file found in
 .Pa /usr/share/syscons/keymaps/ Ns Ao Ar value Ac Ns Pa .kbd
 (if using
 .Xr syscons 4 ) or
 .Pa /usr/share/vt/keymaps/ Ns Ao Ar value Ac Ns Pa .kbd
 (if using
 .Xr vt 4 ) .
 .It Va keyrate
 .Pq Vt str
 The keyboard repeat speed.
 Set to
 .Dq Li slow ,
 .Dq Li normal ,
 .Dq Li fast ,
 or
 .Dq Li NO
 if the default behavior is desired.
 .It Va keychange
 .Pq Vt str
 If not set to
 .Dq Li NO ,
 attempt to program the function keys with the value.
 The value should
 be a single string of the form:
 .Dq Ar funkey_number new_value Op Ar funkey_number new_value ... .
 .It Va cursor
 .Pq Vt str
 Can be set to the value of
 .Dq Li normal ,
 .Dq Li blink ,
 .Dq Li destructive ,
 or
 .Dq Li NO
 to set the cursor behavior explicitly or choose the default behavior.
 .It Va scrnmap
 .Pq Vt str
 If set to
 .Dq Li NO ,
 no screen map is installed, otherwise the value is used to install
 the screen map file in
 .Pa /usr/share/syscons/scrnmaps/ Ns Aq Ar value .
 This parameter is ignored when using
 .Xr vt 4
 as the console driver.
 .It Va font8x16
 .Pq Vt str
 If set to
 .Dq Li NO ,
 the default 8x16 font value is used for screen size requests, otherwise
 the value in
 .Pa /usr/share/syscons/fonts/ Ns Aq Ar value
 or
 .Pa /usr/share/vt/fonts/ Ns Aq Ar value
 is used (depending on the console driver being used).
 .It Va font8x14
 .Pq Vt str
 If set to
 .Dq Li NO ,
 the default 8x14 font value is used for screen size requests, otherwise
 the value in
 .Pa /usr/share/syscons/fonts/ Ns Aq Ar value
 or
 .Pa /usr/share/vt/fonts/ Ns Aq Ar value
 is used (depending on the console driver being used).
 .It Va font8x8
 .Pq Vt str
 If set to
 .Dq Li NO ,
 the default 8x8 font value is used for screen size requests, otherwise
 the value in
 .Pa /usr/share/syscons/fonts/ Ns Aq Ar value
 or
 .Pa /usr/share/vt/fonts/ Ns Aq Ar value
 is used (depending on the console driver being used).
 .It Va blanktime
 .Pq Vt int
 If set to
 .Dq Li NO ,
 the default screen blanking interval is used, otherwise it is set
 to
 .Ar value
 seconds.
 .It Va saver
 .Pq Vt str
 If not set to
 .Dq Li NO ,
 this is the actual screen saver to use
 .Li ( blank , snake , daemon ,
 etc).
 .It Va moused_nondefault_enable
 .Pq Vt str
 If set to
 .Dq Li NO ,
 the mouse device specified on
 the command line is not automatically treated as enabled by the
 .Pa /etc/rc.d/moused
 script.
 Having this variable set to
 .Dq Li YES
 allows a
 .Xr usb 4
 mouse,
 for example,
 to be enabled as soon as it is plugged in.
 .It Va moused_enable
 .Pq Vt str
 If set to
 .Dq Li YES ,
 the
 .Xr moused 8
 daemon is started for doing cut/paste selection on the console.
 .It Va moused_type
 .Pq Vt str
 This is the protocol type of the mouse connected to this host.
 This variable must be set if
 .Va moused_enable
 is set to
 .Dq Li YES .
 The
 .Xr moused 8
 daemon
 is able to detect the appropriate mouse type automatically in many cases.
 Set this variable to
 .Dq Li auto
 to let the daemon detect it, or
 select one from the following list if the automatic detection fails.
 .Pp
 If the mouse is attached to the PS/2 mouse port, choose
 .Dq Li auto
 or
 .Dq Li ps/2 ,
 regardless of the brand and model of the mouse.
 Likewise, if the
 mouse is attached to the bus mouse port, choose
 .Dq Li auto
 or
 .Dq Li busmouse .
 All other protocols are for serial mice and will not work with
 the PS/2 and bus mice.
 If this is a USB mouse,
 .Dq Li auto
 is the only protocol type which will work.
 .Pp
 .Bl -tag -width ".Li x10mouseremote" -compact
 .It Li microsoft
 Microsoft mouse (serial)
 .It Li intellimouse
 Microsoft IntelliMouse (serial)
 .It Li mousesystems
 Mouse systems Corp.\& mouse (serial)
 .It Li mmseries
 MM Series mouse (serial)
 .It Li logitech
 Logitech mouse (serial)
 .It Li busmouse
 A bus mouse
 .It Li mouseman
 Logitech MouseMan and TrackMan (serial)
 .It Li glidepoint
 ALPS GlidePoint (serial)
 .It Li thinkingmouse
 Kensington ThinkingMouse (serial)
 .It Li ps/2
 PS/2 mouse
 .It Li mmhittab
 MM HitTablet (serial)
 .It Li x10mouseremote
 X10 MouseRemote (serial)
 .It Li versapad
 Interlink VersaPad (serial)
 .El
 .Pp
 Even if the mouse is not in the above list, it may be compatible
 with one in the list.
 Refer to the manual page for
 .Xr moused 8
 for compatibility information.
 .Pp
 It should also be noted that while this is enabled, any
 other client of the mouse (such as an X server) should access
 the mouse through the virtual mouse device,
 .Pa /dev/sysmouse ,
 and configure it as a
 .Dq Li sysmouse
 type mouse, since all
 mouse data is converted to this single canonical format when
 using
 .Xr moused 8 .
 If the client program does not support the
 .Dq Li sysmouse
 type,
 specify the
 .Dq Li mousesystems
 type.
 It is the second preferred type.
 .It Va moused_port
 .Pq Vt str
 If
 .Va moused_enable
 is set to
 .Dq Li YES ,
 this is the actual port the mouse is on.
 It might be
 .Pa /dev/cuau0
 for a COM1 serial mouse,
 .Pa /dev/psm0
 for a PS/2 mouse or
 .Pa /dev/mse0
 for a bus mouse, for example.
 .It Va moused_flags
 .Pq Vt str
 If
 .Va moused_flags
 is set, its value is used as an additional set of flags to pass to the
 .Xr moused 8
 daemon.
 .It Va "moused_" Ns Ar XXX Ns Va "_flags"
 When
 .Va moused_nondefault_enable
 is enabled, and a
 .Xr moused 8
 daemon is started for a non-default port, the
 .Va "moused_" Ns Ar XXX Ns Va "_flags"
 set of options has precedence over and replaces the default
 .Va moused_flags
 (where
 .Ar XXX
 is the name of the non-default port, i.e.,\&
 .Ar ums0 ) .
 By setting
 .Va "moused_" Ns Ar XXX Ns Va "_flags"
 it is possible to set up a different set of default flags for each
 .Xr moused 8
 instance.
 For example, you can use
 .Dq Li "-3"
 for the default
 .Va moused_flags
 to make your laptop's touchpad more comfortable to use,
 but an empty set of options for
 .Va moused_ums0_flags
 when your
 .Xr usb 4
 mouse has three or more buttons.
 .It Va mousechar_start
 .Pq Vt int
 If set to
 .Dq Li NO ,
 the default mouse cursor character range
 .Li 0xd0 Ns - Ns Li 0xd3
 is used,
 otherwise the range start is set
 to
 .Ar value
 character, see
 .Xr vidcontrol 1 .
 Use if the default range is occupied in the language code table.
 .It Va allscreens_flags
 .Pq Vt str
 If set,
 .Xr vidcontrol 1
 is run with these options for each of the virtual terminals
 .Pq Pa /dev/ttyv* .
 For example,
 .Dq Fl m Cm on
 will enable the mouse pointer on all virtual terminals
 if
 .Va moused_enable
 is set to
 .Dq Li YES .
 .It Va allscreens_kbdflags
 .Pq Vt str
 If set,
 .Xr kbdcontrol 1
 is run with these options for each of the virtual terminals
 .Pq Pa /dev/ttyv* .
 For example,
 .Dq Fl h Li 200
 will set the
 .Xr syscons 4
 or
 .Xr vt 4
 scrollback (history) buffer to 200 lines.
 .It Va cron_enable
 .Pq Vt bool
 If set to
 .Dq Li YES ,
 run the
 .Xr cron 8
 daemon at system boot time.
 .It Va cron_program
 .Pq Vt str
 Path to
 .Xr cron 8
 (default
 .Pa /usr/sbin/cron ) .
 .It Va cron_flags
 .Pq Vt str
 If
 .Va cron_enable
 is set to
 .Dq Li YES ,
 these are the flags to pass to
 .Xr cron 8 .
 .It Va cron_dst
 .Pq Vt bool
 If set to
 .Dq Li YES ,
 enable the special handling of transitions to and from the
 Daylight Saving Time in
 .Xr cron 8
 (equivalent to using the flag
 .Fl s ) .
 .It Va lpd_program
 .Pq Vt str
 Path to
 .Xr lpd 8
 (default
 .Pa /usr/sbin/lpd ) .
 .It Va lpd_enable
 .Pq Vt bool
 If set to
 .Dq Li YES ,
 run the
 .Xr lpd 8
 daemon at system boot time.
 .It Va lpd_flags
 .Pq Vt str
 If
 .Va lpd_enable
 is set to
 .Dq Li YES ,
 these are the flags to pass to the
 .Xr lpd 8
 daemon.
 .It Va chkprintcap_enable
 .Pq Vt bool
 If set to
 .Dq Li YES ,
 run the
 .Xr chkprintcap 8
 command before starting the
 .Xr lpd 8
 daemon.
 .It Va chkprintcap_flags
 .Pq Vt str
 If
 .Va lpd_enable
 and
 .Va chkprintcap_enable
 are set to
 .Dq Li YES ,
 these are the flags to pass to the
 .Xr chkprintcap 8
 program.
 The default is
 .Dq Li -d ,
 which causes missing directories to be created.
 .It Va mta_start_script
 .Pq Vt str
 This variable specifies the full path to the script to run to start
 a mail transfer agent.
 The default is
 .Pa /etc/rc.sendmail .
 The
 .Va sendmail_*
 variables which
 .Pa /etc/rc.sendmail
 uses are documented in the
 .Xr rc.sendmail 8
 manual page.
 .It Va dumpdev
 .Pq Vt str
 Indicates the device (usually a swap partition) to which a crash dump
 should be written in the event of a system crash.
 If the value of this variable is
 .Dq Li AUTO ,
 the first suitable swap device listed in
 .Pa /etc/fstab
 will be used as dump device.
 Otherwise, the value of this variable is passed as the argument to
 .Xr dumpon 8 .
 To disable crash dumps, set this variable to
 .Dq Li NO .
 .It Va dumpdir
 .Pq Vt str
 When the system reboots after a crash and a crash dump is found on the
 device specified by the
 .Va dumpdev
 variable,
 .Xr savecore 8
 will save that crash dump and a copy of the kernel to the directory
 specified by the
 .Va dumpdir
 variable.
 The default value is
 .Pa /var/crash .
 Set to
 .Dq Li NO
 to not run
 .Xr savecore 8
 at boot time when
 .Va dumpdir
 is set.
 .It Va savecore_enable
 .Pq Vt bool
 If set to
 .Dq Li NO ,
 disable automatic extraction of the crash dump from the
 .Va dumpdev .
 .It Va savecore_flags
 .Pq Vt str
 If crash dumps are enabled, these are the flags to pass to the
 .Xr savecore 8
 utility.
 .It Va quota_enable
 .Pq Vt bool
 Set to
 .Dq Li YES
 to turn on user and group disk quotas on system startup via the
 .Xr quotaon 8
 command for all file systems marked as having quotas enabled in
 .Pa /etc/fstab .
 The kernel must be built with
 .Cd "options QUOTA"
 for disk quotas to function.
 .It Va check_quotas
 .Pq Vt bool
 Set to
 .Dq Li YES
 to enable user and group disk quota checking via the
 .Xr quotacheck 8
 command.
 .It Va quotacheck_flags
 .Pq Vt str
 If
 .Va quota_enable
 is set to
 .Dq Li YES ,
 and
 .Va check_quotas
 is set to
 .Dq Li YES ,
 these are the flags to pass to the
 .Xr quotacheck 8
 utility.
 The default is
 .Dq Li "-a" ,
 which checks quotas for all file systems with quotas enabled in
 .Pa /etc/fstab .
 .It Va quotaon_flags
 .Pq Vt str
 If
 .Va quota_enable
 is set to
 .Dq Li YES ,
 these are the flags to pass to the
 .Xr quotaon 8
 utility.
 The default is
 .Dq Li "-a" ,
 which enables quotas for all file systems with quotas enabled in
 .Pa /etc/fstab .
 .It Va quotaoff_flags
 .Pq Vt str
 If
 .Va quota_enable
 is set to
 .Dq Li YES ,
 these are the flags to pass to the
 .Xr quotaoff 8
 utility when shutting down the quota system.
 The default is
 .Dq Li "-a" ,
 which disables quotas for all file systems with quotas enabled in
 .Pa /etc/fstab .
 .It Va accounting_enable
 .Pq Vt bool
 Set to
 .Dq Li YES
 to enable system accounting through the
 .Xr accton 8
 facility.
 .It Va ibcs2_enable
 .Pq Vt bool
 Set to
 .Dq Li YES
 to enable iBCS2 (SCO) binary emulation at system initial boot
 time.
 .It Va ibcs2_loaders
 .Pq Vt str
 If not set to
 .Dq Li NO
 and if
 .Va ibcs2_enable
 is set to
 .Dq Li YES ,
 this specifies a list of additional iBCS2 loaders to enable.
 .It Va firstboot_sentinel
 .Pq Vt str
 This variable specifies the full path to a
 .Dq first boot
 sentinel file.
 If a file exists with this path,
 .Pa rc.d
 scripts with the
 .Dq firstboot
 keyword will be run on startup and the sentinel file will be deleted
 after the boot process completes.
 The sentinel file must be located on a writable file system which is
 mounted no later than
 .Va early_late_divider
 to function properly.
 The default is
 .Pa /firstboot .
 .It Va linux_enable
 .Pq Vt bool
 Set to
 .Dq Li YES
 to enable Linux/ELF binary emulation at system initial
 boot time.
 .It Va svr4_enable
 .Pq Vt bool
 If set to
 .Dq Li YES ,
 enable SysVR4 emulation at boot time.
 .It Va sysvipc_enable
 .Pq Vt bool
 If set to
 .Dq Li YES ,
 load System V IPC primitives at boot time.
 .It Va clear_tmp_enable
 .Pq Vt bool
 Set to
 .Dq Li YES
 to have
 .Pa /tmp
 cleaned at startup.
 .It Va clear_tmp_X
 .Pq Vt bool
 Set to
 .Dq Li NO
 to disable removing of X11 lock files,
 and the removal and (secure) recreation
 of the various socket directories for X11
 related programs.
 .It Va ldconfig_paths
 .Pq Vt str
 Set to the list of shared library paths to use with
 .Xr ldconfig 8 .
 NOTE:
 .Pa /usr/lib
 will always be added first, so it need not appear in this list.
 .It Va ldconfig32_paths
 .Pq Vt str
 Set to the list of 32-bit compatibility shared library paths to
 use with
 .Xr ldconfig 8 .
 .It Va ldconfig_paths_aout
 .Pq Vt str
 Set to the list of shared library paths to use with
 .Xr ldconfig 8
 legacy
 .Xr a.out 5
 support.
 .It Va ldconfig_insecure
 .Pq Vt bool
 The
 .Xr ldconfig 8
 utility normally refuses to use directories
 which are writable by anyone except root.
 Set this variable to
 .Dq Li YES
 to disable that security check during system startup.
 .It Va ldconfig_local_dirs
 .Pq Vt str
 Set to the list of local
 .Xr ldconfig 8
 directories.
 The names of all files in the directories listed will be
 passed as arguments to
 .Xr ldconfig 8 .
 .It Va ldconfig_local32_dirs
 .Pq Vt str
 Set to the list of local 32-bit compatibility
 .Xr ldconfig 8
 directories.
 The names of all files in the directories listed will be
 passed as arguments to
 .Dq Nm ldconfig Fl 32 .
 .It Va kern_securelevel_enable
 .Pq Vt bool
 Set to
 .Dq Li YES
 to set the kernel security level at system startup.
 .It Va kern_securelevel
 .Pq Vt int
 The kernel security level to set at startup.
 The allowed range of
 .Ar value
 ranges from \-1 (the compile time default) to 3 (the
 most secure).
 See
 .Xr security 7
 for the list of possible security levels and their effect
 on system operation.
 .It Va sshd_program
 .Pq Vt str
 Path to the SSH server program
 .Pa ( /usr/sbin/sshd
 is the default).
 .It Va sshd_enable
 .Pq Vt bool
 Set to
 .Dq Li YES
 to start
 .Xr sshd 8
 at system boot time.
 .It Va sshd_flags
 .Pq Vt str
 If
 .Va sshd_enable
 is set to
 .Dq Li YES ,
 these are the flags to pass to the
 .Xr sshd 8
 daemon.
 .It Va ftpd_program
 .Pq Vt str
 Path to the FTP server program
 .Pa ( /usr/libexec/ftpd
 is the default).
 .It Va ftpd_enable
 .Pq Vt bool
 Set to
 .Dq Li YES
 to start
 .Xr ftpd 8
 as a stand-alone daemon at system boot time.
 .It Va ftpd_flags
 .Pq Vt str
 If
 .Va ftpd_enable
 is set to
 .Dq Li YES ,
 these are the additional flags to pass to the
 .Xr ftpd 8
 daemon.
 .It Va watchdogd_enable
 .Pq Vt bool
 If set to
 .Dq Li YES ,
 start the
 .Xr watchdogd 8
 daemon at boot time.
 This requires that the kernel have been compiled with a
 .Xr watchdog 4
 compatible device.
 .It Va watchdogd_flags
 .Pq Vt str
 If
 .Va watchdogd_enable
 is set to
 .Dq Li YES ,
 these are the flags passed to the
 .Xr watchdogd 8
 daemon.
 .It Va devfs_rulesets
 .Pq Vt str
 List of files containing sets of rules for
 .Xr devfs 8 .
 .It Va devfs_system_ruleset
 .Pq Vt str
 Rule name(s) to apply to the system
 .Pa /dev
 itself.
 .It Va devfs_set_rulesets
 .Pq Vt str
 Pairs of already-mounted
 .Pa dev
 directories and rulesets that should be applied to them.
 For example: /mount/dev=ruleset_name
 .It Va devfs_load_rulesets
 .Pq Vt bool
 If set, always load the default rulesets listed in
 .Va devfs_rulesets .
 .It Va performance_cx_lowest
 .Pq Vt str
 CPU idle state to use while on AC power.
 The string
 .Dq Li LOW
 indicates that
 .Xr acpi 4
 should use the lowest power state available while
 .Dq Li HIGH
 indicates that the lowest latency state (less power savings) should be used.
 .It Va performance_cpu_freq
 .Pq Vt str
 CPU clock frequency to use while on AC power.
 The string
 .Dq Li LOW
 indicates that
 .Xr cpufreq 4
 should use the lowest frequency available while
 .Dq Li HIGH
 indicates that the highest frequency (less power savings) should be used.
 .It Va economy_cx_lowest
 .Pq Vt str
 CPU idle state to use when off AC power.
 The string
 .Dq Li LOW
 indicates that
 .Xr acpi 4
 should use the lowest power state available while
 .Dq Li HIGH
 indicates that the lowest latency state (less power savings) should be used.
 .It Va economy_cpu_freq
 .Pq Vt str
 CPU clock frequency to use when off AC power.
 The string
 .Dq Li LOW
 indicates that
 .Xr cpufreq 4
 should use the lowest frequency available while
 .Dq Li HIGH
 indicates that the highest frequency (less power savings) should be used.
 .It Va jail_enable
 .Pq Vt bool
 If set to
 .Dq Li NO ,
 any configured jails will not be started.
 .It Va jail_conf
 .Pq Vt str
 The configuration filename used by
 .Xr jail 8
 utility.
 The default value is
 .Pa /etc/jail.conf .
 .It Va jail_parallel_start
 .Pq Vt bool
 If set to
 .Dq Li YES ,
 all configured jails will be started in the background (in parallel).
 .It Va jail_flags
 .Pq Vt str
 Unset by default.
 When set, use as default value for
 .Va jail_ Ns Ao Ar jname Ac Ns Va _flags
 for every jail in
 .Va jail_list .
 .It Va jail_list
 .Pq Vt str
 A space-delimited list of jail names.
 When left empty, all of the
 .Xr jail 8
 instances defined in the configuration file are started.
 The names specified in this list control the jail startup order.
 .Xr jail 8
 instances missing from
 .Va jail_list
 must be started manually.
 Note that a jail's
 .Va depend
 parameter in the configuration file may override this list.
 .It Va jail_reverse_stop
 .Pq Vt bool
 When set to
 .Dq Li YES ,
 all configured jails in
 .Va jail_list
 are stopped in reverse order.
 .It Va jail_* variables
 Note that older releases supported per-jail configuration via
 .Xr rc.conf 5
 variables.
 For example,
 hostname of a jail named
 .Li vjail
 was able to be set by
 .Li jail_vjail_hostname .
 These per-jail configuration variables are now obsolete in favor of
 .Xr jail 8
 configuration file.
 For backward compatibility,
 when per-jail configuration variables are defined,
 .Xr jail 8
 configuration files are created as
 .Pa /var/run/jail. Ns Ao Ar jname Ac Ns Pa .conf
 and used.
 .Pp
 The following per-jail parameters are handled by
 .Pa rc.d/jail
 script out of their corresponding
 .Nm
 variables.
 In addition to them, parameters in
 .Va jail_ Ns Ao Ar jname Ac Ns Va _parameters
 will be added to the configuration file.
 They must be a semi-colon
 .Pq Ql \&;
 delimited list of
 .Dq key=value .
 For more details,
 see
 .Xr jail 8
 manual page.
 .Bl  -tag -width "host.hostname" -offset indent
 .It Li path
 set from
 .Va jail_ Ns Ao Ar jname Ac Ns Va _rootdir
 .It Li host.hostname
 set from
 .Va jail_ Ns Ao Ar jname Ac Ns Va _hostname
 .It Li exec.consolelog
 set from
 .Va jail_ Ns Ao Ar jname Ac Ns Va _consolelog .
 The default value is
 .Pa /var/log/jail_ Ao Ar jname Ac Pa _console.log .
 .It Li interface
 set from
 .Va jail_ Ns Ao Ar jname Ac Ns Va _interface .
 .It Li vnet.interface
 set from
 .Va jail_ Ns Ao Ar jname Ac Ns Va _vnet_interface .
 This implies
 .Li vnet
 parameter will be enabled and cannot be specified with
 .Va jail_ Ns Ao Ar jname Ac Ns Va _interface ,
 .Va jail_ Ns Ao Ar jname Ac Ns Va _ip
 and/or
 .Va jail_ Ns Ao Ar jname Ac Ns Va _ip_multi Ns Aq Ar n
 at the same time.
 .It Li fstab
 set from
 .Va jail_ Ns Ao Ar jname Ac Ns Va _fstab
 .It Li mount
 set from
 .Va jail_ Ns Ao Ar jname Ac Ns Va _procfs_enable .
 .It Li exec.fib
 set from
 .Va jail_ Ns Ao Ar jname Ac Ns Va _fib
 .It Li exec.start
 set from
 .Va jail_ Ns Ao Ar jname Ac Ns Va _exec_start .
 The parameter name was
 .Li command
 in some older releases.
 .It Li exec.prestart
 set from
 .Va jail_ Ns Ao Ar jname Ac Ns Va _exec_prestart
 .It Li exec.poststart
 set from
 .Va jail_ Ns Ao Ar jname Ac Ns Va _exec_poststart
 .It Li exec.stop
 set from
 .Va jail_ Ns Ao Ar jname Ac Ns Va _exec_stop
 .It Li exec.prestop
 set from
 .Va jail_ Ns Ao Ar jname Ac Ns Va _exec_prestop
 .It Li exec.poststop
 set from
 .Va jail_ Ns Ao Ar jname Ac Ns Va _exec_poststop
 .It Li ip4.addr
 set if
 .Va jail_ Ns Ao Ar jname Ac Ns Va _ip
 or
 .Va jail_ Ns Ao Ar jname Ac Ns Va _ip_multi Ns Aq Ar n
 contain IPv4 addresses
 .It Li ip6.addr
 set if
 .Va jail_ Ns Ao Ar jname Ac Ns Va _ip
 or
 .Va jail_ Ns Ao Ar jname Ac Ns Va _ip_multi Ns Aq Ar n
 contain IPv6 addresses
 .It Li allow.mount
 set from
 .Va jail_ Ns Ao Ar jname Ac Ns Va _mount_enable
 .It Li mount.devfs
 set from
 .Va jail_ Ns Ao Ar jname Ac Ns Va _devfs_enable
 .It Li devfs_ruleset
 set from
 .Va jail_ Ns Ao Ar jname Ac Ns Va _devfs_ruleset .
 This must be an integer,
 not a string.
 .It Li mount.fdescfs
 set from
 .Va jail_ Ns Ao Ar jname Ac Ns Va _fdescfs_enable
 .It Li allow.set_hostname
 set from
 .Va jail_ Ns Ao Ar jname Ac Ns Va _set_hostname_allow
 .It Li allow.rawsocket
 set from
 .Va jail_ Ns Ao Ar jname Ac Ns Va _socket_unixiproute_only
 .It Li allow.sysvipc
 set from
 .Va jail_ Ns Ao Ar jname Ac Ns Va _sysvipc_allow
 .El
 .\" -----------------------------------------------------
 .It Va harvest_mask
 .Pq Vt int
 Set to a bit-mask
 representing the entropy sources
 you wish to harvest.
 Refer to
 .Xr random 4
 for more information.
 .It Va entropy_dir
 .Pq Vt str
 Set to
 .Dq Li NO
 to disable caching entropy via
 .Xr cron 8 .
 Otherwise set to the directory
 in which the entropy files are stored.
 To be useful,
 there must be
 a system cron job
 that regularly writes and rotates
 files here.
 All files found
 will be used at boot time.
 The default is
 .Pa /var/db/entropy .
 .It Va entropy_file
 .Pq Vt str
 Set to
 .Dq Li NO
 to disable caching entropy through reboots.
 Otherwise set to the name
 of a file used to store cached entropy.
 This file should be located
 on a file system that is readable
 before all the volumes specified in
 .Xr fstab 5
 are mounted.
 By default,
 .Pa /entropy
 is used,
 but if
 .Pa /var/db/entropy-file
 is found it will also be used.
 This will be of some use to
 .Xr bsdinstall 8 .
 .It Va entropy_boot_file
 .Pq Vt str
 Set to
 .Dq Li NO
 to disable
 very early caching entropy
 through reboots.
 Otherwise set to the filename
 used to read
 very early reboot cached entropy.
 This file should be located where
 .Xr loader 8
 can read it.
 See also
 .Xr loader.conf 5 .
 The default location is
 .Pa /boot/entropy .
 .It Va entropy_save_sz
 .Pq Vt int
 Size of the entropy cache files saved by
 .Nm save-entropy
 periodically.
 .It Va entropy_save_num
 .Pq Vt int
 Number of entropy cache files to save by
 .Nm save-entropy
 periodically.
 .It Va ipsec_enable
 .Pq Vt bool
 Set to
 .Dq Li YES
 to run
 .Xr setkey 8
 on
 .Va ipsec_file
 at boot time.
 .It Va ipsec_file
 .Pq Vt str
 Configuration file for
 .Xr setkey 8 .
 .It Va dmesg_enable
 .Pq Vt bool
 Set to
 .Dq Li YES
 to save
 .Xr dmesg 8
 to
 .Pa /var/run/dmesg.boot
 on boot.
 .It Va rcshutdown_timeout
 .Pq Vt int
 If set, start a watchdog timer in the background which will terminate
 .Pa rc.shutdown
 if
 .Xr shutdown 8
 has not completed within the specified time (in seconds).
 Notice that in addition to this soft timeout,
 .Xr init 8
 also applies a hard timeout for the execution of
 .Pa rc.shutdown .
 This is configured via
 .Xr sysctl 8
 variable
 .Va kern.init_shutdown_timeout
 and defaults to 120 seconds.
 Setting the value of
 .Va rcshutdown_timeout
 to more than 120 seconds will have no effect until the
 .Xr sysctl 8
 variable
 .Va kern.init_shutdown_timeout
 is also increased.
 .It Va virecover_enable
 .Pq Vt bool
 Set to
 .Dq Li NO
 to prevent the system from trying to
 recover pre-maturely terminated
 .Xr vi 1
 sessions.
 .It Va ugidfw_enable
 .Pq Vt bool
 Set to
 .Dq Li YES
 to load the
 .Xr mac_bsdextended 4
 module upon system initialization and load a default
 ruleset file.
 .It Va bsdextended_script
 .Pq Vt str
 The default
 .Xr mac_bsdextended 4
 ruleset file to load.
 The default value of this variable is
 .Pa /etc/rc.bsdextended .
 .It Va newsyslog_enable
 .Pq Vt bool
 If set to
 .Dq Li YES ,
 run
 .Xr newsyslog 8
 command at startup.
 .It Va newsyslog_flags
 .Pq Vt str
 If
 .Va newsyslog_enable
 is set to
 .Dq Li YES ,
 these are the flags to pass to the
 .Xr newsyslog 8
 program.
 The default is
 .Dq Li -CN ,
 which causes log files flagged with a
 .Cm C
 to be created.
 .It Va mdconfig_md Ns Aq Ar X
 .Pq Vt str
 Arguments to
 .Xr mdconfig 8
 for
 .Xr md 4
 device
 .Ar X .
 At minimum a
 .Fl t Ar type
 must be specified and either a
 .Fl s Ar size
 for malloc or swap backed
 .Xr md 4
 devices or a
 .Fl f Ar file
 for vnode backed
 .Xr md 4
 devices.
 Note that
 .Va mdconfig_md Ns Aq Ar X
 variables are evaluated until one variable is unset or null.
 .It Va mdconfig_md Ns Ao Ar X Ac Ns Va _newfs
 .Pq Vt str
 Optional arguments passed to
 .Xr newfs 8
 to initialize
 .Xr md 4
 device
 .Ar X .
 .It Va mdconfig_md Ns Ao Ar X Ac Ns Va _owner
 .Pq Vt str
 An ownership specification passed to
 .Xr chown 8
 after the specified
 .Xr md 4
 device
 .Ar X
 has been mounted.
 Both the
 .Xr md 4
 device and the mount point will be changed.
 .It Va mdconfig_md Ns Ao Ar X Ac Ns Va _perms
 .Pq Vt str
 A mode string passed to
 .Xr chmod 1
 after the specified
 .Xr md 4
 device
 .Ar X
 has been mounted.
 Both the
 .Xr md 4
 device and the mount point will be changed.
 .It Va mdconfig_md Ns Ao Ar X Ac Ns Va _files
 .Pq Vt str
 Files to be copied to the mount point of the
 .Xr md 4
 device
 .Ar X
 after it has been mounted.
 .It Va mdconfig_md Ns Ao Ar X Ac Ns Va _cmd
 .Pq Vt str
 Command to execute after the specified
 .Xr md 4
 device
 .Ar X
 has been mounted.
 Note that the command is passed to
 .Ic eval
 and that both
 .Va _dev
 and
 .Va _mp
 variables can be used to reference respectively the
 .Xr md 4
 device and the mount point.
 Assuming that the
 .Xr md 4
 device is
 .Li md0 ,
 one could set the following:
 .Bd -literal
 mdconfig_md0_cmd="tar xfzC /var/file.tgz \e${_mp}"
 .Ed
 .It Va autobridge_interfaces
 .Pq Vt str
 Set to the list of bridge interfaces that will have newly arriving interfaces
 checked against to be automatically added.
 If not set to
 .Dq Li NO
 then for each whitespace separated
 .Ar element
 in the value, a
 .Va autobridge_ Ns Aq Ar element
 variable is assumed to exist which has a whitespace separated list of interface
 names to match, these names can use wildcards.
 For example:
 .Bd -literal
 autobridge_interfaces="bridge0"
 autobridge_bridge0="tap* dc0 vlan[345]"
 .Ed
 .It Va mixer_enable
 .Pq Vt bool
 If set to
 .Dq Li YES ,
 enable support for sound mixer.
 .It Va hcsecd_enable
 .Pq Vt bool
 If set to
 .Dq Li YES ,
 enable Bluetooth security daemon.
 .It Va hcsecd_config
 .Pq Vt str
 Configuration file for
 .Xr hcsecd 8 .
 Default
 .Pa /etc/bluetooth/hcsecd.conf .
 .It Va sdpd_enable
 .Pq Vt bool
 If set to
 .Dq Li YES ,
 enable Bluetooth Service Discovery Protocol daemon.
 .It Va sdpd_control
 .Pq Vt str
 Path to
 .Xr sdpd 8
 control socket.
 Default
 .Pa /var/run/sdp .
 .It Va sdpd_groupname
 .Pq Vt str
 Sets
 .Xr sdpd 8
 group to run as after it initializes.
 Default
 .Dq Li nobody .
 .It Va sdpd_username
 .Pq Vt str
 Sets
 .Xr sdpd 8
 user to run as after it initializes.
 Default
 .Dq Li nobody .
 .It Va bthidd_enable
 .Pq Vt bool
 If set to
 .Dq Li YES ,
 enable Bluetooth Human Interface Device daemon.
 .It Va bthidd_config
 .Pq Vt str
 Configuration file for
 .Xr bthidd 8 .
 Default
 .Pa /etc/bluetooth/bthidd.conf .
 .It Va bthidd_hids
 .Pq Vt str
 Path to a file, where
 .Xr bthidd 8
 will store information about known HID devices.
 Default
 .Pa /var/db/bthidd.hids .
 .It Va rfcomm_pppd_server_enable
 .Pq Vt bool
 If set to
 .Dq Li YES ,
 enable Bluetooth RFCOMM PPP wrapper daemon.
 .It Va rfcomm_pppd_server_profile
 .Pq Vt str
 The name of the profile to use from
 .Pa /etc/ppp/ppp.conf .
 Multiple profiles can be specified here.
 Also used to specify per-profile overrides.
 When the profile name contains any of the characters
 .Dq Li .-/+
 they are translated to
 .Dq Li _
 for the proposes of the override variable names.
 .It Va rfcomm_pppd_server_ Ns Ao Ar profile Ac Ns _bdaddr
 .Pq Vt str
 Overrides local address to listen on.
 By default
 .Xr rfcomm_pppd 8
 will listen on
 .Dq Li ANY
 address.
 The address can be specified as BD_ADDR or name.
 .It Va rfcomm_pppd_server_ Ns Ao Ar profile Ac Ns _channel
 .Pq Vt str
 Overrides local RFCOMM channel to listen on.
 By default
 .Xr rfcomm_pppd 8
 will listen on RFCOMM channel 1.
 Must set properly if multiple profiles used in the same time.
 .It Va rfcomm_pppd_server_ Ns Ao Ar profile Ac Ns _register_sp
 .Pq Vt bool
 Tells
 .Xr rfcomm_pppd 8
 if it should register Serial Port service on the specified RFCOMM channel.
 Default
 .Dq Li NO .
 .It Va rfcomm_pppd_server_ Ns Ao Ar profile Ac Ns _register_dun
 .Pq Vt bool
 Tells
 .Xr rfcomm_pppd 8
 if it should register Dial-Up Networking service on the specified
 RFCOMM channel.
 Default
 .Dq Li NO .
 .It Va ubthidhci_enable
 .Pq Vt bool
 If set to
 .Dq Li YES ,
 change the USB Bluetooth controller from HID mode to HCI mode.
 You also need to specify the location of USB Bluetooth controller with the
 .Va ubthidhci_busnum
 and
 .Va ubthidhci_addr
 variables.
 .It Va ubthidhci_busnum
 Bus number where the USB Bluetooth controller is located.
 Check the output of
 .Xr usbconfig 8
 on your system to find this information.
 .It Va ubthidhci_addr
 Bus address of the USB Bluetooth controller.
 Check the output of
 .Xr usbconfig 8
 on your system to find this information.
 .It Va netwait_enable
 .Pq Vt bool
 If set to
 .Dq Li YES ,
 delays the start of network-reliant services until
 .Va netwait_if
 is up and ICMP packets to a destination defined in
 .Va netwait_ip
 are flowing.
 Link state is examined first, followed by
 .Dq Li pinging
 an IP address to verify network usability.
 If no destination can be reached or timeouts are exceeded,
 network services are started anyway with no guarantee that
 the network is usable.
 Use of this variable requires both
 .Va netwait_ip
 and
 .Va netwait_if
 to be set.
 .It Va netwait_ip
 .Pq Vt str
 Empty by default.
 This variable contains a space-delimited list of IP addresses to
 .Xr ping 8 .
 DNS hostnames should not be used as resolution is not guaranteed
 to be functional at this point.
 If multiple IP addresses are specified,
 each will be tried until one is successful or the list is exhausted.
 .It Va netwait_timeout
 .Pq Vt int
 Indicates the total number of seconds to perform a
 .Dq Li ping
 against each IP address in
 .Va netwait_ip ,
 at a rate of one ping per second.
 If any of the pings are successful,
 full network connectivity is considered reliable.
 The default is 60.
 .It Va netwait_if
 .Pq Vt str
 Empty by default.
 Defines the name of the network interface on which watch for link.
 .Xr ifconfig 8
 is used to monitor the interface, looking for
 .Dq Li status: no carrier .
 Once gone, the link is considered up.
 This can be a
 .Xr vlan 4
 interface if desired.
 .It Va netwait_if_timeout
 .Pq Vt int
 Defines the total number of seconds to wait for link to become usable,
 polled at a 1-second interval.
 The default is 30.
 .It Va rctl_enable
 .Pq Vt bool
 If set to
 .Dq Li YES ,
 load
 .Xr rctl 8
 rules from the defined ruleset.
 The kernel must be built with
 .Cd "options RACCT"
 and
 .Cd "options RCTL" .
 .It Va rctl_rules
 .Pq Vt str
 Set to
 .Pa /etc/rctl.conf
 by default.
 This variables contains the
 .Xr rctl.conf 5
 ruleset to load for
 .Xr rctl 8 .
 .It Va iovctl_files
 .Pq Vt str
 A space-separated list of configuration files used by
 .Xr iovctl 8 .
 The default value is an empty string.
 .It Va autofs_enable
 .Pq Vt bool
 If set to
 .Dq Li YES ,
 start the
 .Xr automount 8
 utility and the
 .Xr automountd 8
 and
 .Xr autounmountd 8
 daemons at boot time.
 .It Va automount_flags
 .Pq Vt str
 If
 .Va autofs_enable
 is set to
 .Dq Li YES ,
 these are the flags to pass to the
 .Xr automount 8
 program.
 By default no flags are passed.
 .It Va automountd_flags
 .Pq Vt str
 If
 .Va autofs_enable
 is set to
 .Dq Li YES ,
 these are the flags to pass to the
 .Xr automountd 8
 daemon.
 By default no flags are passed.
 .It Va autounmountd_flags
 .Pq Vt str
 If
 .Va autofs_enable
 is set to
 .Dq Li YES ,
 these are the flags to pass to the
 .Xr autounmountd 8
 daemon.
 By default no flags are passed.
 .It Va ctld_enable
 .Pq Vt bool
 If set to
 .Dq Li YES ,
 start the
 .Xr ctld 8
 daemon at boot time.
 .It Va iscsid_enable
 .Pq Vt bool
 If set to
 .Dq Li YES ,
 start the
 .Xr iscsid 8
 daemon at boot time.
 .It Va iscsictl_enable
 .Pq Vt bool
 If set to
 .Dq Li YES ,
 start the
 .Xr iscsictl 8
 utility at boot time.
 .It Va iscsictl_flags
 .Pq Vt str
 If
 .Va iscsictl_enable
 is set to
 .Dq Li YES ,
 these are the flags to pass to the
 .Xr iscsictl 8
 program.
 The default is
 .Dq Li -Aa ,
 which configures sessions based on the
 .Pa /etc/iscsi.conf
 configuration file.
 .El
 .Sh FILES
 .Bl -tag -width ".Pa /etc/defaults/rc.conf" -compact
 .It Pa /etc/defaults/rc.conf
 .It Pa /etc/rc.conf
 .It Pa /etc/rc.conf.local
 .El
 .Sh SEE ALSO
 .Xr catman 1 ,
 .Xr chmod 1 ,
 .Xr gdb 1 ,
 .Xr info 1 ,
 .Xr kbdcontrol 1 ,
 .Xr makewhatis 1 ,
 .Xr sh 1 ,
 .Xr vi 1 ,
 .Xr vidcontrol 1 ,
 .Xr bridge 4 ,
 .Xr dummynet 4 ,
 .Xr ip 4 ,
 .Xr ipf 4 ,
 .Xr ipfw 4 ,
 .Xr ipnat 4 ,
 .Xr kld 4 ,
 .Xr pf 4 ,
 .Xr pflog 4 ,
 .Xr pfsync 4 ,
 .Xr tcp 4 ,
 .Xr udp 4 ,
 .Xr exports 5 ,
 .Xr fstab 5 ,
 .Xr ipf 5 ,
 .Xr ipnat 5 ,
 .Xr jail.conf 5 ,
 .Xr loader.conf 5 ,
 .Xr motd 5 ,
 .Xr newsyslog.conf 5 ,
 .Xr pf.conf 5 ,
 .Xr security 7 ,
 .Xr accton 8 ,
 .Xr amd 8 ,
 .Xr apm 8 ,
 .Xr atm 8 ,
 .Xr bsdinstall 8 ,
 .Xr bthidd 8 ,
 .Xr chkprintcap 8 ,
 .Xr chown 8 ,
 .Xr cron 8 ,
 .Xr devfs 8 ,
 .Xr dhclient 8 ,
 .Xr ftpd 8 ,
 .Xr geli 8 ,
 .Xr hcsecd 8 ,
 .Xr ifconfig 8 ,
 .Xr inetd 8 ,
 .Xr iovctl 8 ,
 .Xr ipf 8 ,
 .Xr ipfw 8 ,
 .Xr ipnat 8 ,
 .Xr jail 8 ,
 .Xr kldxref 8 ,
 .Xr loader 8 ,
 .Xr lpd 8 ,
 .Xr mdconfig 8 ,
 .Xr mdmfs 8 ,
 .Xr mixer 8 ,
 .Xr mountd 8 ,
 .Xr moused 8 ,
 .Xr newfs 8 ,
 .Xr newsyslog 8 ,
 .Xr nfsd 8 ,
 .Xr ntpd 8 ,
 .Xr ntpdate 8 ,
 .Xr pfctl 8 ,
 .Xr pflogd 8 ,
 .Xr ping 8 ,
 .Xr powerd 8 ,
 .Xr quotacheck 8 ,
 .Xr quotaon 8 ,
 .Xr rc 8 ,
 .Xr rc.sendmail 8 ,
 .Xr rfcomm_pppd 8 ,
 .Xr route 8 ,
 .Xr routed 8 ,
 .Xr rpc.lockd 8 ,
 .Xr rpc.statd 8 ,
 .Xr rpcbind 8 ,
 .Xr rwhod 8 ,
 .Xr savecore 8 ,
 .Xr sdpd 8 ,
 .Xr sshd 8 ,
 .Xr swapon 8 ,
 .Xr sysctl 8 ,
 .Xr syslogd 8 ,
 .Xr timed 8 ,
 .Xr unbound 8 ,
 .Xr usbconfig 8 ,
 .Xr wlandebug 8 ,
 .Xr yp 8 ,
 .Xr ypbind 8 ,
 .Xr ypserv 8 ,
 .Xr ypset 8
 .Sh HISTORY
 The
 .Nm
 file appeared in
 .Fx 2.2.2 .
 .Sh AUTHORS
 .An Jordan K. Hubbard .
Index: head/share/man/man8/nanobsd.8
===================================================================
--- head/share/man/man8/nanobsd.8	(revision 301590)
+++ head/share/man/man8/nanobsd.8	(revision 301591)
@@ -1,354 +1,355 @@
 .\" Copyright (c) 2006 Daniel Gerzo <danger@FreeBSD.org>
 .\" All rights reserved.
 .\"
 .\" Redistribution and use in source and binary forms, with or without
 .\" modification, are permitted provided that the following conditions
 .\" are met:
 .\" 1. Redistributions of source code must retain the above copyright
 .\"    notice, this list of conditions and the following disclaimer.
 .\" 2. Redistributions in binary form must reproduce the above copyright
 .\"    notice, this list of conditions and the following disclaimer in the
 .\"    documentation and/or other materials provided with the distribution.
 .\"
 .\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS AND CONTRIBUTORS ``AS IS'' AND
 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
 .\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHORS OR CONTRIBUTORS BE LIABLE
 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
 .\" $FreeBSD$
 .\"
 .Dd May 19, 2016
 .Dt NANOBSD 8
 .Os
 .Sh NAME
 .Nm nanobsd.sh
 .Nd utility used to create a FreeBSD system image suitable for embedded
 applications
 .Sh SYNOPSIS
 .Nm
 .Op Fl bfhiKknqvwX
 .Op Fl c Ar config-file
 .Sh DESCRIPTION
 The
 .Nm
 utility is a script which produces a minimal implementation of
 .Fx
 (called
 .Nm NanoBSD ) ,
 which typically fits on a small media such as a Compact Flash card,
 or other mass storage medium.
 It can be used to build specialized install images, designed for easy
 installation and maintenance.
 .Pp
 The following options are available:
 .Bl -tag -width ".Fl c Ar config-file" -offset indent
 .It Fl b
 Skip the build stages (both for kernel and world).
 .It Fl c Ar config-file
 Specify the configuration file to use.
 .It Fl f
 Skip the code slice extraction.
 .It Fl h
 Display usage information.
 .It Fl i
 Skip the disk image build stage.
 .It Fl K
 Skip the
 .Cm installkernel
 stage of the build.
 .It Fl k
 Skip the
 .Cm buildkernel
 stage of the build.
 .It Fl n
 Do not cleanup before each build stage.
 This suppresses the normal cleanup work done before the
 .Cm buildworld
 stage and adds -DNO_CLEAN to the make command line
 used for each build stage (world and kernel).
 .It Fl q
 Make output more quiet.
 .It Fl v
 Make output more verbose.
 .It Fl w
 Skip the
 .Cm buildworld
 stage of the build.
 .It Fl X
 Make
 .Cm native-xtools.
 .El
 .Pp
 The features of
 .Nm NanoBSD
 include:
 .Pp
 .Bl -bullet -offset indent -compact
 .It
 Ports and packages work as in
 .Fx .
 Every single application can be installed and used in a
 .Nm NanoBSD
 image, the same way as in
 .Fx .
 .It
 No missing functionality.
 If it is possible to do something with
 .Fx ,
 it is possible to do the same thing with
 .Nm NanoBSD ,
 unless the specific feature or features were explicitly removed from the
 .Nm NanoBSD
 image when it was created.
 .It
 Everything is read-only at run-time.
 It is safe to pull the power-plug.
 There is no necessity to run
 .Xr fsck 8
 after a non-graceful shutdown of the system.
 .It
 Easy to build and customize.
 Making use of just one shell script and one configuration file it is
 possible to build reduced and customized images satisfying any arbitrary
 set of requirements.
 .El
 .Ss NanoBSD Media Layout
 The mass storage medium is divided into three parts by default (which
 are normally mounted read-only):
 .Pp
 .Bl -bullet -offset indent -compact
 .It
 Two image partitions:
 .Li code#1
 and
 .Li code#2 .
 .It
 The configuration file partition, which can be mounted under the
 .Pa /cfg
 directory at run time.
 .El
 .Pp
 The
 .Pa /etc
 and
 .Pa /var
 directories are
 .Xr md 4
 (malloc backed) disks.
 .Pp
 The configuration file partition persists under the
 .Pa /cfg
 directory.
 It contains files for
 .Pa /etc
 directory and is briefly mounted read-only right after the system boot,
 therefore it is required to copy modified files from
 .Pa /etc
 back to the
 .Pa /cfg
 directory if changes are expected to persist after the system restarts.
 .Sh BUILDING Nm NanoBSD
 A
 .Nm NanoBSD
 image is built using a simple
 .Nm
 shell script, which can be
 found in the
 .Pa src/tools/tools/nanobsd
 directory.
 This script creates a bootable image, which can be copied on the storage
 medium using the
 .Xr dd 1
 utility.
 .Pp
 The necessary commands to build and install a
 .Nm NanoBSD
 image are:
 .Bd -literal -offset indent
 cd /usr/src/tools/tools/nanobsd
 sh nanobsd.sh
 cd /usr/obj/nanobsd.full
 dd if=_.disk.full of=/dev/da0 bs=64k
 .Ed
 .Sh CUSTOMIZING Nm NanoBSD
 This is probably the most important and most interesting feature of
 .Nm NanoBSD .
 This is also where you will be spending most of the time when developing with
 .Nm NanoBSD .
 .Pp
 Customization is done in two ways:
 .Pp
 .Bl -bullet -offset indent -compact
 .It
 Configuration options.
 .It
 Custom functions.
 .El
 .Pp
 With configuration settings, it is possible to configure options passed
 to both the
 .Cm buildworld
 and
 .Cm installworld
 stages of the
 .Nm NanoBSD
 build process, as well as internal options passed to the main build
 process of
 .Nm NanoBSD .
 Through these options it is possible to cut the system down, so it will
 fit on as little as 64MB.
 You can use the configuration options to trim down the system
 even more, until it will consist of just the kernel and two or three
 files in the userland.
 .Pp
 The configuration file consists of configuration options, which override
 the default values.
 The most important directives are:
 .Bl -tag -width ".Va CONF_INSTALL" -offset indent
 .It Va NANO_NAME
 Build name (used to construct the working directory names).
 .It Va NANO_SRC
 Path to the source tree used to build the image.
 .It Va NANO_KERNEL
 Name of the kernel configuration file used to build the kernel.
 .It Va NANO_ARCH
-Machine processor architecture to build. Defaults to output of
+Machine processor architecture to build.
+Defaults to output of
 .Cm uname -p .
 .It Va NANO_BOOT0CFG
 Controls the options passed to
 .Xr boot0cfg 8 ;
 these dictate
 .Nm boot0 Ns 's
 behaviour.
 .It Va NANO_BOOTLOADER
 The
 .Nm boot0
 loader to use relative to the
 .Va NANO_WORLDDIR
 variable.
 This defaults to
 .Pa boot/boot0sio
 and should be overridden to
 .Pa boot/boot0
 to provide a VGA
 console.
 .It Va CONF_BUILD
 Options passed to the
 .Cm buildworld
 stage of the build.
 .It Va CONF_INSTALL
 Options passed to the
 .Cm installworld
 stage of the build.
 .It Va CONF_WORLD
 Options passed to both the
 .Cm buildworld
 and
 .Cm installworld
 stages of the build.
 .It Va FlashDevice
 Defines the type of media to use.
 Check the
 .Pa FlashDevice.sub
 file for more details.
 .El
 .Pp
 For more configuration options, please check the
 .Nm
 script.
 .Pp
 To build
 .Nm NanoBSD
 image using the
 .Pa nanobsd.conf
 configuration file, use the following command:
 .Bd -literal -offset indent
 sh nanobsd.sh -c nanobsd.conf
 .Ed
 .Pp
 It is possible to fine-tune
 .Nm NanoBSD
 using shell functions in the configuration file.
 The following example illustrates the basic model of custom functions:
 .Bd -literal -offset indent
 cust_foo () (
 	echo "bar=topless" > \\
 	     ${NANO_WORLDDIR}/etc/foo
 )
 customize_cmd cust_foo
 .Ed
 .Pp
 There are a few pre-defined customization functions ready for use:
 .Bl -tag -width ".Cm cust_allow_ssh_root" -offset indent
 .It Cm cust_comconsole
 Disables
 .Xr getty 8
 on the virtual
 .Xr syscons 4
 or
 .Xr vt 4
 terminals
 .Pq Pa /dev/ttyv*
 and enables the use of the first serial port as the system
 console.
 .It Cm cust_allow_ssh_root
 Allow root to log in via
 .Xr sshd 8 .
 .It Cm cust_install_files
 Installs files from the
 .Pa nanobsd/Files
 directory, which contains some useful scripts for system administration.
 .El
 .Sh FILES
 .Bl -tag -width ".Pa src/tools/tools/nanobsd" -compact
 .It Pa src/tools/tools/nanobsd
 Base directory of the
 .Nm NanoBSD
 build script.
 .El
 .Sh EXAMPLES
 Making persistent changes to
 .Pa /etc/resolv.conf :
 .Bd -literal -offset indent
 vi /etc/resolv.conf
 \&...
 mount /cfg
 cp /etc/resolv.conf /cfg
 umount /cfg
 .Ed
 .Pp
 A more useful example of a customization function is the following,
 which changes the default size of the
 .Pa /etc
 directory from 5MB to 30MB:
 .Bd -literal -offset indent
 cust_etc_size () (
 	cd ${NANO_WORLDDIR}/conf
 	echo 30000 > default/etc/md_size
 )
 customize_cmd cust_etc_size
 .Ed
 .Sh SEE ALSO
 .Xr make.conf 5 ,
 .Xr boot 8 ,
 .Xr boot0cfg 8 ,
 .Xr picobsd 8
 .Sh HISTORY
 The
 .Nm
 utility first appeared in
 .Fx 6.0 .
 .Sh AUTHORS
 .An -nosplit
 .Nm NanoBSD
 was developed by
 .An Poul-Henning Kamp Aq Mt phk@FreeBSD.org .
 This manual page was written by
 .An Daniel Gerzo Aq Mt danger@FreeBSD.org .