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