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