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