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