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