Thu Sep 3 20:06:39 2009 UTC ()
* Boolean values may be specified with any of YES/TRUE/ON/1 or
  NO/FALSE/OFF/0, so explain that.
* Change all "Foo:  YES or NO.  If not set to YES then ..." to
  "Foo:  Boolean value.  If false then ...".
* Some rewording for clarity.


(apb)
diff -r1.131 -r1.132 src/share/man/man5/rc.conf.5

cvs diff -r1.131 -r1.132 src/share/man/man5/rc.conf.5 (expand / switch to unified diff)

--- src/share/man/man5/rc.conf.5 2009/07/25 21:21:20 1.131
+++ src/share/man/man5/rc.conf.5 2009/09/03 20:06:39 1.132
@@ -1,14 +1,14 @@ @@ -1,14 +1,14 @@
1.\" $NetBSD: rc.conf.5,v 1.131 2009/07/25 21:21:20 wiz Exp $ 1.\" $NetBSD: rc.conf.5,v 1.132 2009/09/03 20:06:39 apb Exp $
2.\" 2.\"
3.\" Copyright (c) 1996 Matthew R. Green 3.\" Copyright (c) 1996 Matthew R. Green
4.\" All rights reserved. 4.\" All rights reserved.
5.\" 5.\"
6.\" Redistribution and use in source and binary forms, with or without 6.\" Redistribution and use in source and binary forms, with or without
7.\" modification, are permitted provided that the following conditions 7.\" modification, are permitted provided that the following conditions
8.\" are met: 8.\" are met:
9.\" 1. Redistributions of source code must retain the above copyright 9.\" 1. Redistributions of source code must retain the above copyright
10.\" notice, this list of conditions and the following disclaimer. 10.\" notice, this list of conditions and the following disclaimer.
11.\" 2. Redistributions in binary form must reproduce the above copyright 11.\" 2. Redistributions in binary form must reproduce the above copyright
12.\" notice, this list of conditions and the following disclaimer in the 12.\" notice, this list of conditions and the following disclaimer in the
13.\" documentation and/or other materials provided with the distribution. 13.\" documentation and/or other materials provided with the distribution.
14.\" 14.\"
@@ -45,27 +45,27 @@ @@ -45,27 +45,27 @@
45.\" 45.\"
46.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR 46.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
47.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES 47.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
48.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. 48.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
49.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, 49.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
50.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, 50.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
51.\" BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; 51.\" BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
52.\" LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED 52.\" LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
53.\" AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, 53.\" AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
54.\" OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 54.\" OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
55.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 55.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
56.\" SUCH DAMAGE. 56.\" SUCH DAMAGE.
57.\" 57.\"
58.Dd July 25, 2009 58.Dd September 3, 2009
59.Dt RC.CONF 5 59.Dt RC.CONF 5
60.Os 60.Os
61.Sh NAME 61.Sh NAME
62.Nm rc.conf 62.Nm rc.conf
63.Nd system startup configuration file 63.Nd system startup configuration file
64.Sh DESCRIPTION 64.Sh DESCRIPTION
65The 65The
66.Nm 66.Nm
67file specifies which services are enabled during system startup by 67file specifies which services are enabled during system startup by
68the startup scripts invoked by 68the startup scripts invoked by
69.Pa /etc/rc 69.Pa /etc/rc
70(see 70(see
71.Xr rc 8 ) , 71.Xr rc 8 ) ,
@@ -76,45 +76,26 @@ The @@ -76,45 +76,26 @@ The
76file is a shell script that is sourced by 76file is a shell script that is sourced by
77.Xr rc 8 , 77.Xr rc 8 ,
78meaning that 78meaning that
79.Nm 79.Nm
80must contain valid shell commands. 80must contain valid shell commands.
81.Pp 81.Pp
82Listed below are the standard 82Listed below are the standard
83.Nm 83.Nm
84variables that may be set, the values to which each may be set, 84variables that may be set, the values to which each may be set,
85a brief description of what each variable does, and a reference to 85a brief description of what each variable does, and a reference to
86relevant manual pages. 86relevant manual pages.
87Third party packages may test for additional variables. 87Third party packages may test for additional variables.
88.Pp 88.Pp
89Most variables are one of two types: enabling variables or flags 
90variables. 
91Enabling variables, such as 
92.Sy inetd , 
93are generally named after the program or the system they enable, 
94and are set to 
95.Sq YES 
96or 
97.Sq NO . 
98Flags variables, such as 
99.Sy inetd_flags 
100have the same name with "_flags" appended, and determine what 
101arguments are passed to the program if it is enabled. 
102.Pp 
103If a variable that 
104.Xr rc 8 
105expects to be set is not set, or the value is not one of the allowed 
106values, a warning will be printed. 
107.Pp 
108By default, 89By default,
109.Nm 90.Nm
110reads 91reads
111.Pa /etc/defaults/rc.conf 92.Pa /etc/defaults/rc.conf
112(if it is readable) 93(if it is readable)
113to obtain default values for various variables, and the end-user 94to obtain default values for various variables, and the end-user
114may override these by appending appropriate entries to the end of 95may override these by appending appropriate entries to the end of
115.Nm . 96.Nm .
116.Pp 97.Pp
117.Xr rc.d 8 98.Xr rc.d 8
118scripts that use 99scripts that use
119.Ic load_rc_config 100.Ic load_rc_config
120from 101from
@@ -125,56 +106,77 @@ file @@ -125,56 +106,77 @@ file
125(where 106(where
126.Ar service 107.Ar service
127is the contents of the 108is the contents of the
128.Sy name 109.Sy name
129variable in the 110variable in the
130.Xr rc.d 8 111.Xr rc.d 8
131script). 112script).
132This may contain variable overrides, including allowing the end-user 113This may contain variable overrides, including allowing the end-user
133to override various 114to override various
134.Ic run_rc_command 115.Ic run_rc_command
135.Xr rc.d 8 116.Xr rc.d 8
136control variables, and thus changing the operation of the script 117control variables, and thus changing the operation of the script
137without requiring editing of the script. 118without requiring editing of the script.
 119.Ss Variable naming conventions and data types
 120Most variables are one of two types: enabling variables or flags
 121variables.
 122Enabling variables, such as
 123.Sy inetd ,
 124are generally named after the program or the system they enable,
 125and have boolean values (specified using
 126.Sq Ic YES ,
 127.Sq Ic TRUE ,
 128.Sq Ic ON
 129or
 130.Sq Ic 1
 131for true, and
 132.Sq Ic NO ,
 133.Sq Ic FALSE ,
 134.Sq Ic OFF
 135or
 136.Sq Ic 0
 137for false, with the values being case insensitive).
 138Flags variables, such as
 139.Sy inetd_flags
 140have the same name with "_flags" appended, and determine what
 141arguments are passed to the program if it is enabled.
 142.Pp
 143If a variable that
 144.Xr rc 8
 145expects to be set is not set, or the value is not one of the allowed
 146values, a warning will be printed.
138.Ss Overall control 147.Ss Overall control
139.Bl -tag -width net_interfaces 148.Bl -tag -width net_interfaces
140.It Sy do_rcshutdown 149.It Sy do_rcshutdown
141.Sq YES 150Boolean value.
142or 151If false,
143.Sq NO . 
144If set to 
145.Sq NO , 
146.Xr shutdown 8 152.Xr shutdown 8
147will not run 153will not run
148.Pa /etc/rc.shutdown . 154.Pa /etc/rc.shutdown .
149.It Sy rcshutdown_rcorder_flags 155.It Sy rcshutdown_rcorder_flags
150A string. 156A string.
151Extra arguments to the 157Extra arguments to the
152.Xr rcorder 8 158.Xr rcorder 8
153run by 159run by
154.Pa /etc/rc.shutdown . 160.Pa /etc/rc.shutdown .
155.It Sy rcshutdown_timeout 161.It Sy rcshutdown_timeout
156A number. 162A number.
157If non-blank, use this as the number of seconds to run a watchdog timer for 163If non-blank, use this as the number of seconds to run a watchdog timer for
158which will terminate 164which will terminate
159.Pa /etc/rc.shutdown 165.Pa /etc/rc.shutdown
160if the timer expires before the shutdown script completes. 166if the timer expires before the shutdown script completes.
161.It Sy rc_configured 167.It Sy rc_configured
162.Sq YES 168Boolean value.
163or 169If false then the system will drop into single-user mode during boot.
164.Sq NO . 
165If not set to 
166.Sq YES 
167then the system will drop into single-user mode during boot. 
168.It Sy rc_fast_and_loose 170.It Sy rc_fast_and_loose
169If set to a non-empty string, 171If set to a non-empty string,
170each script in 172each script in
171.Pa /etc/rc.d 173.Pa /etc/rc.d
172will be executed in the current shell rather than a sub shell. 174will be executed in the current shell rather than a sub shell.
173This may be faster on slow machines that have an expensive 175This may be faster on slow machines that have an expensive
174.Xr fork 2 176.Xr fork 2
175operation. 177operation.
176.Bl -hang 178.Bl -hang
177.It Em Note : 179.It Em Note :
178Use this at your own risk! 180Use this at your own risk!
179A rogue command or script may inadvertently prevent boot to multiuser. 181A rogue command or script may inadvertently prevent boot to multiuser.
180.El 182.El
@@ -263,117 +265,90 @@ during boot before mounting it. @@ -263,117 +265,90 @@ during boot before mounting it.
263This option may be used to override the default command-line options 265This option may be used to override the default command-line options
264passed to the 266passed to the
265.Xr fsck 8 267.Xr fsck 8
266program. 268program.
267.Pp 269.Pp
268When set to 270When set to
269.Fl y , 271.Fl y ,
270.Xr fsck 8 272.Xr fsck 8
271assumes yes as the answer to all operator questions during file system checks. 273assumes yes as the answer to all operator questions during file system checks.
272This might be important with hosts where the administrator does not have 274This might be important with hosts where the administrator does not have
273access to the console and an unsuccessful shutdown must not make the host 275access to the console and an unsuccessful shutdown must not make the host
274unbootable even if the file system checks would fail in preen mode. 276unbootable even if the file system checks would fail in preen mode.
275.It Sy no_swap 277.It Sy no_swap
276.Sq YES 278Boolean value.
277or 279Should be true if you have deliberately configured your system with no swap.
278.Sq NO . 280If false and no swap devices are configured, the system will warn you.
279Set the 
280.Sy no_swap 
281variable to 
282.Sq YES 
283if you have configured your system with no swap on purpose. 
284If not set to 
285.Sq YES , 
286and no swap devices 
287are configured, the system will warn you. 
288.It Sy swapoff 281.It Sy swapoff
289.Sq YES 282Boolean value.
290or 
291.Sq NO . 
292Remove block-type swap devices at shutdown time. 283Remove block-type swap devices at shutdown time.
293Useful if swapping onto RAIDframe devices. 284Useful if swapping onto RAIDframe devices.
294.El 285.El
295.Ss One-time actions to perform or programs to run on boot-up 286.Ss One-time actions to perform or programs to run on boot-up
296.Bl -tag -width net_interfaces 287.Bl -tag -width net_interfaces
297.It Sy accounting 288.It Sy accounting
298.Sq YES 289Boolean value.
299or 
300.Sq NO . 
301Enables process accounting with 290Enables process accounting with
302.Xr accton 8 . 291.Xr accton 8 .
303Requires 292Requires
304.Pa /var/account/acct 293.Pa /var/account/acct
305to exist. 294to exist.
306.It Sy clear_tmp 295.It Sy clear_tmp
307.Sq YES 296Boolean value.
308or 
309.Sq NO . 
310Clear /tmp after reboot. 297Clear /tmp after reboot.
311.It Sy dmesg 298.It Sy dmesg
312.Sq YES 299Boolean value.
313or 
314.Sq NO . 
315Create 300Create
316.Pa /var/run/dmesg.boot 301.Pa /var/run/dmesg.boot
317from the output of 302from the output of
318.Xr dmesg 8 . 303.Xr dmesg 8 .
319Passes 304Passes
320.Sy dmesg_flags . 305.Sy dmesg_flags .
321.It Sy gpio 306.It Sy gpio
322.Sq YES 307Boolean value.
323or 
324.Sq NO . 
325Configure 308Configure
326.Xr gpio 4 309.Xr gpio 4
327devices . 310devices .
328See 311See
329.Xr gpio.conf 5 . 312.Xr gpio.conf 5 .
330.It Sy mixerctl 313.It Sy mixerctl
331.Sq YES 314Boolean value.
332or 
333.Sq NO . 
334Read 315Read
335.Xr mixerctl.conf 5 316.Xr mixerctl.conf 5
336for how to set mixer values. 317for how to set mixer values.
337List in 318List in
338.Sy mixerctl_mixers 319.Sy mixerctl_mixers
339the devices whose settings are to be saved at shutdown and 320the devices whose settings are to be saved at shutdown and
340restored at start-up. 321restored at start-up.
341.It Sy newsyslog 322.It Sy newsyslog
342.Sq YES 323Boolean value.
343or 
344.Sq NO . 
345Run 324Run
346.Nm newsyslog 325.Nm newsyslog
347to trim logfiles before syslogd starts. 326to trim logfiles before syslogd starts.
348Intended for laptop users. 327Intended for laptop users.
349Passes 328Passes
350.Sy newsyslog_flags . 329.Sy newsyslog_flags .
351.It Sy per_user_tmp 330.It Sy per_user_tmp
352.Sq YES 331Boolean value.
353or 
354.Sq NO . 
355Enables a per-user 332Enables a per-user
356.Pa /tmp 333.Pa /tmp
357directory. 334directory.
358.Sy per_user_tmp_dir 335.Sy per_user_tmp_dir
359can be used to override the default location of the 336can be used to override the default location of the
360.Dq real 337.Dq real
361temporary directories, 338temporary directories,
362.Dq Pa /private/tmp . 339.Dq Pa /private/tmp .
363.It Sy rndctl 340.It Sy rndctl
364.Sq YES 341Boolean value.
365or 
366.Sq NO . 
367Runs the 342Runs the
368.Xr rndctl 8 343.Xr rndctl 8
369utility one or more times according to the specification in 344utility one or more times according to the specification in
370.Sy rndctl_flags . 345.Sy rndctl_flags .
371.Pp 346.Pp
372If 347If
373.Sy rndctl_flags 348.Sy rndctl_flags
374does not contain a semicolon 349does not contain a semicolon
375.Pq Ql \&; 350.Pq Ql \&;
376then it is expected to contain zero or more flags, 351then it is expected to contain zero or more flags,
377followed by one or more device or type names. 352followed by one or more device or type names.
378The 353The
379.Xr rndctl 8 354.Xr rndctl 8
@@ -400,70 +375,60 @@ not type names. @@ -400,70 +375,60 @@ not type names.
400.Sy rndctl_flags 375.Sy rndctl_flags
401may contain multiple semicolon-separated segments, in which each 376may contain multiple semicolon-separated segments, in which each
402segment contains flags and device or type names as described above. 377segment contains flags and device or type names as described above.
403This allows different flags to be associated with different 378This allows different flags to be associated with different
404device or type names. 379device or type names.
405For example, given 380For example, given
406.Li rndctl_flags="wd0 wd1; -t tty; -c -t net" , 381.Li rndctl_flags="wd0 wd1; -t tty; -c -t net" ,
407the following commands will be executed: 382the following commands will be executed:
408.Li "rndctl -c -e -d wd0" ; 383.Li "rndctl -c -e -d wd0" ;
409.Li "rndctl -c -e -d wd1" ; 384.Li "rndctl -c -e -d wd1" ;
410.Li "rndctl -c -e -t tty" ; 385.Li "rndctl -c -e -t tty" ;
411.Li "rndctl -c -t net" . 386.Li "rndctl -c -t net" .
412.It Sy savecore 387.It Sy savecore
413.Sq YES 388Boolean value.
414or 
415.Sq NO . 
416Runs the 389Runs the
417.Xr savecore 8 390.Xr savecore 8
418utility. 391utility.
419Passes 392Passes
420.Sy savecore_flags . 393.Sy savecore_flags .
421The directory where crash dumps are stored is specified by 394The directory where crash dumps are stored is specified by
422.Sy savecore_dir . 395.Sy savecore_dir .
423The default setting is 396The default setting is
424.Dq Pa /var/crash . 397.Dq Pa /var/crash .
425.It Sy tpctl 398.It Sy tpctl
426.Sq YES 399Boolean value.
427or 
428.Sq NO . 
429Run 400Run
430.Xr tpctl 8 401.Xr tpctl 8
431to calibrate touch panel device. 402to calibrate touch panel device.
432Passes 403Passes
433.Sy tpctl_flags . 404.Sy tpctl_flags .
434.It Sy update_motd 405.It Sy update_motd
435.Sq YES 406Boolean value.
436or 
437.Sq NO . 
438Updates the 407Updates the
439.Nx 408.Nx
440version string in the 409version string in the
441.Pa /etc/motd 410.Pa /etc/motd
442file to reflect the version of the running kernel. 411file to reflect the version of the running kernel.
443See 412See
444.Xr motd 5 . 413.Xr motd 5 .
445.It Sy veriexec 414.It Sy veriexec
446.Sq YES 415Boolean value.
447or 
448.Sq NO . 
449Load Veriexec fingerprints during startup. 416Load Veriexec fingerprints during startup.
450Read 417Read
451.Xr veriexecctl 8 418.Xr veriexecctl 8
452for more information. 419for more information.
453.It Sy virecover 420.It Sy virecover
454.Sq YES 421Boolean value.
455or 
456.Sq NO . 
457Send notification mail to users if any recoverable files exist in 422Send notification mail to users if any recoverable files exist in
458.Pa /var/tmp/vi.recover . 423.Pa /var/tmp/vi.recover .
459Read 424Read
460.Xr virecover 8 425.Xr virecover 8
461for more information. 426for more information.
462.El 427.El
463.Ss System security setting 428.Ss System security setting
464.Bl -tag -width net_interfaces 429.Bl -tag -width net_interfaces
465.It Sy securelevel 430.It Sy securelevel
466A number. 431A number.
467The system securelevel is set to the specified value early 432The system securelevel is set to the specified value early
468in the boot process, before any external logins, or other programs 433in the boot process, before any external logins, or other programs
469that run users job, are started. 434that run users job, are started.
@@ -501,66 +466,57 @@ A number. @@ -501,66 +466,57 @@ A number.
501Controls the verbosity of Veriexec. 466Controls the verbosity of Veriexec.
502Recommended operation is at level 0, verbose output (mostly used when 467Recommended operation is at level 0, verbose output (mostly used when
503building the signatures file) is at level 1. 468building the signatures file) is at level 1.
504Level 2 is for debugging only and should not be used. 469Level 2 is for debugging only and should not be used.
505.It Sy veriexec_flags 470.It Sy veriexec_flags
506A string. 471A string.
507Flags to pass to the 472Flags to pass to the
508.Nm veriexecctl 473.Nm veriexecctl
509command. 474command.
510.El 475.El
511.Ss Networking startup 476.Ss Networking startup
512.Bl -tag -width net_interfaces 477.Bl -tag -width net_interfaces
513.It Sy altqd 478.It Sy altqd
514.Sq YES 479Boolean value.
515or 
516.Sq NO . 
517ALTQ configuration/monitoring daemon. 480ALTQ configuration/monitoring daemon.
518Passes 481Passes
519.Sy altqd_flags . 482.Sy altqd_flags .
520.It Sy auto_ifconfig 483.It Sy auto_ifconfig
521.Sq YES 484Boolean value.
522or 
523.Sq NO . 
524Sets the 485Sets the
525.Sy net_interfaces 486.Sy net_interfaces
526variable (see below) to the output of 487variable (see below) to the output of
527.Xr ifconfig 8 488.Xr ifconfig 8
528with the 489with the
529.Dq Li -l 490.Dq Li -l
530flag and suppresses warnings about interfaces in this list that 491flag and suppresses warnings about interfaces in this list that
531do not have an ifconfig file or variable. 492do not have an ifconfig file or variable.
532.It Sy dhclient 493.It Sy dhclient
533.Sq YES 494Boolean value.
534or 495Set true to configure some or all network interfaces using
535.Sq NO . 
536Set to 
537.Sq YES 
538to configure some or all network interfaces using 
539the ISC DHCP client. 496the ISC DHCP client.
540If you set 497If you set
541.Sy dhclient 498.Sy dhclient
542to 499true, then
543.Sq YES , 
544you must either have 
545.Pa /var 500.Pa /var
546in 501must be in
547.Sy critical_filesystems_local , 502.Sy critical_filesystems_local ,
548as part of 503or
549.Pa / , 504.Pa /var
550or direct the DHCP client to store the leases file on the root 505must be on the root file system,
551file system by modifying the 506or you must modify the
552.Sy dhclient_flags 507.Sy dhclient_flags
553variable. 508variable to direct the DHCP client to store the leases file
 509in some other directory on the root file system.
554You must not provide ifconfig information or ifaliases 510You must not provide ifconfig information or ifaliases
555information for any interface that is to be configured using the DHCP client. 511information for any interface that is to be configured using the DHCP client.
556Interface aliases can be set up in the DHCP client configuration 512Interface aliases can be set up in the DHCP client configuration
557file if needed - see 513file if needed - see
558.Xr dhclient.conf 5 514.Xr dhclient.conf 5
559for details. 515for details.
560.Pp 516.Pp
561Passes 517Passes
562.Sy dhclient_flags 518.Sy dhclient_flags
563to the DHCP client. 519to the DHCP client.
564See 520See
565.Xr dhclient 8 521.Xr dhclient 8
566for complete documentation. 522for complete documentation.
@@ -572,65 +528,59 @@ on the command line. @@ -572,65 +528,59 @@ on the command line.
572If you must run the DHCP client before mounting critical file systems, 528If you must run the DHCP client before mounting critical file systems,
573then you should specify an alternate location for the DHCP client's lease 529then you should specify an alternate location for the DHCP client's lease
574file in the 530file in the
575.Sy dhclient_flags 531.Sy dhclient_flags
576variable - for example, "-lf /tmp/dhclient.leases". 532variable - for example, "-lf /tmp/dhclient.leases".
577.It Sy dhcpcd_flags 533.It Sy dhcpcd_flags
578Additional arguments to pass to 534Additional arguments to pass to
579.Xr dhcpcd 8 535.Xr dhcpcd 8
580when requesting configuration via 536when requesting configuration via
581.Sy ifconfig_xxN 537.Sy ifconfig_xxN
582or 538or
583.Pa /etc/ifconfig.xxN . 539.Pa /etc/ifconfig.xxN .
584.It Sy flushroutes 540.It Sy flushroutes
585.Sq YES 541Boolean value.
586or 
587.Sq NO . 
588Flushes the route table on networking startup. 542Flushes the route table on networking startup.
589Useful when coming up to multiuser mode after going down to 543Useful when coming up to multiuser mode after going down to
590single-user mode. 544single-user mode.
591.It Sy hostapd 545.It Sy hostapd
592.Sq YES 546Boolean value.
593or 
594.Sq NO . 
595Runs 547Runs
596.Xr hostapd 8 , 548.Xr hostapd 8 ,
597the authenticator for IEEE 802.11 networks. 549the authenticator for IEEE 802.11 networks.
598.It Sy ifaliases_* 550.It Sy ifaliases_*
599A string. 551A string.
600List of 552List of
601.Sq Em "address netmask" 553.Sq Em "address netmask"
602pairs to configure additional network addresses for the given 554pairs to configure additional network addresses for the given
603configured interface 555configured interface
604.Dq * 556.Dq *
605(e.g. 557(e.g.
606.Sy ifaliases_le0 ) . 558.Sy ifaliases_le0 ) .
607If 559If
608.Em netmask 560.Em netmask
609is 561is
610.Dq - , 562.Dq - ,
611then use the default netmask for the interface. 563then use the default netmask for the interface.
612.Pp 564.Pp
613.Sy ifaliases_* 565.Sy ifaliases_*
614covers limited cases only and considered unrecommended. 566covers limited cases only and considered unrecommended.
615We recommend using 567We recommend using
616.Sy ifconfig_nnX 568.Sy ifconfig_nnX
617variables or 569variables or
618.Pa /etc/ifconfig.xxN 570.Pa /etc/ifconfig.xxN
619files with multiple lines instead. 571files with multiple lines instead.
620.It Sy ifwatchd 572.It Sy ifwatchd
621.Sq YES 573Boolean value.
622or 
623.Sq NO . 
624Monitor dynamic interfaces and perform actions upon address changes. 574Monitor dynamic interfaces and perform actions upon address changes.
625Passes 575Passes
626.Sy ifwatchd_flags . 576.Sy ifwatchd_flags .
627.It Sy ip6mode 577.It Sy ip6mode
628A string. 578A string.
629An IPv6 node can be a router 579An IPv6 node can be a router
630.Pq nodes that forward packet for others 580.Pq nodes that forward packet for others
631or a host 581or a host
632.Pq nodes that do not forward . 582.Pq nodes that do not forward .
633A host can be autoconfigured 583A host can be autoconfigured
634based on the information advertised by adjacent IPv6 routers. 584based on the information advertised by adjacent IPv6 routers.
635By setting 585By setting
636.Sy ip6mode 586.Sy ip6mode
@@ -640,72 +590,63 @@ to @@ -640,72 +590,63 @@ to
640or 590or
641.Dq Li autohost , 591.Dq Li autohost ,
642you can configure your node as a router, 592you can configure your node as a router,
643a non-autoconfigured host, or an autoconfigured host. 593a non-autoconfigured host, or an autoconfigured host.
644Invalid values will be ignored, and the node will be configured as 594Invalid values will be ignored, and the node will be configured as
645a non-autoconfigured host. 595a non-autoconfigured host.
646You may want to check 596You may want to check
647.Sy rtsol 597.Sy rtsol
648and 598and
649.Sy rtsold 599.Sy rtsold
650as well, if you set the variable to 600as well, if you set the variable to
651.Dq Li autohost . 601.Dq Li autohost .
652.It Sy ip6uniquelocal 602.It Sy ip6uniquelocal
653.Sq YES 603Boolean value.
654or 
655.Sq NO . 
656If 604If
657.Sy ip6mode 605.Sy ip6mode
658is equal to 606is equal to
659.Dq Li router 607.Dq Li router ,
660and 608and
661.Sy ip6uniquelocal 609.Sy ip6uniquelocal
662is set to 610is false,
663.Sq NO 
664a reject route will be installed on boot to avoid misconfiguration relating 611a reject route will be installed on boot to avoid misconfiguration relating
665to unique-local addresses. 612to unique-local addresses.
666If set to 613If
667.Sq YES 614.Sy ip6uniquelocal
668the reject route won't be installed. 615is true, the reject route won't be installed.
669.It Sy ipfilter 616.It Sy ipfilter
670.Sq YES 617Boolean value.
671or 
672.Sq NO . 
673Runs 618Runs
674.Xr ipf 8 619.Xr ipf 8
675to load in packet filter specifications from 620to load in packet filter specifications from
676.Pa /etc/ipf.conf 621.Pa /etc/ipf.conf
677at network boot time, before any interfaces are configured. 622at network boot time, before any interfaces are configured.
678Passes 623Passes
679.Sy ipfilter_flags . 624.Sy ipfilter_flags .
680See 625See
681.Xr ipf.conf 5 . 626.Xr ipf.conf 5 .
682.It Sy ipfs 627.It Sy ipfs
683.Sq YES 628Boolean value.
684or 
685.Sq NO . 
686Runs 629Runs
687.Xr ipfs 8 630.Xr ipfs 8
688to save and restore information for ipnat and ipfilter state tables. 631to save and restore information for ipnat and ipfilter state tables.
689The information is stored in 632The information is stored in
690.Pa /var/db/ipf/ipstate.ipf 633.Pa /var/db/ipf/ipstate.ipf
691and 634and
692.Pa /var/db/ipf/ipnat.ipf . 635.Pa /var/db/ipf/ipnat.ipf .
693Passes 636Passes
694.Sy ipfs_flags . 637.Sy ipfs_flags .
695.It Sy ipmon 638.It Sy ipmon
696.Sq YES 639Boolean value.
697or 
698.Sq NO . 
699Runs 640Runs
700.Xr ipmon 8 641.Xr ipmon 8
701to read 642to read
702.Xr ipf 8 643.Xr ipf 8
703packet log information and log it to a file or the system log. 644packet log information and log it to a file or the system log.
704Passes 645Passes
705.Sy ipmon_flags . 646.Sy ipmon_flags .
706.It Sy ipmon_flags 647.It Sy ipmon_flags
707A string. 648A string.
708Specifies arguments to supply to 649Specifies arguments to supply to
709.Xr ipmon 8 . 650.Xr ipmon 8 .
710Defaults to 651Defaults to
711.Dq Li -ns . 652.Dq Li -ns .
@@ -714,790 +655,663 @@ A typical example would be @@ -714,790 +655,663 @@ A typical example would be
714to have 655to have
715.Xr ipmon 8 656.Xr ipmon 8
716log directly to a file bypassing 657log directly to a file bypassing
717.Xr syslogd 8 . 658.Xr syslogd 8 .
718If the 659If the
719.Dq -D 660.Dq -D
720argument is used, remember to modify 661argument is used, remember to modify
721.Pa /etc/newsyslog.conf 662.Pa /etc/newsyslog.conf
722accordingly; for example: 663accordingly; for example:
723.Bd -literal 664.Bd -literal
724/var/log/ipflog 640 10 100 * Z /var/run/ipmon.pid 665/var/log/ipflog 640 10 100 * Z /var/run/ipmon.pid
725.Ed 666.Ed
726.It Sy ipnat 667.It Sy ipnat
727.Sq YES 668Boolean value.
728or 
729.Sq NO . 
730Runs 669Runs
731.Xr ipnat 8 670.Xr ipnat 8
732to load in the IP network address translation (NAT) rules from 671to load in the IP network address translation (NAT) rules from
733.Pa /etc/ipnat.conf 672.Pa /etc/ipnat.conf
734at network boot time, before any interfaces are configured. 673at network boot time, before any interfaces are configured.
735See 674See
736.Xr ipnat.conf 5 . 675.Xr ipnat.conf 5 .
737.It Sy ipsec 676.It Sy ipsec
738.Sq YES 677Boolean value.
739or 
740.Sq NO . 
741Runs 678Runs
742.Xr setkey 8 679.Xr setkey 8
743to load in IPsec manual keys and policies from 680to load in IPsec manual keys and policies from
744.Pa /etc/ipsec.conf 681.Pa /etc/ipsec.conf
745at network boot time, before any interfaces are configured. 682at network boot time, before any interfaces are configured.
746.It Sy net_interfaces 683.It Sy net_interfaces
747A string. 684A string.
748The list of network interfaces to be configured at boot time. 685The list of network interfaces to be configured at boot time.
749For each interface "xxN", the system first looks for ifconfig 686For each interface "xxN", the system first looks for ifconfig
750parameters in the variable 687parameters in the variable
751.Sy ifconfig_xxN , 688.Sy ifconfig_xxN ,
752and then in the file 689and then in the file
753.Pa /etc/ifconfig.xxN . 690.Pa /etc/ifconfig.xxN .
754If 691If
755.Sy auto_ifconfig 692.Sy auto_ifconfig
756is set to "NO" and neither the file nor the variable is found, 693is false, and neither the variable nor the file is found,
757a warning is printed. 694a warning is printed.
758Information in either the variable or the file is parsed identically, 695Information in either the variable or the file is parsed identically,
759except that, if an 696except that, if an
760.Sy ifconfig_xxN 697.Sy ifconfig_xxN
761variable contains a single line with embedded semicolons, 698variable contains a single line with embedded semicolons,
762then the value is split into multiple lines prior to further parsing, 699then the value is split into multiple lines prior to further parsing,
763treating the semicolon as a line separator. 700treating the semicolon as a line separator.
764One common case it to set 701One common case it to set
765.Sy ifconfig_xxN Ns Li \&= Ns Qq dhcp , 702.Sy ifconfig_xxN Ns Li \&= Ns Qq dhcp ,
766which will cause 703which will cause
767.Xr dhcpcd 8 704.Xr dhcpcd 8
768to be started for the interface. 705to be started for the interface.
769Another common case it to set the 706Another common case it to set the
770.Sy ifconfig_xxN 707.Sy ifconfig_xxN
771variable to a set of arguments to be passed to an 708variable to a set of arguments to be passed to an
772.Xr ifconfig 8 709.Xr ifconfig 8
773command after the interface name. 710command after the interface name.
774Refer to 711Refer to
775.Xr ifconfig.if 5 712.Xr ifconfig.if 5
776for more details on 713for more details on
777.Pa /etc/ifconfig.xxN 714.Pa /etc/ifconfig.xxN
778files, and note that the information there also applies to 715files, and note that the information there also applies to
779.Sy ifconfig_xxN 716.Sy ifconfig_xxN
780variables (after the variables are split into lines). 717variables (after the variables are split into lines).
781.It Sy ntpdate 718.It Sy ntpdate
782.Sq YES 719Boolean value.
783or 
784.Sq NO . 
785Runs 720Runs
786.Xr ntpdate 8 721.Xr ntpdate 8
787to set the system time from one of the hosts in 722to set the system time from one of the hosts in
788.Sy ntpdate_hosts . 723.Sy ntpdate_hosts .
789If 724If
790.Sy ntpdate_hosts 725.Sy ntpdate_hosts
791is empty, it will attempt to find a list of hosts in 726is empty, it will attempt to find a list of hosts in
792.Pa /etc/ntp.conf . 727.Pa /etc/ntp.conf .
793Passes 728Passes
794.Sy ntpdate_flags . 729.Sy ntpdate_flags .
795.It Sy pf 730.It Sy pf
796.Sq YES 731Boolean value.
797or 
798.Sq NO . 
799Enable 732Enable
800.Xr pf 4 733.Xr pf 4
801at network boot time: 734at network boot time:
802Load the initial configuration 735Load the initial configuration
803.Xr pf.boot.conf 5 736.Xr pf.boot.conf 5
804before the network is up. 737before the network is up.
805After the network has been configured, then load the final ruleset 738After the network has been configured, then load the final ruleset
806.Xr pf.conf 5 . 739.Xr pf.conf 5 .
807.It Sy pf_rules 740.It Sy pf_rules
808A string. 741A string.
809The path of the 742The path of the
810.Xr pf.conf 5 743.Xr pf.conf 5
811ruleset that will be used when loading the final ruleset. 744ruleset that will be used when loading the final ruleset.
812.It Sy pflogd 745.It Sy pflogd
813.Sq YES 746Boolean value.
814or 
815.Sq NO . 
816Run 747Run
817.Xr pflogd 8 748.Xr pflogd 8
818for dumping packet filter logging information to a file. 749for dumping packet filter logging information to a file.
819.It Sy ppp_peers 750.It Sy ppp_peers
820A string. 751A string.
821If 752If
822.Sy ppp_peers 753.Sy ppp_peers
823is not empty, then 754is not empty, then
824.Pa /etc/rc.d/ppp 755.Pa /etc/rc.d/ppp
825will check each word in 756will check each word in
826.Sy ppp_peers 757.Sy ppp_peers
827for a corresponding ppp configuration file in 758for a corresponding ppp configuration file in
828.Pa /etc/ppp/peers 759.Pa /etc/ppp/peers
829and will call 760and will call
830.Xr pppd 8 761.Xr pppd 8
831with the 762with the
832.Dq call Sy peer 763.Dq call Sy peer
833option. 764option.
834.It Sy racoon 765.It Sy racoon
835.Sq YES 766Boolean value.
836or 
837.Sq NO . 
838Runs 767Runs
839.Xr racoon 8 , 768.Xr racoon 8 ,
840the IKE (ISAKMP/Oakley) key management daemon. 769the IKE (ISAKMP/Oakley) key management daemon.
841.It Sy rtsol 770.It Sy rtsol
842.Sq YES 771Boolean value.
843or 
844.Sq NO . 
845Run 772Run
846.Xr rtsol 8 , 773.Xr rtsol 8 ,
847router solicitation command for IPv6 hosts. 774router solicitation command for IPv6 hosts.
848On nomadic hosts like notebook computers, you may want to enable 775On nomadic hosts like notebook computers, you may want to enable
849.Sy rtsold 776.Sy rtsold
850as well. 777as well.
851Passes 778Passes
852.Sy rtsol_flags . 779.Sy rtsol_flags .
853This is only for autoconfigured IPv6 hosts, so set 780This is only for autoconfigured IPv6 hosts, so set
854.Sy ip6mode 781.Sy ip6mode
855to 782to
856.Dq Li autohost 783.Dq Li autohost
857if you use it. 784if you use it.
858.It Sy wpa_supplicant 785.It Sy wpa_supplicant
859.Sq YES 786Boolean value.
860or 
861.Sq NO . 
862Run 787Run
863.Xr wpa_supplicant 8 , 788.Xr wpa_supplicant 8 ,
864WPA/802.11i Supplicant for wireless network devices. 789WPA/802.11i Supplicant for wireless network devices.
865.El 790.El
866.Ss Daemons required by other daemons 791.Ss Daemons required by other daemons
867.Bl -tag -width net_interfaces 792.Bl -tag -width net_interfaces
868.It Sy inetd 793.It Sy inetd
869.Sq YES 794Boolean value.
870or 
871.Sq NO . 
872Runs the 795Runs the
873.Xr inetd 8 796.Xr inetd 8
874daemon to start network server processes (as listed in 797daemon to start network server processes (as listed in
875.Pa /etc/inetd.conf ) 798.Pa /etc/inetd.conf )
876as necessary. 799as necessary.
877Passes 800Passes
878.Sy inetd_flags . 801.Sy inetd_flags .
879The 802The
880.Dq Li -l 803.Dq Li -l
881flag turns on libwrap connection logging. 804flag turns on libwrap connection logging.
882.It Sy rpcbind 805.It Sy rpcbind
883.Sq YES 806Boolean value.
884or 
885.Sq NO . 
886The 807The
887.Xr rpcbind 8 808.Xr rpcbind 8
888daemon is required for any 809daemon is required for any
889.Xr rpc 3 810.Xr rpc 3
890services. 811services.
891These include NFS, 812These include NFS,
892.Tn NIS , 813.Tn NIS ,
893.Xr bootparamd 8 , 814.Xr bootparamd 8 ,
894.Xr rstatd 8 , 815.Xr rstatd 8 ,
895.Xr rusersd 8 , 816.Xr rusersd 8 ,
896and 817and
897.Xr rwalld 8 . 818.Xr rwalld 8 .
898Passes 819Passes
899.Sy rpcbind_flags . 820.Sy rpcbind_flags .
900.El 821.El
901.Ss Commonly used daemons 822.Ss Commonly used daemons
902.Bl -tag -width net_interfaces 823.Bl -tag -width net_interfaces
903.It Sy cron 824.It Sy cron
904.Sq YES 825Boolean value.
905or 
906.Sq NO . 
907Run 826Run
908.Xr cron 8 . 827.Xr cron 8 .
909.It Sy httpd 828.It Sy httpd
910.Sq YES 829Boolean value.
911or 
912.Sq NO . 
913Runs the 830Runs the
914.Xr httpd 8 831.Xr httpd 8
915daemon and passes 832daemon and passes
916.Sy httpd_flags . 833.Sy httpd_flags .
917.It Sy httpd_wwwdir 834.It Sy httpd_wwwdir
918A string. 835A string.
919The 836The
920.Xr httpd 8 837.Xr httpd 8
921WWW root directory. 838WWW root directory.
922Used only if 839Used only if
923.Sy httpd 840.Sy httpd
924is set to 841is true.
925.Sq YES . 
926The default setting is 842The default setting is
927.Dq Pa /var/www . 843.Dq Pa /var/www .
928.It Sy httpd_wwwuser 844.It Sy httpd_wwwuser
929A string. 845A string.
930If non-blank and 846If non-blank and
931.Sy httpd 847.Sy httpd
932is 848is true, run
933.Sq YES , 
934run 
935.Xr httpd 8 849.Xr httpd 8
936and cause it to switch to the specified user after initialization. 850and cause it to switch to the specified user after initialization.
937It is preferred to 851It is preferred to
938.Sy httpd_user 852.Sy httpd_user
939because 853because
940.Xr httpd 8 854.Xr httpd 8
941is requiring extra privileges to start listening on default port 80. 855is requiring extra privileges to start listening on default port 80.
942The default setting is 856The default setting is
943.Dq Dv _httpd . 857.Dq Dv _httpd .
944.It Sy lpd 858.It Sy lpd
945.Sq YES 859Boolean value.
946or 
947.Sq NO . 
948Runs 860Runs
949.Xr lpd 8 861.Xr lpd 8
950and passes 862and passes
951.Sy lpd_flags . 863.Sy lpd_flags .
952The 864The
953.Dq Li -l 865.Dq Li -l
954flag will turn on extra logging. 866flag will turn on extra logging.
955.It Sy named 867.It Sy named
956.Sq YES 868Boolean value.
957or 
958.Sq NO . 
959Runs 869Runs
960.Xr named 8 870.Xr named 8
961and passes 871and passes
962.Sy named_flags . 872.Sy named_flags .
963.It Sy named_chrootdir 873.It Sy named_chrootdir
964A string. 874A string.
965If non-blank and 875If non-blank and
966.Sy named 876.Sy named
967is 877is true, run
968.Sq YES , 
969run 
970.Xr named 8 878.Xr named 8
971as the unprivileged user and group 879as the unprivileged user and group
972.Sq named , 880.Sq named ,
973.Xr chroot 2 Ns ed 881.Xr chroot 2 Ns ed
974to 882to
975.Sy named_chrootdir . 883.Sy named_chrootdir .
976.Sy named_chrootdir Ns Pa /var/run/log 884.Sy named_chrootdir Ns Pa /var/run/log
977will be added to the list of log sockets that 885will be added to the list of log sockets that
978.Xr syslogd 8 886.Xr syslogd 8
979listens to. 887listens to.
980.It Sy ntpd 888.It Sy ntpd
981.Sq YES 889Boolean value.
982or 
983.Sq NO . 
984Runs 890Runs
985.Xr ntpd 8 891.Xr ntpd 8
986and passes 892and passes
987.Sy ntpd_flags . 893.Sy ntpd_flags .
988.It Sy ntpd_chrootdir 894.It Sy ntpd_chrootdir
989A string. 895A string.
990If non-blank and 896If non-blank and
991.Sy ntpd 897.Sy ntpd
992is 898is true, run
993.Sq YES , 
994run 
995.Xr ntpd 8 899.Xr ntpd 8
996as the unprivileged user and group 900as the unprivileged user and group
997.Sq ntpd , 901.Sq ntpd ,
998.Xr chroot 2 Ns ed 902.Xr chroot 2 Ns ed
999to 903to
1000.Sy ntpd_chrootdir . 904.Sy ntpd_chrootdir .
1001.Sy ntpd_chrootdir Ns Pa /var/run/log 905.Sy ntpd_chrootdir Ns Pa /var/run/log
1002will be added to the list of log sockets that 906will be added to the list of log sockets that
1003.Xr syslogd 8 907.Xr syslogd 8
1004listens to. 908listens to.
1005This option requires that the kernel has 909This option requires that the kernel has
1006.Dl pseudo-device clockctl 910.Dl pseudo-device clockctl
1007compiled in, and that 911compiled in, and that
1008.Pa /dev/clockctl 912.Pa /dev/clockctl
1009is present. 913is present.
1010.It Sy postfix 914.It Sy postfix
1011.Sq YES 915Boolean value.
1012or 
1013.Sq NO . 
1014Starts 916Starts
1015.Xr postfix 1 917.Xr postfix 1
1016mail system. 918mail system.
1017.It Sy sshd 919.It Sy sshd
1018.Sq YES 920Boolean value.
1019or 
1020.Sq NO . 
1021Runs 921Runs
1022.Xr sshd 8 922.Xr sshd 8
1023and passes 923and passes
1024.Sy sshd_flags . 924.Sy sshd_flags .
1025.It Sy syslogd 925.It Sy syslogd
1026.Sq YES 926Boolean value.
1027or 
1028.Sq NO . 
1029Runs 927Runs
1030.Xr syslogd 8 928.Xr syslogd 8
1031and passes 929and passes
1032.Sy syslogd_flags . 930.Sy syslogd_flags .
1033.It Sy timed 931.It Sy timed
1034.Sq YES 932Boolean value.
1035or 
1036.Sq NO . 
1037Runs 933Runs
1038.Xr timed 8 934.Xr timed 8
1039and passes 935and passes
1040.Sy timed_flags . 936.Sy timed_flags .
1041The 937The
1042.Dq Li -M 938.Dq Li -M
1043option allows 939option allows
1044.Xr timed 8 940.Xr timed 8
1045to be a master time source as well as a slave. 941to be a master time source as well as a slave.
1046If you are also running 942If you are also running
1047.Xr ntpd 8 , 943.Xr ntpd 8 ,
1048only one machine running both should have the 944only one machine running both should have the
1049.Dq Li -M 945.Dq Li -M
1050flag given to 946flag given to
1051.Xr timed 8 . 947.Xr timed 8 .
1052.El 948.El
1053.Ss Routing daemons 949.Ss Routing daemons
1054.Bl -tag -width net_interfaces 950.Bl -tag -width net_interfaces
1055.It Sy mrouted 951.It Sy mrouted
1056.Sq YES 952Boolean value.
1057or 
1058.Sq NO . 
1059Runs 953Runs
1060.Xr mrouted 8 , 954.Xr mrouted 8 ,
1061the DVMRP multicast routing protocol daemon. 955the DVMRP multicast routing protocol daemon.
1062Passes 956Passes
1063.Sy mrouted_flags . 957.Sy mrouted_flags .
1064.It Sy route6d 958.It Sy route6d
1065.Sq YES 959Boolean value.
1066or 
1067.Sq NO . 
1068Runs 960Runs
1069.Xr route6d 8 , 961.Xr route6d 8 ,
1070the RIPng routing protocol daemon for IPv6. 962the RIPng routing protocol daemon for IPv6.
1071Passes 963Passes
1072.Sy route6d_flags . 964.Sy route6d_flags .
1073.It Sy routed 965.It Sy routed
1074.Sq YES 966Boolean value.
1075or 
1076.Sq NO . 
1077Runs 967Runs
1078.Xr routed 8 , 968.Xr routed 8 ,
1079the RIP routing protocol daemon. 969the RIP routing protocol daemon.
1080Passes 970Passes
1081.Sy routed_flags . 971.Sy routed_flags .
1082.\" This should be 972.\" This should be false
1083.\" .Sq NO 
1084.\" if 973.\" if
1085.\" .Sy gated 974.\" .Sy gated
1086.\" is 975.\" is true.
1087.\" .Sq YES . 
1088.It Sy rtsold 976.It Sy rtsold
1089.Sq YES 977Boolean value.
1090or 
1091.Sq NO . 
1092Runs 978Runs
1093.Xr rtsold 8 , 979.Xr rtsold 8 ,
1094the IPv6 router solicitation daemon. 980the IPv6 router solicitation daemon.
1095.Xr rtsold 8 981.Xr rtsold 8
1096periodically transmits router solicitation packets 982periodically transmits router solicitation packets
1097to find IPv6 routers on the network. 983to find IPv6 routers on the network.
1098This configuration is mainly for nomadic hosts like notebook computers. 984This configuration is mainly for nomadic hosts like notebook computers.
1099Stationary hosts should work fine with just 985Stationary hosts should work fine with just
1100.Sy rtsol . 986.Sy rtsol .
1101Passes 987Passes
1102.Sy rtsold_flags . 988.Sy rtsold_flags .
1103This is only for autoconfigured IPv6 hosts, so set 989This is only for autoconfigured IPv6 hosts, so set
1104.Sy ip6mode 990.Sy ip6mode
1105to 991to
1106.Dq Li autohost 992.Dq Li autohost
1107if you use it. 993if you use it.
1108.El 994.El
1109.Ss Daemons used to boot other hosts over a network 995.Ss Daemons used to boot other hosts over a network
1110.Bl -tag -width net_interfaces 996.Bl -tag -width net_interfaces
1111.It Sy bootparamd 997.It Sy bootparamd
1112.Sq YES 998Boolean value.
1113or 
1114.Sq NO . 
1115Runs 999Runs
1116.Xr bootparamd 8 , 1000.Xr bootparamd 8 ,
1117the boot parameter server, with 1001the boot parameter server, with
1118.Sy bootparamd_flags 1002.Sy bootparamd_flags
1119as options. 1003as options.
1120Used to boot 1004Used to boot
1121.Nx 1005.Nx
1122and 1006and
1123.Tn "SunOS 4.x" 1007.Tn "SunOS 4.x"
1124systems. 1008systems.
1125.It Sy dhcpd 1009.It Sy dhcpd
1126.Sq YES 1010Boolean value.
1127or 
1128.Sq NO . 
1129Runs 1011Runs
1130.Xr dhcpd 8 , 1012.Xr dhcpd 8 ,
1131the Dynamic Host Configuration Protocol (DHCP) daemon, 1013the Dynamic Host Configuration Protocol (DHCP) daemon,
1132for assigning IP addresses to hosts and passing boot information. 1014for assigning IP addresses to hosts and passing boot information.
1133Passes 1015Passes
1134.Sy dhcpd_flags . 1016.Sy dhcpd_flags .
1135.It Sy dhcrelay 1017.It Sy dhcrelay
1136.Sq YES 1018Boolean value.
1137or 
1138.Sq NO . 
1139Runs 1019Runs
1140.Xr dhcrelay 8 . 1020.Xr dhcrelay 8 .
1141Passes 1021Passes
1142.Sy dhcrelay_flags . 1022.Sy dhcrelay_flags .
1143.It Sy mopd 1023.It Sy mopd
1144.Sq YES 1024Boolean value.
1145or 
1146.Sq NO . 
1147Runs 1025Runs
1148.Xr mopd 8 , 1026.Xr mopd 8 ,
1149the 1027the
1150.Tn DEC 1028.Tn DEC
1151.Tn MOP 1029.Tn MOP
1152protocol daemon; used for booting 1030protocol daemon; used for booting
1153.Tn VAX 1031.Tn VAX
1154and other 1032and other
1155.Tn DEC 1033.Tn DEC
1156machines. 1034machines.
1157Passes 1035Passes
1158.Sy mopd_flags . 1036.Sy mopd_flags .
1159.It Sy ndbootd 1037.It Sy ndbootd
1160.Sq YES 1038Boolean value.
1161or 
1162.Sq NO . 
1163Runs 1039Runs
1164.Xr ndbootd 8 , 1040.Xr ndbootd 8 ,
1165the Sun Network Disk (ND) Protocol server. 1041the Sun Network Disk (ND) Protocol server.
1166Passes 1042Passes
1167.Sy ndbootd_flags . 1043.Sy ndbootd_flags .
1168.It Sy rarpd 1044.It Sy rarpd
1169.Sq YES 1045Boolean value.
1170or 
1171.Sq NO . 
1172Runs 1046Runs
1173.Xr rarpd 8 , 1047.Xr rarpd 8 ,
1174the reverse ARP daemon, often used to boot 1048the reverse ARP daemon, often used to boot
1175.Nx 1049.Nx
1176and Sun workstations. 1050and Sun workstations.
1177Passes 1051Passes
1178.Sy rarpd_flags . 1052.Sy rarpd_flags .
1179.It Sy rbootd 1053.It Sy rbootd
1180.Sq YES 1054Boolean value.
1181or 
1182.Sq NO . 
1183Runs 1055Runs
1184.Xr rbootd 8 , 1056.Xr rbootd 8 ,
1185the 1057the
1186.Tn HP 1058.Tn HP
1187boot protocol daemon; used for booting 1059boot protocol daemon; used for booting
1188.Tn HP 1060.Tn HP
1189workstations. 1061workstations.
1190Passes 1062Passes
1191.Sy rbootd_flags . 1063.Sy rbootd_flags .
1192.It Sy rtadvd 1064.It Sy rtadvd
1193.Sq YES 1065Boolean value.
1194or 
1195.Sq NO . 
1196Runs 1066Runs
1197.Xr rtadvd 8 , 1067.Xr rtadvd 8 ,
1198the IPv6 router advertisement daemon, which is used to advertise 1068the IPv6 router advertisement daemon, which is used to advertise
1199information about the subnet to IPv6 end hosts. 1069information about the subnet to IPv6 end hosts.
1200Passes 1070Passes
1201.Sy rtadvd_flags . 1071.Sy rtadvd_flags .
1202This is only for IPv6 routers, so set 1072This is only for IPv6 routers, so set
1203.Sy ip6mode 1073.Sy ip6mode
1204to 1074to
1205.Dq Li router 1075.Dq Li router
1206if you use it. 1076if you use it.
1207.El 1077.El
1208.Ss X Window System daemons 1078.Ss X Window System daemons
1209.Bl -tag -width net_interfaces 1079.Bl -tag -width net_interfaces
1210.It Sy xdm 1080.It Sy xdm
1211.Sq YES 1081Boolean value.
1212or 
1213.Sq NO . 
1214Runs the 1082Runs the
1215.Xr xdm 1 1083.Xr xdm 1
1216X display manager. 1084X display manager.
1217These X daemons are available only with the optional X distribution of 1085These X daemons are available only with the optional X distribution of
1218.Nx . 1086.Nx .
1219.It Sy xfs 1087.It Sy xfs
1220.Sq YES 1088Boolean value.
1221or 
1222.Sq NO . 
1223Runs the 1089Runs the
1224.Xr xfs 1 1090.Xr xfs 1
1225X11 font server, which supplies local X font files to X terminals. 1091X11 font server, which supplies local X font files to X terminals.
1226.El 1092.El
1227.Ss NIS (YP) daemons 1093.Ss NIS (YP) daemons
1228.Bl -tag -width net_interfaces 1094.Bl -tag -width net_interfaces
1229.It Sy ypbind 1095.It Sy ypbind
1230.Sq YES 1096Boolean value.
1231or 
1232.Sq NO . 
1233Runs 1097Runs
1234.Xr ypbind 8 , 1098.Xr ypbind 8 ,
1235which lets 1099which lets
1236.Tn NIS 1100.Tn NIS
1237(YP) clients use information from a 1101(YP) clients use information from a
1238.Tn NIS 1102.Tn NIS
1239server. 1103server.
1240Passes 1104Passes
1241.Sy ypbind_flags . 1105.Sy ypbind_flags .
1242.It Sy yppasswdd 1106.It Sy yppasswdd
1243.Sq YES 1107Boolean value.
1244or 
1245.Sq NO . 
1246Runs 1108Runs
1247.Xr yppasswdd 8 , 1109.Xr yppasswdd 8 ,
1248which allows remote 1110which allows remote
1249.Tn NIS 1111.Tn NIS
1250users to update password on master server. 1112users to update password on master server.
1251Passes 1113Passes
1252.Sy yppasswdd_flags . 1114.Sy yppasswdd_flags .
1253.It Sy ypserv 1115.It Sy ypserv
1254.Sq YES 1116Boolean value.
1255or 
1256.Sq NO . 
1257Runs 1117Runs
1258.Xr ypserv 8 , 1118.Xr ypserv 8 ,
1259the 1119the
1260.Tn NIS 1120.Tn NIS
1261(YP) server for distributing information from certain files in 1121(YP) server for distributing information from certain files in
1262.Pa /etc . 1122.Pa /etc .
1263Passes 1123Passes
1264.Sy ypserv_flags . 1124.Sy ypserv_flags .
1265The 1125The
1266.Dq Li -d 1126.Dq Li -d
1267flag causes it to use DNS for lookups in 1127flag causes it to use DNS for lookups in
1268.Pa /etc/hosts 1128.Pa /etc/hosts
1269that fail. 1129that fail.
1270.El 1130.El
1271.Ss NFS daemons and parameters 1131.Ss NFS daemons and parameters
1272.Bl -tag -width net_interfaces 1132.Bl -tag -width net_interfaces
1273.It Sy amd 1133.It Sy amd
1274.Sq YES 1134Boolean value.
1275or 
1276.Sq NO . 
1277Runs 1135Runs
1278.Xr amd 8 , 1136.Xr amd 8 ,
1279the automounter daemon, which automatically mounts NFS file systems 1137the automounter daemon, which automatically mounts NFS file systems
1280whenever a file or directory within that file system is accessed. 1138whenever a file or directory within that file system is accessed.
1281Passes 1139Passes
1282.Sy amd_flags . 1140.Sy amd_flags .
1283.It Sy amd_dir 1141.It Sy amd_dir
1284A string. 1142A string.
1285The 1143The
1286.Xr amd 8 1144.Xr amd 8
1287mount directory. 1145mount directory.
1288Used only if 1146Used only if
1289.Sy amd 1147.Sy amd
1290is set to 1148is true.
1291.Sq YES . 
1292.It Sy lockd 1149.It Sy lockd
1293.Sq YES 1150Boolean value.
1294or 
1295.Sq NO . 
1296Runs 1151Runs
1297.Xr rpc.lockd 8 1152.Xr rpc.lockd 8
1298if 1153if
1299.Sy nfs_server 1154.Sy nfs_server
1300and/or 1155and/or
1301.Sy nfs_client 1156.Sy nfs_client
1302are set to 1157are true.
1303.Sq YES . 
1304Passes 1158Passes
1305.Sy lockd_flags . 1159.Sy lockd_flags .
1306.It Sy mountd 1160.It Sy mountd
1307.Sq YES 1161Boolean value.
1308or 
1309.Sq NO . 
1310Runs 1162Runs
1311.Xr mountd 8 1163.Xr mountd 8
1312and passes 1164and passes
1313.Sy mountd_flags . 1165.Sy mountd_flags .
1314.It Sy nfs_client 1166.It Sy nfs_client
1315.Sq YES 1167Boolean value.
1316or 
1317.Sq NO . 
1318The number of local NFS asynchronous I/O server is now controlled via 1168The number of local NFS asynchronous I/O server is now controlled via
1319.Xr sysctl 8 . 1169.Xr sysctl 8 .
1320.It Sy nfs_server 1170.It Sy nfs_server
1321.Sq YES 1171Boolean value.
1322or 
1323.Sq NO . 
1324Sets up a host to be a NFS server by running 1172Sets up a host to be a NFS server by running
1325.Xr nfsd 8 1173.Xr nfsd 8
1326and passing 1174and passing
1327.Sy nfsd_flags . 1175.Sy nfsd_flags .
1328.It Sy statd 1176.It Sy statd
1329.Sq YES 1177Boolean value.
1330or 
1331.Sq NO . 
1332Runs 1178Runs
1333.Xr rpc.statd 8 , 1179.Xr rpc.statd 8 ,
1334a status monitoring daemon used when 1180a status monitoring daemon used when
1335.Xr rpc.lockd 8 1181.Xr rpc.lockd 8
1336is running, if 1182is running, if
1337.Sy nfs_server 1183.Sy nfs_server
1338and/or 1184and/or
1339.Sy nfs_client 1185.Sy nfs_client
1340are set to 1186are true.
1341.Sq YES . 
1342Passes 1187Passes
1343.Sy statd_flags . 1188.Sy statd_flags .
1344.El 1189.El
1345.Ss Bluetooth configuration and daemons 1190.Ss Bluetooth configuration and daemons
1346.Bl -tag -width net_interfaces 1191.Bl -tag -width net_interfaces
1347.It Sy btattach 1192.It Sy btattach
1348.Sq YES 1193Boolean value.
1349or 
1350.Sq NO . 
1351Attach serial bluetooth interfaces as listed in the configuration file 1194Attach serial bluetooth interfaces as listed in the configuration file
1352.Pa /etc/bluetooth/btdevctl.conf . 1195.Pa /etc/bluetooth/btdevctl.conf .
1353.It Sy btconfig 1196.It Sy btconfig
1354.Sq YES 1197Boolean value.
1355or 
1356.Sq NO . 
1357Configure bluetooth devices. 1198Configure bluetooth devices.
1358If the 1199If the
1359.Sy btconfig_devices 1200.Sy btconfig_devices
1360variable below is not specified, all devices known to the system 1201variable below is not specified, all devices known to the system
1361will be configured. 1202will be configured.
1362For each device, configuration arguments are first looked for 1203For each device, configuration arguments are first looked for
1363in the 1204in the
1364.Sy btconfig_{dev} 1205.Sy btconfig_{dev}
1365variable, otherwise the value of the 1206variable, otherwise the value of the
1366.Sy btconfig_args 1207.Sy btconfig_args
1367variable will be used, and if that is not specified the default string is 1208variable will be used, and if that is not specified the default string is
1368.Sq enable . 1209.Sq enable .
1369.It Sy btconfig_devices 1210.It Sy btconfig_devices
1370An optional space separated list of bluetooth devices to be configured at 1211An optional space separated list of bluetooth devices to be configured at
1371boot time. 1212boot time.
1372.It Sy btconfig_args 1213.It Sy btconfig_args
1373An optional string, containing default arguments for bluetooth devices to 1214An optional string, containing default arguments for bluetooth devices to
1374be configured. 1215be configured.
1375.It Sy btdevctl 1216.It Sy btdevctl
1376.Sq YES 1217Boolean value.
1377or 
1378.Sq NO . 
1379Configure Bluetooth devices as listed in the configuration file 1218Configure Bluetooth devices as listed in the configuration file
1380.Pa /etc/bluetooth/btdevctl.conf . 1219.Pa /etc/bluetooth/btdevctl.conf .
1381.It Sy bthcid 1220.It Sy bthcid
1382.Sq YES 1221Boolean value.
1383or 
1384.Sq NO . 
1385Runs 1222Runs
1386.Xr bthcid 8 , 1223.Xr bthcid 8 ,
1387the Bluetooth HCI daemon, which manages link keys and PIN codes for 1224the Bluetooth HCI daemon, which manages link keys and PIN codes for
1388Bluetooth links. 1225Bluetooth links.
1389Passes 1226Passes
1390.Sy bthcid_flags . 1227.Sy bthcid_flags .
1391.It Sy sdpd 1228.It Sy sdpd
1392.Sq YES 1229Boolean value.
1393or 
1394.Sq NO . 
1395Runs the Service Discovery Profile daemon, 1230Runs the Service Discovery Profile daemon,
1396.Xr sdpd 8 . 1231.Xr sdpd 8 .
1397Passes 1232Passes
1398.Sy sdpd_flags . 1233.Sy sdpd_flags .
1399.El 1234.El
1400.Ss Other daemons 1235.Ss Other daemons
1401.Bl -tag -width net_interfaces 1236.Bl -tag -width net_interfaces
1402.It Sy isdnd 1237.It Sy isdnd
1403.Sq YES 1238Boolean value.
1404or 
1405.Sq NO . 
1406Runs 1239Runs
1407.Xr isdnd 8 , 1240.Xr isdnd 8 ,
1408the isdn4bsd ISDN connection management daemon. 1241the isdn4bsd ISDN connection management daemon.
1409Passes 1242Passes
1410.Sy isdnd_flags . 1243.Sy isdnd_flags .
1411.It Sy isdn_autoupdown 1244.It Sy isdn_autoupdown
1412.Sq YES 1245Boolean value.
1413or 
1414.Sq NO . 
1415Set all configured ISDN interfaces to 1246Set all configured ISDN interfaces to
1416.Dq up . 1247.Dq up .
1417If 1248If
1418.Sy isdn_interfaces 1249.Sy isdn_interfaces
1419is not blank, only the listed interfaces will be modified. 1250is not blank, only the listed interfaces will be modified.
1420Used only if 1251Used only if
1421.Sy isdnd 1252.Sy isdnd
1422is set to 1253is true.
1423.Sq YES . 
1424.It Sy kdc 1254.It Sy kdc
1425.Sq YES 1255Boolean value.
1426or 
1427.Sq NO . 
1428Runs the 1256Runs the
1429.Xr kdc 8 1257.Xr kdc 8
1430Kerberos v4 and v5 server. 1258Kerberos v4 and v5 server.
1431This should be run on Kerberos master and slave servers. 1259This should be run on Kerberos master and slave servers.
1432.It Sy rwhod 1260.It Sy rwhod
1433.Sq YES 1261Boolean value.
1434or 
1435.Sq NO . 
1436Runs 1262Runs
1437.Xr rwhod 8 1263.Xr rwhod 8
1438to support the 1264to support the
1439.Xr rwho 1 1265.Xr rwho 1
1440and 1266and
1441.Xr ruptime 1 1267.Xr ruptime 1
1442commands. 1268commands.
1443.El 1269.El
1444.Ss Hardware daemons 1270.Ss Hardware daemons
1445.Bl -tag -width net_interfaces 1271.Bl -tag -width net_interfaces
1446.It Sy apmd 1272.It Sy apmd
1447.Sq YES 1273Boolean value.
1448or 
1449.Sq NO . 
1450Runs 1274Runs
1451.Xr apmd 8 1275.Xr apmd 8
1452and passes 1276and passes
1453.Sy apmd_flags . 1277.Sy apmd_flags .
1454.It Sy irdaattach 1278.It Sy irdaattach
1455.Sq YES 1279Boolean value.
1456or 
1457.Sq NO . 
1458Runs 1280Runs
1459.Xr irdaattach 8 1281.Xr irdaattach 8
1460and passes 1282and passes
1461.Sy irdaattach_flags . 1283.Sy irdaattach_flags .
1462.It Sy moused 1284.It Sy moused
1463.Sq YES 1285Boolean value.
1464or 
1465.Sq NO . 
1466Runs 1286Runs
1467.Xr moused 8 , 1287.Xr moused 8 ,
1468to pass serial mouse data to the wscons mouse mux. 1288to pass serial mouse data to the wscons mouse mux.
1469Passes 1289Passes
1470.Sy moused_flags . 1290.Sy moused_flags .
1471.It Sy screenblank 1291.It Sy screenblank
1472.Sq YES 1292Boolean value.
1473or 
1474.Sq NO . 
1475Runs 1293Runs
1476.Xr screenblank 1 1294.Xr screenblank 1
1477and passes 1295and passes
1478.Sy screenblank_flags . 1296.Sy screenblank_flags .
1479.It Sy wscons 1297.It Sy wscons
1480.Sq YES 1298Boolean value.
1481or 
1482.Sq NO . 
1483Configures the 1299Configures the
1484.Xr wscons 4 1300.Xr wscons 4
1485console driver, from the configuration file 1301console driver, from the configuration file
1486.Pa /etc/wscons.conf . 1302.Pa /etc/wscons.conf .
1487.It Sy wsmoused 1303.It Sy wsmoused
1488.Sq YES 1304Boolean value.
1489or 
1490.Sq NO . 
1491Runs 1305Runs
1492.Xr wsmoused 8 , 1306.Xr wsmoused 8 ,
1493to provide copy and paste text support in wscons displays. 1307to provide copy and paste text support in wscons displays.
1494Passes 1308Passes
1495.Sy wsmoused_flags . 1309.Sy wsmoused_flags .
1496.El 1310.El
1497.Sh FILES 1311.Sh FILES
1498.Bl -tag -width /etc/defaults/rc.conf -compact 1312.Bl -tag -width /etc/defaults/rc.conf -compact
1499.It Pa /etc/rc.conf 1313.It Pa /etc/rc.conf
1500The file 1314The file
1501.Nm 1315.Nm
1502resides in 1316resides in
1503.Pa /etc . 1317.Pa /etc .