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