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