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.9 2005/02/17 22:44:39 liamfoy 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 1
 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 1
 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_enable
 142 .Pq Vt bool
 143 If set to
 144 .Dq Li YES ,
 145 enable PCCARD support at boot time.
 146 .It Va pccard_mem
 147 .Pq Vt str
 148 Set to PCCARD controller memory address or
 149 .Dq Li DEFAULT
 150 for the default value.
 151 .It Va pccard_ifconfig
 152 .Pq Vt str
 153 List of arguments to be passed to
 154 .Xr ifconfig 8
 155 at boot time or on
 156 insertion of the card (e.g.\&
 157 .Dq Cm inet Li 192.168.1.1 Cm netmask Li 255.255.255.0
 158 for a fixed address or
 159 .Dq Li DHCP
 160 for a DHCP client).
 161 .It Va pccard_beep
 162 .Pq Vt int
 163 If 0,
 164 set the PCCARD controller to silent mode.
 165 If 1,
 166 set it to beep mode.
 167 If 2,
 168 set it to melody mode.
 169 .It Va pccard_conf
 170 .Pq Vt str
 171 Path to the configuration file for the
 172 .Xr pccardd 8
 173 daemon (e.g.\&
 174 .Pa /etc/pccard.conf.sample ) .
 175 .It Va pccardd_flags
 176 .Pq Vt str
 177 If
 178 .Va pccard_enable
 179 is set to
 180 .Dq Li YES ,
 181 these are the flags to pass to the
 182 .Xr pccardd 8
 183 daemon.
 184 .It Va pccard_ether_delay
 185 .Pq Vt str
 186 Set the delay before starting
 187 .Xr dhclient 8
 188 in the
 189 .Pa /etc/pccard_ether
 190 script.
 191 This defaults to 5 seconds to work around a bug in the
 192 .Xr ed 4
 193 driver which can lead to system hangs when using some newer
 194 .Xr ed 4
 195 based cards.
 196 .It Va removable_interfaces
 197 .Pq Vt str
 198 List of removable network interfaces to be supported by
 199 .Pa /etc/pccard_ether .
 200 .It Va local_startup
 201 .Pq Vt str
 202 List of directories to search for startup script files.
 203 .It Va script_name_sep
 204 .Pq Vt str
 205 The field separator to use for breaking down the list of startup script files
 206 into individual filenames.
 207 The default is a space.
 208 It is not necessary to change this unless there are startup scripts with names
 209 containing spaces.
 210 .It Va hostname
 211 .Pq Vt str
 212 The fully qualified domain name (FQDN) of this host on the network.
 213 This should almost certainly be set to something meaningful, even if
 214 there is no network connection.
 215 If
 216 .Xr dhclient 8
 217 is used to set the hostname via DHCP,
 218 this variable should be set to an empty string.
 219 .It Va ipv6_enable
 220 .Pq Vt bool
 221 Enable support for IPv6 networking.
 222 Note that this requires that the kernel have been compiled with
 223 .Cd "options INET6" .
 224 .It Va nisdomainname
 225 .Pq Vt str
 226 The NIS domain name of this host, or
 227 .Dq Li NO
 228 if NIS is not used.
 229 .It Va dhclient_program
 230 .Pq Vt str
 231 Path to the DHCP client program
 232 .Pa ( /sbin/dhclient ,
 233 the ISC DHCP client,
 234 is the default).
 235 .It Va dhclient_flags
 236 .Pq Vt str
 237 Additional flags to pass to the DHCP client program.
 238 For the ISC DHCP client, see the
 239 .Xr dhclient 8
 240 manpage for a description of the command line options available.
 241 .It Va background_dhclient
 242 .Pq Vt bool
 243 Set to
 244 .Dq Li YES
 245 to start the dhcp client in background.
 246 This can cause trouble with applications depending on
 247 a working network, but it will provide a faster startup
 248 in many cases.
 249 .It Va firewall_enable
 250 .Pq Vt bool
 251 Set to
 252 .Dq Li YES
 253 to load firewall rules at startup.
 254 If the kernel was not built with
 255 .Cd "options IPFIREWALL" ,
 256 the
 257 .Pa ipfw.ko
 258 kernel module will be loaded.
 259 See also
 260 .Va ipfilter_enable .
 261 .It Va ipv6_firewall_enable
 262 .Pq Vt bool
 263 The IPv6 equivalent of
 264 .Va firewall_enable .
 265 Set to
 266 .Dq Li YES
 267 to load IPv6 firewall rules at startup.
 268 If the kernel was not built with
 269 .Cd "options IPV6FIREWALL" ,
 270 the
 271 .Pa ip6fw.ko
 272 kernel module will be loaded.
 273 .It Va firewall_script
 274 .Pq Vt str
 275 This variable specifies the full path to the firewall script to run.
 276 The default is
 277 .Pa /etc/rc.firewall .
 278 .It Va ipv6_firewall_script
 279 .Pq Vt str
 280 The IPv6 equivalent of
 281 .Va firewall_script .
 282 .It Va firewall_type
 283 .Pq Vt str
 284 Names the firewall type from the selection in
 285 .Pa /etc/rc.firewall ,
 286 or the file which contains the local firewall ruleset.
 287 Valid selections from
 288 .Pa /etc/rc.firewall
 289 are:
 290 .Pp
 291 .Bl -tag -width ".Li simple" -compact
 292 .It Li open
 293 unrestricted IP access
 294 .It Li closed
 295 all IP services disabled, except via
 296 .Dq Li lo0
 297 .It Li client
 298 basic protection for a workstation
 299 .It Li simple
 300 basic protection for a LAN.
 301 .El
 302 .Pp
 303 If a filename is specified, the full path
 304 must be given.
 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 1
 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 1
 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 1
 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 1
 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 1
 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 .Xr named.conf 5 .
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
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
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
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_access_cache
1162 .Pq Vt int
1163 If
1164 .Va nfs_client_enable
1165 is set to
1166 .Dq Li YES ,
1167 this can be set to
1168 .Dq Li 0
1169 to disable NFS ACCESS RPC caching, or to the number of seconds for which
1170 NFS ACCESS
1171 results should be cached.
1172 A value of 2-10 seconds will substantially reduce network
1173 traffic for many NFS operations.
1174 .It Va nfs_server_enable
1175 .Pq Vt bool
1176 If set to
1177 .Dq Li YES ,
1178 run the NFS server daemons at boot time.
1179 .It Va nfs_server_flags
1180 .Pq Vt str
1181 If
1182 .Va nfs_server_enable
1183 is set to
1184 .Dq Li YES ,
1185 these are the flags to pass to the
1186 .Xr nfsd 8
1187 daemon.
1188 .It Va mountd_enable
1189 .Pq Vt bool
1190 If set to
1191 .Dq Li YES ,
1192 and no
1193 .Va nfs_server_enable
1194 is set, start
1195 .Xr mountd 8 ,
1196 but not
1197 .Xr nfsd 8
1198 daemon.
1199 It is commonly needed to run CFS without real NFS used.
1200 .It Va mountd_flags
1201 .Pq Vt str
1202 If
1203 .Va mountd_enable
1204 is set to
1205 .Dq Li YES ,
1206 these are the flags to pass to the
1207 .Xr mountd 8
1208 daemon.
1209 .It Va weak_mountd_authentication
1210 .Pq Vt bool
1211 If set to
1212 .Dq Li YES ,
1213 allow services like PCNFSD to make non-privileged mount
1214 requests.
1215 .It Va nfs_reserved_port_only
1216 .Pq Vt bool
1217 If set to
1218 .Dq Li YES ,
1219 provide NFS services only on a secure port.
1220 .It Va nfs_bufpackets
1221 .Pq Vt int
1222 If set to a number, indicates the number of packets worth of
1223 socket buffer space to reserve on an NFS client.
1224 The kernel default is typically 4.
1225 Using a higher number may be
1226 useful on gigabit networks to improve performance.
1227 The minimum value is
1228 2 and the maximum is 64.
1229 .It Va rpc_umntall_enable
1230 .Pq Vt bool
1231 If set to
1232 .Dq Li YES
1233 (default) and we are also an NFS client, run
1234 .Xr rpc.umntall 8
1235 at boot time to clear out old mounts on remote servers.
1236 If set to
1237 .Dq Li NO
1238 then
1239 .Xr rpc.umntall 8
1240 will not be run at boot time.
1241 .It Va rpc_lockd_enable
1242 .Pq Vt bool
1243 If set to
1244 .Dq Li YES
1245 and also an NFS server, run
1246 .Xr rpc.lockd 8
1247 at boot time.
1248 .It Va rpc_statd_enable
1249 .Pq Vt bool
1250 If set to
1251 .Dq Li YES
1252 and also an NFS server, run
1253 .Xr rpc.statd 8
1254 at boot time.
1255 .It Va rpcbind_program
1256 .Pq Vt str
1257 Path to
1258 .Xr rpcbind 8
1259 (default
1260 .Pa /usr/sbin/rpcbind ) .
1261 .It Va rpcbind_enable
1262 .Pq Vt bool
1263 If set to
1264 .Dq Li YES ,
1265 run the
1266 .Xr rpcbind 8
1267 service at boot time.
1268 .It Va rpcbind_flags
1269 .Pq Vt str
1270 If
1271 .Va rpcbind_enable
1272 is set to
1273 .Dq Li YES ,
1274 these are the flags to pass to the
1275 .Xr rpcbind 8
1276 daemon.
1277 .It Va keyserv_enable
1278 .Pq Vt bool
1279 If set to
1280 .Dq Li YES ,
1281 run the
1282 .Xr keyserv 8
1283 daemon on boot for running Secure RPC.
1284 .It Va keyserv_flags
1285 .Pq Vt str
1286 If
1287 .Va keyserv_enable
1288 is set to
1289 .Dq Li YES ,
1290 these are the flags to pass to
1291 .Xr keyserv 8
1292 daemon.
1293 .It Va pppoed_enable
1294 .Pq Vt bool
1295 If set to
1296 .Dq Li YES ,
1297 run the
1298 .Xr pppoed 8
1299 daemon at boot time to provide PPP over Ethernet services.
1300 .It Va pppoed_ Ns Ar provider
1301 .Pq Vt str
1302 .Xr pppoed 8
1303 listens to requests to this
1304 .Ar provider
1305 and ultimately runs
1306 .Xr ppp 8
1307 with a
1308 .Ar system
1309 argument of the same name.
1310 .It Va pppoed_flags
1311 .Pq Vt str
1312 Additional flags to pass to
1313 .Xr pppoed 8 .
1314 .It Va pppoed_interface
1315 .Pq Vt str
1316 The network interface to run
1317 .Xr pppoed 8
1318 on.
1319 This is mandatory when
1320 .Va pppoed_enable
1321 is set to
1322 .Dq Li YES .
1323 .It Va timed_enable
1324 .Pq Vt bool
1325 If set to
1326 .Dq Li YES ,
1327 run the
1328 .Xr timed 8
1329 service at boot time.
1330 This command is intended for networks of
1331 machines where a consistent
1332 .Dq "network time"
1333 for all hosts must be established.
1334 This is often useful in large NFS
1335 environments where time stamps on files are expected to be consistent
1336 network-wide.
1337 .It Va timed_flags
1338 .Pq Vt str
1339 If
1340 .Va timed_enable
1341 is set to
1342 .Dq Li YES ,
1343 these are the flags to pass to the
1344 .Xr timed 8
1345 service.
1346 .It Va ntpd_enable
1347 .Pq Vt bool
1348 If set to
1349 .Dq Li YES ,
1350 run the
1351 .Xr ntpd 8
1352 command at boot time.
1353 .It Va ntpd_program
1354 .Pq Vt str
1355 Path to
1356 .Xr ntpd 8
1357 (default
1358 .Pa /usr/sbin/ntpd ) .
1359 .It Va ntpd_flags
1360 .Pq Vt str
1361 If
1362 .Va ntpd_enable
1363 is set to
1364 .Dq Li YES ,
1365 these are the flags to pass to the
1366 .Xr ntpd 8
1367 daemon. Set to
1368 .Dq Li -s
1369 by default which sets the time immediately at startup if the
1370 local clock is off by more than 180 seconds. To prevent
1371 .Xr ntpd 8
1372 from doing this, set
1373 .Va ntpd_flags
1374 to
1375 .Dq Li -S .
1376 .It Va nis_client_enable
1377 .Pq Vt bool
1378 If set to
1379 .Dq Li YES ,
1380 run the
1381 .Xr ypbind 8
1382 service at system boot time.
1383 .It Va nis_client_flags
1384 .Pq Vt str
1385 If
1386 .Va nis_client_enable
1387 is set to
1388 .Dq Li YES ,
1389 these are the flags to pass to the
1390 .Xr ypbind 8
1391 service.
1392 .It Va nis_ypset_enable
1393 .Pq Vt bool
1394 If set to
1395 .Dq Li YES ,
1396 run the
1397 .Xr ypset 8
1398 daemon at system boot time.
1399 .It Va nis_ypset_flags
1400 .Pq Vt str
1401 If
1402 .Va nis_ypset_enable
1403 is set to
1404 .Dq Li YES ,
1405 these are the flags to pass to the
1406 .Xr ypset 8
1407 daemon.
1408 .It Va nis_server_enable
1409 .Pq Vt bool
1410 If set to
1411 .Dq Li YES ,
1412 run the
1413 .Xr ypserv 8
1414 daemon at system boot time.
1415 .It Va nis_server_flags
1416 .Pq Vt str
1417 If
1418 .Va nis_server_enable
1419 is set to
1420 .Dq Li YES ,
1421 these are the flags to pass to the
1422 .Xr ypserv 8
1423 daemon.
1424 .It Va nis_ypxfrd_enable
1425 .Pq Vt bool
1426 If set to
1427 .Dq Li YES ,
1428 run the
1429 .Xr rpc.ypxfrd 8
1430 daemon at system boot time.
1431 .It Va nis_ypxfrd_flags
1432 .Pq Vt str
1433 If
1434 .Va nis_ypxfrd_enable
1435 is set to
1436 .Dq Li YES ,
1437 these are the flags to pass to the
1438 .Xr rpc.ypxfrd 8
1439 daemon.
1440 .It Va nis_yppasswdd_enable
1441 .Pq Vt bool
1442 If set to
1443 .Dq Li YES ,
1444 run the
1445 .Xr rpc.yppasswdd 8
1446 daemon at system boot time.
1447 .It Va nis_yppasswdd_flags
1448 .Pq Vt str
1449 If
1450 .Va nis_yppasswdd_enable
1451 is set to
1452 .Dq Li YES ,
1453 these are the flags to pass to the
1454 .Xr rpc.yppasswdd 8
1455 daemon.
1456 .It Va rpc_ypupdated_enable
1457 .Pq Vt bool
1458 If set to
1459 .Dq Li YES ,
1460 run the
1461 .Nm rpc.ypupdated
1462 daemon at system boot time.
1463 .It Va defaultrouter
1464 .Pq Vt str
1465 If not set to
1466 .Dq Li NO ,
1467 create a default route to this host name or IP address
1468 (use an IP address if this router is also required to get to the
1469 name server!).
1470 .It Va ipv6_defaultrouter
1471 .Pq Vt str
1472 The IPv6 equivalent of
1473 .Va defaultrouter .
1474 .It Va static_routes
1475 .Pq Vt str
1476 Set to the list of static routes that are to be added at system
1477 boot time.
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 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
1487 operation.
1488 .It Va ipv6_static_routes
1489 .Pq Vt str
1490 The IPv6 equivalent of
1491 .Va static_routes .
1492 If not set to
1493 .Dq Li NO
1494 then for each whitespace separated
1495 .Ar element
1496 in the value, a
1497 .Va ipv6_route_ Ns Aq Ar element
1498 variable is assumed to exist
1499 whose contents will later be passed to a
1500 .Dq Nm route Cm add Fl inet6
1501 operation.
1502 .It Va gateway_enable
1503 .Pq Vt bool
1504 If set to
1505 .Dq Li YES ,
1506 configure host to act as an IP router, e.g. to forward packets
1507 between interfaces.
1508 .It Va ipv6_gateway_enable
1509 .Pq Vt bool
1510 The IPv6 equivalent of
1511 .Va gateway_enable .
1512 .It Va router_enable
1513 .Pq Vt bool
1514 If set to
1515 .Dq Li YES ,
1516 run a routing daemon of some sort, based on the
1517 settings of
1518 .Va router
1519 and
1520 .Va router_flags .
1521 .It Va ipv6_router_enable
1522 .Pq Vt bool
1523 The IPv6 equivalent of
1524 .Va router_enable .
1525 If set to
1526 .Dq Li YES ,
1527 run a routing daemon of some sort, based on the
1528 settings of
1529 .Va ipv6_router
1530 and
1531 .Va ipv6_router_flags .
1532 .It Va router
1533 .Pq Vt str
1534 If
1535 .Va router_enable
1536 is set to
1537 .Dq Li YES ,
1538 this is the name of the routing daemon to use.
1539 .It Va ipv6_router
1540 .Pq Vt str
1541 The IPv6 equivalent of
1542 .Va router .
1543 .It Va router_flags
1544 .Pq Vt str
1545 If
1546 .Va router_enable
1547 is set to
1548 .Dq Li YES ,
1549 these are the flags to pass to the routing daemon.
1550 .It Va ipv6_router_flags
1551 .Pq Vt str
1552 The IPv6 equivalent of
1553 .Va router_flags .
1554 .It Va mrouted_enable
1555 .Pq Vt bool
1556 If set to
1557 .Dq Li YES ,
1558 run the multicast routing daemon,
1559 .Xr mrouted 8 .
1560 .It Va mroute6d_enable
1561 .Pq Vt bool
1562 The IPv6 equivalent of
1563 .Va mrouted_enable .
1564 If set to
1565 .Dq Li YES ,
1566 run the IPv6 multicast routing daemon.
1567 Note that no IPv6 multicast routing daemon is included in the
1568 .Dx
1569 base system but
1570 .Xr pim6dd 8
1571 can be installed from the
1572 .Fx
1573 Ports Collection.
1574 .It Va mrouted_flags
1575 .Pq Vt str
1576 If
1577 .Va mrouted_enable
1578 is set to
1579 .Dq Li YES ,
1580 these are the flags to pass to the
1581 .Xr mrouted 8
1582 daemon.
1583 .It Va mroute6d_flags
1584 .Pq Vt str
1585 The IPv6 equivalent of
1586 .Va mrouted_flags .
1587 If
1588 .Va mroute6d_enable
1589 is set to
1590 .Dq Li YES ,
1591 these are the flags passed to the IPv6 multicast routing daemon.
1592 .It Va mroute6d_program
1593 .Pq Vt str
1594 If
1595 .Va mroute6d_enable
1596 is set to
1597 .Dq Li YES ,
1598 this is the path to the IPv6 multicast routing daemon.
1599 .It Va rtadvd_enable
1600 .Pq Vt bool
1601 If set to
1602 .Dq Li YES ,
1603 run the
1604 .Xr rtadvd 8
1605 daemon at boot time.
1606 .Xr rtadvd 8
1607 will only run if
1608 .Va ipv6_gateway_enable
1609 is also set to
1610 .Dq Li YES .
1611 The
1612 .Xr rtadvd 8
1613 utility sends router advertisement packets to the interfaces specified in
1614 .Va rtadvd_interfaces .
1615 .Xr rtadvd 8
1616 and should only be enabled with great care.
1617 You may want to fine-tune
1618 .Xr rtadvd.conf 5 .
1619 .It Va rtadvd_interfaces
1620 .Pq Vt str
1621 If
1622 .Va rtadvd_enable
1623 is set to
1624 .Dq Li YES
1625 this is the list of interfaces to use.
1626 .It Va ipxgateway_enable
1627 .Pq Vt bool
1628 If set to
1629 .Dq Li YES ,
1630 enable the routing of IPX traffic.
1631 .It Va ipxrouted_enable
1632 .Pq Vt bool
1633 If set to
1634 .Dq Li YES ,
1635 run the
1636 .Xr IPXrouted 8
1637 daemon at system boot time.
1638 .It Va ipxrouted_flags
1639 .Pq Vt str
1640 If
1641 .Va ipxrouted_enable
1642 is set to
1643 .Dq Li YES ,
1644 these are the flags to pass to the
1645 .Xr IPXrouted 8
1646 daemon.
1647 .It Va arpproxy_all
1648 .Pq Vt bool
1649 If set to
1650 .Dq Li YES ,
1651 enable global proxy ARP.
1652 .It Va forward_sourceroute
1653 .Pq Vt bool
1654 If set to
1655 .Dq Li YES
1656 and
1657 .Va gateway_enable
1658 is also set to
1659 .Dq Li YES ,
1660 source-routed packets are forwarded.
1661 .It Va accept_sourceroute
1662 .Pq Vt bool
1663 If set to
1664 .Dq Li YES ,
1665 the system will accept source-routed packets directed at it.
1666 .It Va rarpd_enable
1667 .Pq Vt bool
1668 If set to
1669 .Dq Li YES ,
1670 run the
1671 .Xr rarpd 8
1672 daemon at system boot time.
1673 .It Va rarpd_flags
1674 .Pq Vt str
1675 If
1676 .Va rarpd_enable
1677 is set to
1678 .Dq Li YES ,
1679 these are the flags to pass to the
1680 .Xr rarpd 8
1681 daemon.
1682 .It Va bootparamd_enable
1683 .Pq Vt bool
1684 If set to
1685 .Dq Li YES ,
1686 run the
1687 .Xr bootparamd 8
1688 daemon at system boot time.
1689 .It Va bootparamd_flags
1690 .Pq Vt str
1691 If
1692 .Va bootparamd_enable
1693 is set to
1694 .Dq Li YES ,
1695 these are the flags to pass to the
1696 .Xr bootparamd 8
1697 daemon.
1698 .It Va stf_interface_ipv4addr
1699 .Pq Vt str
1700 If not set to
1701 .Dq Li NO ,
1702 this is the local IPv4 address for 6to4 (IPv6 over IPv4 tunneling
1703 interface).
1704 Specify this entry to enable the 6to4 interface.
1705 .It Va stf_interface_ipv4plen
1706 .Pq Vt int
1707 Prefix length for 6to4 IPv4 addresses, to limit peer address range.
1708 An effective value is 0-31.
1709 .It Va stf_interface_ipv6_ifid
1710 .Pq Vt str
1711 IPv6 interface ID for
1712 .Xr stf 4 .
1713 This can be set to
1714 .Dq Li AUTO .
1715 .It Va stf_interface_ipv6_slaid
1716 .Pq Vt str
1717 IPv6 Site Level Aggregator for
1718 .Xr stf 4 .
1719 .It Va ipv6_faith_prefix
1720 .Pq Vt str
1721 If not set to
1722 .Dq Li NO ,
1723 this is the faith prefix to enable a FAITH IPv6-to-IPv4 TCP
1724 translator.
1725 You also need
1726 .Xr faithd 8
1727 setup.
1728 .It Va ipv6_ipv4mapping
1729 .Pq Vt bool
1730 If set to
1731 .Dq Li YES
1732 this enables IPv4 mapped IPv6 address communication (like
1733 .Li ::ffff:a.b.c.d ) .
1734 .It Va atm_enable
1735 .Pq Vt bool
1736 Set to
1737 .Dq Li YES
1738 to enable the configuration of ATM interfaces at system boot time.
1739 For all of the ATM variables described below, please refer to the
1740 .Xr atm 8
1741 man page for further details on the available command parameters.
1742 Also refer to the files in
1743 .Pa /usr/share/examples/atm
1744 for more detailed configuration information.
1745 .It Va atm_load
1746 .Pq Vt str
1747 This is a list of physical ATM interface drivers to load. Typical values are
1748 .Dq Li hfa_pci
1749 and/or
1750 .Dq Li hea_pci .
1751 .It Va atm_netif_ Ns Aq Ar intf
1752 .Pq Vt str
1753 For the ATM physical interface
1754 .Ar intf ,
1755 this variable defines the name prefix and count for the ATM network
1756 interfaces to be created.
1757 The value will be passed as the parameters of an
1758 .Dq Nm atm Cm "set netif" Ar intf
1759 command.
1760 .It Va atm_sigmgr_ Ns Aq Ar intf
1761 .Pq Vt str
1762 For the ATM physical interface
1763 .Ar intf ,
1764 this variable defines the ATM signalling manager to be used.
1765 The value will be passed as the parameters of an
1766 .Dq Nm atm Cm attach Ar intf
1767 command.
1768 .It Va atm_prefix_ Ns Aq Ar intf
1769 .Pq Vt str
1770 For the ATM physical interface
1771 .Ar intf ,
1772 this variable defines the NSAP prefix for interfaces using a UNI signalling
1773 manager.
1774 If set to
1775 .Dq Li ILMI ,
1776 the prefix will automatically be set via the
1777 .Xr ilmid 8
1778 daemon.
1779 Otherwise, the value will be passed as the parameters of an
1780 .Dq Nm atm Cm "set prefix" Ar intf
1781 command.
1782 .It Va atm_macaddr_ Ns Aq Ar intf
1783 .Pq Vt str
1784 For the ATM physical interface
1785 .Ar intf ,
1786 this variable defines the MAC address for interfaces using a UNI signalling
1787 manager.
1788 If set to
1789 .Dq Li NO ,
1790 the hardware MAC address contained in the ATM interface card will be used.
1791 Otherwise, the value will be passed as the parameters of an
1792 .Dq Nm atm Cm "set mac" Ar intf
1793 command.
1794 .It Va atm_arpserver_ Ns Aq Ar netif
1795 .Pq Vt str
1796 For the ATM network interface
1797 .Ar netif ,
1798 this variable defines the ATM address for a host which is to provide ATMARP
1799 service.
1800 This variable is only applicable to interfaces using a UNI signalling
1801 manager.
1802 If set to
1803 .Dq Li local ,
1804 this host will become an ATMARP server.
1805 The value will be passed as the parameters of an
1806 .Dq Nm atm Cm "set arpserver" Ar netif
1807 command.
1808 .It Va atm_scsparp_ Ns Aq Ar netif
1809 .Pq Vt bool
1810 If set to
1811 .Dq Li YES ,
1812 SCSP/ATMARP service for the network interface
1813 .Ar netif
1814 will be initiated using the
1815 .Xr scspd 8
1816 and
1817 .Xr atmarpd 8
1818 daemons.
1819 This variable is only applicable if
1820 .Va atm_arpserver_ Ns Aq Ar netif
1821 is set to
1822 .Dq Li local .
1823 .It Va atm_pvcs
1824 .Pq Vt str
1825 Set to the list of ATM PVCs to be added at system
1826 boot time.
1827 For each whitespace separated
1828 .Ar element
1829 in the value, an
1830 .Va atm_pvc_ Ns Aq Ar element
1831 variable is assumed to exist.
1832 The value of each of these variables
1833 will be passed as the parameters of an
1834 .Dq Nm atm Cm "add pvc"
1835 command.
1836 .It Va atm_arps
1837 .Pq Vt str
1838 Set to the list of permanent ATM ARP entries to be added
1839 at system boot time.
1840 For each whitespace separated
1841 .Ar element
1842 in the value, an
1843 .Va atm_arp_ Ns Aq Ar element
1844 variable is assumed to exist.
1845 The value of each of these variables
1846 will be passed as the parameters of an
1847 .Dq Nm atm Cm "add arp"
1848 command.
1849 .It Va natm_interfaces
1850 .Pq Vt str
1851 Set to the list of
1852 .Xr natm 4
1853 interfaces that will also be used for HARP through
1854 .Xr harp 4 .
1855 If this list is not empty all interfaces in the list will be brought up
1856 with
1857 .Xr ifconfig 9
1858 and
1859 .Xr harp 4
1860 will be loaded.
1861 For this to work the interface drivers must be either compiled into the
1862 kernel or must reside on the root partition.
1863 .It Va keybell
1864 .Pq Vt str
1865 The keyboard bell sound.
1866 Set to
1867 .Dq Li normal ,
1868 .Dq Li visual ,
1869 .Dq Li off ,
1870 or
1871 .Dq Li NO
1872 if the default behavior is desired.
1873 For details, refer to the
1874 .Xr kbdcontrol 1
1875 manpage.
1876 .It Va keymap
1877 .Pq Vt str
1878 If set to
1879 .Dq Li NO ,
1880 no keymap is installed, otherwise the value is used to install
1881 the keymap file in
1882 .Pa /usr/share/syscons/keymaps/ Ns Ao Ar value Ac Ns Pa .kbd .
1883 .It Va keyrate
1884 .Pq Vt str
1885 The keyboard repeat speed.
1886 Set to
1887 .Dq Li slow ,
1888 .Dq Li normal ,
1889 .Dq Li fast ,
1890 or
1891 .Dq Li NO
1892 if the default behavior is desired.
1893 .It Va keychange
1894 .Pq Vt str
1895 If not set to
1896 .Dq Li NO ,
1897 attempt to program the function keys with the value.
1898 The value should
1899 be a single string of the form:
1900 .Dq Ar funkey_number new_value Op Ar funkey_number new_value ... .
1901 .It Va cursor
1902 .Pq Vt str
1903 Can be set to the value of
1904 .Dq Li normal ,
1905 .Dq Li blink ,
1906 .Dq Li destructive ,
1907 or
1908 .Dq Li NO
1909 to set the cursor behavior explicitly or choose the default behavior.
1910 .It Va scrnmap
1911 .Pq Vt str
1912 If set to
1913 .Dq Li NO ,
1914 no screen map is installed, otherwise the value is used to install
1915 the screen map file in
1916 .Pa /usr/share/syscons/scrnmaps/ Ns Aq Ar value .
1917 .It Va font8x16
1918 .Pq Vt str
1919 If set to
1920 .Dq Li NO ,
1921 the default 8x16 font value is used for screen size requests, otherwise
1922 the value in
1923 .Pa /usr/share/syscons/fonts/ Ns Aq Ar value
1924 is used.
1925 .It Va font8x14
1926 .Pq Vt str
1927 If set to
1928 .Dq Li NO ,
1929 the default 8x14 font value is used for screen size requests, otherwise
1930 the value in
1931 .Pa /usr/share/syscons/fonts/ Ns Aq Ar value
1932 is used.
1933 .It Va font8x8
1934 .Pq Vt str
1935 If set to
1936 .Dq Li NO ,
1937 the default 8x8 font value is used for screen size requests, otherwise
1938 the value in
1939 .Pa /usr/share/syscons/fonts/ Ns Aq Ar value
1940 is used.
1941 .It Va blanktime
1942 .Pq Vt int
1943 If set to
1944 .Dq Li NO ,
1945 the default screen blanking interval is used, otherwise it is set
1946 to
1947 .Ar value
1948 seconds.
1949 .It Va saver
1950 .Pq Vt str
1951 If not set to
1952 .Dq Li NO ,
1953 this is the actual screen saver to use
1954 .Li ( blank , snake , daemon ,
1955 etc).
1956 .It Va moused_enable
1957 .Pq Vt str
1958 If set to
1959 .Dq Li YES ,
1960 the
1961 .Xr moused 8
1962 daemon is started for doing cut/paste selection on the console.
1963 .It Va moused_type
1964 .Pq Vt str
1965 This is the protocol type of the mouse connected to this host.
1966 This variable must be set if
1967 .Va moused_enable
1968 is set to
1969 .Dq Li YES .
1970 The
1971 .Xr moused 8
1972 daemon
1973 is able to detect the appropriate mouse type automatically in many cases.
1974 Set this variable to
1975 .Dq Li auto
1976 to let the daemon detect it, or
1977 select one from the following list if the automatic detection fails.
1978 .Pp
1979 If the mouse is attached to the PS/2 mouse port, choose
1980 .Dq Li auto
1981 or
1982 .Dq Li ps/2 ,
1983 regardless of the brand and model of the mouse.
1984 Likewise, if the
1985 mouse is attached to the bus mouse port, choose
1986 .Dq Li auto
1987 or
1988 .Dq Li busmouse .
1989 All other protocols are for serial mice and will not work with
1990 the PS/2 and bus mice.
1991 If this is a USB mouse,
1992 .Dq Li auto
1993 is the only protocol type which will work.
1994 .Pp
1995 .Bl -tag -width ".Li x10mouseremote" -compact
1996 .It Li microsoft
1997 Microsoft mouse (serial)
1998 .It Li intellimouse
1999 Microsoft IntelliMouse (serial)
2000 .It Li mousesystems
2001 Mouse systems Corp. mouse (serial)
2002 .It Li mmseries
2003 MM Series mouse (serial)
2004 .It Li logitech
2005 Logitech mouse (serial)
2006 .It Li busmouse
2007 A bus mouse
2008 .It Li mouseman
2009 Logitech MouseMan and TrackMan (serial)
2010 .It Li glidepoint
2011 ALPS GlidePoint (serial)
2012 .It Li thinkingmouse
2013 Kensington ThinkingMouse (serial)
2014 .It Li ps/2
2015 PS/2 mouse
2016 .It Li mmhittab
2017 MM HitTablet (serial)
2018 .It Li x10mouseremote
2019 X10 MouseRemote (serial)
2020 .It Li versapad
2021 Interlink VersaPad (serial)
2022 .El
2023 .Pp
2024 Even if the mouse is not in the above list, it may be compatible
2025 with one in the list.
2026 Refer to the man page for
2027 .Xr moused 8
2028 for compatibility information.
2029 .Pp
2030 It should also be noted that while this is enabled, any
2031 other client of the mouse (such as an X server) should access
2032 the mouse through the virtual mouse device,
2033 .Pa /dev/sysmouse ,
2034 and configure it as a
2035 .Dq Li sysmouse
2036 type mouse, since all
2037 mouse data is converted to this single canonical format when
2038 using
2039 .Xr moused 8 .
2040 If the client program does not support the
2041 .Dq Li sysmouse
2042 type,
2043 specify the
2044 .Dq Li mousesystems
2045 type.
2046 It is the second preferred type.
2047 .It Va moused_port
2048 .Pq Vt str
2049 If
2050 .Va moused_enable
2051 is set to
2052 .Dq Li YES ,
2053 this is the actual port the mouse is on.
2054 It might be
2055 .Pa /dev/cuaa0
2056 for a COM1 serial mouse,
2057 .Pa /dev/psm0
2058 for a PS/2 mouse or
2059 .Pa /dev/mse0
2060 for a bus mouse, for example.
2061 .It Va moused_flags
2062 .Pq Vt str
2063 If
2064 .Va moused_type
2065 is set, these are the additional flags to pass to the
2066 .Xr moused 8
2067 daemon.
2068 .It Va mousechar_start
2069 .Pq Vt int
2070 If set to
2071 .Dq Li NO ,
2072 the default mouse cursor character range
2073 .Li 0xd0 Ns - Ns Li 0xd3
2074 is used,
2075 otherwise the range start is set
2076 to
2077 .Ar value
2078 character, see
2079 .Xr vidcontrol 1 .
2080 Use if the default range is occupied in the language code table.
2081 .It Va allscreens_flags
2082 .Pq Vt str
2083 If set,
2084 .Xr vidcontrol 1
2085 is run with these options for each of the virtual terminals
2086 .Pq Pa /dev/ttyv* .
2087 For example,
2088 .Dq Fl m Cm on
2089 will enable the mouse pointer on all virtual terminals
2090 if
2091 .Va moused_enable
2092 is set to
2093 .Dq Li YES .
2094 .It Va allscreens_kbdflags
2095 .Pq Vt str
2096 If set,
2097 .Xr kbdcontrol 1
2098 is run with these options for each of the virtual terminals
2099 .Pq Pa /dev/ttyv* .
2100 For example,
2101 .Dq Fl h Li 200
2102 will set the
2103 .Xr syscons 4
2104 scrollback (history) buffer to 200 lines.
2105 .It Va cron_enable
2106 .Pq Vt bool
2107 If set to
2108 .Dq Li YES ,
2109 run the
2110 .Xr cron 8
2111 daemon at system boot time.
2112 .It Va cron_program
2113 .Pq Vt str
2114 Path to
2115 .Xr cron 8
2116 (default
2117 .Pa /usr/sbin/cron ) .
2118 .It Va cron_flags
2119 .Pq Vt str
2120 If
2121 .Va cron_enable
2122 is set to
2123 .Dq Li YES ,
2124 these are the flags to pass to
2125 .Xr cron 8 .
2126 .It Va lpd_program
2127 .Pq Vt str
2128 Path to
2129 .Xr lpd 8
2130 (default
2131 .Pa /usr/sbin/lpd ) .
2132 .It Va lpd_enable
2133 .Pq Vt bool
2134 If set to
2135 .Dq Li YES ,
2136 run the
2137 .Xr lpd 8
2138 daemon at system boot time.
2139 .It Va lpd_flags
2140 .Pq Vt str
2141 If
2142 .Va lpd_enable
2143 is set to
2144 .Dq Li YES ,
2145 these are the flags to pass to the
2146 .Xr lpd 8
2147 daemon.
2148 .It Va mta_start_script
2149 .Pq Vt str
2150 This variable specifies the full path to the script to run to start
2151 a mail transfer agent.
2152 The default is
2153 .Pa /etc/rc.sendmail .
2154 The
2155 .Va sendmail_*
2156 variables which
2157 .Pa /etc/rc.sendmail
2158 uses are documented in the
2159 .Xr rc.sendmail 8
2160 man page.
2161 .It Va dumpdev
2162 .Pq Vt str
2163 Indicates the device (usually a swap partition) to which a crash dump
2164 should be written in the event of a system crash.
2165 The value of this variable is passed as the argument to
2166 .Xr dumpon 8 .
2167 To disable crash dumps, set this variable to
2168 .Dq Li NO .
2169 .It Va dumpdir
2170 .Pq Vt str
2171 When the system reboots after a crash and a crash dump is found on the
2172 device specified by the
2173 .Va dumpdev
2174 variable,
2175 .Xr savecore 8
2176 will save that crash dump and a copy of the kernel to the directory
2177 specified by the
2178 .Va dumpdir
2179 variable.
2180 The default value is
2181 .Pa /var/crash .
2182 Set to
2183 .Dq Li NO
2184 to not run
2185 .Xr savecore 8
2186 at boot time when
2187 .Va dumpdir
2188 is set.
2189 .It Va savecore_flags
2190 .Pq Vt str
2191 If crash dumps are enabled, these are the flags to pass to the
2192 .Xr savecore 8
2193 utility.
2194 .It Va enable_quotas
2195 .Pq Vt bool
2196 Set to
2197 .Dq Li YES
2198 to turn on user disk quotas on system startup via the
2199 .Xr quotaon 8
2200 command.
2201 .It Va check_quotas
2202 .Pq Vt bool
2203 Set to
2204 .Dq Li YES
2205 to enable user disk quota checking via the
2206 .Xr quotacheck 8
2207 command.
2208 .It Va accounting_enable
2209 .Pq Vt bool
2210 Set to
2211 .Dq Li YES
2212 to enable system accounting through the
2213 .Xr accton 8
2214 facility.
2215 .It Va ibcs2_enable
2216 .Pq Vt bool
2217 Set to
2218 .Dq Li YES
2219 to enable iBCS2 (SCO) binary emulation at system initial boot
2220 time.
2221 .It Va ibcs2_loaders
2222 .Pq Vt str
2223 If not set to
2224 .Dq Li NO
2225 and if
2226 .Va ibcs2_enable
2227 is set to
2228 .Dq Li YES ,
2229 this specifies a list of additional iBCS2 loaders to enable.
2230 .It Va linux_enable
2231 .Pq Vt bool
2232 Set to
2233 .Dq Li YES
2234 to enable Linux/ELF binary emulation at system initial
2235 boot time.
2236 .It Va osf1_enable
2237 .Pq Vt bool
2238 Set to
2239 .Dq Li YES
2240 to enable OSF/1 (Digital UNIX) binary emulation at system
2241 initial boot time.
2242 (alpha)
2243 .It Va svr4_enable
2244 .Pq Vt bool
2245 If set to
2246 .Dq Li YES ,
2247 enable SysVR4 emulation at boot time.
2248 .It Va sysvipc_enable
2249 .Pq Vt bool
2250 If set to
2251 .Dq Li YES ,
2252 load System V IPC primitives at boot time.
2253 .It Va clear_tmp_enable
2254 .Pq Vt bool
2255 Set to
2256 .Dq Li YES
2257 to have
2258 .Pa /tmp
2259 cleaned at startup.
2260 .It Va ldconfig_paths
2261 .Pq Vt str
2262 Set to the list of shared library paths to use with
2263 .Xr ldconfig 8 .
2264 NOTE:
2265 .Pa /usr/lib
2266 will always be added first, so it need not appear in this list.
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 pcvt_verbose
2482 .Pq Vt bool
2483 Set to
2484 .Dq Li NO
2485 by default.
2486 When set to
2487 .Dq Li YES ,
2488 verbose messages about the actions done by the start script are displayed.
2489 .Em Note :
2490 the
2491 .Xr pcvt 4
2492 driver must be compiled into the kernel before the
2493 .Xr pcvt 4
2494 related
2495 options described here take any effect.
2496 .It Va pcvt_keymap
2497 .Pq Vt str
2498 Set to
2499 .Dq Li NO
2500 by default.
2501 Use this to configure a national keyboard mapping found in the
2502 .Pa /usr/share/misc/keycap.pcvt
2503 file of keyboard mappings.
2504 (See also the manual pages
2505 .Xr keycap 5
2506 and
2507 .Xr keycap 3
2508 for usage of
2509 .Xr pcvt 4 Ns 's
2510 keycap database and the manual page
2511 .Xr kcon 1
2512 option
2513 .Fl m
2514 for national keyboard mapping configuration.)
2515 .It Va pcvt_keydel
2516 .Pq Vt int
2517 Set to
2518 .Dq Li NO
2519 by default.
2520 Used to set the keyboard key repeat delay value.
2521 Valid values are
2522 in the range 0..3 for delay values of 250, 500, 750 and 1000 msec.
2523 (See also the
2524 .Xr kcon 1
2525 manual page.)
2526 .It Va pcvt_keyrate
2527 .Pq Vt int
2528 Set to
2529 .Dq Li NO
2530 by default.
2531 Used to set the keyboard key repetition rate value.
2532 Valid values are
2533 in the range 0..31 for repetition values of 2..30 characters per second.
2534 .It Va pcvt_keyrepeat
2535 .Pq Vt bool
2536 Set to
2537 .Dq Li NO
2538 by default.
2539 Set to
2540 .Dq Li YES
2541 to enable automatic keyboard key repeating.
2542 .It Va pcvt_force24
2543 .Pq Vt bool
2544 Set to
2545 .Dq Li NO
2546 by default.
2547 Set to
2548 .Dq Li YES
2549 to force
2550 .Xr pcvt 4
2551 to use 24 lines only (in 25 lines mode) for compatibility
2552 with the original
2553 .Tn VT220
2554 terminal.
2555 .It Va pcvt_hpext
2556 .Pq Vt bool
2557 Set to
2558 .Dq Li NO
2559 by default.
2560 Set to
2561 .Dq Li YES
2562 to enable the display and functionality of function key labels (as found
2563 on
2564 .Tn Hewlett-Packard
2565 terminals such as the
2566 .Tn HP2392A
2567 and the
2568 .Tn HP700/92
2569 in
2570 .Tn ANSI
2571 mode).
2572 .It Va pcvt_lines
2573 .Pq Vt int
2574 Set to
2575 .Dq Li NO
2576 by default resulting in a value of 25.
2577 Used to set the number of lines on the screen.
2578 For VGA displays, valid
2579 values are 25, 28, 40 and 50 lines.
2580 (See also the
2581 .Xr scon 1
2582 manual page.)
2583 .It Va pcvt_blanktime
2584 .Pq Vt int
2585 Set to
2586 .Dq Li NO
2587 by default.
2588 Used to set the screen saver timeout in seconds for values greater than
2589 zero.
2590 .It Va pcvt_cursorh
2591 .Pq Vt int
2592 Set to
2593 .Dq Li NO
2594 by default.
2595 Used to set the cursor top scanline.
2596 (See also the
2597 .Xr cursor 1
2598 manual page.)
2599 .It Va pcvt_cursorl
2600 .Pq Vt int
2601 Set to
2602 .Dq Li NO
2603 by default.
2604 Used to set the cursor bottom scanline.
2605 .It Va pcvt_monohigh
2606 .Pq Vt bool
2607 Set to
2608 .Dq Li NO
2609 by default.
2610 Set to
2611 .Dq Li YES
2612 to set intensity to high on monochrome monitors.
2613 (See also the
2614 .Xr scon 1
2615 manual page, option
2616 .Fl p ,
2617 for more information on changing VGA palette
2618 values.)
2619 .It Va harvest_interrupt
2620 .Pq Vt bool
2621 Set to
2622 .Dq Li YES
2623 to use hardware interrupts as an entropy source.
2624 Refer to
2625 .Xr random 4
2626 for more information.
2627 .It Va harvest_ethernet
2628 .Pq Vt bool
2629 Set to
2630 .Dq Li YES
2631 to use LAN traffic as an entropy source.
2632 Refer to
2633 .Xr random 4
2634 for more information.
2635 .It Va harvest_p_to_p
2636 .Pq Vt bool
2637 Set to
2638 .Dq Li YES
2639 to use serial line traffic as an entropy source.
2640 Refer to
2641 .Xr random 4
2642 for more information.
2643 .It Va entropy_dir
2644 .Pq Vt str
2645 Set to
2646 .Dq Li NO
2647 to disable caching entropy via
2648 .Xr cron 8 .
2649 Otherwise set to the directory used to store entropy files in.
2650 .It Va entropy_file
2651 .Pq Vt str
2652 Set to
2653 .Dq Li NO
2654 to disable caching entropy through reboots.
2655 Otherwise set to the filename used to store cached entropy through
2656 reboots.
2657 This file should be located on the root file system to seed the
2658 .Xr random 4
2659 device as early as possible in the boot process.
2660 .It Va entropy_save_sz
2661 .Pq Vt int
2662 Size of the entropy cache files saved by
2663 .Nm save-entropy
2664 periodically.
2665 .It Va entropy_save_num
2666 .Pq Vt int
2667 Number of entropy cache files to save by
2668 .Nm save-entropy
2669 periodically.
2670 .It Va ipsec_enable
2671 .Pq Vt bool
2672 Set to
2673 .Dq Li YES
2674 to run
2675 .Xr setkey 8
2676 on
2677 .Va ipsec_file
2678 at boot time.
2679 .It Va ipsec_file
2680 .Pq Vt str
2681 Configuration file for
2682 .Xr setkey 8 .
2683 .It Va dmesg_enable
2684 .Pq Vt bool
2685 Set to
2686 .Dq Li YES
2687 to save
2688 .Xr dmesg 8
2689 to
2690 .Pa /var/run/dmesg.boot
2691 on boot.
2692 .It Va rcshutdown_timeout
2693 .Pq Vt int
2694 If set, start a watchdog timer in the background which will terminate
2695 .Pa rc.shutdown
2696 if
2697 .Xr shutdown 8
2698 has not completed within the specified time (in seconds).
2699 .El
2700 .Sh FILES
2701 .Bl -tag -width ".Pa /etc/defaults/rc.conf" -compact
2702 .It Pa /etc/defaults/rc.conf
2703 .It Pa /etc/rc.conf
2704 .It Pa /etc/rc.conf.local
2705 .El
2706 .Sh SEE ALSO
2707 .Xr catman 1 ,
2708 .Xr gdb 1 ,
2709 .Xr info 1 ,
2710 .Xr kbdcontrol 1 ,
2711 .Xr makewhatis 8 ,
2712 .Xr vidcontrol 1 ,
2713 .Xr ip 4 ,
2714 .Xr kld 4 ,
2715 .Xr tcp 4 ,
2716 .Xr udp 4 ,
2717 .Xr exports 5 ,
2718 .Xr motd 5 ,
2719 .Xr accton 8 ,
2720 .Xr amd 8 ,
2721 .Xr apm 8 ,
2722 .Xr atm 8 ,
2723 .Xr cron 8 ,
2724 .Xr dhclient 8 ,
2725 .Xr ifconfig 8 ,
2726 .Xr inetd 8 ,
2727 .Xr isdnd 8 ,
2728 .Xr isdntrace 8 ,
2729 .Xr kldxref 8 ,
2730 .Xr lpd 8 ,
2731 .Xr mdconfig 8 ,
2732 .Xr mountd 8 ,
2733 .Xr moused 8 ,
2734 .Xr mrouted 8 ,
2735 .Xr named 8 ,
2736 .Xr nfsd 8 ,
2737 .Xr ntpd 8 ,
2738 .Xr pcnfsd 8 ,
2739 .Xr quotacheck 8 ,
2740 .Xr quotaon 8 ,
2741 .Xr rc 8 ,
2742 .Xr rc.sendmail 8 ,
2743 .Xr route 8 ,
2744 .Xr routed 8 ,
2745 .Xr rpc.lockd 8 ,
2746 .Xr rpc.statd 8 ,
2747 .Xr rpcbind 8 ,
2748 .Xr rwhod 8 ,
2749 .Xr savecore 8 ,
2750 .Xr sshd 8 ,
2751 .Xr swapon 8 ,
2752 .Xr sysctl 8 ,
2753 .Xr syslogd 8 ,
2754 .Xr timed 8 ,
2755 .Xr usbd 8 ,
2756 .Xr vinum 8 ,
2757 .Xr yp 8 ,
2758 .Xr ypbind 8 ,
2759 .Xr ypserv 8 ,
2760 .Xr ypset 8
2761 .Sh HISTORY
2762 The
2763 .Nm
2764 file appeared in
2765 .Fx 2.2.2 .
2766 .Sh AUTHORS
2767 .An Jordan K. Hubbard .