xref: /freebsd/share/man/man5/rc.conf.5 (revision daf1cffce2e07931f27c6c6998652e90df6ba87e)
1.\" Copyright (c) 1995
2.\"	Jordan K. Hubbard
3.\"
4.\" Redistribution and use in source and binary forms, with or without
5.\" modification, are permitted provided that the following conditions
6.\" are met:
7.\" 1. Redistributions of source code must retain the above copyright
8.\"    notice, this list of conditions and the following disclaimer.
9.\" 2. Redistributions in binary form must reproduce the above copyright
10.\"    notice, this list of conditions and the following disclaimer in the
11.\"    documentation and/or other materials provided with the distribution.
12.\"
13.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND
14.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
15.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
16.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR BE LIABLE
17.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
18.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
19.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
20.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
21.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
22.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
23.\" SUCH DAMAGE.
24.\"
25.\" $FreeBSD$
26.\"
27.Dd April 26, 1997
28.Dt RC.CONF 5
29.Os FreeBSD 2.2.2
30.Sh NAME
31.Nm rc.conf
32.Nd system configuration information.
33.Sh DESCRIPTION
34The file
35.Nm rc.conf
36contains descriptive information about the local host name, configuration
37details for any potential network interfaces and which services should be
38started up at system initial boot time.  In new installations, the
39.Nm rc.conf
40file is generally initialized by the system installation utility:
41.Pa /stand/sysinstall .
42.Pp
43The purpose of
44.Nm rc.conf
45is not to run commands or perform system startup actions
46directly.  Instead, it is included by the
47various generic startup scripts in
48.Pa /etc
49which conditionalize their
50internal actions according to the settings found there.
51.Pp
52The
53.Pa /etc/rc.conf
54file is included from the file
55.Pa /etc/defaults/rc.conf ,
56which specifies the default settings for all the available options. Options
57need only be specified in
58.Pa /etc/rc.conf
59when the system administrator wishes to override these defaults. The file
60.Pa /etc/rc.conf.local
61is used to override settings in
62.Pa /etc/rc.conf
63for historical reasons. See the
64.Dq rc_conf_files
65option below.
66.Pp
67The following list provides a name and short description for each
68variable you can set in the
69.Nm
70file:
71.Bl -tag -width Ar
72.It Ar swapfile
73(str) If set to
74.Ar NO
75then no swapfile is installed, otherwise the value is used as the full
76pathname to a file to use for additional swap space.
77.It Ar apm_enable
78(bool) If set to
79.Ar YES ,
80enable support for Automatic Power Management with
81the
82.Xr apm 8
83command.
84.It Ar apmd_enable
85(bool) Run
86.Xr apmd 8
87to handle APM event from userland.
88This also enable support for APM.
89.It Ar apmd_flags
90(str) If
91.Ar apmd_enable
92is set to
93.Ar YES ,
94these are the flags to pass to the
95.Xr apmd 8
96daemon.
97.It Ar pccard_enable
98(bool) If set to
99.Ar YES ,
100enable PCCARD support at boot time.
101.It Ar pccard_mem
102(str) Set to PCCARD controller memory address or
103.Ar DEFAULT
104for the default value.
105.It Ar pccard_ifconfig
106(str) List of arguments to be passed to ifconfig(8) at boot time or on
107insertion of of the card (e.g. "inet 192.168.1.1 netmask 255.255.255.0"
108for a fixed address or "DHCP" for a DHCP client).
109.It Ar pccard_conf
110(str) Path to the configuration file for the
111.Xr pccardd 8
112daemon (e.g.
113.Ar /etc/pccard.conf.sample ) .
114.It Ar pccardd_flags
115(str) If
116.Ar pccard_enable
117is set to
118.Ar YES ,
119these are the flags to pass to the
120.Xr pccardd 8
121daemon.
122.It Ar local_startup
123(str) List of directories to search for startup script files.
124.It Ar local_periodic
125(str) List of directories to search for periodic scripts.
126.It Ar hostname
127(str) The Fully Qualified Domain Name of your host on the network.
128This should almost certainly be set to something meaningful, even if
129you are not connected to a network.  If you are using
130.Xr dhclient 8
131to set your hostname via DHCP, this variable should be set to an empty string.
132.It Ar nisdomainname
133(str) The NIS domainname of your host, or
134.Ar NO
135if you are not running NIS.
136.It Ar dhcp_program
137(str) Path to the DHCP client progam (/sbin/dhclient, the ISC DHCP client,
138is the default).
139.It Ar dhcp_flags
140(str) Additional flags to pass to the DHCP client program.
141For the ISC DHCP client, see the
142.Xr dhclient 8
143page for a description of the command line options available.
144.It Ar firewall_enable
145(bool) Set to
146.Ar NO
147if you do not want have firewall rules loaded at startup, or
148.Ar YES
149if you do.
150If set to
151.Ar YES ,
152and the kernel was not built with IPFIREWALL, the ipfw
153kernel module will be loaded.
154.It Ar firewall_type
155(str) Names the firewall type from the selection in
156.Pa /etc/rc.firewall ,
157or the file which contains the local firewall ruleset.  Valid selections
158from
159.Pa /etc/rc.firewall ,
160are
161.Dq open
162- unrestricted IP access;
163.Dq closed
164- all IP services disabled, except via lo0;
165.Dq client
166- basic protection for a workstation;
167.Dq simple
168- basic protection for a LAN.  If a filename is specified, the full path
169must be given.
170.It Ar firewall_quiet
171(bool) Set to
172.Ar YES
173to disable the display of ipfw rules on the console during boot.
174.It Ar natd_program
175(str) path to
176.Xr natd 8 .
177.It Ar natd_enable
178(bool) Set to
179.Ar YES
180to enable natd.
181.Ar Firewall_enable
182must also be set to
183.Ar YES ,
184and
185.Xr divert 4
186sockets must be enabled in your kernel.
187.It Ar natd_interface
188This is the name of the public interface on which natd should run.  It
189is mandatory if
190.Ar natd_enable
191is set to
192.Ar YES .
193The interface may be given as an interface name or as an IP address.
194.It Ar natd_flags
195Additional natd flags should be placed here.  The
196.Fl n
197or
198.Fl a
199flag is automatically added with the above
200.Ar natd_interface
201as an argument.
202.It Ar tcp_extensions
203(bool) Set to
204.Ar NO
205by default. Setting this to YES enables certain TCP options as described by
206.Rs
207.%T RFC 1323
208.Re
209If you have problems with connections
210randomly hanging or other weird behavior of such nature, you might
211try setting this back to
212.Ar NO
213and seeing if that helps.  Some hardware/software out there is known
214to be broken with respect to these options.
215.It Ar log_in_vain
216(bool) Set to
217.Ar NO
218by default.
219Setting to YES will enable logging of connection attempts to ports that
220have no listening socket on them.
221.It Ar tcp_keepalive
222(bool) Set to
223.Ar YES
224by default.
225Setting to NO will disable probing idle TCP connections to verify that the
226peer is still up and reachable.
227.It Ar tcp_drop_synfin
228(bool) Set to
229.Ar NO
230by default.
231Setting to YES will cause the kernel to ignore TCP frames that have both
232the SYN and FIN flags set. This prevents OS fingerprinting, but may
233break some legitimate applications. This option is only available if the
234kernel was built with the TCP_DROP_SYNFIN option.
235.It Ar tcp_restrict_rst
236(bool) Set to
237.Ar NO
238by default.
239Setting to YES will cause the kernel to refrain from emitting TCP RST frames
240in response to invalid TCP packets (e.g. frames destined for closed ports).
241This option is only available if the kernel was built with the
242TCP_RESTRICT_RST option.
243.It Ar icmp_drop_redirect
244(bool) Set to
245.Ar NO
246by default.
247Setting to YES will cause the kernel to ignore ICMP REDIRECT packets.
248.It Ar icmp_log_redirect
249(bool) Set to
250.Ar NO
251by default.
252Setting to YES will cause the kernel to log ICMP REDIRECT packets. Note that
253the log messages are not rate-limited, so this option should only be used
254for troubleshooting your own network.
255.It Ar network_interfaces
256(str) Set to the list of network interfaces to configure on this host.
257For example, if you had a loopback device (standard) and an SMC Elite
258Ultra NIC, you might have this set to
259.Qq Ar "lo0 ed0"
260for the two interfaces.  An
261.No ifconfig_ Ns Em interface
262variable is also assumed to exist for each value of
263.Em interface .
264It is also possible to add IP alias entries here in cases where you
265want a single interface to have multiple IP addresses registered against
266it.
267Assuming that the interface in question was ed0, it might look
268something like this:
269.Bd -literal
270ifconfig_ed0_alias0="inet 127.0.0.253 netmask 0xffffffff"
271ifconfig_ed0_alias1="inet 127.0.0.254 netmask 0xffffffff"
272
273.Ed
274And so on.  For each ifconfig_<interface>_alias<n> entry that is
275found, its contents are passed to
276.Xr ifconfig 8 .
277Execution stops at the first unsuccessful access, so if you
278had something like:
279.Bd -literal
280ifconfig_ed0_alias0="inet 127.0.0.251 netmask 0xffffffff"
281ifconfig_ed0_alias1="inet 127.0.0.252 netmask 0xffffffff"
282ifconfig_ed0_alias2="inet 127.0.0.253 netmask 0xffffffff"
283ifconfig_ed0_alias4="inet 127.0.0.254 netmask 0xffffffff"
284
285.Ed
286Then note that alias4 would
287.Em not
288be added since the search would
289stop with the missing alias3 entry.
290.Pp
291You can bring up an interface with DHCP by setting the
292.No ifconfig_ Ns Em interface
293variable to
294.Dq DHCP .
295For instance, to initialize your ed0 device via DHCP,
296you might have something like:
297.Bd -literal
298ifconfig_ed0="DHCP"
299.Ed
300.It Ar ppp_enable
301(bool) If set to
302.Ar YES ,
303run the
304.Xr ppp 8
305daemon.
306.It Ar ppp_mode
307(str) Mode in which to run the
308.Xr ppp 8
309daemon.  Accepted modes are
310.Ar auto , ddial , direct
311and
312.Ar dedicated .
313See the manual for a full description.
314.It Ar ppp_nat
315(bool) If set to
316.Ar YES ,
317enables packet aliasing. Used in conjunction with
318.Ar gateway_enable
319allows hosts on private network addresses access to the Internet using
320this host as a network address translating router.
321.It Ar ppp_profile
322(str) The name of the profile to use from
323.Ar /etc/ppp/ppp.conf .
324.It Ar rc_conf_files
325(str) This option is used to specify a list of files that will override
326the settings in
327.Pa /etc/defaults/rc.conf .
328The files will be read in the order in which they are specified and should
329include the full path to the file. By default, the files specified are
330.Pa /etc/rc.conf
331and
332.Pa /etc/rc.conf.local
333.It Ar syslogd_enable
334(bool) If set to
335.Ar YES ,
336run the
337.Xr syslogd 8
338daemon.
339.It Ar syslogd_flags
340(str) if syslogd_enable is set to
341.Ar YES ,
342these are the flags to pass to
343.Xr syslogd 8 .
344.It Ar inetd_enable
345(bool) If set to
346.Ar YES ,
347run the
348.Xr inetd 8
349daemon.
350.It Ar inetd_flags
351(str) if inetd_enable is set to
352.Ar YES ,
353these are the flags to pass to
354.Xr inetd 8 .
355.It Ar named_enable
356(bool) If set to
357.Ar YES ,
358run the
359.Xr named 8
360daemon.
361.It Ar named_program
362(str) path to
363.Xr named 8
364(default
365.Pa /usr/sbin/named ) .
366.It Ar named_flags
367(str) if
368.Ar named_enable
369is set to
370.Ar YES ,
371these are the flags to pass to
372.Xr named 8 .
373.It Ar kerberos_server_enable
374(bool) Set to
375.Ar YES
376if you want to run a Kerberos authentication server
377at boot time.
378.It Ar kadmind_server_enable
379.Ar YES
380if you want to run
381.Xr kadmind 8
382the Kerberos Administration Daemon); set to
383.Ar NO
384on a slave server.
385.It Ar kerberos_stash
386(str)
387If
388.Ar YES ,
389instruct the Kerberos servers to use the stashed master key instead of
390prompting for it (only if
391.Ar kerberos_server_enable
392is set to
393.Ar YES ,
394and is used for both
395.Xr kerberos 1
396and
397.Xr kadmind 8 ).
398.It Ar rwhod_enable
399(bool) If set to
400.Ar YES ,
401run the
402.Xr rwhod 8
403daemon at boot time.
404.It Ar rwhod_flags
405(str) If
406.Ar rwhod_enable
407is set to
408.Ar YES ,
409these are the flags to pass to it.
410.It Ar amd_enable
411(bool) If set to
412.Ar YES ,
413run the
414.Xr amd 8
415daemon at boot time.
416.It Ar amd_flags
417(str) If
418.Ar amd_enable
419is set to
420.Ar YES ,
421these are the flags to pass to it.
422See the
423.Xr amd 8
424.Xr info 1
425page for more information.
426.It Ar update_motd
427(bool) If set to
428.Ar YES ,
429.Pa /etc/motd
430will be updated at boot time to reflect the kernel release
431bring run.  If set to
432.Ar NO ,
433.Pa /etc/motd
434will not be updated
435.It Ar nfs_client_enable
436(bool) If set to
437.Ar YES ,
438run the NFS client daemons at boot time.
439.It Ar nfs_client_flags
440(str) If
441.Ar nfs_client_enable
442is set to
443.Ar YES ,
444these are the flags to pass to the
445.Xr nfsiod 8
446daemon.
447.It Ar nfs_access_cache
448if
449.Ar nfs_client_enable
450is set to
451.Ar YES ,
452this can be set to
453.Ar 0
454to disable NFS ACCESS RPC caching, or to the number of seconds for which NFS ACCESS
455results should be cached.  A value of 2-10 seconds will substantially reduce network
456traffic for many NFS operations.
457.It Ar nfs_server_enable
458(bool) If set to
459.Ar YES ,
460run the NFS server daemons at boot time.
461.It Ar nfs_server_flags
462(str) If
463.Ar nfs_server_enable
464is set to
465.Ar YES ,
466these are the flags to pass to the
467.Xr nfsd 8
468daemon.
469.It Ar single_mountd_enable
470(bool) If set to
471.Ar YES ,
472and no
473.Ar nfs_server_enable
474is set, start
475.Xr mountd 8 ,
476but not
477.Xr nfsd 8
478daemon. It is commonly needed to run CFS without real NFS used.
479.It Ar weak_mountd_authentication
480(bool) If set to
481.Ar YES ,
482allow services like PCNFSD to make non-privileged mount
483requests.
484.It Ar nfs_reserved_port_only
485(bool) If set to
486.Ar YES ,
487provide NFS services only on a secure port.
488.It Ar rcp_lockd_enable
489(bool) If set to
490.Ar YES
491and also an NFS server, run
492.Xr rpc.lockd 8
493at boot time.
494.It Ar rcp_statd_enable
495(bool) If set to
496.Ar YES
497and also an NFS server, run
498.Xr rpc.statd 8
499at boot time.
500.It Ar portmap_program
501(str) path to
502.Xr portmap 8
503(default
504.Pa /usr/sbin/portmap ) .
505.It Ar portmap_enable
506(bool) If set to
507.Ar YES ,
508run the
509.Xr portmap 8
510service at boot time.
511.It Ar portmap_flags
512(str) If
513.Ar portmap_enable
514is set to
515.Ar YES ,
516these are the flags to pass to the
517.Xr portmap 8
518daemon.
519.It Ar xtend_enable
520(bool) If set to
521.Ar YES
522then run the
523.Xr xtend 8
524daemon at boot time.
525.It Ar xtend_flags
526(str) If
527.Ar xtend_enable
528is set to
529.Ar YES ,
530these are the flags to pass to the
531.Xr xtend 8
532daemon.
533.It Ar pppoed_enable
534(bool) If set to
535.Ar YES
536then run the
537.Xr pppoed 8
538daemon at boot time to provide PPP over Ethernet services.
539.It Ar pppoed_provider
540.Xr pppoed 8
541listens to requests to this
542.Ar provider
543and ultimately runs
544.Xr ppp 8
545with a
546.Ar system
547argument of the same name.
548.It Ar pppoed_flags
549Additional flags to pass to
550.Xr pppoed 8 .
551.It Ar pppoed_interface
552The network interface to run pppoed on.  This is mandatory when
553.Ar pppoed_enable
554is set to
555.Dq YES .
556.It Ar timed_enable
557(boot) if
558.Ar YES
559then run the
560.Xr timed 8
561service at boot time.  This command is intended for networks of
562machines where a consistent
563.Qq "network time"
564for all hosts must be established.  This is often useful in large NFS
565environments where time stamps on files are expected to be consistent
566network-wide.
567.It Ar timed_flags
568(str) If
569.Ar timed_enable
570is set to
571.Ar YES ,
572these are the flags to pass to the
573.Xr timed 8
574service.
575.It Ar ntpdate_enable
576(bool) If set to
577.Ar YES ,
578run ntpdate at system startup.  This command is intended to
579synchronize the system clock only
580.Ar once
581from some standard reference.  An option to set this up initially
582(from a list of known servers) is also provided by the
583.Pa /stand/sysinstall
584program when the system is first installed.
585.It Ar ntpdate_program
586(str) path to
587.Xr ntpdate 8
588(default
589.Pa /usr/sbin/ntpdate ) .
590.It Ar ntpdate_flags
591(str) If
592.Ar ntpdate_enable
593is set to
594.Ar YES ,
595these are the flags to pass to the
596.Xr ntpdate 8
597command (typically a hostname).
598.It Ar xntpd_enable
599(bool) If set to
600.Ar YES
601then run the
602.Xr xntpd 8
603command at boot time.
604.It Ar xntpd_program
605(str) path to
606.Xr xntpd 8
607(default
608.Pa /usr/sbin/xntpd ) .
609.It Ar xntpd_flags
610(str) If
611.Ar xntpd_enable
612is set to
613.Ar YES ,
614these are the flags to pass to the
615.Xr xntpd 8
616daemon.
617.It Ar nis_client_enable
618(bool) If set to
619.Ar YES
620then run the
621.Xr ypbind 8
622service at system boot time.
623.It Ar nis_client_flags
624(str) If
625.Ar nis_client_enable
626is set to
627.Ar YES ,
628these are the flags to pass to the
629.Xr ypbind 8
630service.
631.It Ar nis_ypset_enable
632(bool) If set to
633.Ar YES
634then run the
635.Xr ypset 8
636daemon at system boot time.
637.It Ar nis_ypset_flags
638(str) If
639.Ar nis_ypset_enable
640is set to
641.Ar YES ,
642these are the flags to pass to the
643.Xr ypset 8
644daemon.
645.It Ar nis_server_enable
646(bool) If set to
647.Ar YES
648then run the
649.Xr ypserv 8
650daemon at system boot time.
651.It Ar nis_server_flags
652(str) If
653.Ar nis_server_enable
654is set to
655.Ar YES ,
656these are the flags to pass to the
657.Xr ypserv 8
658daemon.
659.It Ar nis_ypxfrd_enable
660(bool) If set to
661.Ar YES
662then run the
663.Xr ypxfrd 8
664daemon at system boot time.
665.It Ar nis_ypxfrd_flags
666(str) If
667.Ar nis_ypxfrd_enable
668is set to
669.Ar YES ,
670these are the flags to pass to the
671.Xr ypxfrd 8
672daemon.
673.It Ar nis_yppasswdd_enable
674(bool) If set to
675.Ar YES
676then run the
677.Xr yppasswdd 8
678daemon at system boot time.
679.It Ar nis_yppasswdd_flags
680(str) If
681.Ar nis_yppasswdd_enable
682is set to
683.Ar YES ,
684these are the flags to pass to the
685.Xr yppasswdd 8
686daemon.
687.It Ar defaultrouter
688(str) If not set to
689.Ar NO
690then create a default route to this host name or IP address (use IP
691address value if you also require this router to get to a name
692server!)
693.It Ar static_routes
694(str) Set to the list of static routes you would like to add at system
695boot time.  If not set to
696.Ar NO
697then for each whitespace separated
698.Em element
699in the value, a
700.No route_ Ns element
701variable is assumed to exist
702whose contents will later be passed to a
703.Dq route add
704operation.
705.It Ar gateway_enable
706(bool) If set to
707.Ar YES ,
708then configure host to at as an IP router, e.g. to forward packets
709between interfaces.
710.It Ar router_enable
711(bool) If set to
712.Ar YES
713then run a routing daemon of some sort, based on the
714settings of
715.Ar router
716and
717.Ar router_flags .
718.It Ar router
719(str) If
720.Ar router_enable
721is set to
722.Ar YES ,
723this is the name of the routing daemon to use.
724.It Ar router_flags
725(str) If
726.Ar router_enable
727is set to
728.Ar YES ,
729these are the flags to pass to the routing daemon.
730.It Ar mrouted_enable
731(bool) If set to
732.Ar YES
733then run the multicast routing daemon,
734.Xr mrouted 8 .
735.It Ar mrouted_flags
736(str) If
737.Ar mrouted_enable
738is set to
739.Ar YES ,
740these are the flags to pass to the multicast routing daemon.
741.It Ar ipxgateway_enable
742(bool) If set to
743.Ar YES
744then enable the routing of IPX traffic.
745.It Ar ipxrouted_enable
746(bool) If set to
747.Ar YES
748then run the
749.Xr IPXrouted 8
750daemon at system boot time.
751.It Ar ipxrouted_flags
752(str) If
753.Ar ipxrouted_enable
754is set to
755.Ar YES ,
756these are the flags to pass to the
757.Xr IPXrouted 8
758daemon.
759.It Ar arpproxy_all
760If set to
761.Ar YES
762then enable global proxy ARP.
763.It Ar forward_sourceroute
764If set to
765.Ar YES
766then when
767.Ar gateway_enable
768is also set to
769.Ar YES ,
770source routed packets are forwarded.
771.It Ar accept_sourceroute
772If set to
773.Ar YES
774then the system will accept source routed packets directed at it.
775.It Ar rarpd_enable
776(bool) If set to
777.Ar YES
778then run the
779.Xr rarpd 8
780daemon at system boot time.
781.It Ar rarpd_flags
782(str) If
783.Ar rarpd_enable
784is set to
785.Ar YES ,
786these are the flags to pass to the
787.Xr rarpd 8
788daemon.
789.It Ar atm_enable
790(bool) Set to
791.Ar YES
792to enable the configuration of ATM interfaces at system boot time.
793For all of the ATM variables described below, please refer to the
794.Xr atm 8
795man page for further details on the available command parameters.
796Also refer to the files in
797.Pa /usr/share/examples/atm
798for more detailed configuration information.
799.It Ar atm_netif_<intf>
800(str) For the ATM physical interface
801.Va <intf> ,
802this variable defines the name prefix and count for the ATM network interfaces to be created.
803The value will be passed as the parameters of an
804.Dq atm set netif Va <intf>
805command.
806.It Ar atm_sigmgr_<intf>
807(str) For the ATM physical interface
808.Va <intf> ,
809this variable defines the ATM signalling manager to be used.
810The value will be passed as the parameters of an
811.Dq atm attach Va <intf>
812command.
813.It Ar atm_prefix_<intf>
814(str) For the ATM physical interface
815.Va <intf> ,
816this variable defines the NSAP prefix for interfaces using a UNI signalling
817manager.  If set to
818.Em ILMI ,
819then the prefix will automatically be set via the
820.Xr ilmid 8
821daemon.  Otherwise, the value will be passed as the parameters of an
822.Dq atm set prefix Va <intf>
823command.
824.It Ar atm_macaddr_<intf>
825(str) For the ATM physical interface
826.Va <intf> ,
827this variable defines the MAC address for interfaces using a UNI signalling
828manager.  If set to
829.Em NO ,
830then the hardware MAC address contained in the ATM interface card will be used.
831Otherwise, the value will be passed as the parameters of an
832.Dq atm set mac Va <intf>
833command.
834.It Ar atm_arpserver_<netif>
835(str) For the ATM network interface
836.Va <netif> ,
837this variable defines the ATM address for a host which is to provide ATMARP
838service.  This variable is only applicable to interfaces using a UNI signalling
839manager.  If set to
840.Em local ,
841then this host will become an ATMARP server.
842The value will be passed as the parameters of an
843.Dq atm set arpserver Va <netif>
844command.
845.It Ar atm_scsparp_<netif>
846(bool) If set to
847.Em YES ,
848then SCSP/ATMARP service for the network interface
849.Va <netif>
850will be initiated using the
851.Xr scspd 8
852and
853.Xr atmarpd 8
854daemons.  This variable is only applicable if
855.So
856.No atm_arpserver_ Ns Va <netif>
857.No Ns = Ns Qq local
858.Sc
859is defined.
860.It Ar atm_pvcs
861(str) Set to the list of ATM PVCs you would like to add at system
862boot time.  For each whitespace separated
863.Em element
864in the value, an
865.No atm_pvc_ Ns Em element
866variable is assumed to exist.  The value of each of these variables
867will be passed as the parameters of an
868.Dq atm add pvc
869command.
870.It Ar atm_arps
871(str) Set to the list of permanent ATM ARP entries you would like to add
872at system boot time.  For each whitespace separated
873.Em element
874in the value, an
875.No atm_arp_ Ns Em element
876variable is assumed to exist.  The value of each of these variables
877will be passed as the parameters of an
878.Dq atm add arp
879command.
880.It Ar keymap
881(str) If set to
882.Ar NO
883then no keymap is installed, otherwise the value is used to install
884the keymap file in
885.Pa /usr/share/syscons/keymaps/<value>.kbd
886.It Ar keyrate
887(str) The keyboard repeat speed.  Set to
888.Ar slow ,
889.Ar normal ,
890.Ar fast
891or
892.Ar NO
893if the default behavior is desired.
894.It Ar keychange
895(str) If not set to
896.Ar NO ,
897attempt to program the function keys with the value.  The value should
898be a single string of the form:
899.Qq Ar "<funkey_number> <new_value> [<funkey_number> <new_value>]..."
900.It Ar cursor
901(str) Can be set to the value of
902.Ar normal ,
903.Ar blink ,
904.Ar destructive
905or
906.Ar NO
907to set the cursor behavior explicitly or choose the default behavior.
908.It Ar scrnmap
909(str) If set to
910.Ar NO
911then no screen map is installed, otherwise the value is used to install
912the screen map file in
913.Pa /usr/share/syscons/scrnmaps/<value> .
914.It Ar font8x16
915(str) If set to
916.Ar NO
917then the default 8x16 font value is used for screen size requests, otherwise
918the value in
919.Pa /usr/share/syscons/fonts/<value>
920is used.
921.It Ar font8x14
922(str) If set to
923.Ar NO
924then the default 8x14 font value is used for screen size requests, otherwise
925the value in
926.Pa /usr/share/syscons/fonts/<value>
927is used.
928.It Ar font8x8
929(str) If set to
930.Ar NO
931then the default 8x8 font value is used for screen size requests, otherwise
932the value in
933.Pa /usr/share/syscons/fonts/<value>
934is used.
935.It Ar blanktime
936(int) If set to
937.Ar NO
938then the default screen blanking interval is used, otherwise it is set
939to
940.Ar value
941seconds.
942.It Ar saver
943(str) If not set to
944.Ar NO ,
945this is the actual screen saver to use (blank, snake, daemon, etc).
946.It Ar moused_enable
947(str) If set to
948.Ar YES ,
949the
950.Xr moused 8
951daemon is started for doing cut/paste selection on the console.
952.It Ar moused_type
953(str) This is the protocol type of mouse you would like to use.
954This variable must be set if
955.Ar moused_enable
956is set to
957.Ar YES .
958The
959.Xr moused 8
960daemon
961is able to detect the appropriate mouse type automatically in many cases.
962You can set this variable to
963.Ar auto
964to let the daemon detect it, or
965select one from the following list if the automatic detection fails.
966.Pp
967If your mouse is attached to the PS/2 mouse port, you should
968always choose
969.Ar auto
970or
971.Ar ps/2 ,
972regardless of the brand and model of the mouse.  Likewise, if your
973mouse is attached to the bus mouse port, choose
974.Ar auto
975or
976.Ar busmouse .
977All other protocols are for serial mice and will not work with
978the PS/2 and bus mice.
979If you have a USB mouse,
980.Ar auto
981is the only protocol type which works with the USB mouse.
982.Bd -literal
983microsoft        Microsoft mouse (serial)
984intellimouse     Microsoft IntelliMouse (serial)
985mousesystems     Mouse systems Corp mouse (serial)
986mmseries         MM Series mouse (serial)
987logitech         Logitech mouse (serial)
988busmouse         A bus mouse
989mouseman         Logitech MouseMan and TrackMan (serial)
990glidepoint       ALPS GlidePoint (serial)
991thinkingmouse    Kensignton ThinkingMouse (serial)
992ps/2             PS/2 mouse
993mmhittab         MM HitTablet (serial)
994x10mouseremote   X10 MouseRemote (serial)
995versapad         Interlink VersaPad (serial)
996
997.Ed
998Even if your mouse is not in the above list, it may be compatible
999with one in the list. Refer to the man page for
1000.Xr moused 8
1001for compatibility information.
1002.Pp
1003It should also be noted that while this is enabled, any
1004other client of the mouse (such as an X server) should access
1005the mouse through the virtual mouse device:
1006.Pa /dev/sysmouse
1007and configure it as a sysmouse type mouse, since all
1008mouse data is converted to this single canonical format when
1009using
1010.Xr moused 8 .
1011If the client program does not support the sysmouse type,
1012specify the mousesystems type. It is the second prefered type.
1013.It Ar moused_port
1014(str) If
1015.Ar moused_enable
1016is set to
1017.Ar YES ,
1018this is the actual port the mouse is on.
1019It might be
1020.Pa /dev/cuaa0
1021for a COM1 serial mouse,
1022.Pa /dev/psm0
1023for a PS/2 mouse or
1024.Pa /dev/mse0
1025for a bus mouse, for example.
1026.It Ar moused_flags
1027(str) If
1028.Ar moused_type
1029is set, these are the additional flags to pass to the
1030.Xr moused 8
1031daemon.
1032.It Ar allscreens_flags
1033(str) If set,
1034.Xr vidcontrol 1
1035is run with these options for each of the virtual terminals
1036.Pq Pa /dev/ttyv* .
1037For example,
1038.Ar -m on
1039will enable the mouse pointer on all virtual terminals
1040if
1041.Ar moused_enable
1042is set to
1043.Ar YES .
1044.It Ar cron_enable
1045(bool) If set to
1046.Ar YES
1047then run the
1048.Xr cron 8
1049daemon at system boot time.
1050.It Ar lpd_program
1051(str) path to
1052.Xr lpd 8
1053(default
1054.Pa /usr/sbin/lpd ) .
1055.It Ar lpd_enable
1056(bool) If set to
1057.Ar YES
1058then run the
1059.Xr lpd 8
1060daemon at system boot time.
1061.It Ar lpd_flags
1062(str) If
1063.Ar lpd_enable
1064is set to
1065.Ar YES ,
1066these are the flags to pass to the
1067.Xr lpd 8
1068daemon.
1069.It Ar sendmail_enable
1070(bool) If set to
1071.Ar YES
1072then run the
1073.Xr sendmail 8
1074daemon at system boot time.
1075.It Ar sendmail_flags
1076(str) If
1077.Ar sendmail_enable
1078is set to
1079.Ar YES ,
1080these are the flags to pass to the
1081.Xr sendmail 8
1082daemon.
1083.It Ar dumpdev
1084(str) If not set to
1085.Ar NO
1086then point kernel crash-dumps at the swap device
1087specified as
1088.Em value .
1089When the system restarts,
1090a crash-dump found on the specified device
1091will typically be stored in the
1092.Pa /var/crash
1093directory by the
1094.Xr savecore 8
1095program.
1096.It Ar check_quotas
1097(bool) Set to
1098.Ar YES
1099if you want to enable user disk quota checking via the
1100.Xr quotacheck 8
1101command.
1102.It Ar accounting_enable
1103(bool) Set to
1104.Ar YES
1105if you wish to enable system accounting through the
1106.Xr accton 8
1107facility.
1108.It Ar ibcs2_enable
1109(bool) Set to
1110.Ar YES
1111if you wish to enable iBCS2 (SCO) binary emulation at system initial boot
1112time.
1113.It Ar linux_enable
1114(bool) Set to
1115.Ar YES
1116if you wish to enable Linux/ELF binary emulation at system initial
1117boot time.
1118.It Ar rand_irqs
1119(str) Set to the list of IRQs to monitor for random number creation
1120(see the man page for
1121.Xr rndcontrol 8 ).
1122.It Ar clear_tmp_enable
1123(bool) Set to
1124.Ar YES
1125if you want
1126.Pa /tmp
1127to be cleaned at startup.
1128.It Ar ldconfig_paths
1129(str) Set to the list of shared library paths to use with
1130.Xr ldconfig 8 .
1131NOTE:
1132.Pa /usr/lib
1133will always be added first, so it need not appear in this list.
1134.It Ar kern_securelevel_enable
1135(bool) Set to
1136.Ar YES
1137if you wish to set the kernel security level at system startup.
1138.It Ar kern_securelevel
1139(int) The kernel security level to set at startup.
1140The allowed range of
1141.Ar value
1142ranges from -1 (the compile time default) to 3 (the
1143most secure).  See
1144.Xr init 8
1145for the list of possible security levels and their effect
1146on system operation.
1147.It Ar start_vinum
1148(bool) Set to
1149.Ar YES
1150if you want to start
1151.Xr vinum 8
1152at system boot time.
1153.Sh FILES
1154.Bl -tag -width /etc/defaults/rc.conf -compact
1155.It Pa /etc/defaults/rc.conf
1156.El
1157.Pp
1158.Bl -tag -width /etc/rc.conf -compact
1159.It Pa /etc/rc.conf
1160.El
1161.Pp
1162.Bl -tag -width /etc/rc.conf.local -compact
1163.It Pa /etc/rc.conf.local
1164.El
1165.Sh SEE ALSO
1166.Xr catman 1 ,
1167.Xr makewhatis 1 ,
1168.Xr gdb 1 ,
1169.Xr info 1 ,
1170.Xr exports 5 ,
1171.Xr motd 5 ,
1172.Xr accton 8 ,
1173.Xr amd 8 ,
1174.Xr apm 8 ,
1175.Xr atm 8 ,
1176.Xr cron 8 ,
1177.Xr dhclient 8 ,
1178.Xr gated 8 ,
1179.Xr ifconfig 8 ,
1180.Xr inetd 8 ,
1181.Xr lpd 8 ,
1182.Xr moused 8 ,
1183.Xr mrouted 8 ,
1184.Xr named 8 ,
1185.Xr nfsd 8 ,
1186.Xr nfsiod 8 ,
1187.Xr ntpdate 8 ,
1188.Xr pcnfsd 8 ,
1189.Xr periodic 8 ,
1190.Xr portmap 8 ,
1191.Xr quotacheck 8 ,
1192.Xr rc 8 ,
1193.Xr rndcontrol 8 ,
1194.Xr route 8 ,
1195.Xr routed 8 ,
1196.Xr rpc.lockd 8 ,
1197.Xr rpc.statd 8 ,
1198.Xr rwhod 8 ,
1199.Xr savecore 8 ,
1200.Xr sendmail 8 ,
1201.Xr sysctl 8 ,
1202.Xr syslogd 8 ,
1203.Xr swapon 8 ,
1204.Xr tickadj 8 ,
1205.Xr timed 8 ,
1206.Xr vinum 8 ,
1207.Xr vnconfig 8 ,
1208.Xr xntpd 8 ,
1209.Xr xtend 8 ,
1210.Xr ypbind 8 ,
1211.Xr ypserv 8 ,
1212.Xr ypset 8
1213.Sh HISTORY
1214The
1215.Nm
1216file appeared in
1217.Fx 2.2.2 .
1218.Sh AUTHORS
1219.An Jordan K. Hubbard .
1220