xref: /netbsd-src/share/man/man5/rc.conf.5 (revision 4b896b232495b7a9b8b94a1cf1e21873296d53b8)
1.\"	$NetBSD: rc.conf.5,v 1.88 2004/01/15 09:14:54 jmmv 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 January 15, 2004
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 network route.
170If empty or not set, then the contents of
171.Pa /etc/mygate
172(if it exists) are used.
173.It Sy domainname
174A string.
175.Tn NIS
176(YP) domain of host.
177If empty or not set, then the contents of
178.Pa /etc/defaultdomain
179(if it exists) are used.
180.It Sy force_down_interfaces
181A space separated list of interface names.
182These interfaces will be configured down when going from multiuser to singleuser
183mode or on system shutdown.
184.Pp
185This is important for some stateful interfaces, for example PPP over ISDN
186connections that cost money by connection time or PPPoE interfaces which
187have no direct means of noticing
188.Dq disconnect
189events.
190.Pp
191All active
192.Xr pppoe 4
193and
194.Xr ippp 4
195interfaces will be automatically added to this list.
196.It Sy hostname
197A string.
198Name of host.
199If empty or not set, then the contents of
200.Pa /etc/myname
201(if it exists) are used.
202.El
203.Ss Boottime file-system and swap configuration
204.Bl -tag -width net_interfaces
205.It Sy critical_filesystems_local
206A string.
207File systems mounted very early in the system boot before networking
208services are available.
209Usually
210.Pa /var
211is part of this, because it is needed by services such as
212.Xr dhclient 8
213which may be required to get the network operational.
214.It Sy critical_filesystems_remote
215A string.
216File systems such as
217.Pa /usr
218that may require network services to be available to mount,
219that must be available early in the system boot for general services to use.
220.It Sy fsck_flags
221A string.
222A file system is checked with
223.Xr fsck 8
224during boot before mounting it.
225This option may be used to override the default command-line options
226passed to the
227.Xr fsck 8
228program.
229.Pp
230When set to
231.Fl y ,
232.Xr fsck 8
233assumes yes as the answer to all operator questions during file system checks.
234This might be important with hosts where the administrator does not have
235access to the console and an unsuccessful shutdown must not make the host
236unbootable even if the file system checks would fail in preen mode.
237.It Sy no_swap
238.Sq YES
239or
240.Sq NO .
241Set the
242.Sy no_swap
243variable to
244.Sq YES
245if you have configured your system with no swap on purpose.
246If not set to
247.Sq YES ,
248and no swap devices
249are configured, the system will warn you.
250.It Sy swapoff
251.Sq YES
252or
253.Sq NO .
254Remove block-type swap devices at shutdown time.
255Useful if swapping onto RAIDframe devices.
256.El
257.Ss One-time actions to perform or programs to run on boot-up
258.Bl -tag -width net_interfaces
259.It Sy accounting
260.Sq YES
261or
262.Sq NO .
263Enables process accounting with
264.Xr accton 8 .
265Requires
266.Pa /var/account/acct
267to exist.
268.It Sy clear_tmp
269.Sq YES
270or
271.Sq NO .
272Clear /tmp after reboot.
273.It Sy dmesg
274.Sq YES
275or
276.Sq NO .
277Create
278.Pa /var/run/dmesg.boot
279from the output of
280.Xr dmesg 8 .
281Passes
282.Sy dmesg_flags .
283.It Sy lkm
284.Sq YES
285or
286.Sq NO .
287Runs
288.Pa /etc/rc.lkm .
289.It Sy mixerctl
290.Sq YES
291or
292.Sq NO .
293Read
294.Xr mixerctl.conf 5
295for how to set mixer values.
296List in
297.Sy mixerctl_mixers
298the devices whose settings are to be saved at shutdown and
299restored at start-up.
300.It Sy newsyslog
301.Sq YES
302or
303.Sq NO .
304Run
305.Nm newsyslog
306to trim logfiles before syslogd starts.
307Intended for laptop users.
308Passes
309.Sy newsyslog_flags .
310.It Sy savecore
311.Sq YES
312or
313.Sq NO .
314Runs the
315.Xr savecore 8
316utility.
317Passes
318.Sy savecore_flags .
319.It Sy tpctl
320.Sq YES
321or
322.Sq NO .
323Run
324.Xr tpctl 8
325to calibrate touch panel device.
326Passes
327.Sy tpctl_flags .
328.It Sy update_motd
329.Sq YES
330or
331.Sq NO .
332Updates the
333.Nx
334version string in the
335.Pa /etc/motd
336file to reflect the version of the running kernel.
337See
338.Xr motd 5 .
339.It Sy veriexec
340.Sq YES
341or
342.Sq NO .
343Load verified exec fingerprints during startup.
344Read
345.Xr veriexecctl 8
346for more information.
347.It Sy virecover
348.Sq YES
349or
350.Sq NO .
351Send notification mail to users if any recoverable files exist in
352.Pa /var/tmp/vi.recover .
353See
354.Fl r
355option in
356.Xr vi 1
357for details.
358.El
359.Ss System security setting
360.Bl -tag -width net_interfaces
361.It Sy securelevel
362A number.
363The system securelevel is set to the specified value early
364in the boot process, before any external logins, or other programs
365that run users job, are started.
366If set to nothing, the default action is taken, as described in
367.Xr init 8 ,
368which contains definitive information about the system securelevel.
369Note that setting
370.Sy securelevel
371to 0 in
372.Nm
373will actually result in the system booting with securelevel set to 1, as
374.Xr init 8
375will raise the level when
376.Xr rc 8
377completes.
378.El
379.Ss Networking startup
380.Bl -tag -width net_interfaces
381.It Sy altqd
382.Sq YES
383or
384.Sq NO .
385ALTQ configuration/monitoring daemon.
386Passes
387.Sy altqd_flags .
388.It Sy auto_ifconfig
389.Sq YES
390or
391.Sq NO .
392Sets the
393.Sy net_interfaces
394variable (see below) to the output of
395.Xr ifconfig 8
396with the
397.Dq Li -l
398flag and suppresses warnings about interfaces in this list that
399do not have an ifconfig file or variable.
400.It Sy dhclient
401.Sq YES
402or
403.Sq NO .
404Set to
405.Sq YES
406to configure some or all network interfaces using
407the DHCP client.
408If you set
409.Sy dhclient
410to
411.Sq YES ,
412you must either have
413.Pa /var
414in
415.Sy critical_filesystems_local ,
416as part of
417.Pa / ,
418or direct the DHCP client to store the leases file on the root
419file system by modifying the
420.Sy dhclient_flags
421variable.
422You must not provide ifconfig information or ifaliases
423information for any interface that is to be configured using the DHCP client.
424Interface aliases can be set up in the DHCP client configuration
425file if needed - see
426.Xr dhclient.conf 5
427for details.
428.Pp
429Passes
430.Sy dhclient_flags
431to the DHCP client.
432See
433.Xr dhclient 8
434for complete documentation.
435If you wish to configure all broadcast
436network interfaces using the DHCP client, you can leave this blank.
437To configure only specific interfaces, name the interfaces to be configured
438on the command line.
439.Pp
440If you must run the DHCP client before mounting critical file systems,
441then you should specify an alternate location for the DHCP client's lease
442file in the
443.Sy dhclient_flags
444variable - for example, "-lf /tmp/dhclient.leases".
445.It Sy flushroutes
446.Sq YES
447or
448.Sq NO .
449Flushes the route table on networking startup.
450Useful when coming up to multiuser mode after going down to
451single-user mode.
452.It Sy ifaliases_*
453A string.
454List of
455.Sq Em "address netmask"
456pairs to configure additional network addresses for the given
457configured interface
458.Dq *
459(e.g.
460.Sy ifaliases_le0 ) .
461If
462.Em netmask
463is
464.Dq - ,
465then use the default netmask for the interface.
466.Pp
467.Sy ifaliases_*
468covers limited cases only and considered unrecommended.
469We recommend using
470.Pa /etc/ifconfig.xxN
471with multiple lines instead.
472.It Sy ifwatchd
473.Sq YES
474or
475.Sq NO .
476Monitor dynamic interfaces and perform actions upon address changes.
477Passes
478.Sy ifwatchd_flags .
479.It Sy ip6mode
480A string.
481An IPv6 node can be a router
482.Pq nodes that forward packet for others
483or a host
484.Pq nodes that do not forward .
485A host can be autoconfigured
486based on the information advertised by adjacent IPv6 routers.
487By setting
488.Sy ip6mode
489to
490.Dq Li router ,
491.Dq Li host ,
492or
493.Dq Li autohost ,
494you can configure your node as a router,
495a non-autoconfigured host, or an autoconfigured host.
496Invalid values will be ignored, and the node will be configured as
497a non-autoconfigured host.
498You may want to check
499.Sy rtsol
500and
501.Sy rtsold
502as well, if you set the variable to
503.Dq Li autohost .
504.It Sy ip6sitelocal
505.Sq YES
506or
507.Sq NO .
508If you intend to use IPv6 site-local addresses in your site, set it to
509.Sq YES .
510Otherwise, reject routes will get installed on boot to avoid misconfiguration
511relating to site-local addresses.
512.It Sy ipfilter
513.Sq YES
514or
515.Sq NO .
516Runs
517.Xr ipf 8
518to load in packet filter specifications from
519.Pa /etc/ipf.conf
520at network boot time, before any interfaces are configured.
521See
522.Xr ipf.conf 5 .
523.It Sy ipfs
524.Sq YES
525or
526.Sq NO .
527Runs
528.Xr ipfs 8
529to save and restore information for ipnat and ipfilter state tables.
530The information is stored in
531.Pa /var/db/ipf/ipstate.ipf
532and
533.Pa /var/db/ipf/ipnat.ipf .
534Passes
535.Sy ipfs_flags .
536.It Sy ipmon
537.Sq YES
538or
539.Sq NO .
540Runs
541.Xr ipmon 8
542to read
543.Xr ipf 8
544packet log information and log it to a file or the system log.
545Passes
546.Sy ipmon_flags .
547.It Sy ipmon_flags
548A string.
549Specifies arguments to supply to
550.Xr ipmon 8 .
551Defaults to
552.Dq Li -ns .
553A typical example would be
554.Dq Fl nD Pa /var/log/ipflog
555to have
556.Xr ipmon 8
557log directly to a file bypassing
558.Xr syslogd 8 .
559If the
560.Dq -D
561argument is used, remember to modify
562.Pa /etc/newsyslog.conf
563accordingly; for example:
564.Bd -literal
565/var/log/ipflog  640  10  100  *  Z  /var/run/ipmon.pid
566.Ed
567.It Sy ipnat
568.Sq YES
569or
570.Sq NO .
571Runs
572.Xr ipnat 8
573to load in the IP network address translation (NAT) rules from
574.Pa /etc/ipnat.conf
575at network boot time, before any interfaces are configured.
576See
577.Xr ipnat.conf 5 .
578.It Sy ipsec
579.Sq YES
580or
581.Sq NO .
582Runs
583.Xr setkey 8
584to load in IPsec manual keys and policies from
585.Pa /etc/ipsec.conf
586at network boot time, before any interfaces are configured.
587.It Sy net_interfaces
588A string.
589The list of network interfaces to be configured at boot time.
590For each interface "xxN", the system first looks for ifconfig
591parameters in
592.Pa /etc/ifconfig.xxN
593and then in the variable
594.Sy ifconfig_xxN .
595The contents of the file or the variable are handed to ifconfig
596after the interface name.
597If
598.Sy auto_ifconfig
599is set to "NO" and neither the file nor the variable is found,
600a warning is printed.
601Refer to
602.Xr ifconfig.if 5
603for more details on
604.Pa /etc/ifconfig.xxN .
605.It Sy ntpdate
606.Sq YES
607or
608.Sq NO .
609Runs
610.Xr ntpdate 8
611to set the system time from one of the hosts in
612.Sy ntpdate_hosts .
613If
614.Sy ntpdate_hosts
615is empty, it will attempt to find a list of hosts in
616.Pa /etc/ntp.conf .
617Passes
618.Sy ntpdate_flags .
619.It Sy ppp_peers
620A string.
621If
622.Sy ppp_peers
623is not empty, then
624.Pa /etc/rc.d/ppp
625will check each word in
626.Sy ppp_peers
627for a corresponding ppp configuration file in
628.Pa /etc/ppp/peers
629and will call
630.Xr pppd 8
631with the
632.Dq call Sy peer
633option.
634.It Sy racoon
635.Sq YES
636or
637.Sq NO .
638Runs
639.Xr racoon 8 ,
640the IKE (ISAKMP/Oakley) key management daemon.
641.It Sy rtsol
642.Sq YES
643or
644.Sq NO .
645Run
646.Xr rtsol 8 ,
647router solicitation command for IPv6 hosts.
648On nomadic hosts like notebook computers, you may want to enable
649.Sy rtsold
650as well.
651Passes
652.Sy rtsol_flags .
653This is only for autoconfigured IPv6 hosts, so set
654.Sy ip6mode
655to
656.Dq Li autohost
657if you use it.
658.El
659.Ss Daemons required by other daemons
660.Bl -tag -width net_interfaces
661.It Sy inetd
662.Sq YES
663or
664.Sq NO .
665Runs the
666.Xr inetd 8
667daemon to start network server processes (as listed in
668.Pa /etc/inetd.conf )
669as necessary.
670Passes
671.Sy inetd_flags .
672The
673.Dq Li -l
674flag turns on libwrap connection logging.
675.It Sy rpcbind
676.Sq YES
677or
678.Sq NO .
679The
680.Xr rpcbind 8
681daemon is required for any
682.Xr rpc 3
683services.
684These include NFS,
685.Tn NIS ,
686.Xr bootparamd 8 ,
687.Xr rstatd 8 ,
688.Xr rusersd 8 ,
689and
690.Xr rwalld 8 .
691Passes
692.Sy rpcbind_flags .
693.El
694.Ss Commonly used daemons
695.Bl -tag -width net_interfaces
696.It Sy cron
697.Sq YES
698or
699.Sq NO .
700Run
701.Xr cron 8 .
702.It Sy lpd
703.Sq YES
704or
705.Sq NO .
706Runs
707.Xr lpd 8
708and passes
709.Sy lpd_flags .
710The
711.Dq Li -l
712flag will turn on extra logging.
713.It Sy named
714.Sq YES
715or
716.Sq NO .
717Runs
718.Xr named 8
719and passes
720.Sy named_flags .
721.It Sy named_chrootdir
722A string.
723If non-blank and
724.Sy named
725is
726.Sq YES ,
727run
728.Xr named 8
729as the unprivileged user and group
730.Sq named ,
731.Xr chroot 2 Ns ed
732to
733.Sy named_chrootdir .
734.Sy named_chrootdir Ns Pa /var/run/log
735will be added to the list of log sockets that
736.Xr syslogd 8
737listens to.
738.It Sy ntpd
739.Sq YES
740or
741.Sq NO .
742Runs
743.Xr ntpd 8
744and passes
745.Sy ntpd_flags .
746.It Sy ntpd_chrootdir
747A string.
748If non-blank and
749.Sy ntpd
750is
751.Sq YES ,
752run
753.Xr ntpd 8
754as the unprivileged user and group
755.Sq ntpd ,
756.Xr chroot 2 Ns ed
757to
758.Sy ntpd_chrootdir .
759.Sy ntpd_chrootdir Ns Pa /var/run/log
760will be added to the list of log sockets that
761.Xr syslogd 8
762listens to.
763This option requires that the kernel has
764.Dl pseudo-device clockctl
765compiled in, and that
766.Pa /dev/clockctl
767is present.
768.It Sy postfix
769.Sq YES
770or
771.Sq NO .
772Starts
773.Xr postfix 1
774mail system.
775.It Sy sendmail
776.Sq YES
777or
778.Sq NO .
779Runs
780.Xr sendmail 8
781and passes
782.Sy sendmail_flags .
783.It Sy sendmail_suidroot
784.Sq YES
785or
786.Sq NO .
787Asserts that sendmail is being used as a setuid root binary and adjusts
788some precmd checks accordingly.
789If this is set to
790.Sq YES ,
791you can remove the submit.cf file, and then turn off the
792.Sy smmsp
793process.
794.It Sy smmsp
795.Sq YES
796or
797.Sq NO .
798Runs
799.Xr sendmail 8
800as a client queue runner and passes
801.Sy smmsp_flags .
802Note that the smmsp process is not a full-featured SMTP daemon.
803Its main purpose is to flush locally collected mail from the queue, but
804it can also be used as a non-privileged
805.Dq nullclient
806that forwards to a more functional SMTP gateway.
807.It Sy sshd
808.Sq YES
809or
810.Sq NO .
811Runs
812.Xr sshd 8
813and passes
814.Sy sshd_flags .
815.It Sy syslogd
816.Sq YES
817or
818.Sq NO .
819Runs
820.Xr syslogd 8
821and passes
822.Sy syslogd_flags .
823.It Sy timed
824.Sq YES
825or
826.Sq NO .
827Runs
828.Xr timed 8
829and passes
830.Sy timed_flags .
831The
832.Dq Li -M
833option allows
834.Xr timed 8
835to be a master time source as well as a slave.
836If you are also running
837.Xr ntpd 8 ,
838only one machine running both should have the
839.Dq Li -M
840flag given to
841.Xr timed 8 .
842.El
843.Ss Routing daemons
844.Bl -tag -width net_interfaces
845.It Sy mrouted
846.Sq YES
847or
848.Sq NO .
849Runs
850.Xr mrouted 8 ,
851the DVMRP multicast routing protocol daemon.
852Passes
853.Sy mrouted_flags .
854.It Sy route6d
855.Sq YES
856or
857.Sq NO .
858Runs
859.Xr route6d 8 ,
860the RIPng routing protocol daemon for IPv6.
861Passes
862.Sy route6d_flags .
863.It Sy routed
864.Sq YES
865or
866.Sq NO .
867Runs
868.Xr routed 8 ,
869the RIP routing protocol daemon.
870Passes
871.Sy routed_flags .
872.\" This should be
873.\" .Sq NO
874.\" if
875.\" .Sy gated
876.\" is
877.\" .Sq YES .
878.It Sy rtsold
879.Sq YES
880or
881.Sq NO .
882Runs
883.Xr rtsold 8 ,
884the IPv6 router solicitation daemon.
885.Xr rtsold 8
886periodically transmits router solicitation packets
887to find IPv6 routers on the network.
888This configuration is mainly for nomadic hosts like notebook computers.
889Stationary hosts should work fine with just
890.Sy rtsol .
891Passes
892.Sy rtsold_flags .
893This is only for autoconfigured IPv6 hosts, so set
894.Sy ip6mode
895to
896.Dq Li autohost
897if you use it.
898.El
899.Ss Daemons used to boot other hosts over a network
900.Bl -tag -width net_interfaces
901.It Sy bootparamd
902.Sq YES
903or
904.Sq NO .
905Runs
906.Xr bootparamd 8 ,
907the boot parameter server, with
908.Sy bootparamd_flags
909as options.
910Used to boot
911.Nx
912and
913.Tn "SunOS 4.x"
914systems.
915.It Sy dhcpd
916.Sq YES
917or
918.Sq NO .
919Runs
920.Xr dhcpd 8 ,
921the Dynamic Host Configuration Protocol (DHCP) daemon,
922for assigning IP addresses to hosts and passing boot information.
923Passes
924.Sy dhcpd_flags .
925.It Sy dhcrelay
926.Sq YES
927or
928.Sq NO .
929Runs
930.Xr dhcrelay 8 .
931Passes
932.Sy dhcrelay_flags .
933.It Sy mopd
934.Sq YES
935or
936.Sq NO .
937Runs
938.Xr mopd 8 ,
939the
940.Tn DEC
941.Tn MOP
942protocol daemon; used for booting
943.Tn VAX
944and other
945.Tn DEC
946machines.
947Passes
948.Sy mopd_flags .
949.It Sy ndbootd
950.Sq YES
951or
952.Sq NO .
953Runs
954.Xr ndbootd 8 ,
955the Sun Network Disk (ND) Protocol server.
956Passes
957.Sy ndbootd_flags .
958.It Sy rarpd
959.Sq YES
960or
961.Sq NO .
962Runs
963.Xr rarpd 8 ,
964the reverse ARP daemon, often used to boot
965.Nx
966and Sun workstations.
967Passes
968.Sy rarpd_flags .
969.It Sy rbootd
970.Sq YES
971or
972.Sq NO .
973Runs
974.Xr rbootd 8 ,
975the
976.Tn HP
977boot protocol daemon; used for booting
978.Tn HP
979workstations.
980Passes
981.Sy rbootd_flags .
982.It Sy rtadvd
983.Sq YES
984or
985.Sq NO .
986Runs
987.Xr rtadvd 8 ,
988the IPv6 router advertisement daemon, which is used to advertise
989information about the subnet to IPv6 end hosts.
990Passes
991.Sy rtadvd_flags .
992This is only for IPv6 routers, so set
993.Sy ip6mode
994to
995.Dq Li router
996if you use it.
997.El
998.Ss X Window System daemons
999.Bl -tag -width net_interfaces
1000.It Sy xdm
1001.Sq YES
1002or
1003.Sq NO .
1004Runs the
1005.Xr xdm 1
1006X display manager.
1007These X daemons are available only with the optional X distribution of
1008.Nx .
1009.It Sy xfs
1010.Sq YES
1011or
1012.Sq NO .
1013Runs the
1014.Xr xfs 1
1015X11 font server, which supplies local X font files to X terminals.
1016.El
1017.Ss NIS (YP) daemons
1018.Bl -tag -width net_interfaces
1019.It Sy ypbind
1020.Sq YES
1021or
1022.Sq NO .
1023Runs
1024.Xr ypbind 8 ,
1025which lets
1026.Tn NIS
1027(YP) clients use information from a
1028.Tn NIS
1029server.
1030Passes
1031.Sy ypbind_flags .
1032.It Sy yppasswdd
1033.Sq YES
1034or
1035.Sq NO .
1036Runs
1037.Xr yppasswdd 8 ,
1038which allows remote
1039.Tn NIS
1040users to update password on master server.
1041Passes
1042.Sy yppasswdd_flags .
1043.It Sy ypserv
1044.Sq YES
1045or
1046.Sq NO .
1047Runs
1048.Xr ypserv 8 ,
1049the
1050.Tn NIS
1051(YP) server for distributing information from certain files in
1052.Pa /etc .
1053Passes
1054.Sy ypserv_flags .
1055The
1056.Dq Li -d
1057flag causes it to use DNS for lookups in
1058.Pa /etc/hosts
1059that fail.
1060.El
1061.Ss NFS daemons and parameters
1062.Bl -tag -width net_interfaces
1063.It Sy amd
1064.Sq YES
1065or
1066.Sq NO .
1067Runs
1068.Xr amd 8 ,
1069the automounter daemon, which automatically mounts NFS file systems
1070whenever a file or directory within that file system is accessed.
1071Passes
1072.Sy amd_flags .
1073.It Sy amd_dir
1074A string.
1075The
1076.Xr amd 8
1077mount directory.
1078Used only if
1079.Sy amd
1080is set to
1081.Sq YES .
1082.It Sy lockd
1083.Sq YES
1084or
1085.Sq NO .
1086Runs
1087.Xr rpc.lockd 8
1088if
1089.Sy nfs_server
1090and/or
1091.Sy nfs_client
1092are set to
1093.Sq YES .
1094Passes
1095.Sy lockd_flags .
1096.It Sy mountd
1097.Sq YES
1098or
1099.Sq NO .
1100Runs
1101.Xr mountd 8
1102and passes
1103.Sy mountd_flags .
1104.It Sy nfs_client
1105.Sq YES
1106or
1107.Sq NO .
1108The number of local NFS asynchronous I/O server is now controlled via
1109.Xr sysctl 8 .
1110.It Sy nfs_server
1111.Sq YES
1112or
1113.Sq NO .
1114Sets up a host to be a NFS server by running
1115.Xr nfsd 8
1116and passing
1117.Sy nfsd_flags .
1118.It Sy statd
1119.Sq YES
1120or
1121.Sq NO .
1122Runs
1123.Xr rpc.statd 8 ,
1124a status monitoring daemon used when
1125.Xr rpc.lockd 8
1126is running, if
1127.Sy nfs_server
1128and/or
1129.Sy nfs_client
1130are set to
1131.Sq YES .
1132Passes
1133.Sy statd_flags .
1134.El
1135.Ss Other daemons
1136.Bl -tag -width net_interfaces
1137.It Sy isdnd
1138.Sq YES
1139or
1140.Sq NO .
1141Runs
1142.Xr isdnd 8 ,
1143the isdn4bsd ISDN connection management daemon.
1144Passes
1145.Sy isdnd_flags .
1146.It Sy isdn_autoupdown
1147.Sq YES
1148or
1149.Sq NO .
1150Set all configured ISDN interfaces to
1151.Dq up .
1152If
1153.Sy isdn_interfaces
1154is not blank, only the listed interfaces will be modified.
1155Used only if
1156.Sy isdnd
1157is set to
1158.Sq YES .
1159.It Sy kdc
1160.Sq YES
1161or
1162.Sq NO .
1163Runs the
1164.Xr kdc 8
1165Kerberos v4 and v5 server.
1166This should be run on Kerberos master and slave servers.
1167.It Sy rwhod
1168.Sq YES
1169or
1170.Sq NO .
1171Runs
1172.Xr rwhod 8
1173to support the
1174.Xr rwho 1
1175and
1176.Xr ruptime 1
1177commands.
1178.El
1179.Ss Hardware daemons
1180.Bl -tag -width net_interfaces
1181.It Sy apmd
1182.Sq YES
1183or
1184.Sq NO .
1185Runs
1186.Xr apmd 8
1187and passes
1188.Sy apmd_flags .
1189.It Sy moused
1190.Sq YES
1191or
1192.Sq NO .
1193Runs
1194.Xr moused 8 ,
1195to pass serial mouse data to the wscons mouse mux.
1196Passes
1197.Sy moused_flags .
1198.It Sy poffd
1199.Sq YES
1200or
1201.Sq NO .
1202Runs
1203.Xr poffd 8
1204x68k shutdown daemon
1205(only for
1206.Nx Ns /x68k ) .
1207Passes
1208.Sy poffd_flags .
1209.It Sy screenblank
1210.Sq YES
1211or
1212.Sq NO .
1213Runs
1214.Xr screenblank 1
1215and passes
1216.Sy screenblank_flags .
1217.It Sy wscons
1218.Sq YES
1219or
1220.Sq NO .
1221Configures the
1222.Xr wscons 4
1223console driver, from the configuration file
1224.Pa /etc/wscons.conf .
1225.It Sy wsmoused
1226.Sq YES
1227or
1228.Sq NO .
1229Runs
1230.Xr wsmoused 8 ,
1231to provide copy and paste text support in wscons displays.
1232Passes
1233.Sy wsmoused_flags .
1234.El
1235.Sh FILES
1236.Bl -tag -width /etc/defaults/rc.conf -compact
1237.It Pa /etc/rc.conf
1238The file
1239.Nm
1240resides in
1241.Pa /etc .
1242.It Pa /etc/defaults/rc.conf
1243Default settings for
1244.Nm ,
1245sourced by
1246.Nm
1247before the end-user configuration section.
1248.It Pa /etc/rc.conf.d/ Ns Ar foo
1249.Ar foo Ns No -specific
1250.Nm
1251overrides.
1252.El
1253.Sh SEE ALSO
1254.Xr boot 8 ,
1255.Xr rc 8 ,
1256.Xr rc.d 8 ,
1257.Xr rc.subr 8 ,
1258.Xr rcorder 8
1259.Sh HISTORY
1260The
1261.Nm
1262file appeared in
1263.Nx 1.3 .
1264