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