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