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