summaryrefslogtreecommitdiffstats
path: root/share/man
diff options
context:
space:
mode:
authormpp <mpp@FreeBSD.org>1996-08-15 23:36:21 +0000
committermpp <mpp@FreeBSD.org>1996-08-15 23:36:21 +0000
commitc6763c769f08812cb10d4a3541488465b67975d3 (patch)
treedc107bb7268da74389277f9a91b7aaceedff5f01 /share/man
parent52d9ff24a9291df45fce279279cae678d063f532 (diff)
downloadFreeBSD-src-c6763c769f08812cb10d4a3541488465b67975d3.zip
FreeBSD-src-c6763c769f08812cb10d4a3541488465b67975d3.tar.gz
Convert some formatting escape sequences to use mdoc macros when
possible. E.g. xrefs are .Xr. Paths are .Pa, etc...
Diffstat (limited to 'share/man')
-rw-r--r--share/man/man5/sysconfig.5122
1 files changed, 85 insertions, 37 deletions
diff --git a/share/man/man5/sysconfig.5 b/share/man/man5/sysconfig.5
index a06ec4b..d396deb 100644
--- a/share/man/man5/sysconfig.5
+++ b/share/man/man5/sysconfig.5
@@ -22,7 +22,7 @@
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
-.\" $Id: sysconfig.5,v 1.1 1995/12/19 13:35:31 jkh Exp $
+.\" $Id: sysconfig.5,v 1.2 1996/01/30 13:51:41 mpp Exp $
.\"
.Dd December 18, 1995
.Dt SYSCONFIG 5
@@ -38,8 +38,8 @@ details for any potential network interfaces and which services should be
started up at system initial boot time. In new installations, the
.Nm sysconfig
file is generally initialized by the system installation utility:
-\fB/stand/sysinstall\fR.
-.sp
+.Pa /stand/sysinstall .
+.Pp
It is the duty of the system administrator to properly maintain this file
as changes occur on the local host.
.Sh FILES
@@ -51,9 +51,11 @@ 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 \fB/etc\fR which conditionalize their
+various generic startup scripts in
+.Pa /etc
+which conditionalize their
internal actions according to the settings found there.
-
+.Pp
The following list provides a name and short description for each
variable you can set in the
.Nm
@@ -63,7 +65,8 @@ file:
(str) If set to
.Ar NO
then no keymap is installed, otherwise the value is used to to install
-the keymap file in /usr/share/syscons/keymaps/\fIvalue\fR.kbd
+the keymap file in
+.Pa /usr/share/syscons/keymaps/value.kbd
.It Ar keyrate
(str) The keyboard repeat speed. Set to
.Ar slow ,
@@ -90,27 +93,36 @@ to set the cursor behavior explicitly or chose the default behavior.
(str) If set to
.Ar NO
then no screen map is installed, otherwise the value is used to install
-the screen map file in /usr/share/syscons/scrnmaps/\fIvalue\fR
+the screen map file in
+.Pa /usr/share/syscons/scrnmaps/value .
.It Ar font8x16
(str) If set to
.Ar NO
then the default 8x16 font value is used for screen size requests, otherwise
-the value in /usr/share/syscons/fonts/\fIvalue\fR is used.
+the value in
+.Pa /usr/share/syscons/fonts/value
+is used.
.It Ar font8x14
(str) If set to
.Ar NO
then the default 8x14 font value is used for screen size requests, otherwise
-the value in /usr/share/syscons/fonts/\fIvalue\fR is used.
+the value in
+.Pa /usr/share/syscons/fonts/value
+is used.
.It Ar font8x8
(str) If set to
.Ar NO
then the default 8x8 font value is used for screen size requests, otherwise
-the value in /usr/share/syscons/fonts/\fIvalue\fR is used.
+the value in
+.Pa /usr/share/syscons/fonts/value
+is used.
.It Ar blanktime
(int) If set to
.Ar NO
then the default screen blanking interval is used, otherwise it is set
-to \fIvalue\fR seconds.
+to
+.Ar value
+seconds.
.It Ar hostname
(str) The Fully Qualified Domain Name of your host on the network.
This should almost certainly be set to something meaningful, even if
@@ -150,13 +162,16 @@ then create a default route to this host name or IP address (use IP
address value if you also require this router to get to a name
server!)
.It Ar routedflags
-(str) Set to the arguments you wish to invoke the \fBrouted(8)\fR command
+(str) Set to the arguments you wish to invoke the
+.Xr routed 8
+command
with or
.Ar NO
if you do not wish to run routed. This command is generally only
useful in networks where the active exchange of RIP information is encouraged.
.It Ar timedflags
-(str) Set to the arguments you wish to invoke the \fBtimed(8)\fR
+(str) Set to the arguments you wish to invoke the
+.Xr timed 8
command with or
.Ar NO
if you do not wish to run timed. This command is intended for networks
@@ -164,38 +179,52 @@ of machines where a consistent \&"network time\&" for all of them must be
established. This is often useful in large NFS environments where
time stamps on files are expected to be consistent network-wide.
.It Ar xntpdflags
-(str) Set to the arguments you wish to invoke the \fBxntpd(8)\fR command
+(str) Set to the arguments you wish to invoke the
+.Xr xntpd 8
+command
with or
.Ar NO
if you do not wish to run xntpd. This command is intended for applications
where more precise time synchronization is required.
.It Ar ntpdate
-(str) Set to the arguments you wish to invoke the \fBntpdate(8)\fR command
-with or
+(str) Set to the arguments you wish to invoke the
+.Xr ntpdate 8
+command with or
.Ar NO
if you do not wish to initialize the time with ntpdate. This command is
-intended to synchronize the system clock only \fBonce\fR from some standard
+intended to synchronize the system clock only
+.Ar once
+from some standard
server. An option to set this up initially (from a list of known servers)
-is also provided by the \fB/stand/sysinstall\fR program when the system
+is also provided by the
+.Pa /stand/sysinstall
+program when the system
is first installed.
.It Ar rwhod
(bool) Set to
.Ar YES
-if you want to run the \fBrwhod(8)\fR command.
+if you want to run the
+.Xr rwhod 8
+command.
.It Ar sendmail_flags
-(str) Set to the arguments you wish to invoke the \fBsendmail(8)\fR command
-with or
+(str) Set to the arguments you wish to invoke the
+.Xr sendmail 8
+command with or
.Ar NO
if you do not wish to run sendmail. This command should be run by any
host wishing to send and receive electronic mail and is enabled by
default.
.It Ar amdflags
-(str) Set to the arguments you wish to invoke the \fBamd(8)\fR command with or
+(str) Set to the arguments you wish to invoke the
+.Xr amd 8
+command with or
.Ar NO
if you do not wish to run amd. This command implements an
`auto-mount' scheme using NFS and can help prevent the ``spaghetti
mount'' problem often encountered in large computational clusters.
-Read the man page or see the \fBinfo(1)\fR section for AMD.
+Read the man page or see the
+.Xr info 1
+section for AMD.
.It Ar nfs_client
(bool) Set to
.Ar YES
@@ -204,25 +233,30 @@ if this host will be an NFS client.
(bool) Set to
.Ar YES
if this host will be an NFS server. Note: This also requires an
-\fBexports(5)\fR file.
+.Xr exports 5
+file.
.It Ar nis_ypsetflags
-(str) Set to the arguments you wish to invoke the \fBypset(8)\fR command
-with or
+(str) Set to the arguments you wish to invoke the
+.Xr ypset 8
+command with or
.Ar NO
if you do not wish to run NIS as a client.
.It Ar nis_serverflags
-(str) Set to the arguments you wish to invoke the \fBypserv(8)\fR command
-with or
+(str) Set to the arguments you wish to invoke the
+.Xr ypserv 8
+command with or
.Ar NO
if you do not wish to run an NIS server.
.It Ar namedflags
-(str) Set to the arguments you wish to invoke the \fBnamed(8)\fR
+(str) Set to the arguments you wish to invoke the
+.Xr named 8
command with or
.Ar NO
if you do not wish to run a name server (if you don't even know what
this means, then you definitely don't).
.It Ar pcnfsd
-(str) Set to the arguments you wish to invoke the \fBpcnfsd(8)\fR
+(str) Set to the arguments you wish to invoke the
+.Xr pcnfsd 8
command with or
.Ar NO
if you do not wish to support ONC clients on DOS, OS/2, Macintosh,
@@ -233,7 +267,9 @@ the ports collection.
.It Ar apache_httpd
(bool) If set to
.Ar YES
-then the \fBApache web server\fR will be started at system initial
+then the
+.Ar "Apache web server"
+will be started at system initial
boot time. Note that enabling this currently also requires that you
install the optional apache WWW server package. See the net or www sections
of any reasonably recent package archive or the www subdirectory of
@@ -241,19 +277,26 @@ the ports collection.
.It Ar xtend
(bool) If set to
.Ar YES
-then the X-10 power controller daemon (\fBxtend(8)\fR) will be started
+then the X-10 power controller daemon (the
+.Xr xtend 8
+command) will be started
at system initial boot time.
.It Ar dumpdev
(str) If not set to
.Ar NO
then point kernel crash-dumps at the swap device
-specified as \fIvalue\fR.
+specified as
+.Em value .
.It Ar savecore
(bool) Set to
.Ar YES
if you want kernel crash-dumps to go to
.Ar dumpdev
-for later post-mortem diagnosis with the \fBgdb(1)\fR command's \fB-k\fR flag.
+for later post-mortem diagnosis with the
+.Xr gdb 1
+command's
+.Fl k
+flag.
.It Ar kerberos_server
(bool) Set to
.Ar YES
@@ -266,7 +309,9 @@ some sort of packet router).
.It Ar gated
(bool) Set to
.Ar YES
-if you want to run the \fBgated(8)\fR route management system at system
+if you want to run the
+.Xr gated 8
+route management system at system
initial boot time. Note that enabling this currently also requires that
you install the optional gated package. See the networking section
of any reasonably recent package archive or the net subdirectory of
@@ -274,12 +319,15 @@ the ports collection.
.It Ar check_quotas
(bool) Set to
.Ar YES
-if you want to enable user disk quota checking via the \fBquotacheck(8)\fR
+if you want to enable user disk quota checking via the
+.Xr quotacheck 8
command.
.It Ar accounting
(bool) Set to
.Ar YES
-if you wish to enable system accounting through the \fBaccton(8)\fR facility.
+if you wish to enable system accounting through the
+.Xr accton 8
+facility.
.It Ar ibcs2
(bool) Set to
.Ar YES
OpenPOWER on IntegriCloud