]> CyberLeo.Net >> Repos - FreeBSD/stable/9.git/blob - share/man/man5/rc.conf.5
MFC 230453, 230726, 252015, 252426:
[FreeBSD/stable/9.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$
26 .\"
27 .Dd June 20, 2013
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 system installation utility,
42 .Xr sysinstall 8 .
43 .Pp
44 The purpose of
45 .Nm
46 is not to run commands or perform system startup actions
47 directly.
48 Instead, it is included by the
49 various generic startup scripts in
50 .Pa /etc
51 which conditionalize their
52 internal actions according to the settings found there.
53 .Pp
54 The
55 .Pa /etc/rc.conf
56 file is included from the file
57 .Pa /etc/defaults/rc.conf ,
58 which specifies the default settings for all the available options.
59 Options need only be specified in
60 .Pa /etc/rc.conf
61 when the system administrator wishes to override these defaults.
62 The file
63 .Pa /etc/rc.conf.local
64 is used to override settings in
65 .Pa /etc/rc.conf
66 for historical reasons.
67 In addition to
68 .Pa /etc/rc.conf.local
69 you can also place smaller configuration files for each
70 .Xr rc 8
71 script in the
72 .Pa /etc/rc.conf.d
73 directory, which will be included by the
74 .Va load_rc_config
75 function.
76 For jail configurations you could use the file
77 .Pa /etc/rc.conf.d/jail
78 to store jail specific configuration options.
79 Also see the
80 .Va rc_conf_files
81 variable below.
82 .Pp
83 Options are set with
84 .Dq Ar name Ns Li = Ns Ar value
85 assignments that use
86 .Xr sh 1
87 syntax.
88 The following list provides a name and short description for each
89 variable that can be set in the
90 .Nm
91 file:
92 .Bl -tag -width indent-two
93 .It Va rc_debug
94 .Pq Vt bool
95 If set to
96 .Dq Li YES ,
97 enable output of debug messages from rc scripts.
98 This variable can be helpful in diagnosing mistakes when
99 editing or integrating new scripts.
100 Beware that this produces copious output to the terminal and
101 .Xr syslog 3 .
102 .It Va rc_info
103 .Pq Vt bool
104 If set to
105 .Dq Li NO ,
106 disable informational messages from the rc scripts.
107 Informational messages are displayed when
108 a condition that is not serious enough to warrant a warning or
109 an error occurs.
110 .It Va rc_startmsgs
111 .Pq Vt bool
112 If set to
113 .Dq Li YES ,
114 show
115 .Dq Starting foo:
116 when faststart is used (e.g., at boot time).
117 .It Va early_late_divider
118 .Pq Vt str
119 The name of the script that should be used as the
120 delimiter between the
121 .Dq early
122 and
123 .Dq late
124 stages of the boot process.
125 The early stage should contain all the services needed to
126 get the disks (local or remote) mounted so that the late
127 stage can include scripts contained in the directories
128 listed in the
129 .Va local_startup
130 variable (see below).
131 Thus, the two likely candidates for this value are
132 .Pa mountcritlocal
133 for the typical system, and
134 .Pa mountcritremote
135 if the system needs remote file
136 systems mounted to get access to the
137 .Va local_startup
138 directories; for example when
139 .Pa /usr/local
140 is NFS mounted.
141 For
142 .Pa rc.conf
143 within a
144 .Xr jail 8
145 .Pa NETWORKING
146 is likely to be an appropriate value.
147 Extreme care should be taken when changing this value,
148 and before changing it one should ensure that there are
149 adequate provisions to recover from a failed boot
150 (such as physical contact with the machine,
151 or reliable remote console access).
152 .It Va always_force_depends
153 .Pq Vt bool
154 Various
155 .Pa rc.d
156 scripts use the force_depend function to check whether required
157 services are already running, and to start them if necessary.
158 By default during boot time this check is bypassed if the
159 required service is enabled in
160 .Pa /etc/rc.conf[.local] .
161 Setting this option will bypass that check at boot time and
162 always test whether or not the service is actually running.
163 Enabling this option is likely to increase your boot time if
164 services are enabled that utilize the force_depend check.
165 .It Va swapfile
166 .Pq Vt str
167 If set to
168 .Dq Li NO ,
169 no swapfile is installed, otherwise the value is used as the full
170 pathname to a file to use for additional swap space.
171 .It Va apm_enable
172 .Pq Vt bool
173 If set to
174 .Dq Li YES ,
175 enable support for Automatic Power Management with
176 the
177 .Xr apm 8
178 command.
179 .It Va apmd_enable
180 .Pq Vt bool
181 Run
182 .Xr apmd 8
183 to handle APM event from userland.
184 This also enables support for APM.
185 .It Va apmd_flags
186 .Pq Vt str
187 If
188 .Va apmd_enable
189 is set to
190 .Dq Li YES ,
191 these are the flags to pass to the
192 .Xr apmd 8
193 daemon.
194 .It Va devd_enable
195 .Pq Vt bool
196 Run
197 .Xr devd 8
198 to handle device added, removed or unknown events from the kernel.
199 .It Va ddb_enable
200 .Pq Vt bool
201 Run
202 .Xr ddb 8
203 to install
204 .Xr ddb 4
205 scripts at boot time.
206 .It Va ddb_config
207 .Pq Vt str
208 Configuration file for
209 .Xr ddb 8 .
210 Default
211 .Pa /etc/ddb.conf .
212 .It Va kld_list
213 .Pq Vt str
214 A list of kernel modules to load right after the local
215 disks are mounted.
216 Loading modules at this point in the boot process is
217 much faster than doing it via
218 .Pa /boot/loader.conf
219 for those modules not necessary for mounting local disk.
220 .It Va kldxref_enable
221 .Pq Vt bool
222 Set to
223 .Dq Li NO
224 by default.
225 Set to
226 .Dq Li YES
227 to automatically rebuild
228 .Pa linker.hints
229 files with
230 .Xr kldxref 8
231 at boot time.
232 .It Va kldxref_clobber
233 .Pq Vt bool
234 Set to
235 .Dq Li NO
236 by default.
237 If
238 .Va kldxref_enable
239 is true,
240 setting to
241 .Dq Li YES
242 will overwrite existing
243 .Pa linker.hints
244 files at boot time.
245 Otherwise,
246 only missing
247 .Pa linker.hints
248 files are generated.
249 .It Va kldxref_module_path
250 .Pq Vt str
251 Empty by default.
252 A semi-colon
253 .Pq Ql \&;
254 delimited list of paths containing
255 .Xr kld 4
256 modules.
257 If empty,
258 the contents of the
259 .Va kern.module_path
260 .Xr sysctl 8
261 are used.
262 .It Va powerd_enable
263 .Pq Vt bool
264 If set to
265 .Dq Li YES ,
266 enable the system power control facility with the
267 .Xr powerd 8
268 daemon.
269 .It Va powerd_flags
270 .Pq Vt str
271 If
272 .Va powerd_enable
273 is set to
274 .Dq Li YES ,
275 these are the flags to pass to the
276 .Xr powerd 8
277 daemon.
278 .It Va tmpmfs
279 Controls the creation of a
280 .Pa /tmp
281 memory file system.
282 Always happens if set to
283 .Dq Li YES
284 and never happens if set to
285 .Dq Li NO .
286 If set to anything else, a memory file system is created if
287 .Pa /tmp
288 is not writable.
289 .It Va tmpsize
290 Controls the size of a created
291 .Pa /tmp
292 memory file system.
293 .It Va tmpmfs_flags
294 Extra options passed to the
295 .Xr mdmfs 8
296 utility when the memory file system for
297 .Pa /tmp
298 is created.
299 The default is
300 .Dq Li "-S" ,
301 which inhibits the use of softupdates on
302 .Pa /tmp
303 so that file system space is freed without delay
304 after file truncation or deletion.
305 See
306 .Xr mdmfs 8
307 for other options you can use in
308 .Va tmpmfs_flags .
309 .It Va varmfs
310 Controls the creation of a
311 .Pa /var
312 memory file system.
313 Always happens if set to
314 .Dq Li YES
315 and never happens if set to
316 .Dq Li NO .
317 If set to anything else, a memory file system is created if
318 .Pa /var
319 is not writable.
320 .It Va varsize
321 Controls the size of a created
322 .Pa /var
323 memory file system.
324 .It Va varmfs_flags
325 Extra options passed to the
326 .Xr mdmfs 8
327 utility when the memory file system for
328 .Pa /var
329 is created.
330 The default is
331 .Dq Li "-S" ,
332 which inhibits the use of softupdates on
333 .Pa /var
334 so that file system space is freed without delay
335 after file truncation or deletion.
336 See
337 .Xr mdmfs 8
338 for other options you can use in
339 .Va varmfs_flags .
340 .It Va populate_var
341 Controls the automatic population of the
342 .Pa /var
343 file system.
344 Always happens if set to
345 .Dq Li YES
346 and never happens if set to
347 .Dq Li NO .
348 If set to anything else, a memory file system is created if
349 .Pa /var
350 is not writable.
351 Note that this process requires access to certain commands in
352 .Pa /usr
353 before
354 .Pa /usr
355 is mounted on normal systems.
356 .It Va cleanvar_enable
357 .Pq Vt bool
358 Clean the
359 .Pa /var
360 directory.
361 .It Va local_startup
362 .Pq Vt str
363 List of directories to search for startup script files.
364 .It Va script_name_sep
365 .Pq Vt str
366 The field separator to use for breaking down the list of startup script files
367 into individual filenames.
368 The default is a space.
369 It is not necessary to change this unless there are startup scripts with names
370 containing spaces.
371 .It Va hostapd_enable
372 .Pq Vt bool
373 Set to
374 .Dq Li YES
375 to start
376 .Xr hostapd 8
377 at system boot time.
378 .It Va hostname
379 .Pq Vt str
380 The fully qualified domain name (FQDN) of this host on the network.
381 This should almost certainly be set to something meaningful, even if
382 there is no network connection.
383 If
384 .Xr dhclient 8
385 is used to set the hostname via DHCP,
386 this variable should be set to an empty string.
387 If this value remains unset when the system is done booting
388 your console login will display the default hostname of
389 .Dq Amnesiac .
390 .It Va nisdomainname
391 .Pq Vt str
392 The NIS domain name of this host, or
393 .Dq Li NO
394 if NIS is not used.
395 .It Va dhclient_program
396 .Pq Vt str
397 Path to the DHCP client program
398 .Pa ( /sbin/dhclient ,
399 the
400 .Ox
401 DHCP client,
402 is the default).
403 .It Va dhclient_flags
404 .Pq Vt str
405 Additional flags to pass to the DHCP client program.
406 For the
407 .Ox
408 DHCP client, see the
409 .Xr dhclient 8
410 manpage for a description of the command line options available.
411 .It Va dhclient_flags_ Ns Aq Ar iface
412 Additional flags to pass to the DHCP client program running on
413 .Ar iface
414 only.
415 When specified, this variable overrides
416 .Va dhclient_flags .
417 .It Va background_dhclient
418 .Pq Vt bool
419 Set to
420 .Dq Li YES
421 to start the DHCP client in background.
422 This can cause trouble with applications depending on
423 a working network, but it will provide a faster startup
424 in many cases.
425 .It Va background_dhclient_ Ns Aq Ar iface
426 When specified, this variable overrides the
427 .Va background_dhclient
428 variable for interface
429 .Ar iface
430 only.
431 .It Va synchronous_dhclient
432 .Pq Vt bool
433 Set to
434 .Dq Li YES
435 to start
436 .Xr dhclient 8
437 synchronously at startup.
438 This behavior can be overridden on a per-interface basis by replacing
439 the
440 .Dq Li DHCP
441 keyword in the
442 .Va ifconfig_ Ns Aq Ar interface
443 variable with
444 .Dq Li SYNCDHCP
445 or
446 .Dq Li NOSYNCDHCP .
447 .It Va defaultroute_delay
448 .Pq Vt int
449 When set to a positive value, wait up to this long after configuring
450 DHCP interfaces at startup to give the interfaces time to receive a lease.
451 .It Va firewall_enable
452 .Pq Vt bool
453 Set to
454 .Dq Li YES
455 to load firewall rules at startup.
456 If the kernel was not built with
457 .Cd "options IPFIREWALL" ,
458 the
459 .Pa ipfw.ko
460 kernel module will be loaded.
461 See also
462 .Va ipfilter_enable .
463 .It Va firewall_script
464 .Pq Vt str
465 This variable specifies the full path to the firewall script to run.
466 The default is
467 .Pa /etc/rc.firewall .
468 .It Va firewall_type
469 .Pq Vt str
470 Names the firewall type from the selection in
471 .Pa /etc/rc.firewall ,
472 or the file which contains the local firewall ruleset.
473 Valid selections from
474 .Pa /etc/rc.firewall
475 are:
476 .Pp
477 .Bl -tag -width ".Li simple" -compact
478 .It Li open
479 unrestricted IP access
480 .It Li closed
481 all IP services disabled, except via
482 .Dq Li lo0
483 .It Li client
484 basic protection for a workstation
485 .It Li simple
486 basic protection for a LAN.
487 .El
488 .Pp
489 If a filename is specified, the full path
490 must be given.
491 .It Va firewall_quiet
492 .Pq Vt bool
493 Set to
494 .Dq Li YES
495 to disable the display of firewall rules on the console during boot.
496 .It Va firewall_logging
497 .Pq Vt bool
498 Set to
499 .Dq Li YES
500 to enable firewall event logging.
501 This is equivalent to the
502 .Dv IPFIREWALL_VERBOSE
503 kernel option.
504 .It Va firewall_flags
505 .Pq Vt str
506 Flags passed to
507 .Xr ipfw 8
508 if
509 .Va firewall_type
510 specifies a filename.
511 .It Va firewall_coscripts
512 .Pq Vt str
513 List of executables and/or rc scripts to run after firewall starts/stops.
514 Default is empty.
515 .\" ----- firewall_nat_enable setting --------------------------------
516 .It Va firewall_nat_enable
517 .Pq Vt bool
518 The
519 .Xr ipfw 8
520 equivalent of
521 .Va natd_enable .
522 Setting this to
523 .Dq Li YES
524 enables kernel NAT.
525 .Va firewall_enable
526 must also be set to
527 .Dq Li YES .
528 .It Va firewall_nat_interface
529 .Pq Vt str
530 The
531 .Xr ipfw 8
532 equivalent of
533 .Va natd_interface .
534 This is the name of the public interface or IP address on which
535 kernel NAT should run.
536 .It Va firewall_nat_flags
537 .Pq Vt str
538 Additional configuration parameters for kernel NAT should be placed here.
539 .It Va dummynet_enable
540 .Pq Vt bool
541 Setting this to
542 .Dq Li YES
543 will automatically load the
544 .Xr dummynet 4
545 module if
546 .Va firewall_enable
547 is also set to
548 .Dq Li YES .
549 .\" -------------------------------------------------------------------
550 .It Va natd_program
551 .Pq Vt str
552 Path to
553 .Xr natd 8 .
554 .It Va natd_enable
555 .Pq Vt bool
556 Set to
557 .Dq Li YES
558 to enable
559 .Xr natd 8 .
560 .Va firewall_enable
561 must also be set to
562 .Dq Li YES ,
563 and
564 .Xr divert 4
565 sockets must be enabled in the kernel.
566 If the kernel was not built with
567 .Cd "options IPDIVERT" ,
568 the
569 .Pa ipdivert.ko
570 kernel module will be loaded.
571 .It Va natd_interface
572 .Pq Vt str
573 This is the name of the public interface on which
574 .Xr natd 8
575 should run.
576 The interface may be given as an interface name or as an IP address.
577 .It Va natd_flags
578 .Pq Vt str
579 Additional
580 .Xr natd 8
581 flags should be placed here.
582 The
583 .Fl n
584 or
585 .Fl a
586 flag is automatically added with the above
587 .Va natd_interface
588 as an argument.
589 .\" ----- ipfilter_enable setting --------------------------------
590 .It Va ipfilter_enable
591 .Pq Vt bool
592 Set to
593 .Dq Li NO
594 by default.
595 Setting this to
596 .Dq Li YES
597 enables
598 .Xr ipf 8
599 packet filtering.
600 .Pp
601 Typical usage will require putting
602 .Bd -literal
603 ipfilter_enable="YES"
604 ipnat_enable="YES"
605 ipmon_enable="YES"
606 ipfs_enable="YES"
607 .Ed
608 .Pp
609 into
610 .Pa /etc/rc.conf
611 and editing
612 .Pa /etc/ipf.rules
613 and
614 .Pa /etc/ipnat.rules
615 appropriately.
616 .Pp
617 Note that
618 .Va ipfilter_enable
619 and
620 .Va ipnat_enable
621 can be enabled independently.
622 .Va ipmon_enable
623 and
624 .Va ipfs_enable
625 both require at least one of
626 .Va ipfilter_enable
627 and
628 .Va ipnat_enable
629 to be enabled.
630 .Pp
631 Having
632 .Bd -literal
633 options IPFILTER
634 options IPFILTER_LOG
635 options IPFILTER_DEFAULT_BLOCK
636 .Ed
637 .Pp
638 in the kernel configuration file is a good idea, too.
639 .\" ----- ipfilter_program setting ------------------------------
640 .It Va ipfilter_program
641 .Pq Vt str
642 Path to
643 .Xr ipf 8
644 (default
645 .Pa /sbin/ipf ) .
646 .\" ----- ipfilter_rules setting --------------------------------
647 .It Va ipfilter_rules
648 .Pq Vt str
649 Set to
650 .Pa /etc/ipf.rules
651 by default.
652 This variable contains the name of the filter rule definition file.
653 The file is expected to be readable for the
654 .Xr ipf 8
655 command to execute.
656 .\" ----- ipv6_ipfilter_rules setting ---------------------------
657 .It Va ipv6_ipfilter_rules
658 .Pq Vt str
659 Set to
660 .Pa /etc/ipf6.rules
661 by default.
662 This variable contains the IPv6 filter rule definition file.
663 The file is expected to be readable for the
664 .Xr ipf 8
665 command to execute.
666 .\" ----- ipfilter_flags setting --------------------------------
667 .It Va ipfilter_flags
668 .Pq Vt str
669 Empty by default.
670 This variable contains flags passed to the
671 .Xr ipf 8
672 program.
673 .\" ----- ipnat_enable setting ----------------------------------
674 .It Va ipnat_enable
675 .Pq Vt bool
676 Set to
677 .Dq Li NO
678 by default.
679 Set it to
680 .Dq Li YES
681 to enable
682 .Xr ipnat 8
683 network address translation.
684 See
685 .Va ipfilter_enable
686 for a detailed discussion.
687 .\" ----- ipnat_program setting ---------------------------------
688 .It Va ipnat_program
689 .Pq Vt str
690 Path to
691 .Xr ipnat 8
692 (default
693 .Pa /sbin/ipnat ) .
694 .\" ----- ipnat_rules setting -----------------------------------
695 .It Va ipnat_rules
696 .Pq Vt str
697 Set to
698 .Pa /etc/ipnat.rules
699 by default.
700 This variable contains the name of the file
701 holding the network address translation definition.
702 This file is expected to be readable for the
703 .Xr ipnat 8
704 command to execute.
705 .\" ----- ipnat_flags setting -----------------------------------
706 .It Va ipnat_flags
707 .Pq Vt str
708 Empty by default.
709 This variable contains flags passed to the
710 .Xr ipnat 8
711 program.
712 .\" ----- ipmon_enable setting ----------------------------------
713 .It Va ipmon_enable
714 .Pq Vt bool
715 Set to
716 .Dq Li NO
717 by default.
718 Set it to
719 .Dq Li YES
720 to enable
721 .Xr ipmon 8
722 monitoring (logging
723 .Xr ipf 8
724 and
725 .Xr ipnat 8
726 events).
727 Setting this variable needs setting
728 .Va ipfilter_enable
729 or
730 .Va ipnat_enable
731 too.
732 See
733 .Va ipfilter_enable
734 for a detailed discussion.
735 .\" ----- ipmon_program setting ---------------------------------
736 .It Va ipmon_program
737 .Pq Vt str
738 Path to
739 .Xr ipmon 8
740 (default
741 .Pa /sbin/ipmon ) .
742 .\" ----- ipmon_flags setting -----------------------------------
743 .It Va ipmon_flags
744 .Pq Vt str
745 Set to
746 .Dq Li -Ds
747 by default.
748 This variable contains flags passed to the
749 .Xr ipmon 8
750 program.
751 Another typical example would be
752 .Dq Fl D Pa /var/log/ipflog
753 to have
754 .Xr ipmon 8
755 log directly to a file bypassing
756 .Xr syslogd 8 .
757 Make sure to adjust
758 .Pa /etc/newsyslog.conf
759 in such case like this:
760 .Bd -literal
761 /var/log/ipflog  640  10  100  *  Z  /var/run/ipmon.pid
762 .Ed
763 .\" ----- ipfs_enable setting -----------------------------------
764 .It Va ipfs_enable
765 .Pq Vt bool
766 Set to
767 .Dq Li NO
768 by default.
769 Set it to
770 .Dq Li YES
771 to enable
772 .Xr ipfs 8
773 saving the filter and NAT state tables during shutdown
774 and reloading them during startup again.
775 Setting this variable needs setting
776 .Va ipfilter_enable
777 or
778 .Va ipnat_enable
779 to
780 .Dq Li YES
781 too.
782 See
783 .Va ipfilter_enable
784 for a detailed discussion.
785 Note that if
786 .Va kern_securelevel
787 is set to 3,
788 .Va ipfs_enable
789 cannot be used
790 because the raised securelevel will prevent
791 .Xr ipfs 8
792 from saving the state tables at shutdown time.
793 .\" ----- ipfs_program setting ----------------------------------
794 .It Va ipfs_program
795 .Pq Vt str
796 Path to
797 .Xr ipfs 8
798 (default
799 .Pa /sbin/ipfs ) .
800 .\" ----- ipfs_flags setting ------------------------------------
801 .It Va ipfs_flags
802 .Pq Vt str
803 Empty by default.
804 This variable contains flags passed to the
805 .Xr ipfs 8
806 program.
807 .\" ----- end of added ipf hook ---------------------------------
808 .It Va pf_enable
809 .Pq Vt bool
810 Set to
811 .Dq Li NO
812 by default.
813 Setting this to
814 .Dq Li YES
815 enables
816 .Xr pf 4
817 packet filtering.
818 .Pp
819 Typical usage will require putting
820 .Pp
821 .Dl pf_enable="YES"
822 .Pp
823 into
824 .Pa /etc/rc.conf
825 and editing
826 .Pa /etc/pf.conf
827 appropriately.
828 Adding
829 .Pp
830 .Dl "device pf"
831 .Pp
832 builds support for
833 .Xr pf 4
834 into the kernel, otherwise the
835 kernel module will be loaded.
836 .It Va pf_rules
837 .Pq Vt str
838 Path to
839 .Xr pf 4
840 ruleset configuration file
841 (default
842 .Pa /etc/pf.conf ) .
843 .It Va pf_program
844 .Pq Vt str
845 Path to
846 .Xr pfctl 8
847 (default
848 .Pa /sbin/pfctl ) .
849 .It Va pf_flags
850 .Pq Vt str
851 If
852 .Va pf_enable
853 is set to
854 .Dq Li YES ,
855 these flags are passed to the
856 .Xr pfctl 8
857 program when loading the ruleset.
858 .It Va pflog_enable
859 .Pq Vt bool
860 Set to
861 .Dq Li NO
862 by default.
863 Setting this to
864 .Dq Li YES
865 enables
866 .Xr pflogd 8
867 which logs packets from the
868 .Xr pf 4
869 packet filter.
870 .It Va pflog_logfile
871 .Pq Vt str
872 If
873 .Va pflog_enable
874 is set to
875 .Dq Li YES
876 this controls where
877 .Xr pflogd 8
878 stores the logfile
879 (default
880 .Pa /var/log/pflog ) .
881 Check
882 .Pa /etc/newsyslog.conf
883 to adjust logfile rotation for this.
884 .It Va pflog_program
885 .Pq Vt str
886 Path to
887 .Xr pflogd 8
888 (default
889 .Pa /sbin/pflogd ) .
890 .It Va pflog_flags
891 .Pq Vt str
892 Empty by default.
893 This variable contains additional flags passed to the
894 .Xr pflogd 8
895 program.
896 .It Va ftpproxy_enable
897 .Pq Vt bool
898 Set to
899 .Dq Li NO
900 by default.
901 Setting this to
902 .Dq Li YES
903 enables
904 .Xr ftp-proxy 8
905 which supports the
906 .Xr pf 4
907 packet filter in translating ftp connections.
908 .It Va ftpproxy_flags
909 .Pq Vt str
910 Empty by default.
911 This variable contains additional flags passed to the
912 .Xr ftp-proxy 8
913 program.
914 .It Va pfsync_enable
915 .Pq Vt bool
916 Set to
917 .Dq Li NO
918 by default.
919 Setting this to
920 .Dq Li YES
921 enables exposing
922 .Xr pf 4
923 state changes to other hosts over the network by means of
924 .Xr pfsync 4 .
925 The
926 .Va pfsync_syncdev
927 variable
928 must also be set then.
929 .It Va pfsync_syncdev
930 .Pq Vt str
931 Empty by default.
932 This variable specifies the name of the network interface
933 .Xr pfsync 4
934 should operate through.
935 It must be set accordingly if
936 .Va pfsync_enable
937 is set to
938 .Dq Li YES .
939 .It Va pfsync_syncpeer
940 .Pq Vt str
941 Empty by default.
942 This variable is optional.
943 By default, state change messages are sent out on the synchronisation
944 interface using IP multicast packets.
945 The protocol is IP protocol 240, PFSYNC, and the multicast group used is
946 224.0.0.240.
947 When a peer address is specified using the
948 .Va pfsync_syncpeer
949 option, the peer address is used as a destination for the pfsync
950 traffic, and the traffic can then be protected using
951 .Xr ipsec 4 .
952 See the
953 .Xr pfsync 4
954 manpage for more details about using
955 .Xr ipsec 4
956 with
957 .Xr pfsync 4
958 interfaces.
959 .It Va pfsync_ifconfig
960 .Pq Vt str
961 Empty by default.
962 This variable can contain additional options to be passed to the
963 .Xr ifconfig 8
964 command used to set up
965 .Xr pfsync 4 .
966 .It Va tcp_extensions
967 .Pq Vt bool
968 Set to
969 .Dq Li YES
970 by default.
971 Setting this to
972 .Dq Li NO
973 disables certain TCP options as described by
974 .Rs
975 .%T "RFC 1323"
976 .Re
977 Setting this to
978 .Dq Li NO
979 might help remedy such problems with connections as randomly hanging
980 or other weird behavior.
981 Some network devices are known
982 to be broken with respect to these options.
983 .It Va log_in_vain
984 .Pq Vt int
985 Set to 0 by default.
986 The
987 .Xr sysctl 8
988 variables,
989 .Va net.inet.tcp.log_in_vain
990 and
991 .Va net.inet.udp.log_in_vain ,
992 as described in
993 .Xr tcp 4
994 and
995 .Xr udp 4 ,
996 are set to the given value.
997 .It Va tcp_keepalive
998 .Pq Vt bool
999 Set to
1000 .Dq Li YES
1001 by default.
1002 Setting to
1003 .Dq Li NO
1004 will disable probing idle TCP connections to verify that the
1005 peer is still up and reachable.
1006 .It Va tcp_drop_synfin
1007 .Pq Vt bool
1008 Set to
1009 .Dq Li NO
1010 by default.
1011 Setting to
1012 .Dq Li YES
1013 will cause the kernel to ignore TCP frames that have both
1014 the SYN and FIN flags set.
1015 This prevents OS fingerprinting, but may
1016 break some legitimate applications.
1017 .It Va icmp_drop_redirect
1018 .Pq Vt bool
1019 Set to
1020 .Dq Li NO
1021 by default.
1022 Setting to
1023 .Dq Li YES
1024 will cause the kernel to ignore ICMP REDIRECT packets.
1025 Refer to
1026 .Xr icmp 4
1027 for more information.
1028 .It Va icmp_log_redirect
1029 .Pq Vt bool
1030 Set to
1031 .Dq Li NO
1032 by default.
1033 Setting to
1034 .Dq Li YES
1035 will cause the kernel to log ICMP REDIRECT packets.
1036 Note that
1037 the log messages are not rate-limited, so this option should only be used
1038 for troubleshooting networks.
1039 Refer to
1040 .Xr icmp 4
1041 for more information.
1042 .It Va icmp_bmcastecho
1043 .Pq Vt bool
1044 Set to
1045 .Dq Li YES
1046 to respond to broadcast or multicast ICMP ping packets.
1047 Refer to
1048 .Xr icmp 4
1049 for more information.
1050 .It Va ip_portrange_first
1051 .Pq Vt int
1052 If not set to
1053 .Dq Li NO ,
1054 this is the first port in the default portrange.
1055 Refer to
1056 .Xr ip 4
1057 for more information.
1058 .It Va ip_portrange_last
1059 .Pq Vt int
1060 If not set to
1061 .Dq Li NO ,
1062 this is the last port in the default portrange.
1063 Refer to
1064 .Xr ip 4
1065 for more information.
1066 .It Va network_interfaces
1067 .Pq Vt str
1068 Set to the list of network interfaces to configure on this host or
1069 .Dq Li AUTO
1070 (the default) for all current interfaces.
1071 Setting the
1072 .Va network_interfaces
1073 variable to anything other than the default is deprecated.
1074 Interfaces that the administrator wishes to store configuration for,
1075 but not start at boot should be configured with the
1076 .Dq Li NOAUTO
1077 keyword in their
1078 .Va ifconfig_ Ns Aq Ar interface
1079 variables as described below.
1080 .Pp
1081 An
1082 .Va ifconfig_ Ns Aq Ar interface
1083 variable is also assumed to exist for each value of
1084 .Ar interface .
1085 When an interface name contains any of the characters
1086 .Dq Li .-/+
1087 they are translated to
1088 .Dq Li _
1089 before lookup.
1090 The variable can contain arguments to
1091 .Xr ifconfig 8 ,
1092 as well as special case-insensitive keywords described below.
1093 Such keywords are removed before passing the value to
1094 .Xr ifconfig 8
1095 while the order of the other arguments is preserved.
1096 .Pp
1097 It is possible to add IP alias entries using
1098 .Xr ifconfig 8
1099 syntax with the address family keyword such as
1100 .Li inet .
1101 Assuming that the interface in question was
1102 .Li ed0 ,
1103 it might look something like this:
1104 .Bd -literal
1105 ifconfig_ed0_alias0="inet 127.0.0.253 netmask 0xffffffff"
1106 ifconfig_ed0_alias1="inet 127.0.0.254 netmask 0xffffffff"
1107 .Ed
1108 .Pp
1109 It also possible to configure multiple IP addresses in Classless
1110 Inter-Domain Routing
1111 .Pq CIDR
1112 address notation,
1113 whose each address component can be a range like
1114 .Li inet 192.0.2.5-23/24
1115 or
1116 .Li inet6 2001:db8:1-f::1/64 .
1117 This notation allows address and prefix length part only,
1118 not the other address modifiers.
1119 .Pp
1120 In the case of
1121 .Li 192.0.2.5-23/24 ,
1122 the address 192.0.2.5 will be configured with the
1123 netmask /24 and the addresses 192.0.2.6 to 192.0.2.23 with
1124 the non-conflicting netmask /32 as explained in the
1125 .Xr ifconfig 8
1126 alias section.
1127 Note that this special netmask handling is only for
1128 .Li inet ,
1129 not for the other address families such as
1130 .Li inet6 .
1131 .Pp
1132 With the interface in question being
1133 .Li ed0 ,
1134 an example could look like:
1135 .Bd -literal
1136 ifconfig_ed0_alias2="inet 192.0.2.129/27"
1137 ifconfig_ed0_alias3="inet 192.0.2.1-5/28"
1138 .Ed
1139 .Pp
1140 and so on.
1141 .Pp
1142 Note that
1143 .Va ipv4_addrs_ Ns Aq Ar interface
1144 variable was supported for IPv4 CIDR address notation.
1145 It is now deprecated because the functionality was integrated into
1146 .Va ifconfig_ Ns Ao Ar interface Ac Ns Va _alias Ns Aq Ar n
1147 though
1148 .Va ipv4_addrs_ Ns Aq Ar interface
1149 is still supported for backward compatibility.
1150 .Pp
1151 For each
1152 .Va ifconfig_ Ns Ao Ar interface Ac Ns Va _alias Ns Aq Ar n
1153 entry with an address family keyword,
1154 its contents are passed to
1155 .Xr ifconfig 8 .
1156 Execution stops at the first unsuccessful access, so if
1157 something like this is present:
1158 .Bd -literal
1159 ifconfig_ed0_alias0="inet 127.0.0.251 netmask 0xffffffff"
1160 ifconfig_ed0_alias1="inet 127.0.0.252 netmask 0xffffffff"
1161 ifconfig_ed0_alias2="inet 127.0.0.253 netmask 0xffffffff"
1162 ifconfig_ed0_alias4="inet 127.0.0.254 netmask 0xffffffff"
1163 .Ed
1164 .Pp
1165 Then note that alias4 would
1166 .Em not
1167 be added since the search would
1168 stop with the missing
1169 .Dq Li alias3
1170 entry.
1171 Due to this difficult to manage behavior, the
1172 .Va ifconfig_ Ns Ao Ar interface Ac Ns Va _alias Ns Aq Ar n
1173 form is deprecated.
1174 There is
1175 .Va ifconfig_ Ns Ao Ar interface Ac Ns Va _aliases
1176 variable, which has the same functionality as
1177 .Va ifconfig_ Ns Ao Ar interface Ac Ns Va _alias Ns Aq Ar n
1178 and can have all of entries in a variable like the following:
1179 .Bd -literal
1180 ifconfig_ed0_aliases="\\
1181         inet 127.0.0.251 netmask 0xffffffff \\
1182         inet 127.0.0.252 netmask 0xffffffff \\
1183         inet 127.0.0.253 netmask 0xffffffff \\
1184         inet 127.0.0.254 netmask 0xffffffff"
1185 .Ed
1186 .Pp
1187 It also supports CIDR notation.
1188 .Pp
1189 If the
1190 .Pa /etc/start_if. Ns Aq Ar interface
1191 file is present, it is read and executed by the
1192 .Xr sh 1
1193 interpreter
1194 before configuring the interface as specified in the
1195 .Va ifconfig_ Ns Aq Ar interface
1196 and
1197 .Va ifconfig_ Ns Ao Ar interface Ac Ns Va _alias Ns Aq Ar n
1198 variables.
1199 .Pp
1200 If a
1201 .Va vlans_ Ns Aq Ar interface
1202 variable is set,
1203 a
1204 .Xr vlan 4
1205 interface will be created for each item in the list with the
1206 .Ar vlandev
1207 argument set to
1208 .Ar interface .
1209 If a vlan interface's name is a number,
1210 then that number is used as the vlan tag and the new vlan interface is
1211 named
1212 .Ar interface . Ns Ar tag .
1213 Otherwise,
1214 the vlan tag must be specified via a
1215 .Va vlan
1216 parameter in the
1217 .Va create_args_ Ns Aq Ar interface
1218 variable.
1219 .Pp
1220 To create a vlan device named
1221 .Li em0.101
1222 on
1223 .Li em0
1224 with the vlan tag 101 and the optional the IPv4 address 192.0.2.1/24:
1225 .Bd -literal
1226 vlans_em0="101"
1227 ifconfig_em0_101="inet 192.0.2.1/24"
1228 .Ed
1229 .Pp
1230 To create a vlan device named
1231 .Li myvlan
1232 on
1233 .Li em0
1234 with the vlan tag 102:
1235 .Bd -literal
1236 vlans_em0="myvlan"
1237 create_args_myvlan="vlan 102"
1238 .Ed
1239 .Pp
1240 If a
1241 .Va wlans_ Ns Aq Ar interface
1242 variable is set,
1243 an
1244 .Xr wlan 4
1245 interface will be created for each item in the list with the
1246 .Ar wlandev
1247 argument set to
1248 .Ar interface .
1249 Further wlan cloning arguments may be passed to the
1250 .Xr ifconfig 8
1251 .Cm create
1252 command by setting the
1253 .Va create_args_ Ns Aq Ar interface
1254 variable.
1255 One or more
1256 .Xr wlan 4
1257 devices must be created for each wireless devices as of
1258 .Fx 8.0 .
1259 Debugging flags for
1260 .Xr wlan 4
1261 devices as set by
1262 .Xr wlandebug 8
1263 may be specified with an
1264 .Va wlandebug_ Ns Aq Ar interface
1265 variable.
1266 The contents of this variable will be passed directly to
1267 .Xr wlandebug 8 .
1268 .Pp
1269 If the
1270 .Va ifconfig_ Ns Aq Ar interface
1271 contains the keyword
1272 .Dq Li NOAUTO
1273 then the interface will not be configured
1274 at boot or by
1275 .Pa /etc/pccard_ether
1276 when
1277 .Va network_interfaces
1278 is set to
1279 .Dq Li AUTO .
1280 .Pp
1281 It is possible to bring up an interface with DHCP by adding
1282 .Dq Li DHCP
1283 to the
1284 .Va ifconfig_ Ns Aq Ar interface
1285 variable.
1286 For instance, to initialize the
1287 .Li ed0
1288 device via DHCP,
1289 it is possible to use something like:
1290 .Bd -literal
1291 ifconfig_ed0="DHCP"
1292 .Ed
1293 .Pp
1294 Also, if you want to configure your wireless interface with
1295 .Xr wpa_supplicant 8
1296 for use with WPA, EAP/LEAP or WEP, you need to add
1297 .Dq Li WPA
1298 to the
1299 .Va ifconfig_ Ns Aq Ar interface
1300 variable.
1301 .Pp
1302 Finally, you can add
1303 .Xr ifconfig 8
1304 options in this variable, in addition to the
1305 .Pa /etc/start_if. Ns Aq Ar interface
1306 file.
1307 For instance, to configure an
1308 .Xr ath 4
1309 wireless device in station mode with an address obtained
1310 via DHCP, using WPA authentication and 802.11b mode, it is
1311 possible to use something like:
1312 .Bd -literal
1313 wlans_ath0="wlan0"
1314 ifconfig_wlan0="DHCP WPA mode 11b"
1315 .Ed
1316 .Pp
1317 In addition to the
1318 .Va ifconfig_ Ns Aq Ar interface
1319 form, a fallback variable
1320 .Va ifconfig_DEFAULT
1321 may be configured.
1322 It will be used for all interfaces with no
1323 .Va ifconfig_ Ns Aq Ar interface
1324 variable.
1325 This is intended to replace the no longer supported
1326 .Va pccard_ifconfig
1327 variable.
1328 .Pp
1329 It is also possible to rename an interface by doing:
1330 .Bd -literal
1331 ifconfig_ed0_name="net0"
1332 ifconfig_net0="inet 192.0.2.1 netmask 0xffffff00"
1333 .Ed
1334 .It Va ipv6_enable
1335 .Pq Vt bool
1336 This variable is deprecated.
1337 Use
1338 .Va ifconfig_ Ns Ao Ar interface Ac Ns _ipv6
1339 and
1340 .Va ipv6_activate_all_interfaces
1341 if necessary.
1342 .Pp
1343 If the variable is
1344 .Dq Li YES ,
1345 .Dq Li inet6 accept_rtadv
1346 is added to all of
1347 .Va ifconfig_ Ns Ao Ar interface Ac Ns _ipv6
1348 and the
1349 .Va ipv6_activate_all_interfaces
1350 is defined as
1351 .Dq Li YES .
1352 .It Va ipv6_prefer
1353 .Pq Vt bool
1354 This variable is deprecated.
1355 Use
1356 .Va ip6addrctl_policy
1357 instead.
1358 .Pp
1359 If the variable is
1360 .Dq Li YES ,
1361 the default address selection policy table set by
1362 .Xr ip6addrctl 8
1363 will be IPv6-preferred.
1364 .Pp
1365 If the variable is
1366 .Dq Li NO ,
1367 the default address selection policy table set by
1368 .Xr ip6addrctl 8
1369 will be IPv4-preferred.
1370 .It Va ipv6_activate_all_interfaces
1371 .Pq Vt bool
1372 This controls initial configuration on IPv6-capable
1373 interfaces with no corresponding
1374 .Va ifconfig_ Ns Ao Ar interface Ac Ns _ipv6
1375 variable.
1376 Note that it is not always necessary to set this variable to
1377 .Dq YES
1378 to use IPv6 functionality on
1379 .Fx .
1380 In most cases, just configuring
1381 .Va ifconfig_ Ns Ao Ar interface Ac Ns _ipv6
1382 variables works.
1383 .Pp
1384 If the variable is
1385 .Dq Li NO ,
1386 all interfaces which do not have a corresponding
1387 .Va ifconfig_ Ns Ao Ar interface Ac Ns _ipv6
1388 variable will be marked as
1389 .Dq Li IFDISABLED
1390 at creation.
1391 This means that all of IPv6 functionality on that interface
1392 is completely disabled to enforce a security policy.
1393 If the variable is set to
1394 .Dq YES ,
1395 the flag will be cleared on all of the interfaces.
1396 .Pp
1397 In most cases, just defining an
1398 .Va ifconfig_ Ns Ao Ar interface Ac Ns _ipv6
1399 for an IPv6-capable interface should be sufficient.
1400 However, if an interface is added dynamically
1401 .Pq by some tunneling protocols such as PPP, for example ,
1402 it is often difficult to define the variable in advance.
1403 In such a case, configuring the
1404 .Dq Li IFDISABLED
1405 flag can be disabled by setting this variable to
1406 .Dq YES .
1407 .Pp
1408 For more details of the
1409 .Dq Li IFDISABLED
1410 flag and keywords
1411 .Dq Li inet6 ifdisabled ,
1412 see
1413 .Xr ifconfig 8 .
1414 .Pp
1415 Default is
1416 .Dq Li NO .
1417 .It Va ipv6_privacy
1418 .Pq Vt bool
1419 If the variable is
1420 .Dq Li YES
1421 privacy addresses will be generated for each IPv6
1422 interface as described in RFC 4941.
1423 .It Va ipv6_network_interfaces
1424 .Pq Vt str
1425 This is the IPv6 equivalent of
1426 .Va network_interfaces .
1427 Normally manual configuration of this variable is not needed.
1428 .Pp
1429 .It Va ipv6_cpe_wanif
1430 .Pq Vt str
1431 If the variable is set to an interface name,
1432 the
1433 .Xr ifconfig 8
1434 options
1435 .Dq inet6 -no_radr accept_rtadv
1436 will be added to the specified interface automatically before evaluating
1437 .Va ifconfig_ Ns Ao Ar interface Ac Ns _ipv6 ,
1438 and two
1439 .Xr sysctl 8
1440 variables
1441 .Va net.inet6.ip6.rfc6204w3
1442 and
1443 .Va net.inet6.ip6.no_radr
1444 will be set to 1.
1445 .Pp
1446 This means the specified interface will accept ICMPv6 Router
1447 Advertisement messages on that link and add the discovered
1448 routers into the Default Router List.
1449 While the other interfaces can still accept RA messages if the
1450 .Dq inet6 accept_rtadv
1451 option is specified, adding
1452 routes into the Default Router List will be disabled by
1453 .Dq inet6 no_radr
1454 option by default.
1455 See
1456 .Xr ifconfig 8
1457 for more details.
1458 .Pp
1459 Note that ICMPv6 Router Advertisement messages will be
1460 accepted even when
1461 .Va net.inet6.ip6.forwarding
1462 is 1
1463 .Pq packet forwarding is enabled
1464 when
1465 .Va net.inet6.ip6.rfc6204w3
1466 is set to 1.
1467 .Pp
1468 Default is
1469 .Dq Li NO .
1470 .It Va ifconfig_ Ns Ao Ar interface Ac Ns _ipv6
1471 .Pq Vt str
1472 IPv6 functionality on an interface should be configured by
1473 .Va ifconfig_ Ns Ao Ar interface Ac Ns _ipv6 ,
1474 instead of setting ifconfig parameters in
1475 .Va ifconfig_ Ns Aq Ar interface .
1476 If this variable is empty, all of IPv6 configurations on the
1477 specified interface by other variables such as
1478 .Va ipv6_prefix_ Ns Ao Ar interface Ac
1479 will be ignored.
1480 .Pp
1481 Aliases should be set by
1482 .Va ifconfig_ Ns Ao Ar interface Ac Ns Va _alias Ns Aq Ar n
1483 with
1484 .Dq Li inet6
1485 keyword.
1486 For example:
1487 .Bd -literal
1488 ifconfig_ed0_ipv6="inet6 2001:db8:1::1 prefixlen 64"
1489 ifconfig_ed0_alias0="inet6 2001:db8:2::1 prefixlen 64"
1490 .Ed
1491 .Pp
1492 Interfaces that have an
1493 .Dq Li inet6 accept_rtadv
1494 keyword in
1495 .Va ifconfig_ Ns Ao Ar interface Ac Ns _ipv6
1496 setting will be automatically configured by SLAAC
1497 .Pq StateLess Address AutoConfiguration
1498 described in
1499 .Rs
1500 .%T "RFC 4862"
1501 .Re
1502 .Pp
1503 Note that a link-local address will be automatically configured in
1504 addition to the configured global-scope addresses because the IPv6
1505 specifications require it on each link.
1506 The address is calculated from the MAC address by using an algorithm
1507 defined in
1508 .Rs
1509 .%T "RFC 4862"
1510 .%O "Section 5.3"
1511 .Re
1512 .Pp
1513 If only a link-local address is needed on the interface,
1514 the following configuration can be used:
1515 .Bd -literal
1516 ifconfig_ed0_ipv6="inet6 auto_linklocal"
1517 .Ed
1518 .Pp
1519 A link-local address can also be configured manually.
1520 This is useful for the default router address of an IPv6 router
1521 so that it does not change when the network interface
1522 card is replaced.
1523 For example:
1524 .Bd -literal
1525 ifconfig_ed0_ipv6="inet6 fe80::1 prefixlen 64"
1526 .Ed
1527 .It Va ipv6_prefix_ Ns Aq Ar interface
1528 .Pq Vt str
1529 If one or more prefixes are defined in
1530 .Va ipv6_prefix_ Ns Aq Ar interface
1531 addresses based on each prefix and the EUI-64 interface index will be
1532 configured on that interface.
1533 Note that this variable will be ignored when
1534 .Va ifconfig_ Ns Ao Ar interface Ac Ns _ipv6
1535 is empty.
1536 .Pp
1537 For example, the following configuration
1538 .Bd -literal
1539 ipv6_prefix_ed0="2001:db8:1:0 2001:db8:2:0"
1540 .Ed
1541 .Pp
1542 is equivalent to the following:
1543 .Bd -literal
1544 ifconfig_ed0_alias0="inet6 2001:db8:1:: eui64 prefixlen 64"
1545 ifconfig_ed0_alias1="inet6 2001:db8:1:: prefixlen 64 anycast"
1546 ifconfig_ed0_alias2="inet6 2001:db8:2:: eui64 prefixlen 64"
1547 ifconfig_ed0_alias3="inet6 2001:db8:2:: prefixlen 64 anycast"
1548 .Ed
1549 .Pp
1550 These Subnet-Router anycast addresses will be added only when
1551 .Va ipv6_gateway_enable
1552 is YES.
1553 .It Va ipv6_default_interface
1554 .Pq Vt str
1555 If not set to
1556 .Dq Li NO ,
1557 this is the default output interface for scoped addresses.
1558 This works only with ipv6_gateway_enable="NO".
1559 .It Va ip6addrctl_enable
1560 .Pq Vt bool
1561 This variable is to enable configuring default address selection policy table
1562 .Pq RFC 3484 .
1563 The table can be specified in another variable
1564 .Va ip6addrctl_policy .
1565 For
1566 .Va ip6addrctl_policy
1567 the following keywords can be specified:
1568 .Dq Li ipv4_prefer ,
1569 .Dq Li ipv6_prefer ,
1570 or
1571 .Dq Li AUTO .
1572 .Pp
1573 If
1574 .Dq Li ipv4_prefer
1575 or
1576 .Dq Li ipv6_prefer
1577 is specified,
1578 .Xr ip6addrctl 8
1579 installs a pre-defined policy table described in Section 2.1
1580 .Pq IPv6-preferred
1581 or 10.3
1582 .Pq IPv4-preferred
1583 of RFC 3484.
1584 .Pp
1585 If
1586 .Dq Li AUTO
1587 is specified, it attempts to read a file
1588 .Pa /etc/ip6addrctl.conf
1589 first.
1590 If this file is found,
1591 .Xr ip6addrctl 8
1592 reads and installs it.
1593 If not found, a policy is automatically set
1594 according to
1595 .Va ipv6_activate_all_interfaces
1596 variable; if the variable is set to
1597 .Dq Li YES
1598 the IPv6-preferred one is used.
1599 Otherwise IPv4-preferred.
1600 .Pp
1601 The default value of
1602 .Va ip6addrctl_enable
1603 and
1604 .Va ip6addrctl_policy
1605 are
1606 .Dq Li YES
1607 and
1608 .Dq Li AUTO ,
1609 respectively.
1610 .It Va cloned_interfaces
1611 .Pq Vt str
1612 Set to the list of clonable network interfaces to create on this host.
1613 Further cloning arguments may be passed to the
1614 .Xr ifconfig 8
1615 .Cm create
1616 command for each interface by setting the
1617 .Va create_args_ Ns Aq Ar interface
1618 variable.
1619 Entries in
1620 .Va cloned_interfaces
1621 are automatically appended to
1622 .Va network_interfaces
1623 for configuration.
1624 .It Va fec_interfaces
1625 .Pq Vt str
1626 Set to the list of
1627 .Xr ng_fec 4
1628 Fast EtherChannel interfaces to configure on this host.
1629 A
1630 .Va fecconfig_ Ns Aq Ar interface
1631 variable is assumed to exist for each value of
1632 .Ar interface .
1633 The value of this variable is used to configure link aggregated interfaces
1634 according to the syntax of the
1635 .Cm NGM_FEC_ADD_IFACE
1636 to
1637 .Xr ngctl 8
1638 msg.
1639 Additionally, this option ensures that each listed interface is created
1640 via the
1641 .Cm mkpeer
1642 command to
1643 .Xr ngctl 8
1644 before attempting to configure it.
1645 For example:
1646 .Bd -literal
1647 fec_interfaces="fec0"
1648 fecconfig_fec0="em0 em1"
1649 ifconfig_fec0="DHCP"
1650 .Ed
1651 .It Va gif_interfaces
1652 .Pq Vt str
1653 Set to the list of
1654 .Xr gif 4
1655 tunnel interfaces to configure on this host.
1656 A
1657 .Va gifconfig_ Ns Aq Ar interface
1658 variable is assumed to exist for each value of
1659 .Ar interface .
1660 The value of this variable is used to configure the link layer of the
1661 tunnel according to the syntax of the
1662 .Cm tunnel
1663 option to
1664 .Xr ifconfig 8 .
1665 Additionally, this option ensures that each listed interface is created
1666 via the
1667 .Cm create
1668 option to
1669 .Xr ifconfig 8
1670 before attempting to configure it.
1671 .It Va sppp_interfaces
1672 .Pq Vt str
1673 Set to the list of
1674 .Xr sppp 4
1675 interfaces to configure on this host.
1676 A
1677 .Va spppconfig_ Ns Aq Ar interface
1678 variable is assumed to exist for each value of
1679 .Ar interface .
1680 Each interface should also be configured by a general
1681 .Va ifconfig_ Ns Aq Ar interface
1682 setting.
1683 Refer to
1684 .Xr spppcontrol 8
1685 for more information about available options.
1686 .It Va ppp_enable
1687 .Pq Vt bool
1688 If set to
1689 .Dq Li YES ,
1690 run the
1691 .Xr ppp 8
1692 daemon.
1693 .It Va ppp_profile
1694 .Pq Vt str
1695 The name of the profile to use from
1696 .Pa /etc/ppp/ppp.conf .
1697 Also used for per-profile overrides of
1698 .Va ppp_mode
1699 and
1700 .Va ppp_nat ,
1701 and
1702 .Va ppp_ Ns Ao Ar profile Ac Ns _unit .
1703 When the profile name contains any of the characters
1704 .Dq Li .-/+
1705 they are translated to
1706 .Dq Li _
1707 for the proposes of the override variable names.
1708 .It Va ppp_mode
1709 .Pq Vt str
1710 Mode in which to run the
1711 .Xr ppp 8
1712 daemon.
1713 .It Va ppp_ Ns Ao Ar profile Ac Ns _mode
1714 .Pq Vt str
1715 Overrides the global
1716 .Va ppp_mode
1717 for
1718 .Ar profile .
1719 Accepted modes are
1720 .Dq Li auto ,
1721 .Dq Li ddial ,
1722 .Dq Li direct
1723 and
1724 .Dq Li dedicated .
1725 See the manual for a full description.
1726 .It Va ppp_nat
1727 .Pq Vt bool
1728 If set to
1729 .Dq Li YES ,
1730 enables network address translation.
1731 Used in conjunction with
1732 .Va gateway_enable
1733 allows hosts on private network addresses access to the Internet using
1734 this host as a network address translating router.
1735 .It Va ppp_ Ns Ao Ar profile Ac Ns _nat
1736 .Pq Vt str
1737 Overrides the global
1738 .Va ppp_nat
1739 for
1740 .Ar profile .
1741 .It Va ppp_ Ns Ao Ar profile Ac Ns _unit
1742 .Pq Vt int
1743 Set the unit number to be used for this profile.
1744 See the manual description of
1745 .Fl unit Ns Ar N
1746 for details.
1747 .It Va ppp_user
1748 .Pq Vt str
1749 The name of the user under which
1750 .Xr ppp 8
1751 should be started.
1752 By
1753 default,
1754 .Xr ppp 8
1755 is started as
1756 .Dq Li root .
1757 .It Va rc_conf_files
1758 .Pq Vt str
1759 This option is used to specify a list of files that will override
1760 the settings in
1761 .Pa /etc/defaults/rc.conf .
1762 The files will be read in the order in which they are specified and should
1763 include the full path to the file.
1764 By default, the files specified are
1765 .Pa /etc/rc.conf
1766 and
1767 .Pa /etc/rc.conf.local
1768 .It Va zfs_enable
1769 .Pq Vt bool
1770 If set to
1771 .Dq Li YES ,
1772 .Pa /etc/rc.d/zfs
1773 will attempt to automatically mount ZFS file systems and initialize ZFS volumes
1774 (ZVOLs).
1775 .It Va gptboot_enable
1776 .Pq Vt bool
1777 If set to
1778 .Dq Li YES ,
1779 .Pa /etc/rc.d/gptboot
1780 will log if the system successfully (or not) booted from a GPT partition,
1781 which had the
1782 .Ar bootonce
1783 attribute set using
1784 .Xr gpart 8
1785 utility.
1786 .It Va gbde_autoattach_all
1787 .Pq Vt bool
1788 If set to
1789 .Dq Li YES ,
1790 .Pa /etc/rc.d/gbde
1791 will attempt to automatically initialize your .bde devices in
1792 .Pa /etc/fstab .
1793 .It Va gbde_devices
1794 .Pq Vt str
1795 List the devices that the script should try to attach,
1796 or
1797 .Dq Li AUTO .
1798 .It Va gbde_lockdir
1799 .Pq Vt str
1800 The directory where the
1801 .Xr gbde 4
1802 lockfiles are located.
1803 The default lockfile directory is
1804 .Pa /etc .
1805 .Pp
1806 The lockfile for each individual
1807 .Xr gbde 4
1808 device can be overridden by setting the variable
1809 .Va gbde_lock_ Ns Aq Ar device ,
1810 where
1811 .Ar device
1812 is the encrypted device without the
1813 .Dq Pa /dev/
1814 and
1815 .Dq Pa .bde
1816 parts.
1817 .It Va gbde_attach_attempts
1818 .Pq Vt int
1819 Number of times to attempt attaching to a
1820 .Xr gbde 4
1821 device, i.e., how many times the user is asked for the pass-phrase.
1822 Default is 3.
1823 .It Va geli_devices
1824 .Pq Vt str
1825 List of devices to automatically attach on boot.
1826 Note that .eli devices from
1827 .Pa /etc/fstab
1828 are automatically appended to this list.
1829 .It Va geli_tries
1830 .Pq Vt int
1831 Number of times user is asked for the pass-phrase.
1832 If empty, it will be taken from
1833 .Va kern.geom.eli.tries
1834 sysctl variable.
1835 .It Va geli_default_flags
1836 .Pq Vt str
1837 Default flags to use by
1838 .Xr geli 8
1839 when configuring disk encryption.
1840 Flags can be configured for every device separately by defining
1841 .Va geli_ Ns Ao Ar device Ac Ns Va _flags
1842 variable.
1843 .It Va geli_autodetach
1844 .Pq Vt str
1845 Specifies if GELI devices should be marked for detach on last close after
1846 file systems are mounted.
1847 Default is
1848 .Dq Li YES .
1849 This can be changed for every device separately by defining
1850 .Va geli_ Ns Ao Ar device Ac Ns Va _autodetach
1851 variable.
1852 .It Va geli_swap_flags
1853 Options passed to the
1854 .Xr geli 8
1855 utility when encrypted GEOM providers for swap partitions are created.
1856 The default is
1857 .Dq Li "-e aes -l 256 -s 4096 -d" .
1858 .It Va root_rw_mount
1859 .Pq Vt bool
1860 Set to
1861 .Dq Li YES
1862 by default.
1863 After the file systems are checked at boot time, the root file system
1864 is remounted as read-write if this is set to
1865 .Dq Li YES .
1866 Diskless systems that mount their root file system from a read-only remote
1867 NFS share should set this to
1868 .Dq Li NO
1869 in their
1870 .Pa rc.conf .
1871 .It Va fsck_y_enable
1872 .Pq Vt bool
1873 If set to
1874 .Dq Li YES ,
1875 .Xr fsck 8
1876 will be run with the
1877 .Fl y
1878 flag if the initial preen
1879 of the file systems fails.
1880 .It Va background_fsck
1881 .Pq Vt bool
1882 If set to
1883 .Dq Li YES ,
1884 the system will attempt to run
1885 .Xr fsck 8
1886 in the background where possible.
1887 .It Va background_fsck_delay
1888 .Pq Vt int
1889 The amount of time in seconds to sleep before starting a background
1890 .Xr fsck 8 .
1891 It defaults to sixty seconds to allow large applications such as
1892 the X server to start before disk I/O bandwidth is monopolized by
1893 .Xr fsck 8 .
1894 If set to a negative number, the background file system check will be
1895 delayed indefinitely to allow the administrator to run it at a more
1896 convenient time.
1897 For example it may be run from
1898 .Xr cron 8
1899 by adding a line like
1900 .Pp
1901 .Dl "0 4 * * * root /etc/rc.d/bgfsck forcestart"
1902 .Pp
1903 to
1904 .Pa /etc/crontab .
1905 .It Va netfs_types
1906 .Pq Vt str
1907 List of file system types that are network-based.
1908 This list should generally not be modified by end users.
1909 Use
1910 .Va extra_netfs_types
1911 instead.
1912 .It Va extra_netfs_types
1913 .Pq Vt str
1914 If set to something other than
1915 .Dq Li NO
1916 (the default),
1917 this variable extends the list of file system types
1918 for which automatic mounting at startup by
1919 .Xr rc 8
1920 should be delayed until the network is initialized.
1921 It should contain
1922 a whitespace-separated list of network file system descriptor pairs,
1923 each consisting of a file system type as passed to
1924 .Xr mount 8
1925 and a human-readable, one-word description,
1926 joined with a colon
1927 .Pq Ql \&: .
1928 Extending the default list in this way is only necessary
1929 when third party file system types are used.
1930 .It Va syslogd_enable
1931 .Pq Vt bool
1932 If set to
1933 .Dq Li YES ,
1934 run the
1935 .Xr syslogd 8
1936 daemon.
1937 .It Va syslogd_program
1938 .Pq Vt str
1939 Path to
1940 .Xr syslogd 8
1941 (default
1942 .Pa /usr/sbin/syslogd ) .
1943 .It Va syslogd_flags
1944 .Pq Vt str
1945 If
1946 .Va syslogd_enable
1947 is set to
1948 .Dq Li YES ,
1949 these are the flags to pass to
1950 .Xr syslogd 8 .
1951 .It Va inetd_enable
1952 .Pq Vt bool
1953 If set to
1954 .Dq Li YES ,
1955 run the
1956 .Xr inetd 8
1957 daemon.
1958 .It Va inetd_program
1959 .Pq Vt str
1960 Path to
1961 .Xr inetd 8
1962 (default
1963 .Pa /usr/sbin/inetd ) .
1964 .It Va inetd_flags
1965 .Pq Vt str
1966 If
1967 .Va inetd_enable
1968 is set to
1969 .Dq Li YES ,
1970 these are the flags to pass to
1971 .Xr inetd 8 .
1972 .It Va hastd_enable
1973 .Pq Vt bool
1974 If set to
1975 .Dq Li YES ,
1976 run the
1977 .Xr hastd 8
1978 daemon.
1979 .It Va hastd_program
1980 .Pq Vt str
1981 Path to
1982 .Xr hastd 8
1983 (default
1984 .Pa /sbin/hastd ) .
1985 .It Va hastd_flags
1986 .Pq Vt str
1987 If
1988 .Va hastd_enable
1989 is set to
1990 .Dq Li YES ,
1991 these are the flags to pass to
1992 .Xr hastd 8 .
1993 .It Va named_enable
1994 .Pq Vt bool
1995 If set to
1996 .Dq Li YES ,
1997 run the
1998 .Xr named 8
1999 daemon.
2000 .It Va named_program
2001 .Pq Vt str
2002 Path to
2003 .Xr named 8
2004 (default
2005 .Pa /usr/sbin/named ) .
2006 .It Va named_conf
2007 .Pq Vt str
2008 Path to
2009 .Xr named 8
2010 configuration file, (default
2011 .Pa /etc/namedb/named.conf ) .
2012 .It Va named_flags
2013 .Pq Vt str
2014 If
2015 .Va named_enable
2016 is set to
2017 .Dq Li YES ,
2018 these are the flags to pass to
2019 .Xr named 8 .
2020 .It Va named_uid
2021 .Pq Vt str
2022 The user that the
2023 .Xr named 8
2024 process should be run as.
2025 .It Va named_chrootdir
2026 .Pq Vt str
2027 The root directory for a name server run in a
2028 .Xr chroot 8
2029 environment (default
2030 .Pa /var/named ) .
2031 If left empty
2032 .Xr named 8
2033 will not be run in a
2034 .Xr chroot 8
2035 environment.
2036 .It Va named_chroot_autoupdate
2037 .Pq Vt bool
2038 Set to
2039 .Dq Li NO
2040 to disable automatic update of the
2041 .Xr chroot 8
2042 environment.
2043 .It Va named_symlink_enable
2044 .Pq Vt bool
2045 Set to
2046 .Dq Li NO
2047 to disable symlinking of
2048 daemon's PID file
2049 into the
2050 .Xr chroot 8
2051 environment.
2052 .It Va named_wait
2053 .Pq Vt bool
2054 Set to have
2055 .Pa /etc/rc.d/named
2056 loop until working name service is established.
2057 .It Va named_wait_host
2058 .Pq Vt str
2059 Name of host to lookup for the named_wait option.
2060 (Default localhost)
2061 .It Va named_auto_forward
2062 .Pq Vt bool
2063 Set to enable automatic creation of a forwarder
2064 configuration file derived from
2065 .Pa /etc/resolv.conf .
2066 .It Va named_auto_forward_only
2067 .Pq Vt bool
2068 Set to change the default forwarder configuration from
2069 .Dq forward first
2070 to
2071 .Dq forward only .
2072 .It Va kerberos5_server_enable
2073 .Pq Vt bool
2074 Set to
2075 .Dq Li YES
2076 to start a Kerberos 5 authentication server
2077 at boot time.
2078 .It Va kerberos5_server
2079 .Pq Vt str
2080 If
2081 .Va kerberos5_server_enable
2082 is set to
2083 .Dq Li YES
2084 this is the path to Kerberos 5 Authentication Server.
2085 .It Va kerberos5_server_flags
2086 .Pq Vt str
2087 Empty by default.
2088 This variable contains additional flags to be passed to the Kerberos 5
2089 authentication server.
2090 .It Va kadmind5_server_enable
2091 .Pq Vt bool
2092 Set to
2093 .Dq Li YES
2094 to start
2095 .Xr kadmind 8 ,
2096 the Kerberos 5 Administration Daemon; set to
2097 .Dq Li NO
2098 on a slave server.
2099 .It Va kadmind5_server
2100 .Pq Vt str
2101 If
2102 .Va kadmind5_server_enable
2103 is set to
2104 .Dq Li YES
2105 this is the path to Kerberos 5 Administration Daemon.
2106 .It Va kpasswdd_server_enable
2107 .Pq Vt bool
2108 Set to
2109 .Dq Li YES
2110 to start
2111 .Xr kpasswdd 8 ,
2112 the Kerberos 5 Password-Changing Daemon; set to
2113 .Dq Li NO
2114 on a slave server.
2115 .It Va kpasswdd_server
2116 .Pq Vt str
2117 If
2118 .Va kpasswdd_server_enable
2119 is set to
2120 .Dq Li YES
2121 this is the path to Kerberos 5 Password-Changing Daemon.
2122 .It Va rwhod_enable
2123 .Pq Vt bool
2124 If set to
2125 .Dq Li YES ,
2126 run the
2127 .Xr rwhod 8
2128 daemon at boot time.
2129 .It Va rwhod_flags
2130 .Pq Vt str
2131 If
2132 .Va rwhod_enable
2133 is set to
2134 .Dq Li YES ,
2135 these are the flags to pass to it.
2136 .It Va amd_enable
2137 .Pq Vt bool
2138 If set to
2139 .Dq Li YES ,
2140 run the
2141 .Xr amd 8
2142 daemon at boot time.
2143 .It Va amd_flags
2144 .Pq Vt str
2145 If
2146 .Va amd_enable
2147 is set to
2148 .Dq Li YES ,
2149 these are the flags to pass to it.
2150 See the
2151 .Xr amd 8
2152 manpage for more information.
2153 .It Va amd_map_program
2154 .Pq Vt str
2155 If set,
2156 the specified program is run to get the list of
2157 .Xr amd 8
2158 maps.
2159 For example, if the
2160 .Xr amd 8
2161 maps are stored in NIS, one can set this to
2162 run
2163 .Xr ypcat 1
2164 to get a list of
2165 .Xr amd 8
2166 maps from the
2167 .Pa amd.master
2168 NIS map.
2169 .It Va update_motd
2170 .Pq Vt bool
2171 If set to
2172 .Dq Li YES ,
2173 .Pa /etc/motd
2174 will be updated at boot time to reflect the kernel release
2175 being run.
2176 If set to
2177 .Dq Li NO ,
2178 .Pa /etc/motd
2179 will not be updated.
2180 .It Va nfs_client_enable
2181 .Pq Vt bool
2182 If set to
2183 .Dq Li YES ,
2184 run the NFS client daemons at boot time.
2185 .It Va nfs_access_cache
2186 .Pq Vt int
2187 If
2188 .Va nfs_client_enable
2189 is set to
2190 .Dq Li YES ,
2191 this can be set to
2192 .Dq Li 0
2193 to disable NFS ACCESS RPC caching, or to the number of seconds for which
2194 NFS ACCESS
2195 results should be cached.
2196 A value of 2-10 seconds will substantially reduce network
2197 traffic for many NFS operations.
2198 .It Va nfs_server_enable
2199 .Pq Vt bool
2200 If set to
2201 .Dq Li YES ,
2202 run the NFS server daemons at boot time.
2203 .It Va nfs_server_flags
2204 .Pq Vt str
2205 If
2206 .Va nfs_server_enable
2207 is set to
2208 .Dq Li YES ,
2209 these are the flags to pass to the
2210 .Xr nfsd 8
2211 daemon.
2212 .It Va nfsv4_server_enable
2213 .Pq Vt bool
2214 If
2215 .Va nfs_server_enable
2216 is set to
2217 .Dq Li YES
2218 and
2219 .Va nfsv4_server_enable
2220 are set to
2221 .Dq Li YES ,
2222 enable the server for NFSv4 as well as NFSv2 and NFSv3.
2223 .It Va nfsuserd_enable
2224 .Pq Vt bool
2225 If
2226 .Va nfsuserd_enable
2227 is set to
2228 .Dq Li YES ,
2229 run the nfsuserd daemon, which is needed for NFSv4 in order
2230 to map between user/group names vs uid/gid numbers.
2231 If
2232 .Va nfsv4_server_enable
2233 is set to
2234 .Dq Li YES ,
2235 this will be forced enabled.
2236 .It Va nfsuserd_flags
2237 .Pq Vt str
2238 If
2239 .Va nfsuserd_enable
2240 is set to
2241 .Dq Li YES ,
2242 these are the flags to pass to the
2243 .Xr nfsuserd 8
2244 daemon.
2245 .It Va nfscbd_enable
2246 .Pq Vt bool
2247 If
2248 .Va nfscbd_enable
2249 is set to
2250 .Dq Li YES ,
2251 run the nfscbd daemon, which enables callbacks/delegations for the NFSv4 client.
2252 .It Va nfscbd_flags
2253 .Pq Vt str
2254 If
2255 .Va nfscbd_enable
2256 is set to
2257 .Dq Li YES ,
2258 these are the flags to pass to the
2259 .Xr nfscbd 8
2260 daemon.
2261 .It Va oldnfs_server_enable
2262 .Pq Vt bool
2263 If
2264 .Va oldnfs_server_enable
2265 is set to
2266 .Dq Li YES ,
2267 force the NFS server daemons to run the old NFS server code
2268 that does not support NFSv4.
2269 .It Va mountd_enable
2270 .Pq Vt bool
2271 If set to
2272 .Dq Li YES ,
2273 and no
2274 .Va nfs_server_enable
2275 is set, start
2276 .Xr mountd 8 ,
2277 but not
2278 .Xr nfsd 8
2279 daemon.
2280 It is commonly needed to run CFS without real NFS used.
2281 .It Va mountd_flags
2282 .Pq Vt str
2283 If
2284 .Va mountd_enable
2285 is set to
2286 .Dq Li YES ,
2287 these are the flags to pass to the
2288 .Xr mountd 8
2289 daemon.
2290 .It Va weak_mountd_authentication
2291 .Pq Vt bool
2292 If set to
2293 .Dq Li YES ,
2294 allow services like PCNFSD to make non-privileged mount
2295 requests.
2296 .It Va nfs_reserved_port_only
2297 .Pq Vt bool
2298 If set to
2299 .Dq Li YES ,
2300 provide NFS services only on a secure port.
2301 .It Va nfs_bufpackets
2302 .Pq Vt int
2303 If set to a number, indicates the number of packets worth of
2304 socket buffer space to reserve on an NFS client.
2305 The kernel default is typically 4.
2306 Using a higher number may be
2307 useful on gigabit networks to improve performance.
2308 The minimum value is
2309 2 and the maximum is 64.
2310 .It Va rpc_lockd_enable
2311 .Pq Vt bool
2312 If set to
2313 .Dq Li YES
2314 and also an NFS server or client, run
2315 .Xr rpc.lockd 8
2316 at boot time.
2317 .It Va rpc_lockd_flags
2318 .Pq Vt str
2319 If
2320 .Va rpc_lockd_enable
2321 is set to
2322 .Dq Li YES ,
2323 these are the flags to pass to the
2324 .Xr rpc.lockd 8
2325 daemon.
2326 .It Va rpc_statd_enable
2327 .Pq Vt bool
2328 If set to
2329 .Dq Li YES
2330 and also an NFS server or client, run
2331 .Xr rpc.statd 8
2332 at boot time.
2333 .It Va rpc_statd_flags
2334 .Pq Vt str
2335 If
2336 .Va rpc_statd_enable
2337 is set to
2338 .Dq Li YES ,
2339 these are the flags to pass to the
2340 .Xr rpc.statd 8
2341 daemon.
2342 .It Va rpcbind_program
2343 .Pq Vt str
2344 Path to
2345 .Xr rpcbind 8
2346 (default
2347 .Pa /usr/sbin/rpcbind ) .
2348 .It Va rpcbind_enable
2349 .Pq Vt bool
2350 If set to
2351 .Dq Li YES ,
2352 run the
2353 .Xr rpcbind 8
2354 service at boot time.
2355 .It Va rpcbind_flags
2356 .Pq Vt str
2357 If
2358 .Va rpcbind_enable
2359 is set to
2360 .Dq Li YES ,
2361 these are the flags to pass to the
2362 .Xr rpcbind 8
2363 daemon.
2364 .It Va keyserv_enable
2365 .Pq Vt bool
2366 If set to
2367 .Dq Li YES ,
2368 run the
2369 .Xr keyserv 8
2370 daemon on boot for running Secure RPC.
2371 .It Va keyserv_flags
2372 .Pq Vt str
2373 If
2374 .Va keyserv_enable
2375 is set to
2376 .Dq Li YES ,
2377 these are the flags to pass to
2378 .Xr keyserv 8
2379 daemon.
2380 .It Va pppoed_enable
2381 .Pq Vt bool
2382 If set to
2383 .Dq Li YES ,
2384 run the
2385 .Xr pppoed 8
2386 daemon at boot time to provide PPP over Ethernet services.
2387 .It Va pppoed_ Ns Aq Ar provider
2388 .Pq Vt str
2389 .Xr pppoed 8
2390 listens to requests to this
2391 .Ar provider
2392 and ultimately runs
2393 .Xr ppp 8
2394 with a
2395 .Ar system
2396 argument of the same name.
2397 .It Va pppoed_flags
2398 .Pq Vt str
2399 Additional flags to pass to
2400 .Xr pppoed 8 .
2401 .It Va pppoed_interface
2402 .Pq Vt str
2403 The network interface to run
2404 .Xr pppoed 8
2405 on.
2406 This is mandatory when
2407 .Va pppoed_enable
2408 is set to
2409 .Dq Li YES .
2410 .It Va timed_enable
2411 .Pq Vt bool
2412 If set to
2413 .Dq Li YES ,
2414 run the
2415 .Xr timed 8
2416 service at boot time.
2417 This command is intended for networks of
2418 machines where a consistent
2419 .Dq "network time"
2420 for all hosts must be established.
2421 This is often useful in large NFS
2422 environments where time stamps on files are expected to be consistent
2423 network-wide.
2424 .It Va timed_flags
2425 .Pq Vt str
2426 If
2427 .Va timed_enable
2428 is set to
2429 .Dq Li YES ,
2430 these are the flags to pass to the
2431 .Xr timed 8
2432 service.
2433 .It Va ntpdate_enable
2434 .Pq Vt bool
2435 If set to
2436 .Dq Li YES ,
2437 run
2438 .Xr ntpdate 8
2439 at system startup.
2440 This command is intended to
2441 synchronize the system clock only
2442 .Em once
2443 from some standard reference.
2444 An option to set this up initially
2445 (from a list of known servers) is also provided by the
2446 .Xr sysinstall 8
2447 program when the system is first installed.
2448 .It Va ntpdate_config
2449 .Pq Vt str
2450 Configuration file for
2451 .Xr ntpdate 8 .
2452 Default
2453 .Pa /etc/ntp.conf .
2454 .It Va ntpdate_hosts
2455 .Pq Vt str
2456 A whitespace-separated list of NTP servers to synchronize with at startup.
2457 The default is to use the servers listed in
2458 .Va ntpdate_config ,
2459 if that file exists.
2460 .It Va ntpdate_program
2461 .Pq Vt str
2462 Path to
2463 .Xr ntpdate 8
2464 (default
2465 .Pa /usr/sbin/ntpdate ) .
2466 .It Va ntpdate_flags
2467 .Pq Vt str
2468 If
2469 .Va ntpdate_enable
2470 is set to
2471 .Dq Li YES ,
2472 these are the flags to pass to the
2473 .Xr ntpdate 8
2474 command (typically a hostname).
2475 .It Va ntpd_enable
2476 .Pq Vt bool
2477 If set to
2478 .Dq Li YES ,
2479 run the
2480 .Xr ntpd 8
2481 command at boot time.
2482 .It Va ntpd_program
2483 .Pq Vt str
2484 Path to
2485 .Xr ntpd 8
2486 (default
2487 .Pa /usr/sbin/ntpd ) .
2488 .It Va ntpd_config
2489 .Pq Vt str
2490 Path to
2491 .Xr ntpd 8
2492 configuration file.
2493 Default
2494 .Pa /etc/ntp.conf .
2495 .It Va ntpd_flags
2496 .Pq Vt str
2497 If
2498 .Va ntpd_enable
2499 is set to
2500 .Dq Li YES ,
2501 these are the flags to pass to the
2502 .Xr ntpd 8
2503 daemon.
2504 .It Va ntpd_sync_on_start
2505 .Pq Vt bool
2506 If set to
2507 .Dq Li YES ,
2508 .Xr ntpd 8
2509 is run with the
2510 .Fl g
2511 flag, which syncs the system's clock on startup.
2512 See
2513 .Xr ntpd 8
2514 for more information regarding the
2515 .Fl g
2516 option.
2517 This is a preferred alternative to using
2518 .Xr ntpdate 8
2519 or specifying the
2520 .Va ntpdate_enable
2521 variable.
2522 .It Va nis_client_enable
2523 .Pq Vt bool
2524 If set to
2525 .Dq Li YES ,
2526 run the
2527 .Xr ypbind 8
2528 service at system boot time.
2529 .It Va nis_client_flags
2530 .Pq Vt str
2531 If
2532 .Va nis_client_enable
2533 is set to
2534 .Dq Li YES ,
2535 these are the flags to pass to the
2536 .Xr ypbind 8
2537 service.
2538 .It Va nis_ypset_enable
2539 .Pq Vt bool
2540 If set to
2541 .Dq Li YES ,
2542 run the
2543 .Xr ypset 8
2544 daemon at system boot time.
2545 .It Va nis_ypset_flags
2546 .Pq Vt str
2547 If
2548 .Va nis_ypset_enable
2549 is set to
2550 .Dq Li YES ,
2551 these are the flags to pass to the
2552 .Xr ypset 8
2553 daemon.
2554 .It Va nis_server_enable
2555 .Pq Vt bool
2556 If set to
2557 .Dq Li YES ,
2558 run the
2559 .Xr ypserv 8
2560 daemon at system boot time.
2561 .It Va nis_server_flags
2562 .Pq Vt str
2563 If
2564 .Va nis_server_enable
2565 is set to
2566 .Dq Li YES ,
2567 these are the flags to pass to the
2568 .Xr ypserv 8
2569 daemon.
2570 .It Va nis_ypxfrd_enable
2571 .Pq Vt bool
2572 If set to
2573 .Dq Li YES ,
2574 run the
2575 .Xr rpc.ypxfrd 8
2576 daemon at system boot time.
2577 .It Va nis_ypxfrd_flags
2578 .Pq Vt str
2579 If
2580 .Va nis_ypxfrd_enable
2581 is set to
2582 .Dq Li YES ,
2583 these are the flags to pass to the
2584 .Xr rpc.ypxfrd 8
2585 daemon.
2586 .It Va nis_yppasswdd_enable
2587 .Pq Vt bool
2588 If set to
2589 .Dq Li YES ,
2590 run the
2591 .Xr rpc.yppasswdd 8
2592 daemon at system boot time.
2593 .It Va nis_yppasswdd_flags
2594 .Pq Vt str
2595 If
2596 .Va nis_yppasswdd_enable
2597 is set to
2598 .Dq Li YES ,
2599 these are the flags to pass to the
2600 .Xr rpc.yppasswdd 8
2601 daemon.
2602 .It Va rpc_ypupdated_enable
2603 .Pq Vt bool
2604 If set to
2605 .Dq Li YES ,
2606 run the
2607 .Nm rpc.ypupdated
2608 daemon at system boot time.
2609 .It Va bsnmpd_enable
2610 .Pq Vt bool
2611 If set to
2612 .Dq Li YES ,
2613 run the
2614 .Xr bsnmpd 1
2615 daemon at system boot time.
2616 Be sure to understand the security implications of running SNMP daemon
2617 on your host.
2618 .It Va bsnmpd_flags
2619 .Pq Vt str
2620 If
2621 .Va bsnmpd_enable
2622 is set to
2623 .Dq Li YES ,
2624 these are the flags to pass to the
2625 .Xr bsnmpd 1
2626 daemon.
2627 .It Va defaultrouter
2628 .Pq Vt str
2629 If not set to
2630 .Dq Li NO ,
2631 create a default route to this host name or IP address
2632 (use an IP address if this router is also required to get to the
2633 name server!).
2634 .It Va ipv6_defaultrouter
2635 .Pq Vt str
2636 The IPv6 equivalent of
2637 .Va defaultrouter .
2638 .It Va static_arp_pairs
2639 .Pq Vt str
2640 Set to the list of static ARP pairs that are to be added at system
2641 boot time.
2642 For each whitespace separated
2643 .Ar element
2644 in the value, a
2645 .Va static_arp_ Ns Aq Ar element
2646 variable is assumed to exist whose contents will later be passed to a
2647 .Dq Nm arp Cm -S
2648 operation.
2649 For example
2650 .Bd -literal
2651 static_arp_pairs="gw"
2652 static_arp_gw="192.168.1.1 00:01:02:03:04:05"
2653 .Ed
2654 .It Va static_ndp_pairs
2655 .Pq Vt str
2656 Set to the list of static NDP pairs that are to be added at system
2657 boot time.
2658 For each whitespace separated
2659 .Ar element
2660 in the value, a
2661 .Va static_ndp_ Ns Aq Ar element
2662 variable is assumed to exist whose contents will later be passed to a
2663 .Dq Nm ndp Cm -s
2664 operation.
2665 For example
2666 .Bd -literal
2667 static_ndp_pairs="gw"
2668 static_ndp_gw="2001:db8:3::1 00:01:02:03:04:05"
2669 .Ed
2670 .It Va static_routes
2671 .Pq Vt str
2672 Set to the list of static routes that are to be added at system
2673 boot time.
2674 If not set to
2675 .Dq Li NO
2676 then for each whitespace separated
2677 .Ar element
2678 in the value, a
2679 .Va route_ Ns Aq Ar element
2680 variable is assumed to exist
2681 whose contents will later be passed to a
2682 .Dq Nm route Cm add
2683 operation.
2684 For example:
2685 .Bd -literal
2686 static_routes="mcast gif0local"
2687 route_mcast="-net 224.0.0.0/4 -iface gif0"
2688 route_gif0local="-host 169.254.1.1 -iface lo0"
2689 .Ed
2690 .It Va ipv6_static_routes
2691 .Pq Vt str
2692 The IPv6 equivalent of
2693 .Va static_routes .
2694 If not set to
2695 .Dq Li NO
2696 then for each whitespace separated
2697 .Ar element
2698 in the value, a
2699 .Va ipv6_route_ Ns Aq Ar element
2700 variable is assumed to exist
2701 whose contents will later be passed to a
2702 .Dq Nm route Cm add Fl inet6
2703 operation.
2704 .It Va natm_static_routes
2705 .Pq Vt str
2706 The
2707 .Xr natmip 4
2708 equivalent of
2709 .Va static_routes .
2710 If not empty then for each whitespace separated
2711 .Ar element
2712 in the value, a
2713 .Va route_ Ns Aq Ar element
2714 variable is assumed to exist whose contents will later be passed to a
2715 .Dq Nm atmconfig Cm natm Cm add
2716 operation.
2717 .It Va gateway_enable
2718 .Pq Vt bool
2719 If set to
2720 .Dq Li YES ,
2721 configure host to act as an IP router, e.g.\& to forward packets
2722 between interfaces.
2723 .It Va ipv6_gateway_enable
2724 .Pq Vt bool
2725 The IPv6 equivalent of
2726 .Va gateway_enable .
2727 .It Va routed_enable
2728 .Pq Vt bool
2729 If set to
2730 .Dq Li YES ,
2731 run a routing daemon of some sort, based on the
2732 settings of
2733 .Va routed_program
2734 and
2735 .Va routed_flags .
2736 .It Va route6d_enable
2737 .Pq Vt bool
2738 The IPv6 equivalent of
2739 .Va routed_enable .
2740 If set to
2741 .Dq Li YES ,
2742 run a routing daemon of some sort, based on the
2743 settings of
2744 .Va route6d_program
2745 and
2746 .Va route6d_flags .
2747 .It Va routed_program
2748 .Pq Vt str
2749 If
2750 .Va routed_enable
2751 is set to
2752 .Dq Li YES ,
2753 this is the name of the routing daemon to use.
2754 .It Va route6d_program
2755 .Pq Vt str
2756 The IPv6 equivalent of
2757 .Va routed_program .
2758 .It Va routed_flags
2759 .Pq Vt str
2760 If
2761 .Va routed_enable
2762 is set to
2763 .Dq Li YES ,
2764 these are the flags to pass to the routing daemon.
2765 .It Va route6d_flags
2766 .Pq Vt str
2767 The IPv6 equivalent of
2768 .Va routed_flags .
2769 .It Va mrouted_enable
2770 .Pq Vt bool
2771 If set to
2772 .Dq Li YES ,
2773 run the multicast routing daemon,
2774 .Xr mrouted 8 .
2775 .It Va mroute6d_enable
2776 .Pq Vt bool
2777 The IPv6 equivalent of
2778 .Va mrouted_enable .
2779 If set to
2780 .Dq Li YES ,
2781 run the IPv6 multicast routing daemon.
2782 .Pp
2783 Note that multicast routing daemons are no longer included in the
2784 .Fx
2785 base system, however, both
2786 .Xr mrouted 8
2787 and
2788 .Xr pim6dd 8
2789 may be installed from the
2790 .Fx
2791 Ports Collection.
2792 .It Va mrouted_flags
2793 .Pq Vt str
2794 If
2795 .Va mrouted_enable
2796 is set to
2797 .Dq Li YES ,
2798 these are the flags to pass to the
2799 .Xr mrouted 8
2800 daemon.
2801 .It Va mroute6d_flags
2802 .Pq Vt str
2803 The IPv6 equivalent of
2804 .Va mrouted_flags .
2805 If
2806 .Va mroute6d_enable
2807 is set to
2808 .Dq Li YES ,
2809 these are the flags passed to the IPv6 multicast routing daemon.
2810 .It Va mroute6d_program
2811 .Pq Vt str
2812 If
2813 .Va mroute6d_enable
2814 is set to
2815 .Dq Li YES ,
2816 this is the path to the IPv6 multicast routing daemon.
2817 .It Va rtadvd_enable
2818 .Pq Vt bool
2819 If set to
2820 .Dq Li YES ,
2821 run the
2822 .Xr rtadvd 8
2823 daemon at boot time.
2824 The
2825 .Xr rtadvd 8
2826 utility sends ICMPv6 Router Advertisement messages to
2827 the interfaces specified in
2828 .Va rtadvd_interfaces .
2829 This should only be enabled with great care.
2830 You may want to fine-tune
2831 .Xr rtadvd.conf 5 .
2832 .It Va rtadvd_interfaces
2833 .Pq Vt str
2834 If
2835 .Va rtadvd_enable
2836 is set to
2837 .Dq Li YES
2838 this is the list of interfaces to use.
2839 .It Va ipxgateway_enable
2840 .Pq Vt bool
2841 If set to
2842 .Dq Li YES ,
2843 enable the routing of IPX traffic.
2844 .It Va ipxrouted_enable
2845 .Pq Vt bool
2846 If set to
2847 .Dq Li YES ,
2848 run the
2849 .Xr IPXrouted 8
2850 daemon at system boot time.
2851 .It Va ipxrouted_flags
2852 .Pq Vt str
2853 If
2854 .Va ipxrouted_enable
2855 is set to
2856 .Dq Li YES ,
2857 these are the flags to pass to the
2858 .Xr IPXrouted 8
2859 daemon.
2860 .It Va arpproxy_all
2861 .Pq Vt bool
2862 If set to
2863 .Dq Li YES ,
2864 enable global proxy ARP.
2865 .It Va forward_sourceroute
2866 .Pq Vt bool
2867 If set to
2868 .Dq Li YES
2869 and
2870 .Va gateway_enable
2871 is also set to
2872 .Dq Li YES ,
2873 source-routed packets are forwarded.
2874 .It Va accept_sourceroute
2875 .Pq Vt bool
2876 If set to
2877 .Dq Li YES ,
2878 the system will accept source-routed packets directed at it.
2879 .It Va rarpd_enable
2880 .Pq Vt bool
2881 If set to
2882 .Dq Li YES ,
2883 run the
2884 .Xr rarpd 8
2885 daemon at system boot time.
2886 .It Va rarpd_flags
2887 .Pq Vt str
2888 If
2889 .Va rarpd_enable
2890 is set to
2891 .Dq Li YES ,
2892 these are the flags to pass to the
2893 .Xr rarpd 8
2894 daemon.
2895 .It Va bootparamd_enable
2896 .Pq Vt bool
2897 If set to
2898 .Dq Li YES ,
2899 run the
2900 .Xr bootparamd 8
2901 daemon at system boot time.
2902 .It Va bootparamd_flags
2903 .Pq Vt str
2904 If
2905 .Va bootparamd_enable
2906 is set to
2907 .Dq Li YES ,
2908 these are the flags to pass to the
2909 .Xr bootparamd 8
2910 daemon.
2911 .It Va stf_interface_ipv4addr
2912 .Pq Vt str
2913 If not set to
2914 .Dq Li NO ,
2915 this is the local IPv4 address for 6to4 (IPv6 over IPv4 tunneling
2916 interface).
2917 Specify this entry to enable the 6to4 interface.
2918 .It Va stf_interface_ipv4plen
2919 .Pq Vt int
2920 Prefix length for 6to4 IPv4 addresses, to limit peer address range.
2921 An effective value is 0-31.
2922 .It Va stf_interface_ipv6_ifid
2923 .Pq Vt str
2924 IPv6 interface ID for
2925 .Xr stf 4 .
2926 This can be set to
2927 .Dq Li AUTO .
2928 .It Va stf_interface_ipv6_slaid
2929 .Pq Vt str
2930 IPv6 Site Level Aggregator for
2931 .Xr stf 4 .
2932 .It Va ipv6_faith_prefix
2933 .Pq Vt str
2934 If not set to
2935 .Dq Li NO ,
2936 this is the faith prefix to enable a FAITH IPv6-to-IPv4 TCP
2937 translator.
2938 You also need
2939 .Xr faithd 8
2940 setup.
2941 .It Va ipv6_ipv4mapping
2942 .Pq Vt bool
2943 If set to
2944 .Dq Li YES
2945 this enables IPv4 mapped IPv6 address communication (like
2946 .Li ::ffff:a.b.c.d ) .
2947 .It Va rtsold_enable
2948 .Pq Vt bool
2949 Set to
2950 .Dq Li YES
2951 to enable the
2952 .Xr rtsold 8
2953 daemon to send ICMPv6 Router Solicitation messages.
2954 .It Va rtsold_flags
2955 .Pq Vt str
2956 If
2957 .Va rtsold_enable
2958 is set to
2959 .Dq Li YES ,
2960 these are the flags to pass to
2961 .Xr rtsold 8 .
2962 .It Va rtsol_flags
2963 .Pq Vt str
2964 For interfaces configured with the
2965 .Dq Li inet6 accept_rtadv
2966 keyword, these are the flags to pass to
2967 .Xr rtsol 8 .
2968 .Pp
2969 Note that
2970 .Va rtsold_enable
2971 is mutually exclusive to
2972 .Va rtsol_flags ;
2973 .Va rtsold_enable
2974 takes precedence.
2975 .It Va atm_enable
2976 .Pq Vt bool
2977 Set to
2978 .Dq Li YES
2979 to enable the configuration of ATM interfaces at system boot time.
2980 For all of the ATM variables described below, please refer to the
2981 .Xr atm 8
2982 manual page for further details on the available command parameters.
2983 Also refer to the files in
2984 .Pa /usr/share/examples/atm
2985 for more detailed configuration information.
2986 .It Va atm_load
2987 .Pq Vt str
2988 This is a list of physical ATM interface drivers to load.
2989 Typical values are
2990 .Dq Li hfa_pci
2991 and/or
2992 .Dq Li hea_pci .
2993 .It Va atm_netif_ Ns Aq Ar intf
2994 .Pq Vt str
2995 For the ATM physical interface
2996 .Ar intf ,
2997 this variable defines the name prefix and count for the ATM network
2998 interfaces to be created.
2999 The value will be passed as the parameters of an
3000 .Dq Nm atm Cm "set netif" Ar intf
3001 command.
3002 .It Va atm_sigmgr_ Ns Aq Ar intf
3003 .Pq Vt str
3004 For the ATM physical interface
3005 .Ar intf ,
3006 this variable defines the ATM signalling manager to be used.
3007 The value will be passed as the parameters of an
3008 .Dq Nm atm Cm attach Ar intf
3009 command.
3010 .It Va atm_prefix_ Ns Aq Ar intf
3011 .Pq Vt str
3012 For the ATM physical interface
3013 .Ar intf ,
3014 this variable defines the NSAP prefix for interfaces using a UNI signalling
3015 manager.
3016 If set to
3017 .Dq Li ILMI ,
3018 the prefix will automatically be set via the
3019 .Xr ilmid 8
3020 daemon.
3021 Otherwise, the value will be passed as the parameters of an
3022 .Dq Nm atm Cm "set prefix" Ar intf
3023 command.
3024 .It Va atm_macaddr_ Ns Aq Ar intf
3025 .Pq Vt str
3026 For the ATM physical interface
3027 .Ar intf ,
3028 this variable defines the MAC address for interfaces using a UNI signalling
3029 manager.
3030 If set to
3031 .Dq Li NO ,
3032 the hardware MAC address contained in the ATM interface card will be used.
3033 Otherwise, the value will be passed as the parameters of an
3034 .Dq Nm atm Cm "set mac" Ar intf
3035 command.
3036 .It Va atm_arpserver_ Ns Aq Ar netif
3037 .Pq Vt str
3038 For the ATM network interface
3039 .Ar netif ,
3040 this variable defines the ATM address for a host which is to provide ATMARP
3041 service.
3042 This variable is only applicable to interfaces using a UNI signalling
3043 manager.
3044 If set to
3045 .Dq Li local ,
3046 this host will become an ATMARP server.
3047 The value will be passed as the parameters of an
3048 .Dq Nm atm Cm "set arpserver" Ar netif
3049 command.
3050 .It Va atm_scsparp_ Ns Aq Ar netif
3051 .Pq Vt bool
3052 If set to
3053 .Dq Li YES ,
3054 SCSP/ATMARP service for the network interface
3055 .Ar netif
3056 will be initiated using the
3057 .Xr scspd 8
3058 and
3059 .Xr atmarpd 8
3060 daemons.
3061 This variable is only applicable if
3062 .Va atm_arpserver_ Ns Aq Ar netif
3063 is set to
3064 .Dq Li local .
3065 .It Va atm_pvcs
3066 .Pq Vt str
3067 Set to the list of ATM PVCs to be added at system
3068 boot time.
3069 For each whitespace separated
3070 .Ar element
3071 in the value, an
3072 .Va atm_pvc_ Ns Aq Ar element
3073 variable is assumed to exist.
3074 The value of each of these variables
3075 will be passed as the parameters of an
3076 .Dq Nm atm Cm "add pvc"
3077 command.
3078 .It Va atm_arps
3079 .Pq Vt str
3080 Set to the list of permanent ATM ARP entries to be added
3081 at system boot time.
3082 For each whitespace separated
3083 .Ar element
3084 in the value, an
3085 .Va atm_arp_ Ns Aq Ar element
3086 variable is assumed to exist.
3087 The value of each of these variables
3088 will be passed as the parameters of an
3089 .Dq Nm atm Cm "add arp"
3090 command.
3091 .It Va natm_interfaces
3092 .Pq Vt str
3093 Set to the list of
3094 .Xr natm 4
3095 interfaces that will also be used for HARP through
3096 .Xr harp 4 .
3097 If this list is not empty all interfaces in the list will be brought up
3098 with
3099 .Xr ifconfig 8
3100 and
3101 .Xr harp 4
3102 will be loaded.
3103 For this to work the interface drivers must be either compiled into the
3104 kernel or must reside on the root partition.
3105 .It Va keybell
3106 .Pq Vt str
3107 The keyboard bell sound.
3108 Set to
3109 .Dq Li normal ,
3110 .Dq Li visual ,
3111 .Dq Li off ,
3112 or
3113 .Dq Li NO
3114 if the default behavior is desired.
3115 For details, refer to the
3116 .Xr kbdcontrol 1
3117 manpage.
3118 .It Va keyboard
3119 .Pq Vt str
3120 If set to a non-null string, the virtual console's keyboard input is
3121 set to this device.
3122 .It Va keymap
3123 .Pq Vt str
3124 If set to
3125 .Dq Li NO ,
3126 no keymap is installed, otherwise the value is used to install
3127 the keymap file in
3128 .Pa /usr/share/syscons/keymaps/ Ns Ao Ar value Ac Ns Pa .kbd .
3129 .It Va keyrate
3130 .Pq Vt str
3131 The keyboard repeat speed.
3132 Set to
3133 .Dq Li slow ,
3134 .Dq Li normal ,
3135 .Dq Li fast ,
3136 or
3137 .Dq Li NO
3138 if the default behavior is desired.
3139 .It Va keychange
3140 .Pq Vt str
3141 If not set to
3142 .Dq Li NO ,
3143 attempt to program the function keys with the value.
3144 The value should
3145 be a single string of the form:
3146 .Dq Ar funkey_number new_value Op Ar funkey_number new_value ... .
3147 .It Va cursor
3148 .Pq Vt str
3149 Can be set to the value of
3150 .Dq Li normal ,
3151 .Dq Li blink ,
3152 .Dq Li destructive ,
3153 or
3154 .Dq Li NO
3155 to set the cursor behavior explicitly or choose the default behavior.
3156 .It Va scrnmap
3157 .Pq Vt str
3158 If set to
3159 .Dq Li NO ,
3160 no screen map is installed, otherwise the value is used to install
3161 the screen map file in
3162 .Pa /usr/share/syscons/scrnmaps/ Ns Aq Ar value .
3163 .It Va font8x16
3164 .Pq Vt str
3165 If set to
3166 .Dq Li NO ,
3167 the default 8x16 font value is used for screen size requests, otherwise
3168 the value in
3169 .Pa /usr/share/syscons/fonts/ Ns Aq Ar value
3170 is used.
3171 .It Va font8x14
3172 .Pq Vt str
3173 If set to
3174 .Dq Li NO ,
3175 the default 8x14 font value is used for screen size requests, otherwise
3176 the value in
3177 .Pa /usr/share/syscons/fonts/ Ns Aq Ar value
3178 is used.
3179 .It Va font8x8
3180 .Pq Vt str
3181 If set to
3182 .Dq Li NO ,
3183 the default 8x8 font value is used for screen size requests, otherwise
3184 the value in
3185 .Pa /usr/share/syscons/fonts/ Ns Aq Ar value
3186 is used.
3187 .It Va blanktime
3188 .Pq Vt int
3189 If set to
3190 .Dq Li NO ,
3191 the default screen blanking interval is used, otherwise it is set
3192 to
3193 .Ar value
3194 seconds.
3195 .It Va saver
3196 .Pq Vt str
3197 If not set to
3198 .Dq Li NO ,
3199 this is the actual screen saver to use
3200 .Li ( blank , snake , daemon ,
3201 etc).
3202 .It Va moused_nondefault_enable
3203 .Pq Vt str
3204 If set to
3205 .Dq Li NO ,
3206 the mouse device specified on
3207 the command line is not automatically treated as enabled by the
3208 .Pa /etc/rc.d/moused
3209 script.
3210 Having this variable set to
3211 .Dq Li YES
3212 allows a
3213 .Xr usb 4
3214 mouse,
3215 for example,
3216 to be enabled as soon as it is plugged in.
3217 .It Va moused_enable
3218 .Pq Vt str
3219 If set to
3220 .Dq Li YES ,
3221 the
3222 .Xr moused 8
3223 daemon is started for doing cut/paste selection on the console.
3224 .It Va moused_type
3225 .Pq Vt str
3226 This is the protocol type of the mouse connected to this host.
3227 This variable must be set if
3228 .Va moused_enable
3229 is set to
3230 .Dq Li YES .
3231 The
3232 .Xr moused 8
3233 daemon
3234 is able to detect the appropriate mouse type automatically in many cases.
3235 Set this variable to
3236 .Dq Li auto
3237 to let the daemon detect it, or
3238 select one from the following list if the automatic detection fails.
3239 .Pp
3240 If the mouse is attached to the PS/2 mouse port, choose
3241 .Dq Li auto
3242 or
3243 .Dq Li ps/2 ,
3244 regardless of the brand and model of the mouse.
3245 Likewise, if the
3246 mouse is attached to the bus mouse port, choose
3247 .Dq Li auto
3248 or
3249 .Dq Li busmouse .
3250 All other protocols are for serial mice and will not work with
3251 the PS/2 and bus mice.
3252 If this is a USB mouse,
3253 .Dq Li auto
3254 is the only protocol type which will work.
3255 .Pp
3256 .Bl -tag -width ".Li x10mouseremote" -compact
3257 .It Li microsoft
3258 Microsoft mouse (serial)
3259 .It Li intellimouse
3260 Microsoft IntelliMouse (serial)
3261 .It Li mousesystems
3262 Mouse systems Corp.\& mouse (serial)
3263 .It Li mmseries
3264 MM Series mouse (serial)
3265 .It Li logitech
3266 Logitech mouse (serial)
3267 .It Li busmouse
3268 A bus mouse
3269 .It Li mouseman
3270 Logitech MouseMan and TrackMan (serial)
3271 .It Li glidepoint
3272 ALPS GlidePoint (serial)
3273 .It Li thinkingmouse
3274 Kensington ThinkingMouse (serial)
3275 .It Li ps/2
3276 PS/2 mouse
3277 .It Li mmhittab
3278 MM HitTablet (serial)
3279 .It Li x10mouseremote
3280 X10 MouseRemote (serial)
3281 .It Li versapad
3282 Interlink VersaPad (serial)
3283 .El
3284 .Pp
3285 Even if the mouse is not in the above list, it may be compatible
3286 with one in the list.
3287 Refer to the manual page for
3288 .Xr moused 8
3289 for compatibility information.
3290 .Pp
3291 It should also be noted that while this is enabled, any
3292 other client of the mouse (such as an X server) should access
3293 the mouse through the virtual mouse device,
3294 .Pa /dev/sysmouse ,
3295 and configure it as a
3296 .Dq Li sysmouse
3297 type mouse, since all
3298 mouse data is converted to this single canonical format when
3299 using
3300 .Xr moused 8 .
3301 If the client program does not support the
3302 .Dq Li sysmouse
3303 type,
3304 specify the
3305 .Dq Li mousesystems
3306 type.
3307 It is the second preferred type.
3308 .It Va moused_port
3309 .Pq Vt str
3310 If
3311 .Va moused_enable
3312 is set to
3313 .Dq Li YES ,
3314 this is the actual port the mouse is on.
3315 It might be
3316 .Pa /dev/cuad0
3317 for a COM1 serial mouse,
3318 .Pa /dev/psm0
3319 for a PS/2 mouse or
3320 .Pa /dev/mse0
3321 for a bus mouse, for example.
3322 .It Va moused_flags
3323 .Pq Vt str
3324 If
3325 .Va moused_flags
3326 is set, its value is used as an additional set of flags to pass to the
3327 .Xr moused 8
3328 daemon.
3329 .It Va "moused_" Ns Ar XXX Ns Va "_flags"
3330 When
3331 .Va moused_nondefault_enable
3332 is enabled, and a
3333 .Xr moused 8
3334 daemon is started for a non-default port, the
3335 .Va "moused_" Ns Ar XXX Ns Va "_flags"
3336 set of options has precedence over and replaces the default
3337 .Va moused_flags
3338 (where
3339 .Ar XXX
3340 is the name of the non-default port, i.e.,\&
3341 .Ar ums0 ) .
3342 By setting
3343 .Va "moused_" Ns Ar XXX Ns Va "_flags"
3344 it is possible to set up a different set of default flags for each
3345 .Xr moused 8
3346 instance.
3347 For example, you can use
3348 .Dq Li "-3"
3349 for the default
3350 .Va moused_flags
3351 to make your laptop's touchpad more comfortable to use,
3352 but an empty set of options for
3353 .Va moused_ums0_flags
3354 when your
3355 .Xr usb 4
3356 mouse has three or more buttons.
3357 .It Va mousechar_start
3358 .Pq Vt int
3359 If set to
3360 .Dq Li NO ,
3361 the default mouse cursor character range
3362 .Li 0xd0 Ns - Ns Li 0xd3
3363 is used,
3364 otherwise the range start is set
3365 to
3366 .Ar value
3367 character, see
3368 .Xr vidcontrol 1 .
3369 Use if the default range is occupied in the language code table.
3370 .It Va allscreens_flags
3371 .Pq Vt str
3372 If set,
3373 .Xr vidcontrol 1
3374 is run with these options for each of the virtual terminals
3375 .Pq Pa /dev/ttyv* .
3376 For example,
3377 .Dq Fl m Cm on
3378 will enable the mouse pointer on all virtual terminals
3379 if
3380 .Va moused_enable
3381 is set to
3382 .Dq Li YES .
3383 .It Va allscreens_kbdflags
3384 .Pq Vt str
3385 If set,
3386 .Xr kbdcontrol 1
3387 is run with these options for each of the virtual terminals
3388 .Pq Pa /dev/ttyv* .
3389 For example,
3390 .Dq Fl h Li 200
3391 will set the
3392 .Xr syscons 4
3393 scrollback (history) buffer to 200 lines.
3394 .It Va cron_enable
3395 .Pq Vt bool
3396 If set to
3397 .Dq Li YES ,
3398 run the
3399 .Xr cron 8
3400 daemon at system boot time.
3401 .It Va cron_program
3402 .Pq Vt str
3403 Path to
3404 .Xr cron 8
3405 (default
3406 .Pa /usr/sbin/cron ) .
3407 .It Va cron_flags
3408 .Pq Vt str
3409 If
3410 .Va cron_enable
3411 is set to
3412 .Dq Li YES ,
3413 these are the flags to pass to
3414 .Xr cron 8 .
3415 .It Va cron_dst
3416 .Pq Vt bool
3417 If set to
3418 .Dq Li YES ,
3419 enable the special handling of transitions to and from the
3420 Daylight Saving Time in
3421 .Xr cron 8
3422 (equivalent to using the flag
3423 .Fl s ) .
3424 .It Va lpd_program
3425 .Pq Vt str
3426 Path to
3427 .Xr lpd 8
3428 (default
3429 .Pa /usr/sbin/lpd ) .
3430 .It Va lpd_enable
3431 .Pq Vt bool
3432 If set to
3433 .Dq Li YES ,
3434 run the
3435 .Xr lpd 8
3436 daemon at system boot time.
3437 .It Va lpd_flags
3438 .Pq Vt str
3439 If
3440 .Va lpd_enable
3441 is set to
3442 .Dq Li YES ,
3443 these are the flags to pass to the
3444 .Xr lpd 8
3445 daemon.
3446 .It Va chkprintcap_enable
3447 .Pq Vt bool
3448 If set to
3449 .Dq Li YES ,
3450 run the
3451 .Xr chkprintcap 8
3452 command before starting the
3453 .Xr lpd 8
3454 daemon.
3455 .It Va chkprintcap_flags
3456 .Pq Vt str
3457 If
3458 .Va lpd_enable
3459 and
3460 .Va chkprintcap_enable
3461 are set to
3462 .Dq Li YES ,
3463 these are the flags to pass to the
3464 .Xr chkprintcap 8
3465 program.
3466 The default is
3467 .Dq Li -d ,
3468 which causes missing directories to be created.
3469 .It Va mta_start_script
3470 .Pq Vt str
3471 This variable specifies the full path to the script to run to start
3472 a mail transfer agent.
3473 The default is
3474 .Pa /etc/rc.sendmail .
3475 The
3476 .Va sendmail_*
3477 variables which
3478 .Pa /etc/rc.sendmail
3479 uses are documented in the
3480 .Xr rc.sendmail 8
3481 manual page.
3482 .It Va dumpdev
3483 .Pq Vt str
3484 Indicates the device (usually a swap partition) to which a crash dump
3485 should be written in the event of a system crash.
3486 If the value of this variable is
3487 .Dq Li AUTO ,
3488 the first suitable swap device listed in
3489 .Pa /etc/fstab
3490 will be used as dump device.
3491 Otherwise, the value of this variable is passed as the argument to
3492 .Xr dumpon 8 .
3493 To disable crash dumps, set this variable to
3494 .Dq Li NO .
3495 .It Va dumpdir
3496 .Pq Vt str
3497 When the system reboots after a crash and a crash dump is found on the
3498 device specified by the
3499 .Va dumpdev
3500 variable,
3501 .Xr savecore 8
3502 will save that crash dump and a copy of the kernel to the directory
3503 specified by the
3504 .Va dumpdir
3505 variable.
3506 The default value is
3507 .Pa /var/crash .
3508 Set to
3509 .Dq Li NO
3510 to not run
3511 .Xr savecore 8
3512 at boot time when
3513 .Va dumpdir
3514 is set.
3515 .It Va savecore_flags
3516 .Pq Vt str
3517 If crash dumps are enabled, these are the flags to pass to the
3518 .Xr savecore 8
3519 utility.
3520 .It Va quota_enable
3521 .Pq Vt bool
3522 Set to
3523 .Dq Li YES
3524 to turn on user and group disk quotas on system startup via the
3525 .Xr quotaon 8
3526 command for all file systems marked as having quotas enabled in
3527 .Pa /etc/fstab .
3528 The kernel must be built with
3529 .Cd "options QUOTA"
3530 for disk quotas to function.
3531 .It Va check_quotas
3532 .Pq Vt bool
3533 Set to
3534 .Dq Li YES
3535 to enable user and group disk quota checking via the
3536 .Xr quotacheck 8
3537 command.
3538 .It Va quotacheck_flags
3539 .Pq Vt str
3540 If
3541 .Va quota_enable
3542 is set to
3543 .Dq Li YES ,
3544 and
3545 .Va check_quotas
3546 is set to
3547 .Dq Li YES ,
3548 these are the flags to pass to the
3549 .Xr quotacheck 8
3550 utility.
3551 The default is
3552 .Dq Li "-a" ,
3553 which checks quotas for all file systems with quotas enabled in
3554 .Pa /etc/fstab .
3555 .It Va quotaon_flags
3556 .Pq Vt str
3557 If
3558 .Va quota_enable
3559 is set to
3560 .Dq Li YES ,
3561 these are the flags to pass to the
3562 .Xr quotaon 8
3563 utility.
3564 The default is
3565 .Dq Li "-a" ,
3566 which enables quotas for all file systems with quotas enabled in
3567 .Pa /etc/fstab .
3568 .It Va quotaoff_flags
3569 .Pq Vt str
3570 If
3571 .Va quota_enable
3572 is set to
3573 .Dq Li YES ,
3574 these are the flags to pass to the
3575 .Xr quotaoff 8
3576 utility when shutting down the quota system.
3577 The default is
3578 .Dq Li "-a" ,
3579 which disables quotas for all file systems with quotas enabled in
3580 .Pa /etc/fstab .
3581 .It Va accounting_enable
3582 .Pq Vt bool
3583 Set to
3584 .Dq Li YES
3585 to enable system accounting through the
3586 .Xr accton 8
3587 facility.
3588 .It Va ibcs2_enable
3589 .Pq Vt bool
3590 Set to
3591 .Dq Li YES
3592 to enable iBCS2 (SCO) binary emulation at system initial boot
3593 time.
3594 .It Va ibcs2_loaders
3595 .Pq Vt str
3596 If not set to
3597 .Dq Li NO
3598 and if
3599 .Va ibcs2_enable
3600 is set to
3601 .Dq Li YES ,
3602 this specifies a list of additional iBCS2 loaders to enable.
3603 .It Va linux_enable
3604 .Pq Vt bool
3605 Set to
3606 .Dq Li YES
3607 to enable Linux/ELF binary emulation at system initial
3608 boot time.
3609 .It Va svr4_enable
3610 .Pq Vt bool
3611 If set to
3612 .Dq Li YES ,
3613 enable SysVR4 emulation at boot time.
3614 .It Va sysvipc_enable
3615 .Pq Vt bool
3616 If set to
3617 .Dq Li YES ,
3618 load System V IPC primitives at boot time.
3619 .It Va clear_tmp_enable
3620 .Pq Vt bool
3621 Set to
3622 .Dq Li YES
3623 to have
3624 .Pa /tmp
3625 cleaned at startup.
3626 .It Va clear_tmp_X
3627 .Pq Vt bool
3628 Set to
3629 .Dq Li NO
3630 to disable removing of X11 lock files,
3631 and the removal and (secure) recreation
3632 of the various socket directories for X11
3633 related programs.
3634 .It Va ldconfig_paths
3635 .Pq Vt str
3636 Set to the list of shared library paths to use with
3637 .Xr ldconfig 8 .
3638 NOTE:
3639 .Pa /usr/lib
3640 will always be added first, so it need not appear in this list.
3641 .It Va ldconfig32_paths
3642 .Pq Vt str
3643 Set to the list of 32-bit compatibility shared library paths to
3644 use with
3645 .Xr ldconfig 8 .
3646 .It Va ldconfig_paths_aout
3647 .Pq Vt str
3648 Set to the list of shared library paths to use with
3649 .Xr ldconfig 8
3650 legacy
3651 .Xr a.out 5
3652 support.
3653 .It Va ldconfig_insecure
3654 .Pq Vt bool
3655 The
3656 .Xr ldconfig 8
3657 utility normally refuses to use directories
3658 which are writable by anyone except root.
3659 Set this variable to
3660 .Dq Li YES
3661 to disable that security check during system startup.
3662 .It Va ldconfig_local_dirs
3663 .Pq Vt str
3664 Set to the list of local
3665 .Xr ldconfig 8
3666 directories.
3667 The names of all files in the directories listed will be
3668 passed as arguments to
3669 .Xr ldconfig 8 .
3670 .It Va ldconfig_local32_dirs
3671 .Pq Vt str
3672 Set to the list of local 32-bit compatibility
3673 .Xr ldconfig 8
3674 directories.
3675 The names of all files in the directories listed will be
3676 passed as arguments to
3677 .Dq Nm ldconfig Fl 32 .
3678 .It Va kern_securelevel_enable
3679 .Pq Vt bool
3680 Set to
3681 .Dq Li YES
3682 to set the kernel security level at system startup.
3683 .It Va kern_securelevel
3684 .Pq Vt int
3685 The kernel security level to set at startup.
3686 The allowed range of
3687 .Ar value
3688 ranges from \-1 (the compile time default) to 3 (the
3689 most secure).
3690 See
3691 .Xr security 7
3692 for the list of possible security levels and their effect
3693 on system operation.
3694 .It Va sshd_program
3695 .Pq Vt str
3696 Path to the SSH server program
3697 .Pa ( /usr/sbin/sshd
3698 is the default).
3699 .It Va sshd_enable
3700 .Pq Vt bool
3701 Set to
3702 .Dq Li YES
3703 to start
3704 .Xr sshd 8
3705 at system boot time.
3706 .It Va sshd_flags
3707 .Pq Vt str
3708 If
3709 .Va sshd_enable
3710 is set to
3711 .Dq Li YES ,
3712 these are the flags to pass to the
3713 .Xr sshd 8
3714 daemon.
3715 .It Va ftpd_program
3716 .Pq Vt str
3717 Path to the FTP server program
3718 .Pa ( /usr/libexec/ftpd
3719 is the default).
3720 .It Va ftpd_enable
3721 .Pq Vt bool
3722 Set to
3723 .Dq Li YES
3724 to start
3725 .Xr ftpd 8
3726 as a stand-alone daemon at system boot time.
3727 .It Va ftpd_flags
3728 .Pq Vt str
3729 If
3730 .Va ftpd_enable
3731 is set to
3732 .Dq Li YES ,
3733 these are the additional flags to pass to the
3734 .Xr ftpd 8
3735 daemon.
3736 .It Va watchdogd_enable
3737 .Pq Vt bool
3738 If set to
3739 .Dq Li YES ,
3740 start the
3741 .Xr watchdogd 8
3742 daemon at boot time.
3743 This requires that the kernel have been compiled with a
3744 .Xr watchdog 4
3745 compatible device.
3746 .It Va watchdogd_flags
3747 .Pq Vt str
3748 If
3749 .Va watchdogd_enable
3750 is set to
3751 .Dq Li YES ,
3752 these are the flags passed to the
3753 .Xr watchdogd 8
3754 daemon.
3755 .It Va devfs_rulesets
3756 .Pq Vt str
3757 List of files containing sets of rules for
3758 .Xr devfs 8 .
3759 .It Va devfs_system_ruleset
3760 .Pq Vt str
3761 Rule name(s) to apply to the system
3762 .Pa /dev
3763 itself.
3764 .It Va devfs_set_rulesets
3765 .Pq Vt str
3766 Pairs of already-mounted
3767 .Pa dev
3768 directories and rulesets that should be applied to them.
3769 For example: /mount/dev=ruleset_name
3770 .It Va devfs_load_rulesets
3771 .Pq Vt bool
3772 If set, always load the default rulesets listed in
3773 .Va devfs_rulesets .
3774 .It Va performance_cx_lowest
3775 .Pq Vt str
3776 CPU idle state to use while on AC power.
3777 The string
3778 .Dq Li LOW
3779 indicates that
3780 .Xr acpi 4
3781 should use the lowest power state available while
3782 .Dq Li HIGH
3783 indicates that the lowest latency state (less power savings) should be used.
3784 .It Va performance_cpu_freq
3785 .Pq Vt str
3786 CPU clock frequency to use while on AC power.
3787 The string
3788 .Dq Li LOW
3789 indicates that
3790 .Xr cpufreq 4
3791 should use the lowest frequency available while
3792 .Dq Li HIGH
3793 indicates that the highest frequency (less power savings) should be used.
3794 .It Va economy_cx_lowest
3795 .Pq Vt str
3796 CPU idle state to use when off AC power.
3797 The string
3798 .Dq Li LOW
3799 indicates that
3800 .Xr acpi 4
3801 should use the lowest power state available while
3802 .Dq Li HIGH
3803 indicates that the lowest latency state (less power savings) should be used.
3804 .It Va economy_cpu_freq
3805 .Pq Vt str
3806 CPU clock frequency to use when off AC power.
3807 The string
3808 .Dq Li LOW
3809 indicates that
3810 .Xr cpufreq 4
3811 should use the lowest frequency available while
3812 .Dq Li HIGH
3813 indicates that the highest frequency (less power savings) should be used.
3814 .It Va jail_enable
3815 .Pq Vt bool
3816 If set to
3817 .Dq Li NO ,
3818 any configured jails will not be started.
3819 .It jail_parallel_start
3820 .Pq Vt bool
3821 If set to
3822 .Dq Li YES
3823 all configured jails will be started in the background (= in parallel).
3824 .It Va jail_list
3825 .Pq Vt str
3826 A space separated list of names for jails.
3827 This is purely a configuration aid to help identify and
3828 configure multiple jails.
3829 The names specified in this list will be used to
3830 identify settings common to an instance of a jail,
3831 and should contain alphanumeric characters only.
3832 Assuming that the jail in question was named
3833 .Li vjail ,
3834 you would have the following dependent variables:
3835 .Bd -literal
3836 jail_vjail_hostname="jail.example.com"
3837 jail_vjail_ip="192.0.2.100"
3838 jail_vjail_rootdir="/var/jails/vjail/root"
3839 .Ed
3840 .Pp
3841 .It Va jail_flags
3842 .Pq Vt str
3843 Unset by default.
3844 When set, use as default value for
3845 .Va jail_ Ns Ao Ar jname Ac Ns Va _flags
3846 for every jail in
3847 .Va jail_list .
3848 .It Va jail_interface
3849 .Pq Vt str
3850 Unset by default.
3851 When set, use as default value for
3852 .Va jail_ Ns Ao Ar jname Ac Ns Va _interface
3853 for every jail in
3854 .Va jail_list .
3855 .It Va jail_fstab
3856 .Pq Vt str
3857 Unset by default.
3858 When set, use as default value for
3859 .Va jail_ Ns Ao Ar jname Ac Ns Va _fstab
3860 for every jail in
3861 .Va jail_list .
3862 .It Va jail_mount_enable
3863 .Pq Vt bool
3864 Set to
3865 .Dq Li NO
3866 by default.
3867 When set to
3868 .Dq Li YES ,
3869 sets
3870 .Va jail_ Ns Ao Ar jname Ac Ns Va _mount_enable
3871 to
3872 .Dq Li YES
3873 by default for every jail in
3874 .Va jail_list .
3875 .It Va jail_devfs_ruleset
3876 .Pq Vt str
3877 Unset by default.
3878 When set, sets
3879 .Va jail_ Ns Ao Ar jname Ac Ns Va _devfs_ruleset
3880 to given value for every jail in
3881 .Va jail_list .
3882 .It Va jail_devfs_enable
3883 .Pq Vt bool
3884 Set to
3885 .Dq Li NO
3886 by default.
3887 When set to
3888 .Dq Li YES ,
3889 sets
3890 .Va jail_ Ns Ao Ar jname Ac Ns Va _devfs_enable
3891 to
3892 .Dq Li YES
3893 by default for every jail in
3894 .Va jail_list .
3895 .It Va jail_fdescfs_enable
3896 .Pq Vt bool
3897 Set to
3898 .Dq Li NO
3899 by default.
3900 When set to
3901 .Dq Li YES ,
3902 sets
3903 .Va jail_ Ns Ao Ar jname Ac Ns Va _fdescfs_enable
3904 to
3905 .Dq Li YES
3906 by default for every jail in
3907 .Va jail_list .
3908 .It Va jail_procfs_enable
3909 .Pq Vt bool
3910 Set to
3911 .Dq Li NO
3912 by default.
3913 When set to
3914 .Dq Li YES ,
3915 sets
3916 .Va jail_ Ns Ao Ar jname Ac Ns Va _fdescfs_enable
3917 to
3918 .Dq Li YES
3919 by default for every jail in
3920 .Va jail_list .
3921 .It Va jail_exec_prestart Ns Aq Ar N
3922 .Pq Vt str
3923 Unset by default.
3924 When set, use as default value for
3925 .Va jail_ Ns Ao Ar jname Ac Ns Va _exec_prestart Ns Aq Ar N
3926 for every jail in
3927 .Va jail_list .
3928 .It Va jail_exec_start
3929 .Pq Vt str
3930 Unset by default.
3931 When set, use as default value for
3932 .Va jail_ Ns Ao Ar jname Ac Ns Va _exec_start
3933 for every jail in
3934 .Va jail_list .
3935 .It Va jail_exec_afterstart Ns Aq Ar N
3936 .Pq Vt str
3937 Unset by default.
3938 When set, use as default value for
3939 .Va jail_ Ns Ao Ar jname Ac Ns Va _exec_afterstart Ns Aq Ar N
3940 for every jail in
3941 .Va jail_list .
3942 .It Va jail_exec_poststart Ns Aq Ar N
3943 .Pq Vt str
3944 Unset by default.
3945 When set, use as default value for
3946 .Va jail_ Ns Ao Ar jname Ac Ns Va _exec_poststart Ns Aq Ar N
3947 for every jail in
3948 .Va jail_list .
3949 .It Va jail_exec_prestop Ns Aq Ar N
3950 .Pq Vt str
3951 Unset by default.
3952 When set, use as default value for
3953 .Va jail_ Ns Ao Ar jname Ac Ns Va _exec_prestop Ns Aq Ar N
3954 for every jail in
3955 .Va jail_list .
3956 .It Va jail_exec_stop
3957 Unset by default.
3958 When set, use as default value for
3959 .Va jail_ Ns Ao Ar jname Ac Ns Va _exec_stop
3960 for every jail in
3961 .Va jail_list .
3962 .It Va jail_exec_poststop Ns Aq Ar N
3963 .Pq Vt str
3964 Unset by default.
3965 When set, use as default value for
3966 .Va jail_ Ns Ao Ar jname Ac Ns Va _exec_poststop Ns Aq Ar N
3967 for every jail in
3968 .Va jail_list .
3969 .It Va jail_ Ns Ao Ar jname Ac Ns Va _rootdir
3970 .Pq Vt str
3971 Unset by default.
3972 Set to the root directory used by jail
3973 .Va jname .
3974 .It Va jail_ Ns Ao Ar jname Ac Ns Va _hostname
3975 .Pq Vt str
3976 Unset by default.
3977 Set to the fully qualified domain name (FQDN) assigned to jail
3978 .Va jname .
3979 .It Va jail_ Ns Ao Ar jname Ac Ns Va _parameters
3980 .Pq Vt str
3981 Unset by default.
3982 Set extra parameters for jail
3983 .Va jname ,
3984 such as 
3985 .Dq Li allow.chflags
3986 or
3987 .Dq Li children.max .
3988 See
3989 .Xr jail 8
3990 for a list of available parameters.
3991 Note that the following parameters are already defined by
3992 .Pa rc.d/jail
3993 script out of their corresponding
3994 .Nm
3995 variables:
3996 .Bl  -tag -width "host.hostname" -offset indent
3997 .It Li path
3998 set from 
3999 .Va jail_ Ns Ao Ar jname Ac Ns Va _rootdir
4000 .It Li host.hostname
4001 set from
4002 .Va jail_ Ns Ao Ar jname Ac Ns Va _hostname
4003 .It Li command
4004 set from
4005 .Va jail_ Ns Ao Ar jname Ac Ns Va _exec_start
4006 .It Li ip4.addr
4007 set if
4008 .Va jail_ Ns Ao Ar jname Ac Ns Va _ip
4009 contains IPv4 addresses
4010 .It Li ip6.addr
4011 set if
4012 .Va jail_ Ns Ao Ar jname Ac Ns Va _ip6
4013 contains IPv6 addresses
4014 .El
4015 .It Va jail_ Ns Ao Ar jname Ac Ns Va _ip
4016 .Pq Vt str
4017 Unset by default.
4018 Set to the (primary) IPv4 and/or IPv6 address(es) assigned to the jail.
4019 The argument can be a sole address or a comma separated list of addresses.
4020 Additionally each address can be prefixed by the name of an interface
4021 followed by a pipe to overwrite
4022 .Va jail_ Ns Ao Ar jname Ac Ns Va _interface
4023 or
4024 .Va jail_interface
4025 and/or suffixed by a netmask, prefixlen or prefix.
4026 In case no netmask, prefixlen or prefix is given,
4027 .Sq /32
4028 will be used for IPv4 and
4029 .Sq /128
4030 will be used for an IPv6 address.
4031 If no address is given for the jail then the jail will be started with
4032 no networking support.
4033 .It Va jail_ Ns Ao Ar jname Ac Ns Va _ip_multi Ns Aq Ar n
4034 .Pq Vt str
4035 Unset by default.
4036 Set additional IPv4 and/or IPv6 address(es) assigned to the jail.
4037 The sequence starts with
4038 .Dq Li _multi0
4039 and the numbers have to be strictly ascending.
4040 These entries follow the same syntax as their primary
4041 .Va jail_ Ns Ao Ar jname Ac Ns Va _ip
4042 entry.
4043 The order of the entries can be important as the first address for
4044 each address family found will be the primary address of the jail.
4045 See
4046 .Va ip-addresses
4047 option in
4048 .Xr jail 8
4049 for more details.
4050 .It Va jail_ Ns Ao Ar jname Ac Ns Va _flags
4051 .Pq Vt str
4052 Set to
4053 .Dq Li -l -U root
4054 by default.
4055 These are flags to pass to
4056 .Xr jail 8 .
4057 .It Va jail_ Ns Ao Ar jname Ac Ns Va _interface
4058 .Pq Vt str
4059 Unset by default.
4060 When set, sets the interface to use when setting IP address alias.
4061 Note that the alias is created at jail startup and removed at jail shutdown.
4062 .It Va jail_ Ns Ao Ar jname Ac Ns Va _fib
4063 .Pq Vt str
4064 Unset by default.
4065 When set, the jail is started with the specified forwarding table (sometimes
4066 referred to as a routing table) via
4067 .Xr setfib 1 .
4068 .It Va jail_ Ns Ao Ar jname Ac Ns Va _fstab
4069 .Pq Vt str
4070 Set to
4071 .Pa /etc/fstab. Ns Aq Ar jname
4072 by default.
4073 This is the file system information file to use for jail
4074 .Va jname .
4075 .It Va jail_ Ns Ao Ar jname Ac Ns Va _mount_enable
4076 .Pq Vt bool
4077 Set to
4078 .Dq Li NO
4079 by default.
4080 When set to
4081 .Dq Li YES ,
4082 mount all file systems from
4083 .Va jail_ Ns Ao Ar jname Ac Ns Va _fstab
4084 at jail startup.
4085 .It Va jail_ Ns Ao Ar jname Ac Ns Va _devfs_ruleset
4086 .Pq Vt str
4087 Unset by default.
4088 When set, defines the device file system ruleset file to use for jail
4089 .Va jname .
4090 .It Va jail_ Ns Ao Ar jname Ac Ns Va _devfs_enable
4091 .Pq Vt bool
4092 Set to
4093 .Dq Li NO
4094 by default.
4095 When set to
4096 .Dq Li YES ,
4097 mount the device file system inside jail
4098 .Ar jname
4099 at jail startup.
4100 .It Va jail_ Ns Ao Ar jname Ac Ns Va _fdescfs_enable
4101 .Pq Vt bool
4102 Set to
4103 .Dq Li NO
4104 by default.
4105 When set to
4106 .Dq Li YES ,
4107 mount the file-descriptor file system inside jail
4108 .Ar jname
4109 at jail startup.
4110 .It Va jail_ Ns Ao Ar jname Ac Ns Va _procfs_enable
4111 .Pq Vt bool
4112 Set to
4113 .Dq Li NO
4114 by default.
4115 When set to
4116 .Dq Li YES ,
4117 mount the process file system inside jail
4118 .Ar jname
4119 at jail startup.
4120 .It Va jail_ Ns Ao Ar jname Ac Ns Va _exec_prestart Ns Aq Ar N
4121 .Pq Vt str
4122 Unset by default.
4123 This is the command run as
4124 .Ar N Ns
4125 th command
4126 before jail startup, where
4127 .Ar N
4128 is 0, 1, and so on.
4129 It is run outside the jail.
4130 .It Va jail_ Ns Ao Ar jname Ac Ns Va _exec_start
4131 .Pq Vt str
4132 Set to
4133 .Dq Li /bin/sh /etc/rc
4134 by default.
4135 This is the command executed in a jail at jail startup.
4136 .It Va jail_ Ns Ao Ar jname Ac Ns Va _exec_afterstart Ns Aq Ar N
4137 .Pq Vt str
4138 Unset by default.
4139 This is the command run as
4140 .Ar N Ns
4141 th command
4142 in a jail
4143 after jail startup, where
4144 .Ar N
4145 is 1, 2, and so on.
4146 .It Va jail_ Ns Ao Ar jname Ac Ns Va _exec_poststart Ns Aq Ar N
4147 .Pq Vt str
4148 Unset by default.
4149 This is the command run as
4150 .Ar N Ns
4151 th command
4152 after jail startup, where
4153 .Ar N
4154 is 0, 1, and so on.
4155 It is run outside the jail.
4156 .It Va jail_ Ns Ao Ar jname Ac Ns Va _exec_prestop Ns Aq Ar N
4157 .Pq Vt str
4158 Unset by default.
4159 This is the command run as
4160 .Ar N Ns
4161 th command
4162 before jail shutdown, where
4163 .Ar N
4164 is 0, 1, and so on.
4165 It is run outside the jail.
4166 .It Va jail_ Ns Ao Ar jname Ac Ns Va _exec_stop
4167 .Pq Vt str
4168 Set to
4169 .Dq Li /bin/sh /etc/rc.shutdown
4170 by default.
4171 This is the command executed in a jail at jail shutdown.
4172 .It Va jail_ Ns Ao Ar jname Ac Ns Va _exec_poststop Ns Aq Ar N
4173 .Pq Vt str
4174 Unset by default.
4175 This is the command run as
4176 .Ar N Ns
4177 th command
4178 after jail shutdown, where
4179 .Ar N
4180 is 0, 1, and so on.
4181 It is run outside the jail.
4182 .It Va jail_set_hostname_allow
4183 .Pq Vt bool
4184 If set to
4185 .Dq Li NO ,
4186 do not allow the root user in a jail to set its hostname.
4187 .It Va jail_socket_unixiproute_only
4188 .Pq Vt bool
4189 If set to
4190 .Dq Li YES ,
4191 do not allow any sockets,
4192 besides UNIX/IP/route sockets,
4193 to be used within a jail.
4194 .It Va jail_sysvipc_allow
4195 .Pq Vt bool
4196 If set to
4197 .Dq Li YES ,
4198 allow applications within a jail to use System V IPC.
4199 .\" -----------------------------------------------------
4200 .It Va harvest_interrupt
4201 .Pq Vt bool
4202 Set to
4203 .Dq Li YES
4204 to use hardware interrupts as an entropy source.
4205 Refer to
4206 .Xr random 4
4207 for more information.
4208 .It Va harvest_ethernet
4209 .Pq Vt bool
4210 Set to
4211 .Dq Li YES
4212 to use LAN traffic as an entropy source.
4213 Refer to
4214 .Xr random 4
4215 for more information.
4216 .It Va harvest_p_to_p
4217 .Pq Vt bool
4218 Set to
4219 .Dq Li YES
4220 to use serial line traffic as an entropy source.
4221 Refer to
4222 .Xr random 4
4223 for more information.
4224 .It Va entropy_dir
4225 .Pq Vt str
4226 Set to
4227 .Dq Li NO
4228 to disable caching entropy via
4229 .Xr cron 8 .
4230 Otherwise set to the directory used to store entropy files in.
4231 .It Va entropy_file
4232 .Pq Vt str
4233 Set to
4234 .Dq Li NO
4235 to disable caching entropy through reboots.
4236 Otherwise set to the filename used to store cached entropy through
4237 reboots.
4238 This file should be located on the root file system to seed the
4239 .Xr random 4
4240 device as early as possible in the boot process.
4241 .It Va entropy_save_sz
4242 .Pq Vt int
4243 Size of the entropy cache files saved by
4244 .Nm save-entropy
4245 periodically.
4246 .It Va entropy_save_num
4247 .Pq Vt int
4248 Number of entropy cache files to save by
4249 .Nm save-entropy
4250 periodically.
4251 .It Va ipsec_enable
4252 .Pq Vt bool
4253 Set to
4254 .Dq Li YES
4255 to run
4256 .Xr setkey 8
4257 on
4258 .Va ipsec_file
4259 at boot time.
4260 .It Va ipsec_file
4261 .Pq Vt str
4262 Configuration file for
4263 .Xr setkey 8 .
4264 .It Va dmesg_enable
4265 .Pq Vt bool
4266 Set to
4267 .Dq Li YES
4268 to save
4269 .Xr dmesg 8
4270 to
4271 .Pa /var/run/dmesg.boot
4272 on boot.
4273 .It Va rcshutdown_timeout
4274 .Pq Vt int
4275 If set, start a watchdog timer in the background which will terminate
4276 .Pa rc.shutdown
4277 if
4278 .Xr shutdown 8
4279 has not completed within the specified time (in seconds).
4280 Notice that in addition to this soft timeout,
4281 .Xr init 8
4282 also applies a hard timeout for the execution of
4283 .Pa rc.shutdown .
4284 This is configured via
4285 .Xr sysctl 8
4286 variable
4287 .Va kern.init_shutdown_timeout
4288 and defaults to 120 seconds.
4289 Setting the value of
4290 .Va rcshutdown_timeout
4291 to more than 120 seconds will have no effect until the
4292 .Xr sysctl 8
4293 variable
4294 .Va kern.init_shutdown_timeout
4295 is also increased.
4296 .It Va virecover_enable
4297 .Pq Vt bool
4298 Set to
4299 .Dq Li NO
4300 to prevent the system from trying to
4301 recover pre-maturely terminated
4302 .Xr vi 1
4303 sessions.
4304 .It Va ugidfw_enable
4305 .Pq Vt bool
4306 Set to
4307 .Dq Li YES
4308 to load the
4309 .Xr mac_bsdextended 4
4310 module upon system initialization and load a default
4311 ruleset file.
4312 .It Va bsdextended_script
4313 .Pq Vt str
4314 The default
4315 .Xr mac_bsdextended 4
4316 ruleset file to load.
4317 The default value of this variable is
4318 .Pa /etc/rc.bsdextended .
4319 .It Va newsyslog_enable
4320 .Pq Vt bool
4321 If set to
4322 .Dq Li YES ,
4323 run
4324 .Xr newsyslog 8
4325 command at startup.
4326 .It Va newsyslog_flags
4327 .Pq Vt str
4328 If
4329 .Va newsyslog_enable
4330 is set to
4331 .Dq Li YES ,
4332 these are the flags to pass to the
4333 .Xr newsyslog 8
4334 program.
4335 The default is
4336 .Dq Li -CN ,
4337 which causes log files flagged with a
4338 .Cm C
4339 to be created.
4340 .It Va mdconfig_md Ns Aq Ar X
4341 .Pq Vt str
4342 Arguments to
4343 .Xr mdconfig 8
4344 for
4345 .Xr md 4
4346 device
4347 .Ar X .
4348 At minimum a
4349 .Fl t Ar type
4350 must be specified and either a
4351 .Fl s Ar size
4352 for malloc or swap backed
4353 .Xr md 4
4354 devices or a
4355 .Fl f Ar file
4356 for vnode backed
4357 .Xr md 4
4358 devices.
4359 Note that
4360 .Va mdconfig_md Ns Aq Ar X
4361 variables are evaluated until one variable is unset or null.
4362 .It Va mdconfig_md Ns Ao Ar X Ac Ns Va _newfs
4363 .Pq Vt str
4364 Optional arguments passed to
4365 .Xr newfs 8
4366 to initialize
4367 .Xr md 4
4368 device
4369 .Ar X .
4370 .It Va mdconfig_md Ns Ao Ar X Ac Ns Va _owner
4371 .Pq Vt str
4372 An ownership specification passed to
4373 .Xr chown 8
4374 after the specified
4375 .Xr md 4
4376 device
4377 .Ar X
4378 has been mounted.
4379 Both the
4380 .Xr md 4
4381 device and the mount point will be changed.
4382 .It Va mdconfig_md Ns Ao Ar X Ac Ns Va _perms
4383 .Pq Vt str
4384 A mode string passed to
4385 .Xr chmod 1
4386 after the specified
4387 .Xr md 4
4388 device
4389 .Ar X
4390 has been mounted.
4391 Both the
4392 .Xr md 4
4393 device and the mount point will be changed.
4394 .It Va mdconfig_md Ns Ao Ar X Ac Ns Va _files
4395 .Pq Vt str
4396 Files to be copied to the mount point of the
4397 .Xr md 4
4398 device
4399 .Ar X
4400 after it has been mounted.
4401 .It Va mdconfig_md Ns Ao Ar X Ac Ns Va _cmd
4402 .Pq Vt str
4403 Command to execute after the specified
4404 .Xr md 4
4405 device
4406 .Ar X
4407 has been mounted.
4408 Note that the command is passed to
4409 .Ic eval
4410 and that both
4411 .Va _dev
4412 and
4413 .Va _mp
4414 variables can be used to reference respectively the
4415 .Xr md 4
4416 device and the mount point.
4417 Assuming that the
4418 .Xr md 4
4419 device is
4420 .Li md0 ,
4421 one could set the following:
4422 .Bd -literal
4423 mdconfig_md0_cmd="tar xfzC /var/file.tgz \e${_mp}"
4424 .Ed
4425 .It Va autobridge_interfaces
4426 .Pq Vt str
4427 Set to the list of bridge interfaces that will have newly arriving interfaces
4428 checked against to be automatically added.
4429 If not set to
4430 .Dq Li NO
4431 then for each whitespace separated
4432 .Ar element
4433 in the value, a
4434 .Va autobridge_ Ns Aq Ar element
4435 variable is assumed to exist which has a whitespace separated list of interface
4436 names to match, these names can use wildcards.
4437 For example:
4438 .Bd -literal
4439 autobridge_interfaces="bridge0"
4440 autobridge_bridge0="tap* dc0 vlan[345]"
4441 .Ed
4442 .It Va mixer_enable
4443 .Pq Vt bool
4444 If set to
4445 .Dq Li YES ,
4446 enable support for sound mixer.
4447 .It Va hcsecd_enable
4448 .Pq Vt bool
4449 If set to
4450 .Dq Li YES ,
4451 enable Bluetooth security daemon.
4452 .It Va hcsecd_config
4453 .Pq Vt str
4454 Configuration file for
4455 .Xr hcsecd 8 .
4456 Default
4457 .Pa /etc/bluetooth/hcsecd.conf .
4458 .It Va sdpd_enable
4459 .Pq Vt bool
4460 If set to
4461 .Dq Li YES ,
4462 enable Bluetooth Service Discovery Protocol daemon.
4463 .It Va sdpd_control
4464 .Pq Vt str
4465 Path to
4466 .Xr sdpd 8
4467 control socket.
4468 Default
4469 .Pa /var/run/sdp .
4470 .It Va sdpd_groupname
4471 .Pq Vt str
4472 Sets
4473 .Xr sdpd 8
4474 group to run as after it initializes.
4475 Default
4476 .Dq Li nobody .
4477 .It Va sdpd_username
4478 .Pq Vt str
4479 Sets
4480 .Xr sdpd 8
4481 user to run as after it initializes.
4482 Default
4483 .Dq Li nobody .
4484 .It Va bthidd_enable
4485 .Pq Vt bool
4486 If set to
4487 .Dq Li YES ,
4488 enable Bluetooth Human Interface Device daemon.
4489 .It Va bthidd_config
4490 .Pq Vt str
4491 Configuration file for
4492 .Xr bthidd 8 .
4493 Default
4494 .Pa /etc/bluetooth/bthidd.conf .
4495 .It Va bthidd_hids
4496 .Pq Vt str
4497 Path to a file, where
4498 .Xr bthidd 8
4499 will store information about known HID devices.
4500 Default
4501 .Pa /var/db/bthidd.hids .
4502 .It Va rfcomm_pppd_server_enable
4503 .Pq Vt bool
4504 If set to
4505 .Dq Li YES ,
4506 enable Bluetooth RFCOMM PPP wrapper daemon.
4507 .It Va rfcomm_pppd_server_profile
4508 .Pq Vt str
4509 The name of the profile to use from
4510 .Pa /etc/ppp/ppp.conf .
4511 Multiple profiles can be specified here.
4512 Also used to specify per-profile overrides.
4513 When the profile name contains any of the characters
4514 .Dq Li .-/+
4515 they are translated to
4516 .Dq Li _
4517 for the proposes of the override variable names.
4518 .It Va rfcomm_pppd_server_ Ns Ao Ar profile Ac Ns _bdaddr
4519 .Pq Vt str
4520 Overrides local address to listen on.
4521 By default
4522 .Xr rfcomm_pppd 8
4523 will listen on
4524 .Dq Li ANY
4525 address.
4526 The address can be specified as BD_ADDR or name.
4527 .It Va rfcomm_pppd_server_ Ns Ao Ar profile Ac Ns _channel
4528 .Pq Vt str
4529 Overrides local RFCOMM channel to listen on.
4530 By default
4531 .Xr rfcomm_pppd 8
4532 will listen on RFCOMM channel 1.
4533 Must set properly if multiple profiles used in the same time.
4534 .It Va rfcomm_pppd_server_ Ns Ao Ar profile Ac Ns _register_sp
4535 .Pq Vt bool
4536 Tells
4537 .Xr rfcomm_pppd 8
4538 if it should register Serial Port service on the specified RFCOMM channel.
4539 Default
4540 .Dq Li NO .
4541 .It Va rfcomm_pppd_server_ Ns Ao Ar profile Ac Ns _register_dun
4542 .Pq Vt bool
4543 Tells
4544 .Xr rfcomm_pppd 8
4545 if it should register Dial-Up Networking service on the specified
4546 RFCOMM channel.
4547 Default
4548 .Dq Li NO .
4549 .It Va ubthidhci_enable
4550 .Pq Vt bool
4551 If set to
4552 .Dq Li YES ,
4553 change the USB Bluetooth controller from HID mode to HCI mode.
4554 You also need to specify the location of USB Bluetooth controller with the
4555 .Va ubthidhci_busnum
4556 and
4557 .Va ubthidhci_addr
4558 variables.
4559 .It Va ubthidhci_busnum
4560 Bus number where the USB Bluetooth controller is located.
4561 Check the output of
4562 .Xr usbconfig 8
4563 on your system to find this information.
4564 .It Va ubthidhci_addr
4565 Bus address of the USB Bluetooth controller.
4566 Check the output of
4567 .Xr usbconfig 8
4568 on your system to find this information.
4569 .It Va netwait_enable
4570 .Pq Vt bool
4571 If set to
4572 .Dq Li YES ,
4573 delays the start of network-reliant services until
4574 .Va netwait_if
4575 is up and ICMP packets to a destination defined in
4576 .Va netwait_ip
4577 are flowing.
4578 Link state is examined first, followed by
4579 .Dq Li pinging
4580 an IP address to verify network usability.
4581 If no destination can be reached or timeouts are exceeded,
4582 network services are started anyway with no guarantee that
4583 the network is usable.
4584 Use of this variable requires both
4585 .Va netwait_ip
4586 and
4587 .Va netwait_if
4588 to be set.
4589 .It Va netwait_ip
4590 .Pq Vt str
4591 Empty by default.
4592 This variable contains a space-delimited list of IP addresses to
4593 .Xr ping 8 .
4594 DNS hostnames should not be used as resolution is not guaranteed
4595 to be functional at this point.
4596 If multiple IP addresses are specified,
4597 each will be tried until one is successful or the list is exhausted.
4598 .It Va netwait_timeout
4599 .Pq Vt int
4600 Indicates the total number of seconds to perform a
4601 .Dq Li ping
4602 against each IP address in
4603 .Va netwait_ip ,
4604 at a rate of one ping per second.
4605 If any of the pings are successful,
4606 full network connectivity is considered reliable.
4607 The default is 60.
4608 .It Va netwait_if
4609 .Pq Vt str
4610 Empty by default.
4611 Defines the name of the network interface on which watch for link.
4612 .Xr ifconfig 8
4613 is used to monitor the interface, looking for
4614 .Dq Li status: no carrier .
4615 Once gone, the link is considered up.
4616 This can be a
4617 .Xr vlan 4
4618 interface if desired.
4619 .It Va netwait_if_timeout
4620 .Pq Vt int
4621 Defines the total number of seconds to wait for link to become usable,
4622 polled at a 1-second interval.
4623 The default is 30.
4624 .El
4625 .Sh FILES
4626 .Bl -tag -width ".Pa /etc/defaults/rc.conf" -compact
4627 .It Pa /etc/defaults/rc.conf
4628 .It Pa /etc/rc.conf
4629 .It Pa /etc/rc.conf.local
4630 .El
4631 .Sh SEE ALSO
4632 .Xr catman 1 ,
4633 .Xr chmod 1 ,
4634 .Xr gdb 1 ,
4635 .Xr info 1 ,
4636 .Xr kbdcontrol 1 ,
4637 .Xr makewhatis 1 ,
4638 .Xr sh 1 ,
4639 .Xr vi 1 ,
4640 .Xr vidcontrol 1 ,
4641 .Xr bridge 4 ,
4642 .Xr dummynet 4 ,
4643 .Xr ip 4 ,
4644 .Xr ipf 4 ,
4645 .Xr ipfw 4 ,
4646 .Xr ipnat 4 ,
4647 .Xr kld 4 ,
4648 .Xr pf 4 ,
4649 .Xr pflog 4 ,
4650 .Xr pfsync 4 ,
4651 .Xr tcp 4 ,
4652 .Xr udp 4 ,
4653 .Xr exports 5 ,
4654 .Xr fstab 5 ,
4655 .Xr ipf 5 ,
4656 .Xr ipnat 5 ,
4657 .Xr motd 5 ,
4658 .Xr newsyslog.conf 5 ,
4659 .Xr pf.conf 5 ,
4660 .Xr security 7 ,
4661 .Xr accton 8 ,
4662 .Xr amd 8 ,
4663 .Xr apm 8 ,
4664 .Xr atm 8 ,
4665 .Xr bthidd 8 ,
4666 .Xr chkprintcap 8 ,
4667 .Xr chown 8 ,
4668 .Xr cron 8 ,
4669 .Xr devfs 8 ,
4670 .Xr dhclient 8 ,
4671 .Xr ftpd 8 ,
4672 .Xr geli 8 ,
4673 .Xr hcsecd 8 ,
4674 .Xr ifconfig 8 ,
4675 .Xr inetd 8 ,
4676 .Xr ipf 8 ,
4677 .Xr ipfw 8 ,
4678 .Xr ipnat 8 ,
4679 .Xr jail 8 ,
4680 .Xr kldxref 8 ,
4681 .Xr lpd 8 ,
4682 .Xr mdconfig 8 ,
4683 .Xr mdmfs 8 ,
4684 .Xr mixer 8 ,
4685 .Xr mountd 8 ,
4686 .Xr moused 8 ,
4687 .Xr mrouted 8 ,
4688 .Xr named 8 ,
4689 .Xr newfs 8 ,
4690 .Xr newsyslog 8 ,
4691 .Xr nfsd 8 ,
4692 .Xr ntpd 8 ,
4693 .Xr ntpdate 8 ,
4694 .Xr pfctl 8 ,
4695 .Xr pflogd 8 ,
4696 .Xr ping 8 ,
4697 .Xr powerd 8 ,
4698 .Xr quotacheck 8 ,
4699 .Xr quotaon 8 ,
4700 .Xr rc 8 ,
4701 .Xr rc.sendmail 8 ,
4702 .Xr rfcomm_pppd 8 ,
4703 .Xr route 8 ,
4704 .Xr routed 8 ,
4705 .Xr rpcbind 8 ,
4706 .Xr rpc.lockd 8 ,
4707 .Xr rpc.statd 8 ,
4708 .Xr rwhod 8 ,
4709 .Xr savecore 8 ,
4710 .Xr sdpd 8 ,
4711 .Xr sshd 8 ,
4712 .Xr swapon 8 ,
4713 .Xr sysctl 8 ,
4714 .Xr syslogd 8 ,
4715 .Xr timed 8 ,
4716 .Xr usbconfig 8 ,
4717 .Xr wlandebug 8 ,
4718 .Xr yp 8 ,
4719 .Xr ypbind 8 ,
4720 .Xr ypserv 8 ,
4721 .Xr ypset 8
4722 .Sh HISTORY
4723 The
4724 .Nm
4725 file appeared in
4726 .Fx 2.2.2 .
4727 .Sh AUTHORS
4728 .An Jordan K. Hubbard .