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