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