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