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.64.2.52 2003/05/03 22:15:27 keramida Exp $
  26 .\" $DragonFly: src/share/man/man5/rc.conf.5,v 1.2 2003/06/17 04:37:00 dillon Exp $
  27 .\"
  28 .Dd March 3, 2002
  29 .Dt RC.CONF 5
  30 .Os
  31 .Sh NAME
  32 .Nm rc.conf
  33 .Nd system configuration information
  34 .Sh DESCRIPTION
  35 The file
  36 .Nm
  37 contains descriptive information about the local host name, configuration
  38 details for any potential network interfaces and which services should be
  39 started up at system initial boot time.  In new installations, the
  40 .Nm
  41 file is generally initialized by the system installation utility:
  42 .Pa /stand/sysinstall .
  43 .Pp
  44 The purpose of
  45 .Nm
  46 is not to run commands or perform system startup actions
  47 directly.  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
  59 need only be specified in
  60 .Pa /etc/rc.conf
  61 when the system administrator wishes to override these defaults.
  62 The file
  63 .Pa /etc/rc.conf.local
  64 is used to override settings in
  65 .Pa /etc/rc.conf
  66 for historical reasons.
  67 See the
  68 .Dq rc_conf_files
  69 option below.
  70 .Pp
  71 The following list provides a name and short description for each
  72 variable that can be set in the
  73 .Nm
  74 file:
  75 .Bl -tag -width Ar
  76 .It Va swapfile
  77 .Pq Vt str
  78 If set to
  79 .Dq NO
  80 then no swapfile is installed, otherwise the value is used as the full
  81 pathname to a file to use for additional swap space.
  82 .It Va apm_enable
  83 .Pq Vt bool
  84 If set to
  85 .Dq YES ,
  86 enable support for Automatic Power Management with
  87 the
  88 .Xr apm 8
  89 command.
  90 .It Va apmd_enable
  91 .Pq Vt bool
  92 Run
  93 .Xr apmd 8
  94 to handle APM event from userland.
  95 This also enable support for APM.
  96 .It Va apmd_flags
  97 .Pq Vt str
  98 If
  99 .Va apmd_enable
 100 is set to
 101 .Dq YES ,
 102 these are the flags to pass to the
 103 .Xr apmd 8
 104 daemon.
 105 .It Va pccard_enable
 106 .Pq Vt bool
 107 If set to
 108 .Dq YES ,
 109 enable PCCARD support at boot time.
 110 .It Va pccard_mem
 111 .Pq Vt str
 112 Set to PCCARD controller memory address or
 113 .Dq DEFAULT
 114 for the default value.
 115 .It Va pccard_ifconfig
 116 .Pq Vt str
 117 List of arguments to be passed to
 118 .Xr ifconfig 8
 119 at boot time or on
 120 insertion of the card (e.g. "inet 192.168.1.1 netmask 255.255.255.0"
 121 for a fixed address or "DHCP" for a DHCP client).
 122 .It Va pccard_beep
 123 .Pq Vt int
 124 If 0,
 125 set the PCCARD controller to silent mode.
 126 If 1,
 127 set it to beep mode.
 128 If 2,
 129 set it to melody mode.
 130 .It Va pccard_conf
 131 .Pq Vt str
 132 Path to the configuration file for the
 133 .Xr pccardd 8
 134 daemon.
 135 .It Va pccardd_flags
 136 .Pq Vt str
 137 If
 138 .Va pccard_enable
 139 is set to
 140 .Dq YES ,
 141 these are the flags to pass to the
 142 .Xr pccardd 8
 143 daemon.
 144 .It Va pccard_ether_delay
 145 .Pq Vt str
 146 Set the delay before starting
 147 .Xr dhclient 8
 148 in
 149 .Xr pccard_ether 8
 150 script.
 151 This defaults to 5 seconds to work around a bug in the
 152 .Xr ed 4
 153 driver which can lead to system hangs when using some newer
 154 .Xr ed 4
 155 based cards.
 156 .It Va local_startup
 157 .Pq Vt str
 158 List of directories to search for startup script files.
 159 .It Va script_name_sep
 160 .Pq Vt str
 161 The field separator to use for breaking down the list of startup script files
 162 into individual filenames.
 163 The default is a space.
 164 It is not necessary to change this unless there are startup scripts with names
 165 containing spaces.
 166 .It Va hostname
 167 .Pq Vt str
 168 The Fully Qualified Domain Name of this host on the network.
 169 This should almost certainly be set to something meaningful, even if
 170 there is no network connection.
 171 If
 172 .Xr dhclient 8
 173 is used to set the hostname via DHCP,
 174 this variable should be set to an empty string.
 175 .It Va nisdomainname
 176 .Pq Vt str
 177 The NIS domain name of this host, or
 178 .Dq NO
 179 if NIS is not used.
 180 .It Va dhcp_program
 181 .Pq Vt str
 182 Path to the DHCP client program
 183 .Pa ( /sbin/dhclient ,
 184 the ISC DHCP client,
 185 is the default).
 186 .It Va dhcp_flags
 187 .Pq Vt str
 188 Additional flags to pass to the DHCP client program.
 189 For the ISC DHCP client, see the
 190 .Xr dhclient 8
 191 page for a description of the command line options available.
 192 .It Va firewall_enable
 193 .Pq Vt bool
 194 Set to
 195 .Dq YES
 196 to load firewall rules at startup.
 197 If the kernel was not built with
 198 .Dv IPFIREWALL ,
 199 the ipfw
 200 kernel module will be loaded.
 201 See also
 202 .Va ipfilter_enable .
 203 .It Va firewall_script
 204 .Pq Vt str
 205 This variable specifies the full path to the firewall script to run.
 206 The default is
 207 .Pa /etc/rc.firewall .
 208 .It Va firewall_type
 209 .Pq Vt str
 210 Names the firewall type from the selection in
 211 .Pa /etc/rc.firewall ,
 212 or the file which contains the local firewall ruleset.  Valid selections
 213 from
 214 .Pa /etc/rc.firewall ,
 215 are
 216 .Dq open
 217 - unrestricted IP access;
 218 .Dq closed
 219 - all IP services disabled, except via lo0;
 220 .Dq client
 221 - basic protection for a workstation;
 222 .Dq simple
 223 - basic protection for a LAN.  If a filename is specified, the full path
 224 must be given.
 225 .It Va firewall_quiet
 226 .Pq Vt bool
 227 Set to
 228 .Dq YES
 229 to disable the display of ipfw rules on the console during boot.
 230 .It Va firewall_logging
 231 .Pq Vt bool
 232 Set to
 233 .Dq YES
 234 to enable ipfw event logging.
 235 This is equivalent to the
 236 .Dv IPFIREWALL_VERBOSE
 237 kernel option.
 238 .It Va firewall_flags
 239 .Pq Vt str
 240 Flags passed to
 241 .Xr ipfw 8
 242 if
 243 .Va firewall_type
 244 specifies a filename.
 245 .It Va natd_program
 246 .Pq Vt str
 247 Path to
 248 .Xr natd 8 .
 249 .It Va natd_enable
 250 .Pq Vt bool
 251 Set to
 252 .Dq YES
 253 to enable natd.
 254 .Va firewall_enable
 255 must also be set to
 256 .Dq YES ,
 257 and
 258 .Xr divert 4
 259 sockets must be enabled in the kernel.
 260 .It Va natd_interface
 261 .Pq Vt str
 262 This is the name of the public interface on which natd should run.
 263 The interface may be given as an interface name or as an IP address.
 264 .It Va natd_flags
 265 .Pq Vt str
 266 Additional natd flags should be placed here.  The
 267 .Fl n
 268 or
 269 .Fl a
 270 flag is automatically added with the above
 271 .Va natd_interface
 272 as an argument.
 273 .\" ----- ipfilter_enable setting --------------------------------
 274 .It Va ipfilter_enable
 275 .Pq Vt bool
 276 Set to
 277 .Dq NO
 278 by default.
 279 Setting this to
 280 .Dq YES
 281 enables
 282 .Xr ipf 8
 283 packet filtering.
 284 .Pp
 285 Typical usage will require putting
 286 .Bd -literal
 287 ipfilter_enable="YES"
 288 ipnat_enable="YES"
 289 ipmon_enable="YES"
 290 ipfs_enable="YES"
 291 .Ed
 292 .Pp
 293 into
 294 .Pa /etc/rc.conf
 295 and editing
 296 .Pa /etc/ipf.rules
 297 and
 298 .Pa /etc/ipnat.rules
 299 appropriately.
 300 .Pp
 301 Note that
 302 .Va ipfilter_enable
 303 and
 304 .Va ipnat_enable
 305 can be enabled independently.
 306 .Va ipmon_enable
 307 and
 308 .Va ipfs_enable
 309 both require at least one of
 310 .Va ipfilter_enable
 311 and
 312 .Va ipnat_enable
 313 to be enabled.
 314 .Pp
 315 Having
 316 .Bd -literal
 317 options  IPFILTER
 318 options  IPFILTER_LOG
 319 options  IPFILTER_DEFAULT_BLOCK
 320 .Ed
 321 .Pp
 322 in the kernel configuration file is a good idea, too.
 323 .\" ----- ipfilter_program setting ------------------------------
 324 .It Va ipfilter_program
 325 .Pq Vt str
 326 Path to
 327 .Xr ipf 8
 328 (default
 329 .Pa /sbin/ipf ) .
 330 .\" ----- ipfilter_rules setting --------------------------------
 331 .It Va ipfilter_rules
 332 .Pq Vt str
 333 Set to
 334 .Dq /etc/ipf.rules
 335 by default.
 336 This variable contains the name of the filter rule definition file.
 337 The file is expected to be readable for the
 338 .Xr ipf 8
 339 command to execute.
 340 .\" ----- ipfilter_flags setting --------------------------------
 341 .It Va ipfilter_flags
 342 .Pq Vt str
 343 Empty by default.
 344 This variable contains flags passed to the
 345 .Xr ipf 8
 346 program.
 347 .\" ----- ipnat_enable setting ----------------------------------
 348 .It Va ipnat_enable
 349 .Pq Vt bool
 350 Set to
 351 .Dq NO
 352 by default.
 353 Set it to
 354 .Dq YES
 355 to enable
 356 .Xr ipnat 1
 357 network address translation.
 358 See
 359 .Va ipfilter_enable
 360 for a detailed discussion.
 361 .\" ----- ipnat_program setting ---------------------------------
 362 .It Va ipnat_program
 363 .Pq Vt str
 364 Path to
 365 .Xr ipnat 1
 366 (default
 367 .Pa /sbin/ipnat ) .
 368 .\" ----- ipnat_rules setting -----------------------------------
 369 .It Va ipnat_rules
 370 .Pq Vt str
 371 Set to
 372 .Dq /etc/ipnat.rules
 373 by default.
 374 This variable contains the name of the file
 375 holding the network address translation definition.
 376 This file is expected to be readable for the
 377 .Xr ipnat 1
 378 command to execute.
 379 .\" ----- ipnat_flags setting -----------------------------------
 380 .It Va ipnat_flags
 381 .Pq Vt str
 382 Empty by default.
 383 This variable contains flags passed to the
 384 .Xr ipnat 1
 385 program.
 386 .\" ----- ipmon_enable setting ----------------------------------
 387 .It Va ipmon_enable
 388 .Pq Vt bool
 389 Set to
 390 .Dq NO
 391 by default.
 392 Set it to
 393 .Dq YES
 394 to enable
 395 .Xr ipmon 8
 396 monitoring (logging
 397 .Xr ipf 8
 398 and
 399 .Xr ipnat 1
 400 events).
 401 Setting this variable needs setting
 402 .Va ipfilter_enable
 403 or
 404 .Va ipnat_enable
 405 too.
 406 See
 407 .Va ipfilter_enable
 408 for a detailed discussion.
 409 .\" ----- ipmon_program setting ---------------------------------
 410 .It Va ipmon_program
 411 .Pq Vt str
 412 Path to
 413 .Xr ipmon 8
 414 (default
 415 .Pa /sbin/ipmon ) .
 416 .\" ----- ipmon_flags setting -----------------------------------
 417 .It Va ipmon_flags
 418 .Pq Vt str
 419 Set to
 420 .Dq -Ds
 421 by default.
 422 This variable contains flags passed to the
 423 .Xr ipmon 8
 424 program.
 425 Another typical example would be
 426 .Dq -D /var/log/ipflog
 427 to have
 428 .Xr ipmon 8
 429 log directly to a file bypassing
 430 .Xr syslogd 8 .
 431 Make sure to adjust
 432 .Pa /etc/newsyslog.conf
 433 in such case like this:
 434 .Bd -literal
 435 /var/log/ipflog  640  10  100  *  Z  /var/run/ipmon.pid
 436 .Ed
 437 .\" ----- ipfs_enable setting -----------------------------------
 438 .It Va ipfs_enable
 439 .Pq Vt bool
 440 Set to
 441 .Dq NO
 442 by default.
 443 Set it to
 444 .Dq YES
 445 to enable
 446 .Xr ipfs 8
 447 saving the filter and NAT state tables during shutdown
 448 and reloading them during startup again.
 449 Setting this variable needs setting
 450 .Va ipfilter_enable
 451 or
 452 .Va ipnat_enable
 453 to
 454 .Dq YES
 455 too.
 456 See
 457 .Va ipfilter_enable
 458 for a detailed discussion.
 459 Note that if
 460 .Va kern_securelevel
 461 is set to 3,
 462 .Va ipfs_enable
 463 cannot be used
 464 because the raised securelevel will prevent
 465 .Xr ipfs 8
 466 from saving the state tables at shutdown time.
 467 .\" ----- ipfs_program setting ----------------------------------
 468 .It Va ipfs_program
 469 .Pq Vt str
 470 Path to
 471 .Xr ipfs 8
 472 (default
 473 .Pa /sbin/ipfs ) .
 474 .\" ----- ipfs_flags setting ------------------------------------
 475 .It Va ipfs_flags
 476 .Pq Vt str
 477 Empty by default.
 478 This variable contains flags passed to the
 479 .Xr ipfs 8
 480 program.
 481 .\" ----- end of added ipf hook ---------------------------------
 482 .It Va tcp_extensions
 483 .Pq Vt bool
 484 Set to
 485 .Dq YES
 486 by default.
 487 Setting this to NO disables certain TCP options as described by
 488 .Rs
 489 .%T RFC 1323
 490 .Re
 491 Setting this to
 492 .Dq NO
 493 might help remedy such problems with connections as randomly hanging
 494 or other weird behavior.
 495 Some network devices are known
 496 to be broken with respect to these options.
 497 .It Va log_in_vain
 498 .Pq Vt int
 499 Set to 0 by default.
 500 The
 501 .Xr sysctl 8
 502 variables,
 503 .Sy net.inet.tcp.log_in_vain
 504 and
 505 .Sy net.inet.udp.log_in_vain
 506 as described in
 507 .Xr tcp 4
 508 and
 509 .Xr udp 4 ,
 510 are set to the given value.
 511 .It Va tcp_keepalive
 512 .Pq Vt bool
 513 Set to
 514 .Dq YES
 515 by default.
 516 Setting to NO will disable probing idle TCP connections to verify that the
 517 peer is still up and reachable.
 518 .It Va tcp_drop_synfin
 519 .Pq Vt bool
 520 Set to
 521 .Dq NO
 522 by default.
 523 Setting to YES will cause the kernel to ignore TCP frames that have both
 524 the SYN and FIN flags set.
 525 This prevents OS fingerprinting, but may
 526 break some legitimate applications.
 527 This option is only available if the
 528 kernel was built with the
 529 .Dv TCP_DROP_SYNFIN
 530 option.
 531 .It Va icmp_drop_redirect
 532 .Pq Vt bool
 533 Set to
 534 .Dq NO
 535 by default.
 536 Setting to YES will cause the kernel to ignore ICMP REDIRECT packets.
 537 .It Va icmp_log_redirect
 538 .Pq Vt bool
 539 Set to
 540 .Dq NO
 541 by default.
 542 Setting to YES will cause the kernel to log ICMP REDIRECT packets.
 543 Note that
 544 the log messages are not rate-limited, so this option should only be used
 545 for troubleshooting networks.
 546 .It Va network_interfaces
 547 .Pq Vt str
 548 Set to the list of network interfaces to configure on this host.
 549 For example, if the only network devices in the system are the loopback
 550 device
 551 (lo0)
 552 and a NIC using the ed0 driver,
 553 this could be set to
 554 .Dq "lo0 ed0"
 555 An
 556 .Va ifconfig_ Ns Aq Ar interface
 557 variable is also assumed to exist for each value of
 558 .Ar interface .
 559 It is also possible to add IP alias entires here in cases where
 560 multiple IP addresses registered against a single interface
 561 are desired.
 562 Assuming that the interface in question was ed0, it might look
 563 something like this:
 564 .Bd -literal
 565 ifconfig_ed0_alias0="inet 127.0.0.253 netmask 0xffffffff"
 566 ifconfig_ed0_alias1="inet 127.0.0.254 netmask 0xffffffff"
 567 .Ed
 568 .Pp
 569 And so on.
 570 For each
 571 .Va ifconfig_ Ns Ao Ar interface Ac Ns Va _alias Ns Aq Ar n
 572 entry that is found,
 573 its contents are passed to
 574 .Xr ifconfig 8 .
 575 Execution stops at the first unsuccessful access, so if
 576 something like this is present:
 577 .Bd -literal
 578 ifconfig_ed0_alias0="inet 127.0.0.251 netmask 0xffffffff"
 579 ifconfig_ed0_alias1="inet 127.0.0.252 netmask 0xffffffff"
 580 ifconfig_ed0_alias2="inet 127.0.0.253 netmask 0xffffffff"
 581 ifconfig_ed0_alias4="inet 127.0.0.254 netmask 0xffffffff"
 582 .Ed
 583 .Pp
 584 Then note that alias4 would
 585 .Em not
 586 be added since the search would
 587 stop with the missing alias3 entry.
 588 .Pp
 589 It is possible to bring up an interface with DHCP by setting the
 590 .Va ifconfig_ Ns Aq Ar interface
 591 variable to
 592 .Dq DHCP .
 593 For instance, to initialize the ed0 device via DHCP,
 594 it is possible to use something like:
 595 .Bd -literal
 596 ifconfig_ed0="DHCP"
 597 .Ed
 598 .It Va cloned_interfaces
 599 .Pq Vt str
 600 Set to the list of clonable network interfaces to create on this host.
 601 Entries in
 602 .Va cloned_interfaces
 603 are automatically appended to
 604 .Va network_interfaces
 605 for configuration.
 606 .It Va gif_interfaces
 607 .Pq Vt str
 608 Set to the list of
 609 .Xr gif 4
 610 tunnel interfaces to configure on this host.
 611 A
 612 .Va gifconfig_ Ns Aq Ar interface
 613 variable is assumed to exist for each value of
 614 .Ar interface .
 615 The value of this variable is used to configure the link layer of the
 616 tunnel according to the syntax of the
 617 .Cm tunnel
 618 option to
 619 .Xr ifconfig 8 .
 620 Additionaly, this option ensures that each listed interface is created
 621 via the
 622 .Cm create
 623 option to
 624 .Xr ifconfig 8
 625 before attempting to configure it.
 626 .It Va ppp_enable
 627 .Pq Vt bool
 628 If set to
 629 .Dq YES ,
 630 run the
 631 .Xr ppp 8
 632 daemon.
 633 .It Va ppp_mode
 634 .Pq Vt str
 635 Mode in which to run the
 636 .Xr ppp 8
 637 daemon.  Accepted modes are
 638 .Dq auto ,
 639 .Dq ddial ,
 640 .Dq direct
 641 and
 642 .Dq dedicated .
 643 See the manual for a full description.
 644 .It Va ppp_nat
 645 .Pq Vt bool
 646 If set to
 647 .Dq YES ,
 648 enables packet aliasing.
 649 Used in conjunction with
 650 .Va gateway_enable
 651 allows hosts on private network addresses access to the Internet using
 652 this host as a network address translating router.
 653 .It Va ppp_profile
 654 .Pq Vt str
 655 The name of the profile to use from
 656 .Pa /etc/ppp/ppp.conf .
 657 .It Va ppp_user
 658 .Pq Vt str
 659 The name of the user under which ppp should be started.
 660 By
 661 default, ppp is started as
 662 .Dq root .
 663 .It Va rc_conf_files
 664 .Pq Vt str
 665 This option is used to specify a list of files that will override
 666 the settings in
 667 .Pa /etc/defaults/rc.conf .
 668 The files will be read in the order in which they are specified and should
 669 include the full path to the file.
 670 By default, the files specified are
 671 .Pa /etc/rc.conf
 672 and
 673 .Pa /etc/rc.conf.local
 674 .It Va fsck_y_enable
 675 .Pq Vt bool
 676 If set to
 677 .Dq YES ,
 678 .Xr fsck 8
 679 will be run with the -y flag if the initial preen
 680 of the filesystems fails.
 681 .It Va syslogd_enable
 682 .Pq Vt bool
 683 If set to
 684 .Dq YES ,
 685 run the
 686 .Xr syslogd 8
 687 daemon.
 688 .It Va syslogd_program
 689 .Pq Vt str
 690 Path to
 691 .Xr syslogd 8
 692 (default
 693 .Pa /usr/sbin/syslogd ) .
 694 .It Va syslogd_flags
 695 .Pq Vt str
 696 If
 697 .Va syslogd_enable
 698 is set to
 699 .Dq YES ,
 700 these are the flags to pass to
 701 .Xr syslogd 8 .
 702 .It Va inetd_enable
 703 .Pq Vt bool
 704 If set to
 705 .Dq YES ,
 706 run the
 707 .Xr inetd 8
 708 daemon.
 709 .It Va inetd_program
 710 .Pq Vt str
 711 Path to
 712 .Xr inetd 8
 713 (default
 714 .Pa /usr/sbin/inetd ) .
 715 .It Va inetd_flags
 716 .Pq Vt str
 717 If
 718 .Va inetd_enable
 719 is set to
 720 .Dq YES ,
 721 these are the flags to pass to
 722 .Xr inetd 8 .
 723 .It Va named_enable
 724 .Pq Vt bool
 725 If set to
 726 .Dq YES ,
 727 run the
 728 .Xr named 8
 729 daemon.
 730 .It Va named_program
 731 .Pq Vt str
 732 Path to
 733 .Xr named 8
 734 (default
 735 .Pa /usr/sbin/named ) .
 736 .It Va named_flags
 737 .Pq Vt str
 738 If
 739 .Va named_enable
 740 is set to
 741 .Dq YES ,
 742 these are the flags to pass to
 743 .Xr named 8 .
 744 .It Va kerberos_server_enable
 745 .Pq Vt bool
 746 Set to
 747 .Dq YES
 748 to start a Kerberos IV authentication server
 749 at boot time.
 750 .It Va kadmind_server_enable
 751 .Pq Vt bool
 752 Set to
 753 .Dq YES
 754 to start
 755 .Xr kadmind 8 ,
 756 the Kerberos IV Administration Daemon; set to
 757 .Dq NO
 758 on a slave server.
 759 .It Va kerberos_stash
 760 .Pq Vt str
 761 If
 762 .Dq YES ,
 763 instruct the Kerberos servers to use the stashed master key instead of
 764 prompting for it (only if
 765 .Va kerberos_server_enable
 766 is set to
 767 .Dq YES ,
 768 and is used for both
 769 .Xr kerberos 1
 770 and
 771 .Xr kadmind 8 ) .
 772 .It Va kerberos5_server_enable
 773 .Pq Vt bool
 774 Set to
 775 .Dq YES
 776 to start a Kerberos 5 authentication server
 777 at boot time.
 778 .It Va kadmind5_server_enable
 779 .Pq Vt bool
 780 Set to
 781 .Dq YES
 782 to start
 783 .Xr k5admind 8 ,
 784 the Kerberos 5 Administration Daemon; set to
 785 .Dq NO
 786 on a slave server.
 787 .It Va rwhod_enable
 788 .Pq Vt bool
 789 If set to
 790 .Dq YES ,
 791 run the
 792 .Xr rwhod 8
 793 daemon at boot time.
 794 .It Va rwhod_flags
 795 .Pq Vt str
 796 If
 797 .Va rwhod_enable
 798 is set to
 799 .Dq YES ,
 800 these are the flags to pass to it.
 801 .It Va amd_enable
 802 .Pq Vt bool
 803 If set to
 804 .Dq YES ,
 805 run the
 806 .Xr amd 8
 807 daemon at boot time.
 808 .It Va amd_flags
 809 .Pq Vt str
 810 If
 811 .Va amd_enable
 812 is set to
 813 .Dq YES ,
 814 these are the flags to pass to it.
 815 See the
 816 .Xr amd 8
 817 .Xr info 1
 818 page for more information.
 819 .It Va amd_map_program
 820 .Pq Vt str
 821 If set,
 822 the specified program is run to get the list of
 823 .Xr amd 8
 824 maps.
 825 For example, if the
 826 .Xr amd 8
 827 maps are stored in NIS, one can set this to
 828 run
 829 .Xr ypcat 1
 830 to get a list of
 831 .Xr amd 8
 832 maps from the
 833 .Pa amd.master
 834 NIS map.
 835 .It Va update_motd
 836 .Pq Vt bool
 837 If set to
 838 .Dq YES ,
 839 .Pa /etc/motd
 840 will be updated at boot time to reflect the kernel release
 841 being run.  If set to
 842 .Dq NO ,
 843 .Pa /etc/motd
 844 will not be updated
 845 .It Va nfs_client_enable
 846 .Pq Vt bool
 847 If set to
 848 .Dq YES ,
 849 run the NFS client daemons at boot time.
 850 .It Va nfs_client_flags
 851 .Pq Vt str
 852 If
 853 .Va nfs_client_enable
 854 is set to
 855 .Dq YES ,
 856 these are the flags to pass to the
 857 .Xr nfsiod 8
 858 daemon.
 859 .It Va nfs_access_cache
 860 .Pq Vt int
 861 If
 862 .Va nfs_client_enable
 863 is set to
 864 .Dq YES ,
 865 this can be set to
 866 .Dq 0
 867 to disable NFS ACCESS RPC caching, or to the number of seconds for which
 868 NFS ACCESS
 869 results should be cached.
 870 A value of 2-10 seconds will substantially reduce network
 871 traffic for many NFS operations.
 872 .It Va nfs_server_enable
 873 .Pq Vt bool
 874 If set to
 875 .Dq YES ,
 876 run the NFS server daemons at boot time.
 877 .It Va nfs_server_flags
 878 .Pq Vt str
 879 If
 880 .Va nfs_server_enable
 881 is set to
 882 .Dq YES ,
 883 these are the flags to pass to the
 884 .Xr nfsd 8
 885 daemon.
 886 .It Va single_mountd_enable
 887 .Pq Vt bool
 888 If set to
 889 .Dq YES ,
 890 and no
 891 .Va nfs_server_enable
 892 is set, start
 893 .Xr mountd 8 ,
 894 but not
 895 .Xr nfsd 8
 896 daemon.
 897 It is commonly needed to run CFS without real NFS used.
 898 .It Va mountd_flags
 899 .Pq Vt str
 900 If
 901 .Va mountd_enable
 902 is set to
 903 .Dq Li YES ,
 904 these are the flags to pass to the
 905 ,Xr mountd 8
 906 daemon.
 907 .It Va weak_mountd_authentication
 908 .Pq Vt bool
 909 If set to
 910 .Dq YES ,
 911 allow services like PCNFSD to make non-privileged mount
 912 requests.
 913 .It Va nfs_reserved_port_only
 914 .Pq Vt bool
 915 If set to
 916 .Dq YES ,
 917 provide NFS services only on a secure port.
 918 .It Va nfs_bufpackets
 919 .Pq Vt int
 920 If set to a number, indicates the number of packets worth of
 921 socket buffer space to reserve on an NFS client.
 922 The kernel default is typically 4.
 923 Using a higher number may be
 924 useful on gigabit networks to improve performance.
 925 The minimum value is
 926 2 and the maximum is 64.
 927 .It Va rpc_lockd_enable
 928 .Pq Vt bool
 929 If set to
 930 .Dq YES
 931 and also an NFS server, run
 932 .Xr rpc.lockd 8
 933 at boot time.
 934 .It Va rpc_statd_enable
 935 .Pq Vt bool
 936 If set to
 937 .Dq YES
 938 and also an NFS server, run
 939 .Xr rpc.statd 8
 940 at boot time.
 941 .It Va portmap_program
 942 .Pq Vt str
 943 Path to
 944 .Xr portmap 8
 945 (default
 946 .Pa /usr/sbin/portmap ) .
 947 .It Va portmap_enable
 948 .Pq Vt bool
 949 If set to
 950 .Dq YES ,
 951 run the
 952 .Xr portmap 8
 953 service at boot time.
 954 .It Va portmap_flags
 955 .Pq Vt str
 956 If
 957 .Va portmap_enable
 958 is set to
 959 .Dq YES ,
 960 these are the flags to pass to the
 961 .Xr portmap 8
 962 daemon.
 963 .It Va xtend_enable
 964 .Pq Vt bool
 965 If set to
 966 .Dq YES
 967 then run the
 968 .Xr xtend 8
 969 daemon at boot time.
 970 .It Va xtend_flags
 971 .Pq Vt str
 972 If
 973 .Va xtend_enable
 974 is set to
 975 .Dq YES ,
 976 these are the flags to pass to the
 977 .Xr xtend 8
 978 daemon.
 979 .It Va pppoed_enable
 980 .Pq Vt bool
 981 If set to
 982 .Dq YES
 983 then run the
 984 .Xr pppoed 8
 985 daemon at boot time to provide PPP over Ethernet services.
 986 .It Va pppoed_ Ns Ar provider
 987 .Pq Vt str
 988 .Xr pppoed 8
 989 listens to requests to this
 990 .Ar provider
 991 and ultimately runs
 992 .Xr ppp 8
 993 with a
 994 .Ar system
 995 argument of the same name.
 996 .It Va pppoed_flags
 997 .Pq Vt str
 998 Additional flags to pass to
 999 .Xr pppoed 8 .
1000 .It Va pppoed_interface
1001 .Pq Vt str
1002 The network interface to run pppoed on.  This is mandatory when
1003 .Va pppoed_enable
1004 is set to
1005 .Dq YES .
1006 .It Va timed_enable
1007 .Pq Vt boot
1008 If
1009 .Dq YES
1010 then run the
1011 .Xr timed 8
1012 service at boot time.  This command is intended for networks of
1013 machines where a consistent
1014 .Qq "network time"
1015 for all hosts must be established.  This is often useful in large NFS
1016 environments where time stamps on files are expected to be consistent
1017 network-wide.
1018 .It Va timed_flags
1019 .Pq Vt str
1020 If
1021 .Va timed_enable
1022 is set to
1023 .Dq YES ,
1024 these are the flags to pass to the
1025 .Xr timed 8
1026 service.
1027 .It Va ntpdate_enable
1028 .Pq Vt bool
1029 If set to
1030 .Dq YES ,
1031 run ntpdate at system startup.  This command is intended to
1032 synchronize the system clock only
1033 .Em once
1034 from some standard reference.  An option to set this up initially
1035 (from a list of known servers) is also provided by the
1036 .Pa /stand/sysinstall
1037 program when the system is first installed.
1038 .It Va ntpdate_program
1039 .Pq Vt str
1040 Path to
1041 .Xr ntpdate 8
1042 (default
1043 .Pa /usr/sbin/ntpdate ) .
1044 .It Va ntpdate_flags
1045 .Pq Vt str
1046 If
1047 .Va ntpdate_enable
1048 is set to
1049 .Dq YES ,
1050 these are the flags to pass to the
1051 .Xr ntpdate 8
1052 command (typically a hostname).
1053 .It Va xntpd_enable
1054 .Pq Vt bool
1055 If set to
1056 .Dq YES
1057 then run the
1058 .Xr ntpd 8
1059 command at boot time.
1060 .It Va xntpd_program
1061 .Pq Vt str
1062 Path to
1063 .Xr ntpd 8
1064 (default
1065 .Pa /usr/sbin/ntpd ) .
1066 .It Va xntpd_flags
1067 .Pq Vt str
1068 If
1069 .Va xntpd_enable
1070 is set to
1071 .Dq YES ,
1072 these are the flags to pass to the
1073 .Xr ntpd 8
1074 daemon.
1075 .It Va nis_client_enable
1076 .Pq Vt bool
1077 If set to
1078 .Dq YES
1079 then run the
1080 .Xr ypbind 8
1081 service at system boot time.
1082 .It Va nis_client_flags
1083 .Pq Vt str
1084 If
1085 .Va nis_client_enable
1086 is set to
1087 .Dq YES ,
1088 these are the flags to pass to the
1089 .Xr ypbind 8
1090 service.
1091 .It Va nis_ypset_enable
1092 .Pq Vt bool
1093 If set to
1094 .Dq YES
1095 then run the
1096 .Xr ypset 8
1097 daemon at system boot time.
1098 .It Va nis_ypset_flags
1099 .Pq Vt str
1100 If
1101 .Va nis_ypset_enable
1102 is set to
1103 .Dq YES ,
1104 these are the flags to pass to the
1105 .Xr ypset 8
1106 daemon.
1107 .It Va nis_server_enable
1108 .Pq Vt bool
1109 If set to
1110 .Dq YES
1111 then run the
1112 .Xr ypserv 8
1113 daemon at system boot time.
1114 .It Va nis_server_flags
1115 .Pq Vt str
1116 If
1117 .Va nis_server_enable
1118 is set to
1119 .Dq YES ,
1120 these are the flags to pass to the
1121 .Xr ypserv 8
1122 daemon.
1123 .It Va nis_ypxfrd_enable
1124 .Pq Vt bool
1125 If set to
1126 .Dq YES
1127 then run the
1128 .Xr rpc.ypxfrd 8
1129 daemon at system boot time.
1130 .It Va nis_ypxfrd_flags
1131 .Pq Vt str
1132 If
1133 .Va nis_ypxfrd_enable
1134 is set to
1135 .Dq YES ,
1136 these are the flags to pass to the
1137 .Xr rpc.ypxfrd 8
1138 daemon.
1139 .It Va nis_yppasswdd_enable
1140 .Pq Vt bool
1141 If set to
1142 .Dq YES
1143 then run the
1144 .Xr rpc.yppasswdd 8
1145 daemon at system boot time.
1146 .It Va nis_yppasswdd_flags
1147 .Pq Vt str
1148 If
1149 .Va nis_yppasswdd_enable
1150 is set to
1151 .Dq YES ,
1152 these are the flags to pass to the
1153 .Xr rpc.yppasswdd 8
1154 daemon.
1155 .It Va defaultrouter
1156 .Pq Vt str
1157 If not set to
1158 .Dq NO
1159 then create a default route to this host name or IP address
1160 (use an IP address if this router is also required to get to the
1161 name server!).
1162 .It Va static_routes
1163 .Pq Vt str
1164 Set to the list of static routes that are to be added at system
1165 boot time.  If not set to
1166 .Dq NO
1167 then for each whitespace separated
1168 .Ar element
1169 in the value, a
1170 .Va route_ Ns Aq Ar element
1171 variable is assumed to exist
1172 whose contents will later be passed to a
1173 .Dq route add
1174 operation.
1175 .It Va gateway_enable
1176 .Pq Vt bool
1177 If set to
1178 .Dq YES ,
1179 then configure host to at as an IP router, e.g. to forward packets
1180 between interfaces.
1181 .It Va router_enable
1182 .Pq Vt bool
1183 If set to
1184 .Dq YES
1185 then run a routing daemon of some sort, based on the
1186 settings of
1187 .Va router
1188 and
1189 .Va router_flags .
1190 .It Va router
1191 .Pq Vt str
1192 If
1193 .Va router_enable
1194 is set to
1195 .Dq YES ,
1196 this is the name of the routing daemon to use.
1197 .It Va router_flags
1198 .Pq Vt str
1199 If
1200 .Va router_enable
1201 is set to
1202 .Dq YES ,
1203 these are the flags to pass to the routing daemon.
1204 .It Va mrouted_enable
1205 .Pq Vt bool
1206 If set to
1207 .Dq YES
1208 then run the multicast routing daemon,
1209 .Xr mrouted 8 .
1210 .It Va mrouted_flags
1211 .Pq Vt str
1212 If
1213 .Va mrouted_enable
1214 is set to
1215 .Dq YES ,
1216 these are the flags to pass to the multicast routing daemon.
1217 .It Va ipxgateway_enable
1218 .Pq Vt bool
1219 If set to
1220 .Dq YES
1221 then enable the routing of IPX traffic.
1222 .It Va ipxrouted_enable
1223 .Pq Vt bool
1224 If set to
1225 .Dq YES
1226 then run the
1227 .Xr IPXrouted 8
1228 daemon at system boot time.
1229 .It Va ipxrouted_flags
1230 .Pq Vt str
1231 If
1232 .Va ipxrouted_enable
1233 is set to
1234 .Dq YES ,
1235 these are the flags to pass to the
1236 .Xr IPXrouted 8
1237 daemon.
1238 .It Va arpproxy_all
1239 .Pq Vt bool
1240 If set to
1241 .Dq YES
1242 then enable global proxy ARP.
1243 .It Va forward_sourceroute
1244 .Pq Vt bool
1245 If set to
1246 .Dq YES
1247 then when
1248 .Va gateway_enable
1249 is also set to
1250 .Dq YES ,
1251 source routed packets are forwarded.
1252 .It Va accept_sourceroute
1253 .Pq Vt bool
1254 If set to
1255 .Dq YES
1256 then the system will accept source routed packets directed at it.
1257 .It Va rarpd_enable
1258 .Pq Vt bool
1259 If set to
1260 .Dq YES
1261 then run the
1262 .Xr rarpd 8
1263 daemon at system boot time.
1264 .It Va rarpd_flags
1265 .Pq Vt str
1266 If
1267 .Va rarpd_enable
1268 is set to
1269 .Dq YES ,
1270 these are the flags to pass to the
1271 .Xr rarpd 8
1272 daemon.
1273 .It Va atm_enable
1274 .Pq Vt bool
1275 Set to
1276 .Dq YES
1277 to enable the configuration of ATM interfaces at system boot time.
1278 For all of the ATM variables described below, please refer to the
1279 .Xr atm 8
1280 man page for further details on the available command parameters.
1281 Also refer to the files in
1282 .Pa /usr/share/examples/atm
1283 for more detailed configuration information.
1284 .It Va atm_netif_<intf>
1285 .Pq Vt str
1286 For the ATM physical interface
1287 .Va <intf> ,
1288 this variable defines the name prefix and count for the ATM network interfaces to be created.
1289 The value will be passed as the parameters of an
1290 .Dq atm set netif Va <intf>
1291 command.
1292 .It Va atm_sigmgr_<intf>
1293 .Pq Vt str
1294 For the ATM physical interface
1295 .Va <intf> ,
1296 this variable defines the ATM signalling manager to be used.
1297 The value will be passed as the parameters of an
1298 .Dq atm attach Va <intf>
1299 command.
1300 .It Va atm_prefix_<intf>
1301 .Pq Vt str
1302 For the ATM physical interface
1303 .Va <intf> ,
1304 this variable defines the NSAP prefix for interfaces using a UNI signalling
1305 manager.  If set to
1306 .Em ILMI ,
1307 then the prefix will automatically be set via the
1308 .Xr ilmid 8
1309 daemon.  Otherwise, the value will be passed as the parameters of an
1310 .Dq atm set prefix Va <intf>
1311 command.
1312 .It Va atm_macaddr_<intf>
1313 .Pq Vt str
1314 For the ATM physical interface
1315 .Va <intf> ,
1316 this variable defines the MAC address for interfaces using a UNI signalling
1317 manager.  If set to
1318 .Dq NO ,
1319 then the hardware MAC address contained in the ATM interface card will be used.
1320 Otherwise, the value will be passed as the parameters of an
1321 .Dq atm set mac Va <intf>
1322 command.
1323 .It Va atm_arpserver_<netif>
1324 .Pq Vt str
1325 For the ATM network interface
1326 .Va <netif> ,
1327 this variable defines the ATM address for a host which is to provide ATMARP
1328 service.  This variable is only applicable to interfaces using a UNI signalling
1329 manager.  If set to
1330 .Em local ,
1331 then this host will become an ATMARP server.
1332 The value will be passed as the parameters of an
1333 .Dq atm set arpserver Va <netif>
1334 command.
1335 .It Va atm_scsparp_<netif>
1336 .Pq Vt bool
1337 If set to
1338 .Dq YES ,
1339 then SCSP/ATMARP service for the network interface
1340 .Va <netif>
1341 will be initiated using the
1342 .Xr scspd 8
1343 and
1344 .Xr atmarpd 8
1345 daemons.  This variable is only applicable if
1346 .So
1347 .Va atm_arpserver_ Ns Aq Ar netif
1348 .No = Ns Qq local
1349 .Sc
1350 is defined.
1351 .It Va atm_pvcs
1352 .Pq Vt str
1353 Set to the list of ATM PVCs to be added at system
1354 boot time.  For each whitespace separated
1355 .Ar element
1356 in the value, an
1357 .Va atm_pvc_ Ns Aq Ar element
1358 variable is assumed to exist.  The value of each of these variables
1359 will be passed as the parameters of an
1360 .Dq atm add pvc
1361 command.
1362 .It Va atm_arps
1363 .Pq Vt str
1364 Set to the list of permanent ATM ARP entries to be added
1365 at system boot time.  For each whitespace separated
1366 .Ar element
1367 in the value, an
1368 .Va atm_arp_ Ns Aq Ar element
1369 variable is assumed to exist.  The value of each of these variables
1370 will be passed as the parameters of an
1371 .Dq atm add arp
1372 command.
1373 .It Va keymap
1374 .Pq Vt str
1375 If set to
1376 .Dq NO
1377 then no keymap is installed, otherwise the value is used to install
1378 the keymap file in
1379 .Pa /usr/share/syscons/keymaps/<value>.kbd
1380 .It Va keyrate
1381 .Pq Vt str
1382 The keyboard repeat speed.  Set to
1383 .Dq slow ,
1384 .Dq normal ,
1385 .Dq fast
1386 or
1387 .Dq NO
1388 if the default behavior is desired.
1389 .It Va keychange
1390 .Pq Vt str
1391 If not set to
1392 .Dq NO ,
1393 attempt to program the function keys with the value.  The value should
1394 be a single string of the form:
1395 .Qq Ar "<funkey_number> <new_value> [<funkey_number> <new_value>]..."
1396 .It Va cursor
1397 .Pq Vt str
1398 Can be set to the value of
1399 .Dq normal ,
1400 .Dq blink ,
1401 .Dq destructive
1402 or
1403 .Dq NO
1404 to set the cursor behavior explicitly or choose the default behavior.
1405 .It Va scrnmap
1406 .Pq Vt str
1407 If set to
1408 .Dq NO
1409 then no screen map is installed, otherwise the value is used to install
1410 the screen map file in
1411 .Pa /usr/share/syscons/scrnmaps/<value> .
1412 .It Va font8x16
1413 .Pq Vt str
1414 If set to
1415 .Dq NO
1416 then the default 8x16 font value is used for screen size requests, otherwise
1417 the value in
1418 .Pa /usr/share/syscons/fonts/<value>
1419 is used.
1420 .It Va font8x14
1421 .Pq Vt str
1422 If set to
1423 .Dq NO
1424 then the default 8x14 font value is used for screen size requests, otherwise
1425 the value in
1426 .Pa /usr/share/syscons/fonts/<value>
1427 is used.
1428 .It Va font8x8
1429 .Pq Vt str
1430 If set to
1431 .Dq NO
1432 then the default 8x8 font value is used for screen size requests, otherwise
1433 the value in
1434 .Pa /usr/share/syscons/fonts/<value>
1435 is used.
1436 .It Va blanktime
1437 .Pq Vt int
1438 If set to
1439 .Dq NO
1440 then the default screen blanking interval is used, otherwise it is set
1441 to
1442 .Ar value
1443 seconds.
1444 .It Va saver
1445 .Pq Vt str
1446 If not set to
1447 .Dq NO ,
1448 this is the actual screen saver to use (blank, snake, daemon, etc).
1449 .It Va moused_enable
1450 .Pq Vt str
1451 If set to
1452 .Dq YES ,
1453 the
1454 .Xr moused 8
1455 daemon is started for doing cut/paste selection on the console.
1456 .It Va moused_type
1457 .Pq Vt str
1458 This is the protocol type of the mouse connected to this host.
1459 This variable must be set if
1460 .Va moused_enable
1461 is set to
1462 .Dq YES .
1463 The
1464 .Xr moused 8
1465 daemon
1466 is able to detect the appropriate mouse type automatically in many cases.
1467 Set this variable to
1468 .Dq auto
1469 to let the daemon detect it, or
1470 select one from the following list if the automatic detection fails.
1471 .Pp
1472 If the mouse is attached to the PS/2 mouse port, choose
1473 .Dq auto
1474 or
1475 .Dq ps/2 ,
1476 regardless of the brand and model of the mouse.  Likewise, if the
1477 mouse is attached to the bus mouse port, choose
1478 .Dq auto
1479 or
1480 .Dq busmouse .
1481 All other protocols are for serial mice and will not work with
1482 the PS/2 and bus mice.
1483 If this is a USB mouse,
1484 .Dq auto
1485 is the only protocol type which will work.
1486 .Bd -literal
1487 microsoft        Microsoft mouse (serial)
1488 intellimouse     Microsoft IntelliMouse (serial)
1489 mousesystems     Mouse systems Corp mouse (serial)
1490 mmseries         MM Series mouse (serial)
1491 logitech         Logitech mouse (serial)
1492 busmouse         A bus mouse
1493 mouseman         Logitech MouseMan and TrackMan (serial)
1494 glidepoint       ALPS GlidePoint (serial)
1495 thinkingmouse    Kensington ThinkingMouse (serial)
1496 ps/2             PS/2 mouse
1497 mmhittab         MM HitTablet (serial)
1498 x10mouseremote   X10 MouseRemote (serial)
1499 versapad         Interlink VersaPad (serial)
1500 .Ed
1501 .Pp
1502 Even if the mouse is not in the above list, it may be compatible
1503 with one in the list.
1504 Refer to the man page for
1505 .Xr moused 8
1506 for compatibility information.
1507 .Pp
1508 It should also be noted that while this is enabled, any
1509 other client of the mouse (such as an X server) should access
1510 the mouse through the virtual mouse device:
1511 .Pa /dev/sysmouse
1512 and configure it as a sysmouse type mouse, since all
1513 mouse data is converted to this single canonical format when
1514 using
1515 .Xr moused 8 .
1516 If the client program does not support the sysmouse type,
1517 specify the mousesystems type.
1518 It is the second preferred type.
1519 .It Va moused_port
1520 .Pq Vt str
1521 If
1522 .Va moused_enable
1523 is set to
1524 .Dq YES ,
1525 this is the actual port the mouse is on.
1526 It might be
1527 .Pa /dev/cuaa0
1528 for a COM1 serial mouse,
1529 .Pa /dev/psm0
1530 for a PS/2 mouse or
1531 .Pa /dev/mse0
1532 for a bus mouse, for example.
1533 .It Va moused_flags
1534 .Pq Vt str
1535 If
1536 .Va moused_type
1537 is set, these are the additional flags to pass to the
1538 .Xr moused 8
1539 daemon.
1540 .It Va allscreens_flags
1541 .Pq Vt str
1542 If set,
1543 .Xr vidcontrol 1
1544 is run with these options for each of the virtual terminals
1545 .Pq Pa /dev/ttyv* .
1546 For example,
1547 .Dq -m on
1548 will enable the mouse pointer on all virtual terminals
1549 if
1550 .Va moused_enable
1551 is set to
1552 .Dq YES .
1553 .It Va cron_enable
1554 .Pq Vt bool
1555 If set to
1556 .Dq YES
1557 then run the
1558 .Xr cron 8
1559 daemon at system boot time.
1560 .It Va cron_program
1561 .Pq Vt str
1562 Path to
1563 .Xr cron 8
1564 (default
1565 .Pa /usr/sbin/cron ) .
1566 .It Va cron_flags
1567 .Pq Vt str
1568 If
1569 .Va cron_enable
1570 is set to
1571 .Dq YES ,
1572 these are the flags to pass to
1573 .Xr cron 8 .
1574 .It Va lpd_program
1575 .Pq Vt str
1576 Path to
1577 .Xr lpd 8
1578 (default
1579 .Pa /usr/sbin/lpd ) .
1580 .It Va lpd_enable
1581 .Pq Vt bool
1582 If set to
1583 .Dq YES
1584 then run the
1585 .Xr lpd 8
1586 daemon at system boot time.
1587 .It Va lpd_flags
1588 .Pq Vt str
1589 If
1590 .Va lpd_enable
1591 is set to
1592 .Dq YES ,
1593 these are the flags to pass to the
1594 .Xr lpd 8
1595 daemon.
1596 .It Va mta_start_script
1597 .Pq Vt str
1598 This variable specifies the full path to the script to run to start
1599 a mail transfer agent.
1600 The default is
1601 .Pa /etc/rc.sendmail .
1602 The
1603 .Va sendmail_*
1604 variables which
1605 .Pa /etc/rc.sendmail
1606 uses are documented in the
1607 .Xr rc.sendmail 8
1608 man page.
1609 .It Va dumpdev
1610 .Pq Vt str
1611 Indicates the device (usually a swap partition) to which a crash dump
1612 should be written in the event of a system crash.
1613 The value of this variable is passed as the argument to
1614 .Xr dumpon 8 .
1615 To disable crash dumps, set this variable to
1616 .Dq NO .
1617 .It Va dumpdir
1618 .Pq Vt str
1619 When the system reboots after a crash and a crash dump is found on the
1620 device specified by the
1621 .Va dumpdev
1622 variable,
1623 .Xr savecore 8
1624 will save that crash dump and a copy of the kernel to the directory
1625 specified by the
1626 .Va dumpdir
1627 variable.
1628 The default value is
1629 .Dq /var/crash .
1630 Set to
1631 .Dq NO
1632 to not run
1633 .Xr savecore 8
1634 at boot time when
1635 .Va dumpdir
1636 is set.
1637 .It Va savecore_flags
1638 .Pq Vt str
1639 If crash dumps are enabled, these are the flags to pass to the
1640 .Xr savecore 8
1641 utility.
1642 .It Va enable_quotas
1643 .Pq Vt bool
1644 Set to
1645 .Dq YES
1646 to turn on user disk quotas on system startup via the
1647 .Xr quotaon 8
1648 command.
1649 .It Va check_quotas
1650 .Pq Vt bool
1651 Set to
1652 .Dq YES
1653 to enable user disk quota checking via the
1654 .Xr quotacheck 8
1655 command.
1656 .It Va accounting_enable
1657 .Pq Vt bool
1658 Set to
1659 .Dq YES
1660 to enable system accounting through the
1661 .Xr accton 8
1662 facility.
1663 .It Va ibcs2_enable
1664 .Pq Vt bool
1665 Set to
1666 .Dq YES
1667 to enable iBCS2 (SCO) binary emulation at system initial boot
1668 time.
1669 .It Va ibcs2_loaders
1670 .Pq Vt str
1671 If not set to
1672 .Dq NO
1673 and if
1674 .Va ibcs2_enable
1675 is set to
1676 .Dq YES ,
1677 this specifies a list of additional iBCS2 loaders to enable.
1678 .It Va linux_enable
1679 .Pq Vt bool
1680 Set to
1681 .Dq YES
1682 to enable Linux/ELF binary emulation at system initial
1683 boot time.
1684 .It Va osf1_enable
1685 .Pq Vt bool
1686 Set to
1687 .Dq YES
1688 to enable OSF/1 (Digital UNIX) binary emulation at system
1689 initial boot time.
1690 (alpha)
1691 .It Va rand_irqs
1692 .Pq Vt str
1693 Set to the list of IRQs to monitor for random number creation
1694 (see the man page for
1695 .Xr rndcontrol 8 ) .
1696 .It Va clear_tmp_enable
1697 .Pq Vt bool
1698 Set to
1699 .Dq YES
1700 to have
1701 .Pa /tmp
1702 cleaned at startup.
1703 .It Va ldconfig_paths
1704 .Pq Vt str
1705 Set to the list of shared library paths to use with
1706 .Xr ldconfig 8 .
1707 NOTE:
1708 .Pa /usr/lib
1709 will always be added first, so it need not appear in this list.
1710 .It Va ldconfig_insecure
1711 .Pq Vt bool
1712 The
1713 .Xr ldconfig 8
1714 utility normally refuses to use directories
1715 which are writable by anyone except root.
1716 Set this variable to
1717 .Dq YES
1718 to disable that security check during system startup.
1719 .It Va kern_securelevel_enable
1720 .Pq Vt bool
1721 Set to
1722 .Dq YES
1723 to set the kernel security level at system startup.
1724 .It Va kern_securelevel
1725 .Pq Vt int
1726 The kernel security level to set at startup.
1727 The allowed range of
1728 .Ar value
1729 ranges from -1 (the compile time default) to 3 (the
1730 most secure).  See
1731 .Xr init 8
1732 for the list of possible security levels and their effect
1733 on system operation.
1734 .It Va start_vinum
1735 .Pq Vt bool
1736 Set to
1737 .Dq YES
1738 to start
1739 .Xr vinum 8
1740 at system boot time.
1741 .It Va sshd_program
1742 .Pq Vt str
1743 Path to the SSH server program
1744 .Pa ( /usr/sbin/sshd
1745 is the default).
1746 .It Va sshd_enable
1747 .Pq Vt bool
1748 Set to
1749 .Dq YES
1750 to start
1751 .Xr sshd 8
1752 at system boot time.
1753 .It Va sshd_flags
1754 .Pq Vt str
1755 If
1756 .Va sshd_enable
1757 is set to
1758 .Dq YES ,
1759 these are the flags to pass to the
1760 .Xr sshd 8
1761 daemon.
1762 .It Va unaligned_print
1763 .Pq Vt bool
1764 If set to
1765 .Dq NO
1766 then unaligned access warnings will not be printed.
1767 (alpha)
1768 .\" ----- isdn settings ---------------------------------
1769 .It Va isdn_enable
1770 .Pq Vt bool
1771 Set to
1772 .Dq NO
1773 by default.
1774 When set to
1775 .Dq YES ,
1776 starts the isdn daemon
1777 .Pa /usr/sbin/isdnd
1778 at system boot time.
1779 .It Va isdn_flags
1780 .Pq Vt str
1781 Set to
1782 .Dq -dn -d0x1f9
1783 by default.
1784 Additional flags to pass to
1785 .Xr isdnd 8
1786 (but see
1787 .Va isdn_fsdev
1788 and
1789 .Va isdn_ttype
1790 for certain tunable parameters).
1791 .It Va isdn_ttype
1792 .Pq Vt str
1793 Set to
1794 .Dq cons25
1795 by default.
1796 The terminal type of the output device when
1797 .Xr isdnd 8
1798 operates in fullscreen mode.
1799 .It Va isdn_screenflags
1800 .Pq Vt str
1801 Set to
1802 .Dq NO
1803 by default.
1804 The video mode for fullscreen mode (only for
1805 .Xr syscons 4
1806 console driver, see
1807 .Xr vidcontrol 1
1808 for valid modes).
1809 .It Va isdn_fsdev
1810 .Pq Vt str
1811 Set to
1812 .Dq /dev/ttyv4
1813 by default.
1814 The output device for
1815 .Xr isdnd 8
1816 in fullscreen mode (or
1817 .Dq NO
1818 for daemon mode).
1819 .It Va isdn_trace
1820 .Pq Vt bool
1821 Set to
1822 .Dq NO
1823 by default.
1824 When set to
1825 .Dq YES ,
1826 enables the ISDN protocol trace utility
1827 .Pa /usr/sbin/isdntrace
1828 at system boot time.
1829 .It Va isdn_traceflags
1830 .Pq Vt str
1831 Set to
1832 .Dq -f /var/tmp/isdntrace0
1833 by default.
1834 Flags for
1835 .Pa /usr/sbin/isdntrace .
1836 .\" -----------------------------------------------------
1837 .El
1838 .Sh FILES
1839 .Bl -tag -width /etc/defaults/rc.conf -compact
1840 .It Pa /etc/defaults/rc.conf
1841 .It Pa /etc/rc.conf
1842 .It Pa /etc/rc.conf.local
1843 .El
1844 .Sh SEE ALSO
1845 .Xr catman 1 ,
1846 .Xr gdb 1 ,
1847 .Xr info 1 ,
1848 .Xr makewhatis 1 ,
1849 .Xr vidcontrol 1 ,
1850 .Xr tcp 4 ,
1851 .Xr udp 4 ,
1852 .Xr exports 5 ,
1853 .Xr motd 5 ,
1854 .Xr accton 8 ,
1855 .Xr amd 8 ,
1856 .Xr apm 8 ,
1857 .Xr atm 8 ,
1858 .Xr cron 8 ,
1859 .Xr dhclient 8 ,
1860 .Xr gated 8 ,
1861 .Xr ifconfig 8 ,
1862 .Xr inetd 8 ,
1863 .Xr isdnd 8 ,
1864 .Xr isdntrace 8 ,
1865 .Xr lpd 8 ,
1866 .Xr mountd 8 ,
1867 .Xr moused 8 ,
1868 .Xr mrouted 8 ,
1869 .Xr named 8 ,
1870 .Xr nfsd 8 ,
1871 .Xr nfsiod 8 ,
1872 .Xr ntpd 8 ,
1873 .Xr ntpdate 8 ,
1874 .Xr pcnfsd 8 ,
1875 .Xr portmap 8 ,
1876 .Xr quotacheck 8 ,
1877 .Xr quotaon 8 ,
1878 .Xr rc 8 ,
1879 .Xr rc.sendmail 8 ,
1880 .Xr rndcontrol 8 ,
1881 .Xr route 8 ,
1882 .Xr routed 8 ,
1883 .Xr rpc.lockd 8 ,
1884 .Xr rpc.statd 8 ,
1885 .Xr rpcbind 8 ,
1886 .Xr rwhod 8 ,
1887 .Xr savecore 8 ,
1888 .Xr sshd 8 ,
1889 .Xr swapon 8 ,
1890 .Xr sysctl 8 ,
1891 .Xr syslogd 8 ,
1892 .Xr timed 8 ,
1893 .Xr vinum 8 ,
1894 .Xr vnconfig 8 ,
1895 .Xr xtend 8 ,
1896 .Xr yp 8 ,
1897 .Xr ypbind 8 ,
1898 .Xr ypserv 8 ,
1899 .Xr ypset 8
1900 .Sh HISTORY
1901 The
1902 .Nm
1903 file appeared in
1904 .Fx 2.2.2 .
1905 .Sh AUTHORS
1906 .An Jordan K. Hubbard .