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