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