summaryrefslogtreecommitdiffstats
path: root/share/man/man5
diff options
context:
space:
mode:
Diffstat (limited to 'share/man/man5')
-rw-r--r--share/man/man5/devfs.514
-rw-r--r--share/man/man5/devfs.conf.52
-rw-r--r--share/man/man5/devfs.rules.52
-rw-r--r--share/man/man5/linprocfs.51
-rw-r--r--share/man/man5/mailer.conf.529
-rw-r--r--share/man/man5/make.conf.53
-rw-r--r--share/man/man5/portsnap.conf.514
-rw-r--r--share/man/man5/rc.conf.578
8 files changed, 76 insertions, 67 deletions
diff --git a/share/man/man5/devfs.5 b/share/man/man5/devfs.5
index b8be967..d932425 100644
--- a/share/man/man5/devfs.5
+++ b/share/man/man5/devfs.5
@@ -69,13 +69,6 @@ The
.Xr mknod 8
tool can be used to recover deleted device entries under
.Nm .
-.Sh EXAMPLES
-To mount a
-.Nm
-volume located on
-.Pa /dev :
-.Pp
-.Dl "mount -t devfs devfs /dev"
.Sh FILES
.Bl -tag -width /dev/XXXX -compact
.It Pa /dev
@@ -83,6 +76,13 @@ The normal
.Nm
mount point.
.El
+.Sh EXAMPLES
+To mount a
+.Nm
+volume located on
+.Pa /dev :
+.Pp
+.Dl "mount -t devfs devfs /dev"
.Sh SEE ALSO
.Xr devfs 8 ,
.Xr mount 8
diff --git a/share/man/man5/devfs.conf.5 b/share/man/man5/devfs.conf.5
index 83d1a66..9d83726 100644
--- a/share/man/man5/devfs.conf.5
+++ b/share/man/man5/devfs.conf.5
@@ -131,9 +131,9 @@ perm cd0 0660
.Ed
.Sh SEE ALSO
.Xr chmod 1 ,
+.Xr devd.conf 5 ,
.Xr devfs 5 ,
.Xr devfs.rules 5 ,
-.Xr devd.conf 5 ,
.Xr chown 8
.Sh AUTHORS
This manual page was written by
diff --git a/share/man/man5/devfs.rules.5 b/share/man/man5/devfs.rules.5
index 04fb6b4..3722cea 100644
--- a/share/man/man5/devfs.rules.5
+++ b/share/man/man5/devfs.rules.5
@@ -24,7 +24,7 @@
.\"
.\" $FreeBSD$
.\"
-.Dd Jan 30, 2006
+.Dd January 30, 2006
.Dt DEVFS.RULES 5
.Os
.Sh NAME
diff --git a/share/man/man5/linprocfs.5 b/share/man/man5/linprocfs.5
index 0eecc17..a85afe9 100644
--- a/share/man/man5/linprocfs.5
+++ b/share/man/man5/linprocfs.5
@@ -12,7 +12,6 @@
.Bd -literal
linproc /compat/linux/proc linprocfs rw 0 0
.Ed
-.Pp
.Sh DESCRIPTION
The Linux process file system, or
.Nm ,
diff --git a/share/man/man5/mailer.conf.5 b/share/man/man5/mailer.conf.5
index 213db6d..f17c44b 100644
--- a/share/man/man5/mailer.conf.5
+++ b/share/man/man5/mailer.conf.5
@@ -43,12 +43,12 @@ The file
.Pa /etc/mail/mailer.conf
contains a series of lines of the form
.Pp
-.Pa name
-.Pa program
+.Ar name
+.Ar program
.Op Ar arguments ...
.Pp
The first word of each line is the
-.Pa name
+.Ar name
of a program invoking
.Xr mailwrapper 8 .
(For example, on a typical system
@@ -60,29 +60,28 @@ as would
and
.Xr mailq 1 .
Thus,
-.Pa name
+.Ar name
might be
-.Dq sendmail
+.Dq Li sendmail
or
-.Dq newaliases
+.Dq Li newaliases
etc.)
.Pp
The second word of each line is the name of the
-.Pa program
+.Ar program
to actually execute when the first name is invoked.
.Pp
The further
.Ar arguments ,
if any, are passed to the
-.Pa program ,
+.Ar program ,
followed by the arguments
.Xr mailwrapper 8
was called with.
.Pp
The file may also contain comment lines, denoted by a
-.Sq #
+.Ql #
mark in the first column of any line.
-first column of any line.
.Sh FILES
/etc/mail/mailer.conf
.Sh EXAMPLES
@@ -111,9 +110,10 @@ mailq /usr/local/sbin/sendmail
newaliases /usr/local/sbin/sendmail
.Ed
.Pp
-This example shows the use of the mini_sendmail package from ports
-in place of
-.Xr sendmail 8 :
+This example shows the use of the
+.Nm mini_sendmail
+package from ports in place of
+.Xr sendmail 8 .
Note the use of additional arguments.
.Bd -literal -offset indent
# Send outgoing mail to a smart relay using mini_sendmail
@@ -127,8 +127,7 @@ send-mail /usr/local/bin/mini_sendmail -srelayhost
.Xr mailwrapper 8 ,
.Xr sendmail 8
.Pp
-.Xr postfix 1
-.Pq Pa ports/mail/postfix ,
+.Xr postfix 1 Pq Pa ports/mail/postfix ,
.Xr mini_sendmail 8 Pq Pa ports/mail/mini_sendmail
.Sh HISTORY
.Nm
diff --git a/share/man/man5/make.conf.5 b/share/man/man5/make.conf.5
index 5d3d300..0129555 100644
--- a/share/man/man5/make.conf.5
+++ b/share/man/man5/make.conf.5
@@ -320,7 +320,6 @@ to update your ports with
.Dq Li "make update" .
.El
.Ss "BUILDING THE KERNEL"
-.Pp
The following list provides a name and short description for variables
that are only used doing a kernel build:
.Bl -tag -width Ar
@@ -392,7 +391,6 @@ This is applied
.Va MODULES_OVERRIDE .
.El
.Ss "BUILDING THE WORLD"
-.Pp
The following list provides a name and short description for variables
that are used during the world build:
.Bl -tag -width Ar
@@ -628,7 +626,6 @@ times.
The value assigned is the highest optimization value used.
.El
.Ss "BUILDING DOCUMENTATION"
-.Pp
The following list provides a name and short description for variables
that are used when building documentation.
.Bl -tag -width ".Va PRINTERDEVICE"
diff --git a/share/man/man5/portsnap.conf.5 b/share/man/man5/portsnap.conf.5
index ba632166..9204e83 100644
--- a/share/man/man5/portsnap.conf.5
+++ b/share/man/man5/portsnap.conf.5
@@ -30,7 +30,7 @@
.Os FreeBSD
.Sh NAME
.Nm portsnap.conf
-.Nd configuration file for
+.Nd configuration file for
.Xr portsnap 8
.Sh DESCRIPTION
The
@@ -46,7 +46,7 @@ A line of the form
specifies the source from which snapshots should be fetched.
This is equivalent to the
.Fl s Ar server
-option to
+option to
.Xr portsnap 8 , and will be ignored if the command-line
option is used.
.Pp
@@ -57,7 +57,7 @@ specifies the SHA-256 hash of the OpenSSL public key file
belonging to an RSA keypair which is trusted to sign updates.
This is equivalent to the
.Fl k Ar KEY
-option to
+option to
.Xr portsnap 8 , and will be ignored if the command-line
option is used.
.Pp
@@ -94,7 +94,7 @@ Finally, a line of the form
will instruct
.Xr portsnap 8
to ignore parts of the ports tree with paths starting with
-.Ar foo
+.Ar foo
or
.Ar bar ,
which are interpreted as extended regular expressions by
@@ -128,9 +128,9 @@ Any lines not of the above forms will be ignored.
Default location of the portsnap configuration file.
.El
.Sh SEE ALSO
-.Xr egrep 1
-.Xr fetch 1
-.Xr portsnap 8
+.Xr egrep 1 ,
+.Xr fetch 1 ,
+.Xr portsnap 8 ,
.Xr sha256 8
.Sh AUTHORS
.An Colin Percival Aq cperciva@FreeBSD.org
diff --git a/share/man/man5/rc.conf.5 b/share/man/man5/rc.conf.5
index 25b4a28..7e38ff5 100644
--- a/share/man/man5/rc.conf.5
+++ b/share/man/man5/rc.conf.5
@@ -69,7 +69,7 @@ See the
variable below.
.Pp
Options are set with
-.Dq Li name=value
+.Dq Ar name Ns Li = Ns Ar value
assignments that use
.Xr sh 1
syntax.
@@ -110,8 +110,10 @@ listed in the
.Va local_startup
variable (see below).
Thus, the two likely candidates for this value are
-mountcritlocal for the typical system,
-and mountcritremote if the system needs remote file
+.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
@@ -121,7 +123,8 @@ For
.Pa rc.conf
within a
.Xr jail 8
-NETWORKING is likely to be an appropriate value.
+.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
@@ -356,9 +359,9 @@ For the
DHCP client, see the
.Xr dhclient 8
manpage for a description of the command line options available.
-.It Va dhclient_flags_ Ns Va iface
+.It Va dhclient_flags_ Ns Aq Ar iface
Additional flags to pass to the DHCP client program running on
-.Va iface
+.Ar iface
only.
When specified, this variable overrides
.Va dhclient_flags .
@@ -370,11 +373,11 @@ 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 Va iface
+.It Va background_dhclient_ Ns Aq Ar iface
When specified, this variable overrides the
.Va background_dhclient
variable for interface
-.Va iface
+.Ar iface
only.
.It Va synchronous_dhclient
.Pq Bt bool
@@ -1453,7 +1456,9 @@ This must match the location in
.Xr named.conf 5 .
.It Va named_uid
.Pq Vt str
-The user that the named process should be run as.
+The user that the
+.Xr named 8
+process should be run as.
.It Va named_chrootdir
.Pq Vt str
The root directory for a name server run in a
@@ -1721,7 +1726,7 @@ If set to
run the
.Xr pppoed 8
daemon at boot time to provide PPP over Ethernet services.
-.It Va pppoed_ Ns Ar provider
+.It Va pppoed_ Ns Aq Ar provider
.Pq Vt str
.Xr pppoed 8
listens to requests to this
@@ -1783,11 +1788,11 @@ An option to set this up initially
.Xr sysinstall 8
program when the system is first installed.
.It Va ntpdate_config
+.Pq Vt str
Configuration file for
.Xr ntpdate 8 .
-.Pq Vt str
-(default
-.Pa /etc/ntp.conf ).
+Default
+.Pa /etc/ntp.conf .
.It Va ntpdate_hosts
.Pq Vt str
A whitespace-separated list of NTP servers to synchronize with at startup.
@@ -1827,8 +1832,8 @@ Path to
Path to
.Xr ntpd 8
configuration file.
-(default
-.Pa /etc/ntp.conf ) .
+Default
+.Pa /etc/ntp.conf .
.It Va ntpd_flags
.Pq Vt str
If
@@ -2877,8 +2882,7 @@ Set to the list of local 32-bit compatibility
directories.
The names of all files in the directories listed will be
passed as arguments to
-.Xr ldconfig 8
-.Fl 32 .
+.Dq Nm ldconfig Fl 32 .
.It Va kern_securelevel_enable
.Pq Vt bool
Set to
@@ -3047,7 +3051,9 @@ When set to
.Dq Li YES ,
sets
.Va jail_ Ns Ao Ar jname Ac Ns Va _mount_enable
-to YES by default for every jail in
+to
+.Dq Li YES
+by default for every jail in
.Va jail_list .
.It Va jail_devfs_ruleset
.Pq Vt str
@@ -3065,7 +3071,9 @@ When set to
.Dq Li YES ,
sets
.Va jail_ Ns Ao Ar jname Ac Ns Va _devfs_enable
-to YES by default for every jail in
+to
+.Dq Li YES
+by default for every jail in
.Va jail_list .
.It Va jail_fdescfs_enable
.Pq Vt bool
@@ -3076,7 +3084,9 @@ When set to
.Dq Li YES ,
sets
.Va jail_ Ns Ao Ar jname Ac Ns Va _fdescfs_enable
-to YES by default for every jail in
+to
+.Dq Li YES
+by default for every jail in
.Va jail_list .
.It Va jail_procfs_enable
.Pq Vt bool
@@ -3087,14 +3097,16 @@ When set to
.Dq Li YES ,
sets
.Va jail_ Ns Ao Ar jname Ac Ns Va _fdescfs_enable
-to YES by default for every jail in
+to
+.Dq Li YES
+by default for every jail in
.Va jail_list .
.It Va jail_exec_start
.Pq Vt str
Unset by default.
When set, use as default value for
.Va jail_ Ns Ao Ar jname Ac Ns Va _exec_start
-for every jail in
+for every jail in
.Va jail_list .
.It Va jail_exec_afterstart Ns Aq Ar N
.Pq Vt str
@@ -3139,7 +3151,7 @@ Note that the alias is created at jail startup and removed at jail shutdown.
.It Va jail_ Ns Ao Ar jname Ac Ns Va _fstab
.Pq Vt str
Set to
-.Pa /etc/fstab. Ns Ao Ar jname Ac
+.Pa /etc/fstab. Ns Aq Ar jname
by default.
This is the file system information file to use for jail
.Va jname .
@@ -3198,9 +3210,9 @@ This is the command executed at jail startup.
.Pq Vt str
Unset by default.
This is the command run as
-.Ar N Ns
+.Ar N Ns
th command
-after jail startup, where
+after jail startup, where
.Ar N
is 1, 2, and so on.
.It Va jail_ Ns Ao Ar jname Ac Ns Va _exec_stop
@@ -3436,7 +3448,7 @@ The default is
which causes log files flagged with a
.Cm C
to be created.
-.It Va mdconfig_md Ns Ao Ar X Ac
+.It Va mdconfig_md Ns Aq Ar X
.Pq Vt str
Arguments to
.Xr mdconfig 8
@@ -3456,7 +3468,7 @@ for vnode backed
.Xr md 4
devices.
Note that
-.Va mdconfig_md Ns Ao Ar X Ac
+.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
@@ -3505,11 +3517,11 @@ device
.Ar X
has been mounted.
Note that the command is passed to
-.Li eval
+.Ic eval
and that both
-.Li _dev
+.Va _dev
and
-.Li _mp
+.Va _mp
variables can be used to reference respectively the
.Xr md 4
device and the mount point.
@@ -3519,7 +3531,7 @@ device is
.Li md0 ,
one could set the following:
.Bd -literal
-mdconfig_md0_cmd="tar xfzC /var/file.tgz \\${_mp}"
+mdconfig_md0_cmd="tar xfzC /var/file.tgz \e${_mp}"
.Ed
.It Va ramdisk_units
.Pq Vt str
@@ -3537,7 +3549,9 @@ in a
.Va ramdisk_ Ns Ao Ar X Ac Ns Va _config
variable.
Note that this way to configure ramdisks has been deprecated
-in favor of new mdconfig variables (see above).
+in favor of new
+.Va mdconfig_md*
+variables (see above).
.It Va ramdisk_ Ns Ao Ar X Ac Ns Va _config
.Pq Vt str
Arguments to
OpenPOWER on IntegriCloud