Misc mdoc(7) cleanup:
[dragonfly.git] / share / man / man5 / rc.conf.5
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: src/share/man/man5/rc.conf.5,v 1.197 2003/07/28 13:56:00 mbr Exp $
26 .\" $DragonFly: src/share/man/man5/rc.conf.5,v 1.19 2006/05/21 14:15:05 swildner Exp $
27 .Dd March 3, 2002
28 .Dt RC.CONF 5
29 .Os
30 .Sh NAME
31 .Nm rc.conf
32 .Nd system configuration information
33 .Sh DESCRIPTION
34 The file
35 .Nm
36 contains descriptive information about the local host name, configuration
37 details for any potential network interfaces and which services should be
38 started up at system initial boot time.
39 In new installations, the
40 .Nm
41 file is generally initialized by the installer.
42 .Pp
43 The purpose of
44 .Nm
45 is not to run commands or perform system startup actions
46 directly.
47 Instead, it is included by the
48 various generic startup scripts in
49 .Pa /etc
50 which conditionalize their
51 internal actions according to the settings found there.
52 .Pp
53 The
54 .Pa /etc/rc.conf
55 file is included from the file
56 .Pa /etc/defaults/rc.conf ,
57 which specifies the default settings for all the available options.
58 Options need only be specified in
59 .Pa /etc/rc.conf
60 when the system administrator wishes to override these defaults.
61 The file
62 .Pa /etc/rc.conf.local
63 is used to override settings in
64 .Pa /etc/rc.conf
65 for historical reasons.
66 See the
67 .Va rc_conf_files
68 variable below.
69 .Pp
70 The following list provides a name and short description for each
71 variable that can be set in the
72 .Nm
73 file:
74 .Bl -tag -width indent-two
75 .It Va rc_debug
76 .Pq Vt bool
77 If set to
78 .Dq Li YES ,
79 enable output of debug messages from rc scripts.
80 This variable can be helpful in diagnosing mistakes when
81 editing or integrating new scripts.
82 Beware that this produces copious output to the terminal and
83 .Xr syslog 3 .
84 .It Va rc_info
85 .Pq Vt bool
86 If set to
87 .Dq Li NO ,
88 disable informational messages from the rc scripts.
89 Informational messages are displayed when
90 a condition that is not serious enough to warrant a warning or
91 an error occurs.
92 .It Va swapfile
93 .Pq Vt str
94 If set to
95 .Dq Li NO ,
96 no swapfile is installed, otherwise the value is used as the full
97 pathname to a file to use for additional swap space.
98 .It Va apm_enable
99 .Pq Vt bool
100 If set to
101 .Dq Li YES ,
102 enable support for Automatic Power Management with
103 the
104 .Xr apm 8
105 command.
106 .It Va apmd_enable
107 .Pq Vt bool
108 Run
109 .Xr apmd 8
110 to handle APM event from userland.
111 This also enables support for APM.
112 .It Va apmd_flags
113 .Pq Vt str
114 If
115 .Va apmd_enable
116 is set to
117 .Dq Li YES ,
118 these are the flags to pass to the
119 .Xr apmd 8
120 daemon.
121 .It Va battd_enable
122 Enable
123 .Xr battd 8
124 to monitor the status of batteries present in the system.
125 This also enables support for APM.
126 .It Va battd_flags
127 .Pq Vt str
128 If
129 .Va battd_enable
130 is set to
131 .Dq Li YES ,
132 these are the flags to pass to the
133 .Xr battd 8
134 daemon.
135 .It Va devd_enable
136 .Pq Vt bool
137 Run
138 .Xr devd 8
139 to handle device added, removed or unknown events from the kernel.
140 .It Va pccard_ifconfig
141 .Pq Vt str
142 List of arguments to be passed to
143 .Xr ifconfig 8
144 at boot time or on
145 insertion of the card (e.g.\&
146 .Dq Cm inet Li 192.168.1.1 Cm netmask Li 255.255.255.0
147 for a fixed address or
148 .Dq Li DHCP
149 for a DHCP client).
150 .It Va pccard_ether_delay
151 .Pq Vt str
152 Set the delay before starting
153 .Xr dhclient 8
154 in the
155 .Pa /etc/pccard_ether
156 script.
157 This defaults to 5 seconds to work around a bug in the
158 .Xr ed 4
159 driver which can lead to system hangs when using some newer
160 .Xr ed 4
161 based cards.
162 .It Va removable_interfaces
163 .Pq Vt str
164 List of removable network interfaces to be supported by
165 .Pa /etc/pccard_ether .
166 .It Va local_startup
167 .Pq Vt str
168 List of directories to search for startup script files.
169 .It Va script_name_sep
170 .Pq Vt str
171 The field separator to use for breaking down the list of startup script files
172 into individual filenames.
173 The default is a space.
174 It is not necessary to change this unless there are startup scripts with names
175 containing spaces.
176 .It Va hostname
177 .Pq Vt str
178 The fully qualified domain name (FQDN) of this host on the network.
179 This should almost certainly be set to something meaningful, even if
180 there is no network connection.
181 If
182 .Xr dhclient 8
183 is used to set the hostname via DHCP,
184 this variable should be set to an empty string.
185 .It Va ipv6_enable
186 .Pq Vt bool
187 Enable support for IPv6 networking.
188 Note that this requires that the kernel have been compiled with
189 .Cd "options INET6" .
190 .It Va nisdomainname
191 .Pq Vt str
192 The NIS domain name of this host, or
193 .Dq Li NO
194 if NIS is not used.
195 .It Va dhclient_program
196 .Pq Vt str
197 Path to the DHCP client program
198 .Pa ( /sbin/dhclient ,
199 the ISC DHCP client,
200 is the default).
201 .It Va dhclient_flags
202 .Pq Vt str
203 Additional flags to pass to the DHCP client program.
204 For the ISC DHCP client, see the
205 .Xr dhclient 8
206 manpage for a description of the command line options available.
207 .It Va background_dhclient
208 .Pq Vt bool
209 Set to
210 .Dq Li YES
211 to start the dhcp client in background.
212 This can cause trouble with applications depending on
213 a working network, but it will provide a faster startup
214 in many cases.
215 .It Va firewall_enable
216 .Pq Vt bool
217 Set to
218 .Dq Li YES
219 to load firewall rules at startup.
220 If the kernel was not built with
221 .Cd "options IPFIREWALL" ,
222 the
223 .Pa ipfw.ko
224 kernel module will be loaded.
225 See also
226 .Va ipfilter_enable .
227 .It Va ipv6_firewall_enable
228 .Pq Vt bool
229 The IPv6 equivalent of
230 .Va firewall_enable .
231 Set to
232 .Dq Li YES
233 to load IPv6 firewall rules at startup.
234 If the kernel was not built with
235 .Cd "options IPV6FIREWALL" ,
236 the
237 .Pa ip6fw.ko
238 kernel module will be loaded.
239 .It Va firewall_script
240 .Pq Vt str
241 This variable specifies the full path to the firewall script to run.
242 The default is
243 .Pa /etc/rc.firewall .
244 .It Va ipv6_firewall_script
245 .Pq Vt str
246 The IPv6 equivalent of
247 .Va firewall_script .
248 .It Va firewall_type
249 .Pq Vt str
250 Names the firewall type from the selection in
251 .Pa /etc/rc.firewall ,
252 or the file which contains the local firewall ruleset.
253 Valid selections from
254 .Pa /etc/rc.firewall
255 are:
256 .Pp
257 .Bl -tag -width ".Li simple" -compact
258 .It Li open
259 unrestricted IP access
260 .It Li closed
261 all IP services disabled, except via
262 .Dq Li lo0
263 .It Li client
264 basic protection for a workstation
265 .It Li simple
266 basic protection for a LAN.
267 .El
268 .Pp
269 If a filename is specified, the full path
270 must be given.
271 .It Va ipv6_firewall_type
272 .Pq Vt str
273 The IPv6 equivalent of
274 .Va firewall_type .
275 .It Va firewall_quiet
276 .Pq Vt bool
277 Set to
278 .Dq Li YES
279 to disable the display of firewall rules on the console during boot.
280 .It Va ipv6_firewall_quiet
281 .Pq Vt bool
282 The IPv6 equivalent of
283 .Va firewall_quiet .
284 .It Va firewall_logging
285 .Pq Vt bool
286 Set to
287 .Dq Li YES
288 to enable firewall event logging.
289 This is equivalent to the
290 .Dv IPFIREWALL_VERBOSE
291 kernel option.
292 .It Va ipv6_firewall_logging
293 .Pq Vt bool
294 The IPv6 equivalent of
295 .Va firewall_logging .
296 .It Va firewall_flags
297 .Pq Vt str
298 Flags passed to
299 .Xr ipfw 8
300 if
301 .Va firewall_type
302 specifies a filename.
303 .It Va ipv6_firewall_flags
304 .Pq Vt str
305 The IPv6 equivalent of
306 .Va firewall_flags .
307 .It Va natd_program
308 .Pq Vt str
309 Path to
310 .Xr natd 8 .
311 .It Va natd_enable
312 .Pq Vt bool
313 Set to
314 .Dq Li YES
315 to enable
316 .Xr natd 8 .
317 .Va firewall_enable
318 must also be set to
319 .Dq Li YES ,
320 and
321 .Xr divert 4
322 sockets must be enabled in the kernel.
323 .It Va natd_interface
324 .Pq Vt str
325 This is the name of the public interface on which
326 .Xr natd 8
327 should run.
328 The interface may be given as an interface name or as an IP address.
329 .It Va natd_flags
330 .Pq Vt str
331 Additional
332 .Xr natd 8
333 flags should be placed here.
334 The
335 .Fl n
336 or
337 .Fl a
338 flag is automatically added with the above
339 .Va natd_interface
340 as an argument.
341 .\" ----- ipfilter_enable setting --------------------------------
342 .It Va ipfilter_enable
343 .Pq Vt bool
344 Set to
345 .Dq Li NO
346 by default.
347 Setting this to
348 .Dq Li YES
349 enables
350 .Xr ipf 8
351 packet filtering.
352 .Pp
353 Typical usage will require putting
354 .Bd -literal
355 ipfilter_enable="YES"
356 ipnat_enable="YES"
357 ipmon_enable="YES"
358 ipfs_enable="YES"
359 .Ed
360 .Pp
361 into
362 .Pa /etc/rc.conf
363 and editing
364 .Pa /etc/ipf.rules
365 and
366 .Pa /etc/ipnat.rules
367 appropriately.
368 .Pp
369 Note that
370 .Va ipfilter_enable
371 and
372 .Va ipnat_enable
373 can be enabled independently.
374 .Va ipmon_enable
375 and
376 .Va ipfs_enable
377 both require at least one of
378 .Va ipfilter_enable
379 and
380 .Va ipnat_enable
381 to be enabled.
382 .Pp
383 Having
384 .Bd -literal
385 options IPFILTER
386 options IPFILTER_LOG
387 options IPFILTER_DEFAULT_BLOCK
388 .Ed
389 .Pp
390 in the kernel configuration file is a good idea, too.
391 .\" ----- ipfilter_program setting ------------------------------
392 .It Va ipfilter_program
393 .Pq Vt str
394 Path to
395 .Xr ipf 8
396 (default
397 .Pa /sbin/ipf ) .
398 .\" ----- ipfilter_rules setting --------------------------------
399 .It Va ipfilter_rules
400 .Pq Vt str
401 Set to
402 .Pa /etc/ipf.rules
403 by default.
404 This variable contains the name of the filter rule definition file.
405 The file is expected to be readable for the
406 .Xr ipf 8
407 command to execute.
408 .\" ----- ipv6_ipfilter_rules setting ---------------------------
409 .It Va ipv6_ipfilter_rules
410 .Pq Vt str
411 Set to
412 .Pa /etc/ipf6.rules
413 by default.
414 This variable contains the IPv6 filter rule definition file.
415 The file is expected to be readable for the
416 .Xr ipf 8
417 command to execute.
418 .\" ----- ipfilter_flags setting --------------------------------
419 .It Va ipfilter_flags
420 .Pq Vt str
421 Empty by default.
422 This variable contains flags passed to the
423 .Xr ipf 8
424 program.
425 .\" ----- ipnat_enable setting ----------------------------------
426 .It Va ipnat_enable
427 .Pq Vt bool
428 Set to
429 .Dq Li NO
430 by default.
431 Set it to
432 .Dq Li YES
433 to enable
434 .Xr ipnat 8
435 network address translation.
436 See
437 .Va ipfilter_enable
438 for a detailed discussion.
439 .\" ----- ipnat_program setting ---------------------------------
440 .It Va ipnat_program
441 .Pq Vt str
442 Path to
443 .Xr ipnat 8
444 (default
445 .Pa /sbin/ipnat ) .
446 .\" ----- ipnat_rules setting -----------------------------------
447 .It Va ipnat_rules
448 .Pq Vt str
449 Set to
450 .Pa /etc/ipnat.rules
451 by default.
452 This variable contains the name of the file
453 holding the network address translation definition.
454 This file is expected to be readable for the
455 .Xr ipnat 8
456 command to execute.
457 .\" ----- ipnat_flags setting -----------------------------------
458 .It Va ipnat_flags
459 .Pq Vt str
460 Empty by default.
461 This variable contains flags passed to the
462 .Xr ipnat 8
463 program.
464 .\" ----- ipmon_enable setting ----------------------------------
465 .It Va ipmon_enable
466 .Pq Vt bool
467 Set to
468 .Dq Li NO
469 by default.
470 Set it to
471 .Dq Li YES
472 to enable
473 .Xr ipmon 8
474 monitoring (logging
475 .Xr ipf 8
476 and
477 .Xr ipnat 8
478 events).
479 Setting this variable needs setting
480 .Va ipfilter_enable
481 or
482 .Va ipnat_enable
483 too.
484 See
485 .Va ipfilter_enable
486 for a detailed discussion.
487 .\" ----- ipmon_program setting ---------------------------------
488 .It Va ipmon_program
489 .Pq Vt str
490 Path to
491 .Xr ipmon 8
492 (default
493 .Pa /sbin/ipmon ) .
494 .\" ----- ipmon_flags setting -----------------------------------
495 .It Va ipmon_flags
496 .Pq Vt str
497 Set to
498 .Dq Li -Ds
499 by default.
500 This variable contains flags passed to the
501 .Xr ipmon 8
502 program.
503 Another typical example would be
504 .Dq Fl D Pa /var/log/ipflog
505 to have
506 .Xr ipmon 8
507 log directly to a file bypassing
508 .Xr syslogd 8 .
509 Make sure to adjust
510 .Pa /etc/newsyslog.conf
511 in such case like this:
512 .Bd -literal
513 /var/log/ipflog  640  10  100  *  Z  /var/run/ipmon.pid
514 .Ed
515 .\" ----- ipfs_enable setting -----------------------------------
516 .It Va ipfs_enable
517 .Pq Vt bool
518 Set to
519 .Dq Li NO
520 by default.
521 Set it to
522 .Dq Li YES
523 to enable
524 .Xr ipfs 8
525 saving the filter and NAT state tables during shutdown
526 and reloading them during startup again.
527 Setting this variable needs setting
528 .Va ipfilter_enable
529 or
530 .Va ipnat_enable
531 to
532 .Dq Li YES
533 too.
534 See
535 .Va ipfilter_enable
536 for a detailed discussion.
537 Note that if
538 .Va kern_securelevel
539 is set to 3,
540 .Va ipfs_enable
541 cannot be used
542 because the raised securelevel will prevent
543 .Xr ipfs 8
544 from saving the state tables at shutdown time.
545 .\" ----- ipfs_program setting ----------------------------------
546 .It Va ipfs_program
547 .Pq Vt str
548 Path to
549 .Xr ipfs 8
550 (default
551 .Pa /sbin/ipfs ) .
552 .\" ----- ipfs_flags setting ------------------------------------
553 .It Va ipfs_flags
554 .Pq Vt str
555 Empty by default.
556 This variable contains flags passed to the
557 .Xr ipfs 8
558 program.
559 .\" ----- end of added ipf hook ---------------------------------
560 .It Va tcp_extensions
561 .Pq Vt bool
562 Set to
563 .Dq Li YES
564 by default.
565 Setting this to
566 .Dq Li NO
567 disables certain TCP options as described by
568 .Rs
569 .%T "RFC 1323"
570 .Re
571 Setting this to
572 .Dq Li NO
573 might help remedy such problems with connections as randomly hanging
574 or other weird behavior.
575 Some network devices are known
576 to be broken with respect to these options.
577 .It Va log_in_vain
578 .Pq Vt int
579 Set to 0 by default.
580 The
581 .Xr sysctl 8
582 variables,
583 .Va net.inet.tcp.log_in_vain
584 and
585 .Va net.inet.udp.log_in_vain ,
586 as described in
587 .Xr tcp 4
588 and
589 .Xr udp 4 ,
590 are set to the given value.
591 .It Va tcp_keepalive
592 .Pq Vt bool
593 Set to
594 .Dq Li YES
595 by default.
596 Setting to
597 .Dq Li NO
598 will disable probing idle TCP connections to verify that the
599 peer is still up and reachable.
600 .It Va tcp_drop_synfin
601 .Pq Vt bool
602 Set to
603 .Dq Li NO
604 by default.
605 Setting to
606 .Dq Li YES
607 will cause the kernel to ignore TCP frames that have both
608 the SYN and FIN flags set.
609 This prevents OS fingerprinting, but may
610 break some legitimate applications.
611 This option is only available if the
612 kernel was built with the
613 .Dv TCP_DROP_SYNFIN
614 option.
615 .It Va icmp_drop_redirect
616 .Pq Vt bool
617 Set to
618 .Dq Li NO
619 by default.
620 Setting to
621 .Dq Li YES
622 will cause the kernel to ignore ICMP REDIRECT packets.
623 Refer to
624 .Xr icmp 4
625 for more information.
626 .It Va icmp_log_redirect
627 .Pq Vt bool
628 Set to
629 .Dq Li NO
630 by default.
631 Setting to
632 .Dq Li YES
633 will cause the kernel to log ICMP REDIRECT packets.
634 Note that
635 the log messages are not rate-limited, so this option should only be used
636 for troubleshooting networks.
637 Refer to
638 .Xr icmp 4
639 for more information.
640 .It Va icmp_bmcastecho
641 .Pq Vt bool
642 Set to
643 .Dq Li YES
644 to respond to broadcast or multicast ICMP ping packets.
645 Refer to
646 .Xr icmp 4
647 for more information.
648 .It Va ip_portrange_first
649 .Pq Vt int
650 If not set to
651 .Dq Li NO ,
652 this is the first port in the default portrange.
653 Refer to
654 .Xr ip 4
655 for more information.
656 .It Va ip_portrange_last
657 .Pq Vt int
658 If not set to
659 .Dq Li NO ,
660 this is the last port in the default portrange.
661 Refer to
662 .Xr ip 4
663 for more information.
664 .It Va network_interfaces
665 .Pq Vt str
666 Set to the list of network interfaces to configure on this host.
667 For example, if the only network devices in the system are the loopback
668 device
669 .Pq Li lo0
670 and a NIC using the
671 .Xr ed 4
672 driver,
673 this could be set to
674 .Dq Li "lo0 ed0" .
675 An
676 .Va ifconfig_ Ns Aq Ar interface
677 variable is also assumed to exist for each value of
678 .Ar interface .
679 It is also possible to add IP alias entries here in cases where
680 multiple IP addresses registered against a single interface
681 are desired.
682 Assuming that the interface in question was
683 .Li ed0 ,
684 it might look
685 something like this:
686 .Bd -literal
687 ifconfig_ed0_alias0="inet 127.0.0.253 netmask 0xffffffff"
688 ifconfig_ed0_alias1="inet 127.0.0.254 netmask 0xffffffff"
689 .Ed
690 .Pp
691 And so on.
692 For each
693 .Va ifconfig_ Ns Ao Ar interface Ac Ns Va _alias Ns Aq Ar n
694 entry that is found,
695 its contents are passed to
696 .Xr ifconfig 8 .
697 Execution stops at the first unsuccessful access, so if
698 something like this is present:
699 .Bd -literal
700 ifconfig_ed0_alias0="inet 127.0.0.251 netmask 0xffffffff"
701 ifconfig_ed0_alias1="inet 127.0.0.252 netmask 0xffffffff"
702 ifconfig_ed0_alias2="inet 127.0.0.253 netmask 0xffffffff"
703 ifconfig_ed0_alias4="inet 127.0.0.254 netmask 0xffffffff"
704 .Ed
705 .Pp
706 Then note that alias4 would
707 .Em not
708 be added since the search would
709 stop with the missing alias3 entry.
710 .Pp
711 If the
712 .Pa /etc/start_if. Ns Aq Ar interface
713 file is present, it is read and executed by the
714 .Xr sh 1
715 interpreter
716 before configuring the interface as specified in the
717 .Va ifconfig_ Ns Aq Ar interface
718 and
719 .Va ifconfig_ Ns Ao Ar interface Ac Ns Va _alias Ns Aq Ar n
720 variables.
721 .Pp
722 It is possible to bring up an interface with DHCP by setting the
723 .Va ifconfig_ Ns Aq Ar interface
724 variable to
725 .Dq Li DHCP .
726 For instance, to initialize the
727 .Li ed0
728 device via DHCP,
729 it is possible to use something like:
730 .Bd -literal
731 ifconfig_ed0="DHCP"
732 .Ed
733 .It Va ipv6_network_interfaces
734 .Pq Vt str
735 This is the IPv6 equivalent of
736 .Va network_interfaces .
737 Instead of setting the ifconfig variables as
738 .Va ifconfig_ Ns Aq Ar interface
739 they should be set as
740 .Va ipv6_ifconfig_ Ns Aq Ar interface .
741 Aliases should be set as
742 .Va ipv6_ifconfig_ Ns Ao Ar interface Ac Ns Va _alias Ns Aq Ar n .
743 .Va ipv6_prefix_ Ns Aq Ar interface
744 does something.
745 Interfaces that do not have a
746 .Va ipv6_ifconfig_ Ns Aq Ar interface
747 setting will be auto configured by
748 .Xr rtsol 8
749 if the
750 .Va ipv6_gateway_enable
751 is set to
752 .Dq Li NO .
753 Note that the IPv6 networking code does not support the
754 .Pa /etc/start_if. Ns Aq Ar interface
755 files.
756 .It Va ipv6_default_interface
757 .Pq Vt str
758 If not set to
759 .Dq Li NO ,
760 this is the default output interface for scoped addresses.
761 Now this works only for IPv6 link local multicast addresses.
762 .It Va cloned_interfaces
763 .Pq Vt str
764 Set to the list of clonable network interfaces to create on this host.
765 Entries in
766 .Va cloned_interfaces
767 are automatically appended to
768 .Va network_interfaces
769 for configuration.
770 .It Va gif_interfaces
771 .Pq Vt str
772 Set to the list of
773 .Xr gif 4
774 tunnel interfaces to configure on this host.
775 A
776 .Va gifconfig_ Ns Aq Ar interface
777 variable is assumed to exist for each value of
778 .Ar interface .
779 The value of this variable is used to configure the link layer of the
780 tunnel according to the syntax of the
781 .Cm tunnel
782 option to
783 .Xr ifconfig 8 .
784 Additionally, this option ensures that each listed interface is created
785 via the
786 .Cm create
787 option to
788 .Xr ifconfig 8
789 before attempting to configure it.
790 .It Va sppp_interfaces
791 .Pq Vt str
792 Set to the list of
793 .Xr sppp 4
794 interfaces to configure on this host.
795 A
796 .Va spppconfig_ Ns Aq Ar interface
797 variable is assumed to exist for each value of
798 .Ar interface .
799 Each interface should also be configured by a general
800 .Va ifconfig_ Ns Aq Ar interface
801 setting.
802 Refer to
803 .Xr spppcontrol 8
804 for more information about available options.
805 .It Va ppp_enable
806 .Pq Vt bool
807 If set to
808 .Dq Li YES ,
809 run the
810 .Xr ppp 8
811 daemon.
812 .It Va ppp_mode
813 .Pq Vt str
814 Mode in which to run the
815 .Xr ppp 8
816 daemon.
817 Accepted modes are
818 .Dq Li auto ,
819 .Dq Li ddial ,
820 .Dq Li direct
821 and
822 .Dq Li dedicated .
823 See the manual for a full description.
824 .It Va ppp_nat
825 .Pq Vt bool
826 If set to
827 .Dq Li YES ,
828 enables network address translation.
829 Used in conjunction with
830 .Va gateway_enable
831 allows hosts on private network addresses access to the Internet using
832 this host as a network address translating router.
833 .It Va ppp_profile
834 .Pq Vt str
835 The name of the profile to use from
836 .Pa /etc/ppp/ppp.conf .
837 .It Va ppp_user
838 .Pq Vt str
839 The name of the user under which
840 .Xr ppp 8
841 should be started.
842 By
843 default,
844 .Xr ppp 8
845 is started as
846 .Dq Li root .
847 .It Va rc_conf_files
848 .Pq Vt str
849 This option is used to specify a list of files that will override
850 the settings in
851 .Pa /etc/defaults/rc.conf .
852 The files will be read in the order in which they are specified and should
853 include the full path to the file.
854 By default, the files specified are
855 .Pa /etc/rc.conf
856 and
857 .Pa /etc/rc.conf.local
858 .It Va fsck_y_enable
859 .Pq Vt bool
860 If set to
861 .Dq Li YES ,
862 .Xr fsck 8
863 will be run with the
864 .Fl y
865 flag if the initial preen
866 of the file systems fails.
867 .It Va netfs_types
868 .Pq Vt str
869 List of file system types that are network-based.
870 This list should generally not be modified by end users.
871 Use
872 .Va extra_netfs_types
873 instead.
874 .It Va extra_netfs_types
875 .Pq Vt str
876 If set to something other than
877 .Dq Li NO
878 (the default),
879 this variable extends the list of file system types
880 for which automatic mounting at startup by
881 .Xr rc 8
882 should be delayed until the network is initialized.
883 It should contain
884 a whitespace-separated list of network file system descriptor pairs,
885 each consisting of a file system type as passed to
886 .Xr mount 8
887 and a human-readable, one-word description,
888 joined with a colon
889 .Pq Ql \&: .
890 Extending the default list in this way is only necessary
891 when third party file system types are used.
892 .It Va syslogd_enable
893 .Pq Vt bool
894 If set to
895 .Dq Li YES ,
896 run the
897 .Xr syslogd 8
898 daemon.
899 .It Va syslogd_program
900 .Pq Vt str
901 Path to
902 .Xr syslogd 8
903 (default
904 .Pa /usr/sbin/syslogd ) .
905 .It Va syslogd_flags
906 .Pq Vt str
907 If
908 .Va syslogd_enable
909 is set to
910 .Dq Li YES ,
911 these are the flags to pass to
912 .Xr syslogd 8 .
913 .It Va inetd_enable
914 .Pq Vt bool
915 If set to
916 .Dq Li YES ,
917 run the
918 .Xr inetd 8
919 daemon.
920 .It Va inetd_program
921 .Pq Vt str
922 Path to
923 .Xr inetd 8
924 (default
925 .Pa /usr/sbin/inetd ) .
926 .It Va inetd_flags
927 .Pq Vt str
928 If
929 .Va inetd_enable
930 is set to
931 .Dq Li YES ,
932 these are the flags to pass to
933 .Xr inetd 8 .
934 .It Va named_rcng
935 .Pq Vt bool
936 If set to
937 .Dq Li YES
938 use new functionality provided in the
939 .Pa /etc/rc.d/named
940 script to facilitate a
941 .Xr chroot 8
942 instance of
943 .Xr named 8 .
944 This variable is experimental.
945 It may be removed or changed in the near future.
946 .It Va named_enable
947 .Pq Vt bool
948 If set to
949 .Dq Li YES ,
950 run the
951 .Xr named 8
952 daemon.
953 .It Va named_program
954 .Pq Vt str
955 Path to
956 .Xr named 8
957 (default
958 .Pa /usr/sbin/named ) .
959 .It Va named_flags
960 .Pq Vt str
961 If
962 .Va named_enable
963 is set to
964 .Dq Li YES ,
965 these are the flags to pass to
966 .Xr named 8 .
967 .It Va named_pidfile
968 .Pq Vt str
969 This is the default path to the
970 .Xr named 8
971 daemon's PID file.
972 Change it if you change the location in
973 .Pa /etc/namedb/named.conf .
974 .It Va named_chrootdir
975 .Pq Vt str
976 The root directory for a name server run in a
977 .Xr chroot 8
978 environment.
979 If left empty
980 .Xr named 8
981 will not be run in a
982 .Xr chroot 8
983 environment.
984 This variable has no effect if
985 .Va named_rcng
986 is not enabled.
987 This variable is experimental.
988 It may be removed or changed in the near future.
989 .It Va named_chroot_autoupdate
990 .Pq Vt bool
991 Set to
992 .Dq Li NO
993 to disable automatic syncing of libraries and
994 other system files between the root file system and the
995 .Xr chroot 8 .
996 This variable has no effect if
997 .Va named_rcng
998 is not enabled.
999 This variable is experimental.
1000 It may be removed or changed in the near future.
1001 .It Va named_symlink_enable
1002 .Pq Vt bool
1003 Set to
1004 .Dq Li NO
1005 to disable symlinking of
1006 .Va named_pidfile
1007 and
1008 .Pa /var/run/ndc
1009 into the
1010 .Xr chroot 8
1011 environment in which
1012 .Xr named 8
1013 is running.
1014 This variable has no effect if
1015 .Va named_rcng
1016 is not enabled.
1017 This variable is experimental.
1018 It may be removed or changed in the near future.
1019 .It Va kerberos5_server_enable
1020 .Pq Vt bool
1021 Set to
1022 .Dq Li YES
1023 to start a Kerberos 5 authentication server
1024 at boot time.
1025 .It Va kerberos5_server
1026 .Pq Vt str
1027 If
1028 .Va kerberos5_server_enable
1029 is set to
1030 .Dq Li YES
1031 this is the path to Kerberos 5 Authentication Server.
1032 .It Va kadmind5_server_enable
1033 .Pq Vt bool
1034 Set to
1035 .Dq Li YES
1036 to start
1037 .Xr kadmind 8 ,
1038 the Kerberos 5 Administration Daemon; set to
1039 .Dq Li NO
1040 on a slave server.
1041 .It Va kadmind5_server
1042 .Pq Vt str
1043 If
1044 .Va kadmind5_server_enable
1045 is set to
1046 .Dq Li YES
1047 this is the path to Kerberos 5 Administration Daemon.
1048 .It Va kpasswdd_server_enable
1049 .Pq Vt bool
1050 Set to
1051 .Dq Li YES
1052 to start
1053 .Xr kpasswdd 8 ,
1054 the Kerberos 5 Password-Changing Daemon; set to
1055 .Dq Li NO
1056 on a slave server.
1057 .It Va kpasswdd_server
1058 .Pq Vt str
1059 If
1060 .Va kpasswdd_server_enable
1061 is set to
1062 .Dq Li YES
1063 this is the path to Kerberos 5 Password-Changing Daemon.
1064 .It Va rwhod_enable
1065 .Pq Vt bool
1066 If set to
1067 .Dq Li YES ,
1068 run the
1069 .Xr rwhod 8
1070 daemon at boot time.
1071 .It Va rwhod_flags
1072 .Pq Vt str
1073 If
1074 .Va rwhod_enable
1075 is set to
1076 .Dq Li YES ,
1077 these are the flags to pass to it.
1078 .It Va amd_enable
1079 .Pq Vt bool
1080 If set to
1081 .Dq Li YES ,
1082 run the
1083 .Xr amd 8
1084 daemon at boot time.
1085 .It Va amd_flags
1086 .Pq Vt str
1087 If
1088 .Va amd_enable
1089 is set to
1090 .Dq Li YES ,
1091 these are the flags to pass to it.
1092 See the
1093 .Xr amd 8
1094 manpage for more information.
1095 .It Va amd_map_program
1096 .Pq Vt str
1097 If set,
1098 the specified program is run to get the list of
1099 .Xr amd 8
1100 maps.
1101 For example, if the
1102 .Xr amd 8
1103 maps are stored in NIS, one can set this to
1104 run
1105 .Xr ypcat 1
1106 to get a list of
1107 .Xr amd 8
1108 maps from the
1109 .Pa amd.master
1110 NIS map.
1111 .It Va update_motd
1112 .Pq Vt bool
1113 If set to
1114 .Dq Li YES ,
1115 .Pa /etc/motd
1116 will be updated at boot time to reflect the kernel release
1117 being run.
1118 If set to
1119 .Dq Li NO ,
1120 .Pa /etc/motd
1121 will not be updated.
1122 .It Va nfs_client_enable
1123 .Pq Vt bool
1124 If set to
1125 .Dq Li YES ,
1126 run the NFS client daemons at boot time.
1127 .It Va nfs_access_cache
1128 .Pq Vt int
1129 If
1130 .Va nfs_client_enable
1131 is set to
1132 .Dq Li YES ,
1133 this can be set to
1134 .Dq Li 0
1135 to disable NFS ACCESS RPC caching, or to the number of seconds for which
1136 NFS ACCESS
1137 results should be cached.
1138 A value of 2-10 seconds will substantially reduce network traffic for
1139 many NFS operations.  The default is 5 seconds.  Note that the attribute
1140 cache holds stat information only.  The NFS data cache is independant
1141 of the attribute cache and is only invalidated when the client detects that
1142 the server has modified the underlying file.  This value specifies a
1143 maximum timeout.  The NFS client will automatically use a shorter timeout
1144 for files which have been recently modified.
1145 .It Va nfs_neg_cache
1146 .Pq Vt int
1147 If
1148 .Va nfs_client_enable
1149 is set to
1150 .Dq Li YES ,
1151 this can be set to
1152 .Dq Li 0
1153 to disable the caching of NEGATIVE LOOKUPS (lookups of non-existant
1154 filenames), or to the number of seconds for which negative lookups should
1155 be cached.
1156 A value of 2-10 seconds will substantially reduce network
1157 traffic for many NFS operations, especially source code builds.  The
1158 default is 3 seconds.
1159 .It Va nfs_server_enable
1160 .Pq Vt bool
1161 If set to
1162 .Dq Li YES ,
1163 run the NFS server daemons at boot time.
1164 .It Va nfs_server_flags
1165 .Pq Vt str
1166 If
1167 .Va nfs_server_enable
1168 is set to
1169 .Dq Li YES ,
1170 these are the flags to pass to the
1171 .Xr nfsd 8
1172 daemon.
1173 .It Va mountd_enable
1174 .Pq Vt bool
1175 If set to
1176 .Dq Li YES ,
1177 and no
1178 .Va nfs_server_enable
1179 is set, start
1180 .Xr mountd 8 ,
1181 but not
1182 .Xr nfsd 8
1183 daemon.
1184 It is commonly needed to run CFS without real NFS used.
1185 .It Va mountd_flags
1186 .Pq Vt str
1187 If
1188 .Va mountd_enable
1189 is set to
1190 .Dq Li YES ,
1191 these are the flags to pass to the
1192 .Xr mountd 8
1193 daemon.
1194 .It Va weak_mountd_authentication
1195 .Pq Vt bool
1196 If set to
1197 .Dq Li YES ,
1198 allow services like PCNFSD to make non-privileged mount
1199 requests.
1200 .It Va nfs_reserved_port_only
1201 .Pq Vt bool
1202 If set to
1203 .Dq Li YES ,
1204 provide NFS services only on a secure port.
1205 .It Va nfs_bufpackets
1206 .Pq Vt int
1207 If set to a number, indicates the number of packets worth of
1208 socket buffer space to reserve on an NFS client.
1209 The kernel default is typically 4.
1210 Using a higher number may be
1211 useful on gigabit networks to improve performance.
1212 The minimum value is
1213 2 and the maximum is 64.
1214 .It Va rpc_umntall_enable
1215 .Pq Vt bool
1216 If set to
1217 .Dq Li YES
1218 (default) and we are also an NFS client, run
1219 .Xr rpc.umntall 8
1220 at boot time to clear out old mounts on remote servers.
1221 If set to
1222 .Dq Li NO
1223 then
1224 .Xr rpc.umntall 8
1225 will not be run at boot time.
1226 .It Va rpc_lockd_enable
1227 .Pq Vt bool
1228 If set to
1229 .Dq Li YES
1230 and also an NFS server, run
1231 .Xr rpc.lockd 8
1232 at boot time.
1233 .It Va rpc_statd_enable
1234 .Pq Vt bool
1235 If set to
1236 .Dq Li YES
1237 and also an NFS server, run
1238 .Xr rpc.statd 8
1239 at boot time.
1240 .It Va rpcbind_program
1241 .Pq Vt str
1242 Path to
1243 .Xr rpcbind 8
1244 (default
1245 .Pa /usr/sbin/rpcbind ) .
1246 .It Va rpcbind_enable
1247 .Pq Vt bool
1248 If set to
1249 .Dq Li YES ,
1250 run the
1251 .Xr rpcbind 8
1252 service at boot time.
1253 .It Va rpcbind_flags
1254 .Pq Vt str
1255 If
1256 .Va rpcbind_enable
1257 is set to
1258 .Dq Li YES ,
1259 these are the flags to pass to the
1260 .Xr rpcbind 8
1261 daemon.
1262 .It Va keyserv_enable
1263 .Pq Vt bool
1264 If set to
1265 .Dq Li YES ,
1266 run the
1267 .Xr keyserv 8
1268 daemon on boot for running Secure RPC.
1269 .It Va keyserv_flags
1270 .Pq Vt str
1271 If
1272 .Va keyserv_enable
1273 is set to
1274 .Dq Li YES ,
1275 these are the flags to pass to
1276 .Xr keyserv 8
1277 daemon.
1278 .It Va pppoed_enable
1279 .Pq Vt bool
1280 If set to
1281 .Dq Li YES ,
1282 run the
1283 .Xr pppoed 8
1284 daemon at boot time to provide PPP over Ethernet services.
1285 .It Va pppoed_ Ns Ar provider
1286 .Pq Vt str
1287 .Xr pppoed 8
1288 listens to requests to this
1289 .Ar provider
1290 and ultimately runs
1291 .Xr ppp 8
1292 with a
1293 .Ar system
1294 argument of the same name.
1295 .It Va pppoed_flags
1296 .Pq Vt str
1297 Additional flags to pass to
1298 .Xr pppoed 8 .
1299 .It Va pppoed_interface
1300 .Pq Vt str
1301 The network interface to run
1302 .Xr pppoed 8
1303 on.
1304 This is mandatory when
1305 .Va pppoed_enable
1306 is set to
1307 .Dq Li YES .
1308 .It Va timed_enable
1309 .Pq Vt bool
1310 If set to
1311 .Dq Li YES ,
1312 run the
1313 .Xr timed 8
1314 service at boot time.
1315 This command is intended for networks of
1316 machines where a consistent
1317 .Dq "network time"
1318 for all hosts must be established.
1319 This is often useful in large NFS
1320 environments where time stamps on files are expected to be consistent
1321 network-wide.
1322 .It Va timed_flags
1323 .Pq Vt str
1324 If
1325 .Va timed_enable
1326 is set to
1327 .Dq Li YES ,
1328 these are the flags to pass to the
1329 .Xr timed 8
1330 service.
1331 .It Va ntpd_enable
1332 .Pq Vt bool
1333 If set to
1334 .Dq Li YES ,
1335 run the
1336 .Xr ntpd 8
1337 command at boot time.
1338 .It Va ntpd_program
1339 .Pq Vt str
1340 Path to
1341 .Xr ntpd 8
1342 (default
1343 .Pa /usr/sbin/ntpd ) .
1344 .It Va ntpd_flags
1345 .Pq Vt str
1346 If
1347 .Va ntpd_enable
1348 is set to
1349 .Dq Li YES ,
1350 these are the flags to pass to the
1351 .Xr ntpd 8
1352 daemon. Set to
1353 .Dq Li -s
1354 by default which sets the time immediately at startup if the
1355 local clock is off by more than 180 seconds. To prevent
1356 .Xr ntpd 8
1357 from doing this, set
1358 .Va ntpd_flags
1359 to
1360 .Dq Li -S .
1361 .It Va nis_client_enable
1362 .Pq Vt bool
1363 If set to
1364 .Dq Li YES ,
1365 run the
1366 .Xr ypbind 8
1367 service at system boot time.
1368 .It Va nis_client_flags
1369 .Pq Vt str
1370 If
1371 .Va nis_client_enable
1372 is set to
1373 .Dq Li YES ,
1374 these are the flags to pass to the
1375 .Xr ypbind 8
1376 service.
1377 .It Va nis_ypset_enable
1378 .Pq Vt bool
1379 If set to
1380 .Dq Li YES ,
1381 run the
1382 .Xr ypset 8
1383 daemon at system boot time.
1384 .It Va nis_ypset_flags
1385 .Pq Vt str
1386 If
1387 .Va nis_ypset_enable
1388 is set to
1389 .Dq Li YES ,
1390 these are the flags to pass to the
1391 .Xr ypset 8
1392 daemon.
1393 .It Va nis_server_enable
1394 .Pq Vt bool
1395 If set to
1396 .Dq Li YES ,
1397 run the
1398 .Xr ypserv 8
1399 daemon at system boot time.
1400 .It Va nis_server_flags
1401 .Pq Vt str
1402 If
1403 .Va nis_server_enable
1404 is set to
1405 .Dq Li YES ,
1406 these are the flags to pass to the
1407 .Xr ypserv 8
1408 daemon.
1409 .It Va nis_ypxfrd_enable
1410 .Pq Vt bool
1411 If set to
1412 .Dq Li YES ,
1413 run the
1414 .Xr rpc.ypxfrd 8
1415 daemon at system boot time.
1416 .It Va nis_ypxfrd_flags
1417 .Pq Vt str
1418 If
1419 .Va nis_ypxfrd_enable
1420 is set to
1421 .Dq Li YES ,
1422 these are the flags to pass to the
1423 .Xr rpc.ypxfrd 8
1424 daemon.
1425 .It Va nis_yppasswdd_enable
1426 .Pq Vt bool
1427 If set to
1428 .Dq Li YES ,
1429 run the
1430 .Xr rpc.yppasswdd 8
1431 daemon at system boot time.
1432 .It Va nis_yppasswdd_flags
1433 .Pq Vt str
1434 If
1435 .Va nis_yppasswdd_enable
1436 is set to
1437 .Dq Li YES ,
1438 these are the flags to pass to the
1439 .Xr rpc.yppasswdd 8
1440 daemon.
1441 .It Va rpc_ypupdated_enable
1442 .Pq Vt bool
1443 If set to
1444 .Dq Li YES ,
1445 run the
1446 .Nm rpc.ypupdated
1447 daemon at system boot time.
1448 .It Va defaultrouter
1449 .Pq Vt str
1450 If not set to
1451 .Dq Li NO ,
1452 create a default route to this host name or IP address
1453 (use an IP address if this router is also required to get to the
1454 name server!).
1455 .It Va ipv6_defaultrouter
1456 .Pq Vt str
1457 The IPv6 equivalent of
1458 .Va defaultrouter .
1459 .It Va static_routes
1460 .Pq Vt str
1461 Set to the list of static routes that are to be added at system
1462 boot time.
1463 If not set to
1464 .Dq Li NO
1465 then for each whitespace separated
1466 .Ar element
1467 in the value, a
1468 .Va route_ Ns Aq Ar element
1469 variable is assumed to exist
1470 whose contents will later be passed to a
1471 .Dq Nm route Cm add
1472 operation.
1473 .It Va ipv6_static_routes
1474 .Pq Vt str
1475 The IPv6 equivalent of
1476 .Va static_routes .
1477 If not set to
1478 .Dq Li NO
1479 then for each whitespace separated
1480 .Ar element
1481 in the value, a
1482 .Va ipv6_route_ Ns Aq Ar element
1483 variable is assumed to exist
1484 whose contents will later be passed to a
1485 .Dq Nm route Cm add Fl inet6
1486 operation.
1487 .It Va gateway_enable
1488 .Pq Vt bool
1489 If set to
1490 .Dq Li YES ,
1491 configure host to act as an IP router, e.g. to forward packets
1492 between interfaces.
1493 .It Va ipv6_gateway_enable
1494 .Pq Vt bool
1495 The IPv6 equivalent of
1496 .Va gateway_enable .
1497 .It Va router_enable
1498 .Pq Vt bool
1499 If set to
1500 .Dq Li YES ,
1501 run a routing daemon of some sort, based on the
1502 settings of
1503 .Va router
1504 and
1505 .Va router_flags .
1506 .It Va ipv6_router_enable
1507 .Pq Vt bool
1508 The IPv6 equivalent of
1509 .Va router_enable .
1510 If set to
1511 .Dq Li YES ,
1512 run a routing daemon of some sort, based on the
1513 settings of
1514 .Va ipv6_router
1515 and
1516 .Va ipv6_router_flags .
1517 .It Va router
1518 .Pq Vt str
1519 If
1520 .Va router_enable
1521 is set to
1522 .Dq Li YES ,
1523 this is the name of the routing daemon to use.
1524 .It Va ipv6_router
1525 .Pq Vt str
1526 The IPv6 equivalent of
1527 .Va router .
1528 .It Va router_flags
1529 .Pq Vt str
1530 If
1531 .Va router_enable
1532 is set to
1533 .Dq Li YES ,
1534 these are the flags to pass to the routing daemon.
1535 .It Va ipv6_router_flags
1536 .Pq Vt str
1537 The IPv6 equivalent of
1538 .Va router_flags .
1539 .It Va mrouted_enable
1540 .Pq Vt bool
1541 If set to
1542 .Dq Li YES ,
1543 run the multicast routing daemon,
1544 .Xr mrouted 8 .
1545 .It Va mroute6d_enable
1546 .Pq Vt bool
1547 The IPv6 equivalent of
1548 .Va mrouted_enable .
1549 If set to
1550 .Dq Li YES ,
1551 run the IPv6 multicast routing daemon.
1552 Note that no IPv6 multicast routing daemon is included in the
1553 .Dx
1554 base system but
1555 .Xr pim6dd 8
1556 can be installed from the
1557 .Fx
1558 Ports Collection.
1559 .It Va mrouted_flags
1560 .Pq Vt str
1561 If
1562 .Va mrouted_enable
1563 is set to
1564 .Dq Li YES ,
1565 these are the flags to pass to the
1566 .Xr mrouted 8
1567 daemon.
1568 .It Va mroute6d_flags
1569 .Pq Vt str
1570 The IPv6 equivalent of
1571 .Va mrouted_flags .
1572 If
1573 .Va mroute6d_enable
1574 is set to
1575 .Dq Li YES ,
1576 these are the flags passed to the IPv6 multicast routing daemon.
1577 .It Va mroute6d_program
1578 .Pq Vt str
1579 If
1580 .Va mroute6d_enable
1581 is set to
1582 .Dq Li YES ,
1583 this is the path to the IPv6 multicast routing daemon.
1584 .It Va rtadvd_enable
1585 .Pq Vt bool
1586 If set to
1587 .Dq Li YES ,
1588 run the
1589 .Xr rtadvd 8
1590 daemon at boot time.
1591 .Xr rtadvd 8
1592 will only run if
1593 .Va ipv6_gateway_enable
1594 is also set to
1595 .Dq Li YES .
1596 The
1597 .Xr rtadvd 8
1598 utility sends router advertisement packets to the interfaces specified in
1599 .Va rtadvd_interfaces .
1600 .Xr rtadvd 8
1601 and should only be enabled with great care.
1602 You may want to fine-tune
1603 .Xr rtadvd.conf 5 .
1604 .It Va rtadvd_interfaces
1605 .Pq Vt str
1606 If
1607 .Va rtadvd_enable
1608 is set to
1609 .Dq Li YES
1610 this is the list of interfaces to use.
1611 .It Va ipxgateway_enable
1612 .Pq Vt bool
1613 If set to
1614 .Dq Li YES ,
1615 enable the routing of IPX traffic.
1616 .It Va ipxrouted_enable
1617 .Pq Vt bool
1618 If set to
1619 .Dq Li YES ,
1620 run the
1621 .Xr IPXrouted 8
1622 daemon at system boot time.
1623 .It Va ipxrouted_flags
1624 .Pq Vt str
1625 If
1626 .Va ipxrouted_enable
1627 is set to
1628 .Dq Li YES ,
1629 these are the flags to pass to the
1630 .Xr IPXrouted 8
1631 daemon.
1632 .It Va arpproxy_all
1633 .Pq Vt bool
1634 If set to
1635 .Dq Li YES ,
1636 enable global proxy ARP.
1637 .It Va forward_sourceroute
1638 .Pq Vt bool
1639 If set to
1640 .Dq Li YES
1641 and
1642 .Va gateway_enable
1643 is also set to
1644 .Dq Li YES ,
1645 source-routed packets are forwarded.
1646 .It Va accept_sourceroute
1647 .Pq Vt bool
1648 If set to
1649 .Dq Li YES ,
1650 the system will accept source-routed packets directed at it.
1651 .It Va rarpd_enable
1652 .Pq Vt bool
1653 If set to
1654 .Dq Li YES ,
1655 run the
1656 .Xr rarpd 8
1657 daemon at system boot time.
1658 .It Va rarpd_flags
1659 .Pq Vt str
1660 If
1661 .Va rarpd_enable
1662 is set to
1663 .Dq Li YES ,
1664 these are the flags to pass to the
1665 .Xr rarpd 8
1666 daemon.
1667 .It Va bootparamd_enable
1668 .Pq Vt bool
1669 If set to
1670 .Dq Li YES ,
1671 run the
1672 .Xr bootparamd 8
1673 daemon at system boot time.
1674 .It Va bootparamd_flags
1675 .Pq Vt str
1676 If
1677 .Va bootparamd_enable
1678 is set to
1679 .Dq Li YES ,
1680 these are the flags to pass to the
1681 .Xr bootparamd 8
1682 daemon.
1683 .It Va stf_interface_ipv4addr
1684 .Pq Vt str
1685 If not set to
1686 .Dq Li NO ,
1687 this is the local IPv4 address for 6to4 (IPv6 over IPv4 tunneling
1688 interface).
1689 Specify this entry to enable the 6to4 interface.
1690 .It Va stf_interface_ipv4plen
1691 .Pq Vt int
1692 Prefix length for 6to4 IPv4 addresses, to limit peer address range.
1693 An effective value is 0-31.
1694 .It Va stf_interface_ipv6_ifid
1695 .Pq Vt str
1696 IPv6 interface ID for
1697 .Xr stf 4 .
1698 This can be set to
1699 .Dq Li AUTO .
1700 .It Va stf_interface_ipv6_slaid
1701 .Pq Vt str
1702 IPv6 Site Level Aggregator for
1703 .Xr stf 4 .
1704 .It Va ipv6_faith_prefix
1705 .Pq Vt str
1706 If not set to
1707 .Dq Li NO ,
1708 this is the faith prefix to enable a FAITH IPv6-to-IPv4 TCP
1709 translator.
1710 You also need
1711 .Xr faithd 8
1712 setup.
1713 .It Va ipv6_ipv4mapping
1714 .Pq Vt bool
1715 If set to
1716 .Dq Li YES
1717 this enables IPv4 mapped IPv6 address communication (like
1718 .Li ::ffff:a.b.c.d ) .
1719 .It Va atm_enable
1720 .Pq Vt bool
1721 Set to
1722 .Dq Li YES
1723 to enable the configuration of ATM interfaces at system boot time.
1724 For all of the ATM variables described below, please refer to the
1725 .Xr atm 8
1726 man page for further details on the available command parameters.
1727 Also refer to the files in
1728 .Pa /usr/share/examples/atm
1729 for more detailed configuration information.
1730 .It Va atm_load
1731 .Pq Vt str
1732 This is a list of physical ATM interface drivers to load. Typical values are
1733 .Dq Li hfa_pci
1734 and/or
1735 .Dq Li hea_pci .
1736 .It Va atm_netif_ Ns Aq Ar intf
1737 .Pq Vt str
1738 For the ATM physical interface
1739 .Ar intf ,
1740 this variable defines the name prefix and count for the ATM network
1741 interfaces to be created.
1742 The value will be passed as the parameters of an
1743 .Dq Nm atm Cm "set netif" Ar intf
1744 command.
1745 .It Va atm_sigmgr_ Ns Aq Ar intf
1746 .Pq Vt str
1747 For the ATM physical interface
1748 .Ar intf ,
1749 this variable defines the ATM signalling manager to be used.
1750 The value will be passed as the parameters of an
1751 .Dq Nm atm Cm attach Ar intf
1752 command.
1753 .It Va atm_prefix_ Ns Aq Ar intf
1754 .Pq Vt str
1755 For the ATM physical interface
1756 .Ar intf ,
1757 this variable defines the NSAP prefix for interfaces using a UNI signalling
1758 manager.
1759 If set to
1760 .Dq Li ILMI ,
1761 the prefix will automatically be set via the
1762 .Xr ilmid 8
1763 daemon.
1764 Otherwise, the value will be passed as the parameters of an
1765 .Dq Nm atm Cm "set prefix" Ar intf
1766 command.
1767 .It Va atm_macaddr_ Ns Aq Ar intf
1768 .Pq Vt str
1769 For the ATM physical interface
1770 .Ar intf ,
1771 this variable defines the MAC address for interfaces using a UNI signalling
1772 manager.
1773 If set to
1774 .Dq Li NO ,
1775 the hardware MAC address contained in the ATM interface card will be used.
1776 Otherwise, the value will be passed as the parameters of an
1777 .Dq Nm atm Cm "set mac" Ar intf
1778 command.
1779 .It Va atm_arpserver_ Ns Aq Ar netif
1780 .Pq Vt str
1781 For the ATM network interface
1782 .Ar netif ,
1783 this variable defines the ATM address for a host which is to provide ATMARP
1784 service.
1785 This variable is only applicable to interfaces using a UNI signalling
1786 manager.
1787 If set to
1788 .Dq Li local ,
1789 this host will become an ATMARP server.
1790 The value will be passed as the parameters of an
1791 .Dq Nm atm Cm "set arpserver" Ar netif
1792 command.
1793 .It Va atm_scsparp_ Ns Aq Ar netif
1794 .Pq Vt bool
1795 If set to
1796 .Dq Li YES ,
1797 SCSP/ATMARP service for the network interface
1798 .Ar netif
1799 will be initiated using the
1800 .Xr scspd 8
1801 and
1802 .Xr atmarpd 8
1803 daemons.
1804 This variable is only applicable if
1805 .Va atm_arpserver_ Ns Aq Ar netif
1806 is set to
1807 .Dq Li local .
1808 .It Va atm_pvcs
1809 .Pq Vt str
1810 Set to the list of ATM PVCs to be added at system
1811 boot time.
1812 For each whitespace separated
1813 .Ar element
1814 in the value, an
1815 .Va atm_pvc_ Ns Aq Ar element
1816 variable is assumed to exist.
1817 The value of each of these variables
1818 will be passed as the parameters of an
1819 .Dq Nm atm Cm "add pvc"
1820 command.
1821 .It Va atm_arps
1822 .Pq Vt str
1823 Set to the list of permanent ATM ARP entries to be added
1824 at system boot time.
1825 For each whitespace separated
1826 .Ar element
1827 in the value, an
1828 .Va atm_arp_ Ns Aq Ar element
1829 variable is assumed to exist.
1830 The value of each of these variables
1831 will be passed as the parameters of an
1832 .Dq Nm atm Cm "add arp"
1833 command.
1834 .It Va natm_interfaces
1835 .Pq Vt str
1836 Set to the list of
1837 .Xr natm 4
1838 interfaces that will also be used for HARP through
1839 .Xr harp 4 .
1840 If this list is not empty all interfaces in the list will be brought up
1841 with
1842 .Xr ifconfig 9
1843 and
1844 .Xr harp 4
1845 will be loaded.
1846 For this to work the interface drivers must be either compiled into the
1847 kernel or must reside on the root partition.
1848 .It Va keybell
1849 .Pq Vt str
1850 The keyboard bell sound.
1851 Set to
1852 .Dq Li normal ,
1853 .Dq Li visual ,
1854 .Dq Li off ,
1855 or
1856 .Dq Li NO
1857 if the default behavior is desired.
1858 For details, refer to the
1859 .Xr kbdcontrol 1
1860 manpage.
1861 .It Va keymap
1862 .Pq Vt str
1863 If set to
1864 .Dq Li NO ,
1865 no keymap is installed, otherwise the value is used to install
1866 the keymap file in
1867 .Pa /usr/share/syscons/keymaps/ Ns Ao Ar value Ac Ns Pa .kbd .
1868 .It Va keyrate
1869 .Pq Vt str
1870 The keyboard repeat speed.
1871 Set to
1872 .Dq Li slow ,
1873 .Dq Li normal ,
1874 .Dq Li fast ,
1875 or
1876 .Dq Li NO
1877 if the default behavior is desired.
1878 .It Va keychange
1879 .Pq Vt str
1880 If not set to
1881 .Dq Li NO ,
1882 attempt to program the function keys with the value.
1883 The value should
1884 be a single string of the form:
1885 .Dq Ar funkey_number new_value Op Ar funkey_number new_value ... .
1886 .It Va cursor
1887 .Pq Vt str
1888 Can be set to the value of
1889 .Dq Li normal ,
1890 .Dq Li blink ,
1891 .Dq Li destructive ,
1892 or
1893 .Dq Li NO
1894 to set the cursor behavior explicitly or choose the default behavior.
1895 .It Va scrnmap
1896 .Pq Vt str
1897 If set to
1898 .Dq Li NO ,
1899 no screen map is installed, otherwise the value is used to install
1900 the screen map file in
1901 .Pa /usr/share/syscons/scrnmaps/ Ns Aq Ar value .
1902 .It Va font8x16
1903 .Pq Vt str
1904 If set to
1905 .Dq Li NO ,
1906 the default 8x16 font value is used for screen size requests, otherwise
1907 the value in
1908 .Pa /usr/share/syscons/fonts/ Ns Aq Ar value
1909 is used.
1910 .It Va font8x14
1911 .Pq Vt str
1912 If set to
1913 .Dq Li NO ,
1914 the default 8x14 font value is used for screen size requests, otherwise
1915 the value in
1916 .Pa /usr/share/syscons/fonts/ Ns Aq Ar value
1917 is used.
1918 .It Va font8x8
1919 .Pq Vt str
1920 If set to
1921 .Dq Li NO ,
1922 the default 8x8 font value is used for screen size requests, otherwise
1923 the value in
1924 .Pa /usr/share/syscons/fonts/ Ns Aq Ar value
1925 is used.
1926 .It Va blanktime
1927 .Pq Vt int
1928 If set to
1929 .Dq Li NO ,
1930 the default screen blanking interval is used, otherwise it is set
1931 to
1932 .Ar value
1933 seconds.
1934 .It Va saver
1935 .Pq Vt str
1936 If not set to
1937 .Dq Li NO ,
1938 this is the actual screen saver to use
1939 .Li ( blank , snake , daemon ,
1940 etc).
1941 .It Va moused_enable
1942 .Pq Vt str
1943 If set to
1944 .Dq Li YES ,
1945 the
1946 .Xr moused 8
1947 daemon is started for doing cut/paste selection on the console.
1948 .It Va moused_type
1949 .Pq Vt str
1950 This is the protocol type of the mouse connected to this host.
1951 This variable must be set if
1952 .Va moused_enable
1953 is set to
1954 .Dq Li YES .
1955 The
1956 .Xr moused 8
1957 daemon
1958 is able to detect the appropriate mouse type automatically in many cases.
1959 Set this variable to
1960 .Dq Li auto
1961 to let the daemon detect it, or
1962 select one from the following list if the automatic detection fails.
1963 .Pp
1964 If the mouse is attached to the PS/2 mouse port, choose
1965 .Dq Li auto
1966 or
1967 .Dq Li ps/2 ,
1968 regardless of the brand and model of the mouse.
1969 Likewise, if the
1970 mouse is attached to the bus mouse port, choose
1971 .Dq Li auto
1972 or
1973 .Dq Li busmouse .
1974 All other protocols are for serial mice and will not work with
1975 the PS/2 and bus mice.
1976 If this is a USB mouse,
1977 .Dq Li auto
1978 is the only protocol type which will work.
1979 .Pp
1980 .Bl -tag -width ".Li x10mouseremote" -compact
1981 .It Li microsoft
1982 Microsoft mouse (serial)
1983 .It Li intellimouse
1984 Microsoft IntelliMouse (serial)
1985 .It Li mousesystems
1986 Mouse systems Corp. mouse (serial)
1987 .It Li mmseries
1988 MM Series mouse (serial)
1989 .It Li logitech
1990 Logitech mouse (serial)
1991 .It Li busmouse
1992 A bus mouse
1993 .It Li mouseman
1994 Logitech MouseMan and TrackMan (serial)
1995 .It Li glidepoint
1996 ALPS GlidePoint (serial)
1997 .It Li thinkingmouse
1998 Kensington ThinkingMouse (serial)
1999 .It Li ps/2
2000 PS/2 mouse
2001 .It Li mmhittab
2002 MM HitTablet (serial)
2003 .It Li x10mouseremote
2004 X10 MouseRemote (serial)
2005 .It Li versapad
2006 Interlink VersaPad (serial)
2007 .El
2008 .Pp
2009 Even if the mouse is not in the above list, it may be compatible
2010 with one in the list.
2011 Refer to the man page for
2012 .Xr moused 8
2013 for compatibility information.
2014 .Pp
2015 It should also be noted that while this is enabled, any
2016 other client of the mouse (such as an X server) should access
2017 the mouse through the virtual mouse device,
2018 .Pa /dev/sysmouse ,
2019 and configure it as a
2020 .Dq Li sysmouse
2021 type mouse, since all
2022 mouse data is converted to this single canonical format when
2023 using
2024 .Xr moused 8 .
2025 If the client program does not support the
2026 .Dq Li sysmouse
2027 type,
2028 specify the
2029 .Dq Li mousesystems
2030 type.
2031 It is the second preferred type.
2032 .It Va moused_port
2033 .Pq Vt str
2034 If
2035 .Va moused_enable
2036 is set to
2037 .Dq Li YES ,
2038 this is the actual port the mouse is on.
2039 It might be
2040 .Pa /dev/cuaa0
2041 for a COM1 serial mouse,
2042 .Pa /dev/psm0
2043 for a PS/2 mouse or
2044 .Pa /dev/mse0
2045 for a bus mouse, for example.
2046 .It Va moused_flags
2047 .Pq Vt str
2048 If
2049 .Va moused_type
2050 is set, these are the additional flags to pass to the
2051 .Xr moused 8
2052 daemon.
2053 .It Va mousechar_start
2054 .Pq Vt int
2055 If set to
2056 .Dq Li NO ,
2057 the default mouse cursor character range
2058 .Li 0xd0 Ns - Ns Li 0xd3
2059 is used,
2060 otherwise the range start is set
2061 to
2062 .Ar value
2063 character, see
2064 .Xr vidcontrol 1 .
2065 Use if the default range is occupied in the language code table.
2066 .It Va allscreens_flags
2067 .Pq Vt str
2068 If set,
2069 .Xr vidcontrol 1
2070 is run with these options for each of the virtual terminals
2071 .Pq Pa /dev/ttyv* .
2072 For example,
2073 .Dq Fl m Cm on
2074 will enable the mouse pointer on all virtual terminals
2075 if
2076 .Va moused_enable
2077 is set to
2078 .Dq Li YES .
2079 .It Va allscreens_kbdflags
2080 .Pq Vt str
2081 If set,
2082 .Xr kbdcontrol 1
2083 is run with these options for each of the virtual terminals
2084 .Pq Pa /dev/ttyv* .
2085 For example,
2086 .Dq Fl h Li 200
2087 will set the
2088 .Xr syscons 4
2089 scrollback (history) buffer to 200 lines.
2090 .It Va cron_enable
2091 .Pq Vt bool
2092 If set to
2093 .Dq Li YES ,
2094 run the
2095 .Xr cron 8
2096 daemon at system boot time.
2097 .It Va cron_program
2098 .Pq Vt str
2099 Path to
2100 .Xr cron 8
2101 (default
2102 .Pa /usr/sbin/cron ) .
2103 .It Va cron_flags
2104 .Pq Vt str
2105 If
2106 .Va cron_enable
2107 is set to
2108 .Dq Li YES ,
2109 these are the flags to pass to
2110 .Xr cron 8 .
2111 .It Va lpd_program
2112 .Pq Vt str
2113 Path to
2114 .Xr lpd 8
2115 (default
2116 .Pa /usr/sbin/lpd ) .
2117 .It Va lpd_enable
2118 .Pq Vt bool
2119 If set to
2120 .Dq Li YES ,
2121 run the
2122 .Xr lpd 8
2123 daemon at system boot time.
2124 .It Va lpd_flags
2125 .Pq Vt str
2126 If
2127 .Va lpd_enable
2128 is set to
2129 .Dq Li YES ,
2130 these are the flags to pass to the
2131 .Xr lpd 8
2132 daemon.
2133 .It Va mta_start_script
2134 .Pq Vt str
2135 This variable specifies the full path to the script to run to start
2136 a mail transfer agent.
2137 The default is
2138 .Pa /etc/rc.sendmail .
2139 The
2140 .Va sendmail_*
2141 variables which
2142 .Pa /etc/rc.sendmail
2143 uses are documented in the
2144 .Xr rc.sendmail 8
2145 man page.
2146 .It Va dumpdev
2147 .Pq Vt str
2148 Indicates the device (usually a swap partition) to which a crash dump
2149 should be written in the event of a system crash.
2150 The value of this variable is passed as the argument to
2151 .Xr dumpon 8 .
2152 To disable crash dumps, set this variable to
2153 .Dq Li NO .
2154 .It Va dumpdir
2155 .Pq Vt str
2156 When the system reboots after a crash and a crash dump is found on the
2157 device specified by the
2158 .Va dumpdev
2159 variable,
2160 .Xr savecore 8
2161 will save that crash dump and a copy of the kernel to the directory
2162 specified by the
2163 .Va dumpdir
2164 variable.
2165 The default value is
2166 .Pa /var/crash .
2167 Set to
2168 .Dq Li NO
2169 to not run
2170 .Xr savecore 8
2171 at boot time when
2172 .Va dumpdir
2173 is set.
2174 .It Va savecore_flags
2175 .Pq Vt str
2176 If crash dumps are enabled, these are the flags to pass to the
2177 .Xr savecore 8
2178 utility.
2179 .It Va enable_quotas
2180 .Pq Vt bool
2181 Set to
2182 .Dq Li YES
2183 to turn on user disk quotas on system startup via the
2184 .Xr quotaon 8
2185 command.
2186 .It Va check_quotas
2187 .Pq Vt bool
2188 Set to
2189 .Dq Li YES
2190 to enable user disk quota checking via the
2191 .Xr quotacheck 8
2192 command.
2193 .It Va accounting_enable
2194 .Pq Vt bool
2195 Set to
2196 .Dq Li YES
2197 to enable system accounting through the
2198 .Xr accton 8
2199 facility.
2200 .It Va linux_enable
2201 .Pq Vt bool
2202 Set to
2203 .Dq Li YES
2204 to enable Linux/ELF binary emulation at system initial
2205 boot time.
2206 .It Va osf1_enable
2207 .Pq Vt bool
2208 Set to
2209 .Dq Li YES
2210 to enable OSF/1 (Digital UNIX) binary emulation at system
2211 initial boot time.
2212 (alpha)
2213 .It Va svr4_enable
2214 .Pq Vt bool
2215 If set to
2216 .Dq Li YES ,
2217 enable SysVR4 emulation at boot time.
2218 .It Va sysvipc_enable
2219 .Pq Vt bool
2220 If set to
2221 .Dq Li YES ,
2222 load System V IPC primitives at boot time.
2223 .\" ----- cleanvar_enable setting--------------------------------
2224 .It Va cleanvar_enable
2225 .Pq Vt bool
2226 Set to
2227 .Dq Li YES
2228 to have
2229 .Pa /var/run ,
2230 .Pa /var/spool/lock
2231 and
2232 .Pa /var/spool/uucp/.Temp/*
2233 cleaned at startup.
2234 .\" ----- clear_tmp_enable setting-------------------------------
2235 .It Va clear_tmp_enable
2236 .Pq Vt bool
2237 Set to
2238 .Dq Li YES
2239 to have
2240 .Pa /tmp
2241 cleaned at startup.
2242 .\" ----- ldconfig_paths setting --------------------------------
2243 .It Va ldconfig_paths
2244 .Pq Vt str
2245 Set to the list of shared library paths to use with
2246 .Xr ldconfig 8 .
2247 NOTE:
2248 .Pa /usr/lib
2249 will always be added first, so it need not appear in this list.
2250 .\" ----- ldconfig_paths_aout setting ---------------------------
2251 .It Va ldconfig_paths_aout
2252 .Pq Vt str
2253 Set to the list of shared library paths to use with
2254 .Xr ldconfig 8
2255 legacy
2256 .Xr a.out 5
2257 support.
2258 .It Va ldconfig_insecure
2259 .Pq Vt bool
2260 The
2261 .Xr ldconfig 8
2262 utility normally refuses to use directories
2263 which are writable by anyone except root.
2264 Set this variable to
2265 .Dq Li YES
2266 to disable that security check during system startup.
2267 .It Va kern_securelevel_enable
2268 .Pq Vt bool
2269 Set to
2270 .Dq Li YES
2271 to set the kernel security level at system startup.
2272 .It Va kern_securelevel
2273 .Pq Vt int
2274 The kernel security level to set at startup.
2275 The allowed range of
2276 .Ar value
2277 ranges from \-1 (the compile time default) to 3 (the
2278 most secure).
2279 See
2280 .Xr init 8
2281 for the list of possible security levels and their effect
2282 on system operation.
2283 .It Va lomac_enable
2284 .Pq Vt bool
2285 Set to
2286 .Dq Li YES
2287 to enable Low Watermark Mandatory Access Control (LOMAC) at boot time.
2288 This security model enforces integrity constraints for system processes;
2289 see
2290 .Xr lomac 4
2291 for a complete description of the LOMAC model, as well as its impact
2292 on system operation.
2293 .It Va start_vinum
2294 .Pq Vt bool
2295 Set to
2296 .Dq Li YES
2297 to start
2298 .Xr vinum 8
2299 at system boot time.
2300 .It Va sshd_program
2301 .Pq Vt str
2302 Path to the SSH server program
2303 .Pa ( /usr/sbin/sshd
2304 is the default).
2305 .It Va sshd_enable
2306 .Pq Vt bool
2307 Set to
2308 .Dq Li YES
2309 to start
2310 .Xr sshd 8
2311 at system boot time.
2312 .It Va sshd_flags
2313 .Pq Vt str
2314 If
2315 .Va sshd_enable
2316 is set to
2317 .Dq Li YES ,
2318 these are the flags to pass to the
2319 .Xr sshd 8
2320 daemon.
2321 .It Va usbd_enable
2322 .Pq Vt bool
2323 If set to
2324 .Dq Li YES ,
2325 run the
2326 .Xr usbd 8
2327 daemon at boot time.
2328 .It Va usbd_flags
2329 .Pq Vt str
2330 If
2331 .Va usbd_enable
2332 is set to
2333 .Dq Li YES ,
2334 these are the flags passed to
2335 .Xr usbd 8
2336 daemon.
2337 .It Va watchdogd_enable
2338 .Pq Vt bool
2339 If set to
2340 .Dq Li YES ,
2341 start the
2342 .Xr watchdogd 8
2343 daemon at boot time.
2344 This requires that the kernel have been compiled with
2345 .Cd "options WATCHDOG" .
2346 .It Va jail_enable
2347 .Pq Vt bool
2348 If set to
2349 .Dq Li NO ,
2350 any configured jails will not be started.
2351 .It Va jail_list
2352 .Pq Vt str
2353 A space separated list of names for jails.
2354 This is purely a configuration aid to help identify and
2355 configure multiple jails.
2356 The names specified in this list will be used to
2357 identify settings common to an instance of a jail.
2358 Assuming that the jail in question was named
2359 .Li vjail ,
2360 you would have the following dependant variables:
2361 .Bd -literal
2362 jail_vjail_hostname="jail.example.com"
2363 jail_vjail_ip="192.168.1.100"
2364 jail_vjail_rootdir="/var/jails/vjail/root"
2365 jail_vjail_exec="/bin/sh /etc/rc"
2366 .Ed
2367 .Pp
2368 The last one is optional.
2369 It defaults to
2370 .Pa /etc/rc
2371 if it is not set.
2372 .It Va jail_set_hostname_allow
2373 .Pq Vt bool
2374 If set to
2375 .Dq Li NO ,
2376 do not allow the root user in a jail to set its hostname.
2377 .It Va jail_socket_unixiproute_only
2378 .Pq Vt bool
2379 If set to
2380 .Dq Li NO ,
2381 do not allow any protocol,
2382 besides TCP/IP,
2383 to be used within a jail.
2384 .It Va jail_sysvipc_allow
2385 .Pq Vt bool
2386 If set to
2387 .Dq Li YES ,
2388 allow applications within a jail to use System V IPC.
2389 .It Va unaligned_print
2390 .Pq Vt bool
2391 If set to
2392 .Dq Li NO ,
2393 unaligned access warnings will not be printed.
2394 (alpha)
2395 .\" ----- isdn settings ---------------------------------
2396 .It Va isdn_enable
2397 .Pq Vt bool
2398 Set to
2399 .Dq Li NO
2400 by default.
2401 When set to
2402 .Dq Li YES ,
2403 starts the
2404 .Xr isdnd 8
2405 daemon
2406 at system boot time.
2407 .It Va isdn_flags
2408 .Pq Vt str
2409 Set to
2410 .Dq Fl d Ns Cm n Fl d Ns Li 0x1f9
2411 by default.
2412 Additional flags to pass to
2413 .Xr isdnd 8
2414 (but see
2415 .Va isdn_fsdev
2416 and
2417 .Va isdn_ttype
2418 for certain tunable parameters).
2419 .It Va isdn_ttype
2420 .Pq Vt str
2421 Set to
2422 .Dq Li cons25
2423 by default.
2424 The terminal type of the output device when
2425 .Xr isdnd 8
2426 operates in full-screen mode.
2427 .It Va isdn_screenflags
2428 .Pq Vt str
2429 Set to
2430 .Dq Li NO
2431 by default.
2432 The video mode for full-screen mode (only for
2433 .Xr syscons 4
2434 console driver, see
2435 .Xr vidcontrol 1
2436 for valid modes).
2437 .It Va isdn_fsdev
2438 .Pq Vt str
2439 Set to
2440 .Dq Li NO
2441 by default.
2442 The output device for
2443 .Xr isdnd 8
2444 in full-screen mode (or
2445 .Dq Li NO
2446 for daemon mode).
2447 .It Va isdn_trace
2448 .Pq Vt bool
2449 Set to
2450 .Dq Li NO
2451 by default.
2452 When set to
2453 .Dq Li YES ,
2454 enables the ISDN protocol trace utility
2455 .Xr isdntrace 8
2456 at system boot time.
2457 .It Va isdn_traceflags
2458 .Pq Vt str
2459 Set to
2460 .Dq Fl f Pa /var/tmp/isdntrace0
2461 by default.
2462 Flags for
2463 .Xr isdntrace 8 .
2464 .\" -----------------------------------------------------
2465 .It Va harvest_interrupt
2466 .Pq Vt bool
2467 Set to
2468 .Dq Li YES
2469 to use hardware interrupts as an entropy source.
2470 Refer to
2471 .Xr random 4
2472 for more information.
2473 .It Va harvest_ethernet
2474 .Pq Vt bool
2475 Set to
2476 .Dq Li YES
2477 to use LAN traffic as an entropy source.
2478 Refer to
2479 .Xr random 4
2480 for more information.
2481 .It Va harvest_p_to_p
2482 .Pq Vt bool
2483 Set to
2484 .Dq Li YES
2485 to use serial line traffic as an entropy source.
2486 Refer to
2487 .Xr random 4
2488 for more information.
2489 .It Va entropy_dir
2490 .Pq Vt str
2491 Set to
2492 .Dq Li NO
2493 to disable caching entropy via
2494 .Xr cron 8 .
2495 Otherwise set to the directory used to store entropy files in.
2496 .It Va entropy_file
2497 .Pq Vt str
2498 Set to
2499 .Dq Li NO
2500 to disable caching entropy through reboots.
2501 Otherwise set to the filename used to store cached entropy through
2502 reboots.
2503 This file should be located on the root file system to seed the
2504 .Xr random 4
2505 device as early as possible in the boot process.
2506 .It Va entropy_save_sz
2507 .Pq Vt int
2508 Size of the entropy cache files saved by
2509 .Nm save-entropy
2510 periodically.
2511 .It Va entropy_save_num
2512 .Pq Vt int
2513 Number of entropy cache files to save by
2514 .Nm save-entropy
2515 periodically.
2516 .It Va ipsec_enable
2517 .Pq Vt bool
2518 Set to
2519 .Dq Li YES
2520 to run
2521 .Xr setkey 8
2522 on
2523 .Va ipsec_file
2524 at boot time.
2525 .It Va ipsec_file
2526 .Pq Vt str
2527 Configuration file for
2528 .Xr setkey 8 .
2529 .It Va dmesg_enable
2530 .Pq Vt bool
2531 Set to
2532 .Dq Li YES
2533 to save
2534 .Xr dmesg 8
2535 to
2536 .Pa /var/run/dmesg.boot
2537 on boot.
2538 .It Va rcshutdown_timeout
2539 .Pq Vt int
2540 If set, start a watchdog timer in the background which will terminate
2541 .Pa rc.shutdown
2542 if
2543 .Xr shutdown 8
2544 has not completed within the specified time (in seconds).
2545 .El
2546 .Sh FILES
2547 .Bl -tag -width ".Pa /etc/defaults/rc.conf" -compact
2548 .It Pa /etc/defaults/rc.conf
2549 .It Pa /etc/rc.conf
2550 .It Pa /etc/rc.conf.local
2551 .El
2552 .Sh SEE ALSO
2553 .Xr catman 1 ,
2554 .Xr gdb 1 ,
2555 .Xr info 1 ,
2556 .Xr kbdcontrol 1 ,
2557 .Xr vidcontrol 1 ,
2558 .Xr ip 4 ,
2559 .Xr kld 4 ,
2560 .Xr tcp 4 ,
2561 .Xr udp 4 ,
2562 .Xr exports 5 ,
2563 .Xr motd 5 ,
2564 .Xr accton 8 ,
2565 .Xr amd 8 ,
2566 .Xr apm 8 ,
2567 .Xr atm 8 ,
2568 .Xr cron 8 ,
2569 .Xr dhclient 8 ,
2570 .Xr ifconfig 8 ,
2571 .Xr inetd 8 ,
2572 .Xr isdnd 8 ,
2573 .Xr isdntrace 8 ,
2574 .Xr kldxref 8 ,
2575 .Xr lpd 8 ,
2576 .Xr makewhatis 8 ,
2577 .Xr mdconfig 8 ,
2578 .Xr mountd 8 ,
2579 .Xr moused 8 ,
2580 .Xr mrouted 8 ,
2581 .Xr named 8 ,
2582 .Xr nfsd 8 ,
2583 .Xr ntpd 8 ,
2584 .Xr pcnfsd 8 ,
2585 .Xr quotacheck 8 ,
2586 .Xr quotaon 8 ,
2587 .Xr rc 8 ,
2588 .Xr rc.sendmail 8 ,
2589 .Xr route 8 ,
2590 .Xr routed 8 ,
2591 .Xr rpc.lockd 8 ,
2592 .Xr rpc.statd 8 ,
2593 .Xr rpcbind 8 ,
2594 .Xr rwhod 8 ,
2595 .Xr savecore 8 ,
2596 .Xr sshd 8 ,
2597 .Xr swapon 8 ,
2598 .Xr sysctl 8 ,
2599 .Xr syslogd 8 ,
2600 .Xr timed 8 ,
2601 .Xr usbd 8 ,
2602 .Xr vinum 8 ,
2603 .Xr yp 8 ,
2604 .Xr ypbind 8 ,
2605 .Xr ypserv 8 ,
2606 .Xr ypset 8
2607 .Sh HISTORY
2608 The
2609 .Nm
2610 file appeared in
2611 .Fx 2.2.2 .
2612 .Sh AUTHORS
2613 .An Jordan K. Hubbard .