share/man/man5/rc.conf.5

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