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