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