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