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