1.\" $NetBSD: rc.conf.5,v 1.109 2006/10/13 21:21:47 wiz Exp $ 2.\" 3.\" Copyright (c) 1996 Matthew R. Green 4.\" Copyright (c) 1997 Curt J. Sampson 5.\" Copyright (c) 1997 Michael W. Long 6.\" Copyright (c) 1998-2002 The NetBSD Foundation, Inc. 7.\" All rights reserved. 8.\" 9.\" This document is derived from works contributed to The NetBSD Foundation 10.\" by Luke Mewburn. 11.\" 12.\" Redistribution and use in source and binary forms, with or without 13.\" modification, are permitted provided that the following conditions 14.\" are met: 15.\" 1. Redistributions of source code must retain the above copyright 16.\" notice, this list of conditions and the following disclaimer. 17.\" 2. Redistributions in binary form must reproduce the above copyright 18.\" notice, this list of conditions and the following disclaimer in the 19.\" documentation and/or other materials provided with the distribution. 20.\" 3. The name of the author may not be used to endorse or promote products 21.\" derived from this software without specific prior written permission. 22.\" 23.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR 24.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES 25.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. 26.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, 27.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, 28.\" BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; 29.\" LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED 30.\" AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, 31.\" OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 32.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 33.\" SUCH DAMAGE. 34.\" 35.Dd October 10, 2006 36.Dt RC.CONF 5 37.Os 38.Sh NAME 39.Nm rc.conf 40.Nd system startup configuration file 41.Sh DESCRIPTION 42The 43.Nm 44file specifies which services are enabled during system startup by 45the startup scripts invoked by 46.Pa /etc/rc 47(see 48.Xr rc 8 ) , 49and the shutdown scripts invoked by 50.Pa /etc/rc.shutdown . 51The 52.Nm 53file is a shell script that is sourced by 54.Xr rc 8 , 55meaning that 56.Nm 57must contain valid shell commands. 58.Pp 59Listed below are the standard 60.Nm 61variables that may be set, the values to which each may be set, 62a brief description of what each variable does, and a reference to 63relevant manual pages. 64Third party packages may test for additional variables. 65.Pp 66Most variables are one of two types: enabling variables or flags 67variables. 68Enabling variables, such as 69.Sy inetd , 70are generally named after the program or the system they enable, 71and are set to 72.Sq YES 73or 74.Sq NO . 75Flags variables, such as 76.Sy inetd_flags 77have the same name with "_flags" appended, and determine what 78arguments are passed to the program if it is enabled. 79.Pp 80If a variable that 81.Xr rc 8 82expects to be set is not set, or the value is not one of the allowed 83values, a warning will be printed. 84.Pp 85By default, 86.Nm 87reads 88.Pa /etc/defaults/rc.conf 89(if it is readable) 90to obtain default values for various variables, and the end-user 91may override these by appending appropriate entries to the end of 92.Nm . 93.Pp 94.Xr rc.d 8 95scripts that use 96.Ic load_rc_config 97from 98.Xr rc.subr 8 99also support sourcing an optional end-user provided per-script override 100file 101.Pa /etc/rc.conf.d/ Ns Ar service , 102(where 103.Ar service 104is the contents of the 105.Sy name 106variable in the 107.Xr rc.d 8 108script). 109This may contain variable overrides, including allowing the end-user 110to override various 111.Ic run_rc_command 112.Xr rc.d 8 113control variables, and thus changing the operation of the script 114without requiring editing of the script. 115.Ss Overall control 116.Bl -tag -width net_interfaces 117.It Sy do_rcshutdown 118.Sq YES 119or 120.Sq NO . 121If set to 122.Sq NO , 123.Xr shutdown 8 124will not run 125.Pa /etc/rc.shutdown . 126.It Sy rcshutdown_rcorder_flags 127A string. 128Extra arguments to the 129.Xr rcorder 8 130run by 131.Pa /etc/rc.shutdown . 132.It Sy rcshutdown_timeout 133A number. 134If non-blank, use this as the number of seconds to run a watchdog timer for 135which will terminate 136.Pa /etc/rc.shutdown 137if the timer expires before the shutdown script completes. 138.It Sy rc_configured 139.Sq YES 140or 141.Sq NO . 142If not set to 143.Sq YES 144then the system will drop into single-user mode during boot. 145.It Sy rc_fast_and_loose 146If set to a non-empty string, 147each script in 148.Pa /etc/rc.d 149will be executed in the current shell rather than a sub shell. 150This may be faster on slow machines that have an expensive 151.Xr fork 2 152operation. 153.Bl -hang 154.It Em Note : 155Use this at your own risk! 156A rogue command or script may inadvertently prevent boot to multiuser. 157.El 158.It Sy rc_rcorder_flags 159A string. 160Extra arguments to the 161.Xr rcorder 8 162run by 163.Pa /etc/rc . 164.El 165.Ss Basic network configuration 166.Bl -tag -width net_interfaces 167.It Sy defaultroute 168A string. 169Default IPv4 network route. 170If empty or not set, then the contents of 171.Pa /etc/mygate 172(if it exists) are used. 173.It Sy defaultroute6 174A string. 175Default IPv6 network route. 176If empty or not set, then the contents of 177.Pa /etc/mygate6 178(if it exists) are used. 179.It Sy domainname 180A string. 181.Tn NIS 182(YP) domain of host. 183If empty or not set, then the contents of 184.Pa /etc/defaultdomain 185(if it exists) are used. 186.It Sy force_down_interfaces 187A space separated list of interface names. 188These interfaces will be configured down when going from multiuser to singleuser 189mode or on system shutdown. 190.Pp 191This is important for some stateful interfaces, for example PPP over ISDN 192connections that cost money by connection time or PPPoE interfaces which 193have no direct means of noticing 194.Dq disconnect 195events. 196.Pp 197All active 198.Xr pppoe 4 199and 200.Xr ippp 4 201interfaces will be automatically added to this list. 202.It Sy hostname 203A string. 204Name of host. 205If empty or not set, then the contents of 206.Pa /etc/myname 207(if it exists) are used. 208.El 209.Ss Boottime file-system and swap configuration 210.Bl -tag -width net_interfaces 211.It Sy critical_filesystems_local 212A string. 213File systems mounted very early in the system boot before networking 214services are available. 215Usually 216.Pa /var 217is part of this, because it is needed by services such as 218.Xr dhclient 8 219which may be required to get the network operational. 220.It Sy critical_filesystems_remote 221A string. 222File systems such as 223.Pa /usr 224that may require network services to be available to mount, 225that must be available early in the system boot for general services to use. 226.It Sy fsck_flags 227A string. 228A file system is checked with 229.Xr fsck 8 230during boot before mounting it. 231This option may be used to override the default command-line options 232passed to the 233.Xr fsck 8 234program. 235.Pp 236When set to 237.Fl y , 238.Xr fsck 8 239assumes yes as the answer to all operator questions during file system checks. 240This might be important with hosts where the administrator does not have 241access to the console and an unsuccessful shutdown must not make the host 242unbootable even if the file system checks would fail in preen mode. 243.It Sy no_swap 244.Sq YES 245or 246.Sq NO . 247Set the 248.Sy no_swap 249variable to 250.Sq YES 251if you have configured your system with no swap on purpose. 252If not set to 253.Sq YES , 254and no swap devices 255are configured, the system will warn you. 256.It Sy swapoff 257.Sq YES 258or 259.Sq NO . 260Remove block-type swap devices at shutdown time. 261Useful if swapping onto RAIDframe devices. 262.El 263.Ss One-time actions to perform or programs to run on boot-up 264.Bl -tag -width net_interfaces 265.It Sy accounting 266.Sq YES 267or 268.Sq NO . 269Enables process accounting with 270.Xr accton 8 . 271Requires 272.Pa /var/account/acct 273to exist. 274.It Sy clear_tmp 275.Sq YES 276or 277.Sq NO . 278Clear /tmp after reboot. 279.It Sy dmesg 280.Sq YES 281or 282.Sq NO . 283Create 284.Pa /var/run/dmesg.boot 285from the output of 286.Xr dmesg 8 . 287Passes 288.Sy dmesg_flags . 289.It Sy lkm 290.Sq YES 291or 292.Sq NO . 293Runs 294.Pa /etc/rc.lkm . 295.It Sy mixerctl 296.Sq YES 297or 298.Sq NO . 299Read 300.Xr mixerctl.conf 5 301for how to set mixer values. 302List in 303.Sy mixerctl_mixers 304the devices whose settings are to be saved at shutdown and 305restored at start-up. 306.It Sy newsyslog 307.Sq YES 308or 309.Sq NO . 310Run 311.Nm newsyslog 312to trim logfiles before syslogd starts. 313Intended for laptop users. 314Passes 315.Sy newsyslog_flags . 316.It Sy savecore 317.Sq YES 318or 319.Sq NO . 320Runs the 321.Xr savecore 8 322utility. 323Passes 324.Sy savecore_flags . 325The directory where crash dumps are stored is specified by 326.Sy savecore_dir . 327The default setting is 328.Dq Pa /var/crash . 329.It Sy tpctl 330.Sq YES 331or 332.Sq NO . 333Run 334.Xr tpctl 8 335to calibrate touch panel device. 336Passes 337.Sy tpctl_flags . 338.It Sy update_motd 339.Sq YES 340or 341.Sq NO . 342Updates the 343.Nx 344version string in the 345.Pa /etc/motd 346file to reflect the version of the running kernel. 347See 348.Xr motd 5 . 349.It Sy veriexec 350.Sq YES 351or 352.Sq NO . 353Load Veriexec fingerprints during startup. 354Read 355.Xr veriexecctl 8 356for more information. 357.It Sy virecover 358.Sq YES 359or 360.Sq NO . 361Send notification mail to users if any recoverable files exist in 362.Pa /var/tmp/vi.recover . 363Read 364.Xr virecover 8 365for more information. 366.El 367.Ss System security setting 368.Bl -tag -width net_interfaces 369.It Sy securelevel 370A number. 371The system securelevel is set to the specified value early 372in the boot process, before any external logins, or other programs 373that run users job, are started. 374If set to nothing, the default action is taken, as described in 375.Xr init 8 , 376which contains definitive information about the system securelevel. 377Note that setting 378.Sy securelevel 379to 0 in 380.Nm 381will actually result in the system booting with securelevel set to 1, as 382.Xr init 8 383will raise the level when 384.Xr rc 8 385completes. 386.It Sy permit_nonalpha 387Allow passwords to include non-alpha characters, usually to allow 388NIS/YP netgroups. 389.It Sy veriexec_strict 390A number. 391Controls the strict level of Veriexec. 392Level 0 is learning mode, used when building the signatures file. 393It will only output messages but will not enforce anything. 394Level 1 will only prevent access to files with a fingerprint 395mismatch. 396Level 2 will also deny writing to and removing of 397monitored files, as well as enforce access type (as specified in 398the signatures file). 399Level 3 will take a step further and prevent 400access to files that are not monitored. 401.It Sy veriexec_verbose 402A number. 403Controls the verbosity of Veriexec. 404Recommended operation is at level 0, verbose output (mostly used when 405building the signatures file) is at level 1. 406Level 2 is for debugging only and should not be used. 407.El 408.Ss Networking startup 409.Bl -tag -width net_interfaces 410.It Sy altqd 411.Sq YES 412or 413.Sq NO . 414ALTQ configuration/monitoring daemon. 415Passes 416.Sy altqd_flags . 417.It Sy auto_ifconfig 418.Sq YES 419or 420.Sq NO . 421Sets the 422.Sy net_interfaces 423variable (see below) to the output of 424.Xr ifconfig 8 425with the 426.Dq Li -l 427flag and suppresses warnings about interfaces in this list that 428do not have an ifconfig file or variable. 429.It Sy dhclient 430.Sq YES 431or 432.Sq NO . 433Set to 434.Sq YES 435to configure some or all network interfaces using 436the DHCP client. 437If you set 438.Sy dhclient 439to 440.Sq YES , 441you must either have 442.Pa /var 443in 444.Sy critical_filesystems_local , 445as part of 446.Pa / , 447or direct the DHCP client to store the leases file on the root 448file system by modifying the 449.Sy dhclient_flags 450variable. 451You must not provide ifconfig information or ifaliases 452information for any interface that is to be configured using the DHCP client. 453Interface aliases can be set up in the DHCP client configuration 454file if needed - see 455.Xr dhclient.conf 5 456for details. 457.Pp 458Passes 459.Sy dhclient_flags 460to the DHCP client. 461See 462.Xr dhclient 8 463for complete documentation. 464If you wish to configure all broadcast 465network interfaces using the DHCP client, you can leave this blank. 466To configure only specific interfaces, name the interfaces to be configured 467on the command line. 468.Pp 469If you must run the DHCP client before mounting critical file systems, 470then you should specify an alternate location for the DHCP client's lease 471file in the 472.Sy dhclient_flags 473variable - for example, "-lf /tmp/dhclient.leases". 474.It Sy flushroutes 475.Sq YES 476or 477.Sq NO . 478Flushes the route table on networking startup. 479Useful when coming up to multiuser mode after going down to 480single-user mode. 481.It Sy hostapd 482.Sq YES 483or 484.Sq NO . 485Runs 486.Xr hostapd 8 , 487the authenticator for IEEE 802.11 networks. 488.It Sy ifaliases_* 489A string. 490List of 491.Sq Em "address netmask" 492pairs to configure additional network addresses for the given 493configured interface 494.Dq * 495(e.g. 496.Sy ifaliases_le0 ) . 497If 498.Em netmask 499is 500.Dq - , 501then use the default netmask for the interface. 502.Pp 503.Sy ifaliases_* 504covers limited cases only and considered unrecommended. 505We recommend using 506.Pa /etc/ifconfig.xxN 507with multiple lines instead. 508.It Sy ifwatchd 509.Sq YES 510or 511.Sq NO . 512Monitor dynamic interfaces and perform actions upon address changes. 513Passes 514.Sy ifwatchd_flags . 515.It Sy ip6mode 516A string. 517An IPv6 node can be a router 518.Pq nodes that forward packet for others 519or a host 520.Pq nodes that do not forward . 521A host can be autoconfigured 522based on the information advertised by adjacent IPv6 routers. 523By setting 524.Sy ip6mode 525to 526.Dq Li router , 527.Dq Li host , 528or 529.Dq Li autohost , 530you can configure your node as a router, 531a non-autoconfigured host, or an autoconfigured host. 532Invalid values will be ignored, and the node will be configured as 533a non-autoconfigured host. 534You may want to check 535.Sy rtsol 536and 537.Sy rtsold 538as well, if you set the variable to 539.Dq Li autohost . 540.It Sy ip6uniquelocal 541.Sq YES 542or 543.Sq NO . 544If 545.Sy ip6mode 546is equal to 547.Dq Li router 548and 549.Sy ip6uniquelocal 550is set to 551.Sq NO 552a reject route will be installed on boot to avoid misconfiguration relating 553to unique-local addresses. 554If set to 555.Sq YES 556the reject route won't be installed. 557.It Sy ipfilter 558.Sq YES 559or 560.Sq NO . 561Runs 562.Xr ipf 8 563to load in packet filter specifications from 564.Pa /etc/ipf.conf 565at network boot time, before any interfaces are configured. 566See 567.Xr ipf.conf 5 . 568.It Sy ipfs 569.Sq YES 570or 571.Sq NO . 572Runs 573.Xr ipfs 8 574to save and restore information for ipnat and ipfilter state tables. 575The information is stored in 576.Pa /var/db/ipf/ipstate.ipf 577and 578.Pa /var/db/ipf/ipnat.ipf . 579Passes 580.Sy ipfs_flags . 581.It Sy ipmon 582.Sq YES 583or 584.Sq NO . 585Runs 586.Xr ipmon 8 587to read 588.Xr ipf 8 589packet log information and log it to a file or the system log. 590Passes 591.Sy ipmon_flags . 592.It Sy ipmon_flags 593A string. 594Specifies arguments to supply to 595.Xr ipmon 8 . 596Defaults to 597.Dq Li -ns . 598A typical example would be 599.Dq Fl nD Pa /var/log/ipflog 600to have 601.Xr ipmon 8 602log directly to a file bypassing 603.Xr syslogd 8 . 604If the 605.Dq -D 606argument is used, remember to modify 607.Pa /etc/newsyslog.conf 608accordingly; for example: 609.Bd -literal 610/var/log/ipflog 640 10 100 * Z /var/run/ipmon.pid 611.Ed 612.It Sy ipnat 613.Sq YES 614or 615.Sq NO . 616Runs 617.Xr ipnat 8 618to load in the IP network address translation (NAT) rules from 619.Pa /etc/ipnat.conf 620at network boot time, before any interfaces are configured. 621See 622.Xr ipnat.conf 5 . 623.It Sy ipsec 624.Sq YES 625or 626.Sq NO . 627Runs 628.Xr setkey 8 629to load in IPsec manual keys and policies from 630.Pa /etc/ipsec.conf 631at network boot time, before any interfaces are configured. 632.It Sy net_interfaces 633A string. 634The list of network interfaces to be configured at boot time. 635For each interface "xxN", the system first looks for ifconfig 636parameters in 637.Pa /etc/ifconfig.xxN 638and then in the variable 639.Sy ifconfig_xxN . 640The contents of the file or the variable are handed to ifconfig 641after the interface name. 642If 643.Sy auto_ifconfig 644is set to "NO" and neither the file nor the variable is found, 645a warning is printed. 646Refer to 647.Xr ifconfig.if 5 648for more details on 649.Pa /etc/ifconfig.xxN . 650.It Sy ntpdate 651.Sq YES 652or 653.Sq NO . 654Runs 655.Xr ntpdate 8 656to set the system time from one of the hosts in 657.Sy ntpdate_hosts . 658If 659.Sy ntpdate_hosts 660is empty, it will attempt to find a list of hosts in 661.Pa /etc/ntp.conf . 662Passes 663.Sy ntpdate_flags . 664.It Sy ppp_peers 665A string. 666If 667.Sy ppp_peers 668is not empty, then 669.Pa /etc/rc.d/ppp 670will check each word in 671.Sy ppp_peers 672for a corresponding ppp configuration file in 673.Pa /etc/ppp/peers 674and will call 675.Xr pppd 8 676with the 677.Dq call Sy peer 678option. 679.It Sy racoon 680.Sq YES 681or 682.Sq NO . 683Runs 684.Xr racoon 8 , 685the IKE (ISAKMP/Oakley) key management daemon. 686.It Sy rtsol 687.Sq YES 688or 689.Sq NO . 690Run 691.Xr rtsol 8 , 692router solicitation command for IPv6 hosts. 693On nomadic hosts like notebook computers, you may want to enable 694.Sy rtsold 695as well. 696Passes 697.Sy rtsol_flags . 698This is only for autoconfigured IPv6 hosts, so set 699.Sy ip6mode 700to 701.Dq Li autohost 702if you use it. 703.El 704.Ss Daemons required by other daemons 705.Bl -tag -width net_interfaces 706.It Sy inetd 707.Sq YES 708or 709.Sq NO . 710Runs the 711.Xr inetd 8 712daemon to start network server processes (as listed in 713.Pa /etc/inetd.conf ) 714as necessary. 715Passes 716.Sy inetd_flags . 717The 718.Dq Li -l 719flag turns on libwrap connection logging. 720.It Sy rpcbind 721.Sq YES 722or 723.Sq NO . 724The 725.Xr rpcbind 8 726daemon is required for any 727.Xr rpc 3 728services. 729These include NFS, 730.Tn NIS , 731.Xr bootparamd 8 , 732.Xr rstatd 8 , 733.Xr rusersd 8 , 734and 735.Xr rwalld 8 . 736Passes 737.Sy rpcbind_flags . 738.El 739.Ss Commonly used daemons 740.Bl -tag -width net_interfaces 741.It Sy cron 742.Sq YES 743or 744.Sq NO . 745Run 746.Xr cron 8 . 747.It Sy lpd 748.Sq YES 749or 750.Sq NO . 751Runs 752.Xr lpd 8 753and passes 754.Sy lpd_flags . 755The 756.Dq Li -l 757flag will turn on extra logging. 758.It Sy named 759.Sq YES 760or 761.Sq NO . 762Runs 763.Xr named 8 764and passes 765.Sy named_flags . 766.It Sy named_chrootdir 767A string. 768If non-blank and 769.Sy named 770is 771.Sq YES , 772run 773.Xr named 8 774as the unprivileged user and group 775.Sq named , 776.Xr chroot 2 Ns ed 777to 778.Sy named_chrootdir . 779.Sy named_chrootdir Ns Pa /var/run/log 780will be added to the list of log sockets that 781.Xr syslogd 8 782listens to. 783.It Sy ntpd 784.Sq YES 785or 786.Sq NO . 787Runs 788.Xr ntpd 8 789and passes 790.Sy ntpd_flags . 791.It Sy ntpd_chrootdir 792A string. 793If non-blank and 794.Sy ntpd 795is 796.Sq YES , 797run 798.Xr ntpd 8 799as the unprivileged user and group 800.Sq ntpd , 801.Xr chroot 2 Ns ed 802to 803.Sy ntpd_chrootdir . 804.Sy ntpd_chrootdir Ns Pa /var/run/log 805will be added to the list of log sockets that 806.Xr syslogd 8 807listens to. 808This option requires that the kernel has 809.Dl pseudo-device clockctl 810compiled in, and that 811.Pa /dev/clockctl 812is present. 813.It Sy postfix 814.Sq YES 815or 816.Sq NO . 817Starts 818.Xr postfix 1 819mail system. 820.It Sy sshd 821.Sq YES 822or 823.Sq NO . 824Runs 825.Xr sshd 8 826and passes 827.Sy sshd_flags . 828.It Sy syslogd 829.Sq YES 830or 831.Sq NO . 832Runs 833.Xr syslogd 8 834and passes 835.Sy syslogd_flags . 836.It Sy timed 837.Sq YES 838or 839.Sq NO . 840Runs 841.Xr timed 8 842and passes 843.Sy timed_flags . 844The 845.Dq Li -M 846option allows 847.Xr timed 8 848to be a master time source as well as a slave. 849If you are also running 850.Xr ntpd 8 , 851only one machine running both should have the 852.Dq Li -M 853flag given to 854.Xr timed 8 . 855.El 856.Ss Routing daemons 857.Bl -tag -width net_interfaces 858.It Sy mrouted 859.Sq YES 860or 861.Sq NO . 862Runs 863.Xr mrouted 8 , 864the DVMRP multicast routing protocol daemon. 865Passes 866.Sy mrouted_flags . 867.It Sy route6d 868.Sq YES 869or 870.Sq NO . 871Runs 872.Xr route6d 8 , 873the RIPng routing protocol daemon for IPv6. 874Passes 875.Sy route6d_flags . 876.It Sy routed 877.Sq YES 878or 879.Sq NO . 880Runs 881.Xr routed 8 , 882the RIP routing protocol daemon. 883Passes 884.Sy routed_flags . 885.\" This should be 886.\" .Sq NO 887.\" if 888.\" .Sy gated 889.\" is 890.\" .Sq YES . 891.It Sy rtsold 892.Sq YES 893or 894.Sq NO . 895Runs 896.Xr rtsold 8 , 897the IPv6 router solicitation daemon. 898.Xr rtsold 8 899periodically transmits router solicitation packets 900to find IPv6 routers on the network. 901This configuration is mainly for nomadic hosts like notebook computers. 902Stationary hosts should work fine with just 903.Sy rtsol . 904Passes 905.Sy rtsold_flags . 906This is only for autoconfigured IPv6 hosts, so set 907.Sy ip6mode 908to 909.Dq Li autohost 910if you use it. 911.El 912.Ss Daemons used to boot other hosts over a network 913.Bl -tag -width net_interfaces 914.It Sy bootparamd 915.Sq YES 916or 917.Sq NO . 918Runs 919.Xr bootparamd 8 , 920the boot parameter server, with 921.Sy bootparamd_flags 922as options. 923Used to boot 924.Nx 925and 926.Tn "SunOS 4.x" 927systems. 928.It Sy dhcpd 929.Sq YES 930or 931.Sq NO . 932Runs 933.Xr dhcpd 8 , 934the Dynamic Host Configuration Protocol (DHCP) daemon, 935for assigning IP addresses to hosts and passing boot information. 936Passes 937.Sy dhcpd_flags . 938.It Sy dhcrelay 939.Sq YES 940or 941.Sq NO . 942Runs 943.Xr dhcrelay 8 . 944Passes 945.Sy dhcrelay_flags . 946.It Sy mopd 947.Sq YES 948or 949.Sq NO . 950Runs 951.Xr mopd 8 , 952the 953.Tn DEC 954.Tn MOP 955protocol daemon; used for booting 956.Tn VAX 957and other 958.Tn DEC 959machines. 960Passes 961.Sy mopd_flags . 962.It Sy ndbootd 963.Sq YES 964or 965.Sq NO . 966Runs 967.Xr ndbootd 8 , 968the Sun Network Disk (ND) Protocol server. 969Passes 970.Sy ndbootd_flags . 971.It Sy rarpd 972.Sq YES 973or 974.Sq NO . 975Runs 976.Xr rarpd 8 , 977the reverse ARP daemon, often used to boot 978.Nx 979and Sun workstations. 980Passes 981.Sy rarpd_flags . 982.It Sy rbootd 983.Sq YES 984or 985.Sq NO . 986Runs 987.Xr rbootd 8 , 988the 989.Tn HP 990boot protocol daemon; used for booting 991.Tn HP 992workstations. 993Passes 994.Sy rbootd_flags . 995.It Sy rtadvd 996.Sq YES 997or 998.Sq NO . 999Runs 1000.Xr rtadvd 8 , 1001the IPv6 router advertisement daemon, which is used to advertise 1002information about the subnet to IPv6 end hosts. 1003Passes 1004.Sy rtadvd_flags . 1005This is only for IPv6 routers, so set 1006.Sy ip6mode 1007to 1008.Dq Li router 1009if you use it. 1010.El 1011.Ss X Window System daemons 1012.Bl -tag -width net_interfaces 1013.It Sy xdm 1014.Sq YES 1015or 1016.Sq NO . 1017Runs the 1018.Xr xdm 1 1019X display manager. 1020These X daemons are available only with the optional X distribution of 1021.Nx . 1022.It Sy xfs 1023.Sq YES 1024or 1025.Sq NO . 1026Runs the 1027.Xr xfs 1 1028X11 font server, which supplies local X font files to X terminals. 1029.El 1030.Ss NIS (YP) daemons 1031.Bl -tag -width net_interfaces 1032.It Sy ypbind 1033.Sq YES 1034or 1035.Sq NO . 1036Runs 1037.Xr ypbind 8 , 1038which lets 1039.Tn NIS 1040(YP) clients use information from a 1041.Tn NIS 1042server. 1043Passes 1044.Sy ypbind_flags . 1045.It Sy yppasswdd 1046.Sq YES 1047or 1048.Sq NO . 1049Runs 1050.Xr yppasswdd 8 , 1051which allows remote 1052.Tn NIS 1053users to update password on master server. 1054Passes 1055.Sy yppasswdd_flags . 1056.It Sy ypserv 1057.Sq YES 1058or 1059.Sq NO . 1060Runs 1061.Xr ypserv 8 , 1062the 1063.Tn NIS 1064(YP) server for distributing information from certain files in 1065.Pa /etc . 1066Passes 1067.Sy ypserv_flags . 1068The 1069.Dq Li -d 1070flag causes it to use DNS for lookups in 1071.Pa /etc/hosts 1072that fail. 1073.El 1074.Ss NFS daemons and parameters 1075.Bl -tag -width net_interfaces 1076.It Sy amd 1077.Sq YES 1078or 1079.Sq NO . 1080Runs 1081.Xr amd 8 , 1082the automounter daemon, which automatically mounts NFS file systems 1083whenever a file or directory within that file system is accessed. 1084Passes 1085.Sy amd_flags . 1086.It Sy amd_dir 1087A string. 1088The 1089.Xr amd 8 1090mount directory. 1091Used only if 1092.Sy amd 1093is set to 1094.Sq YES . 1095.It Sy lockd 1096.Sq YES 1097or 1098.Sq NO . 1099Runs 1100.Xr rpc.lockd 8 1101if 1102.Sy nfs_server 1103and/or 1104.Sy nfs_client 1105are set to 1106.Sq YES . 1107Passes 1108.Sy lockd_flags . 1109.It Sy mountd 1110.Sq YES 1111or 1112.Sq NO . 1113Runs 1114.Xr mountd 8 1115and passes 1116.Sy mountd_flags . 1117.It Sy nfs_client 1118.Sq YES 1119or 1120.Sq NO . 1121The number of local NFS asynchronous I/O server is now controlled via 1122.Xr sysctl 8 . 1123.It Sy nfs_server 1124.Sq YES 1125or 1126.Sq NO . 1127Sets up a host to be a NFS server by running 1128.Xr nfsd 8 1129and passing 1130.Sy nfsd_flags . 1131.It Sy statd 1132.Sq YES 1133or 1134.Sq NO . 1135Runs 1136.Xr rpc.statd 8 , 1137a status monitoring daemon used when 1138.Xr rpc.lockd 8 1139is running, if 1140.Sy nfs_server 1141and/or 1142.Sy nfs_client 1143are set to 1144.Sq YES . 1145Passes 1146.Sy statd_flags . 1147.El 1148.Ss Bluetooth configuration and daemons 1149.Bl -tag -width net_interfaces 1150.It Sy btconfig 1151.Sq YES 1152or 1153.Sq NO . 1154Configure bluetooth devices. 1155If the 1156.Sy btconfig_devices 1157variable below is not specified, all devices known to the system 1158will be configured. 1159For each device, configuration arguments are first looked for 1160in the 1161.Sy btconfig_{dev} 1162variable, otherwise the value of the 1163.Sy btconfig_args 1164variable will be used, and if that is not specified the default string is 1165.Sq enable . 1166.It Sy btconfig_devices 1167An optional space separated list of bluetooth devices to be configured at 1168boot time. 1169.It Sy btconfig_args 1170An optional string, containing default arguments for bluetooth devices to 1171be configured. 1172.It Sy btdevctl 1173.Sq YES 1174or 1175.Sq NO . 1176Configure Bluetooth devices as listed in the configuration file 1177.Pa /etc/bluetooth/btdevctl.conf . 1178.It Sy bthcid 1179.Sq YES 1180or 1181.Sq NO . 1182Runs 1183.Xr bthcid 8 , 1184the Bluetooth HCI daemon, which manages link keys and PIN codes for 1185Bluetooth links. 1186Passes 1187.Sy bthcid_flags . 1188.It Sy sdpd 1189.Sq YES 1190or 1191.Sq NO . 1192Runs the Service Discovery Profile daemon, 1193.Xr sdpd 8 . 1194.It Sy sdpd_control 1195Optional string specifying the path to the 1196.Xr sdpd 8 1197control socket. 1198Defaults to 1199.Pa /var/run/sdp . 1200.It Sy sdpd_username 1201Optional string specifying the username that 1202.Xr sdpd 8 1203will run as after initialisation. 1204Defaults to 1205.Sq nobody . 1206.It Sy sdpd_groupname 1207Optional string specifying the groupname that 1208.Xr sdpd 8 1209will run as after initialisation. 1210Defaults to 1211.Sq nobody . 1212.El 1213.Ss Other daemons 1214.Bl -tag -width net_interfaces 1215.It Sy isdnd 1216.Sq YES 1217or 1218.Sq NO . 1219Runs 1220.Xr isdnd 8 , 1221the isdn4bsd ISDN connection management daemon. 1222Passes 1223.Sy isdnd_flags . 1224.It Sy isdn_autoupdown 1225.Sq YES 1226or 1227.Sq NO . 1228Set all configured ISDN interfaces to 1229.Dq up . 1230If 1231.Sy isdn_interfaces 1232is not blank, only the listed interfaces will be modified. 1233Used only if 1234.Sy isdnd 1235is set to 1236.Sq YES . 1237.It Sy kdc 1238.Sq YES 1239or 1240.Sq NO . 1241Runs the 1242.Xr kdc 8 1243Kerberos v4 and v5 server. 1244This should be run on Kerberos master and slave servers. 1245.It Sy rwhod 1246.Sq YES 1247or 1248.Sq NO . 1249Runs 1250.Xr rwhod 8 1251to support the 1252.Xr rwho 1 1253and 1254.Xr ruptime 1 1255commands. 1256.El 1257.Ss Hardware daemons 1258.Bl -tag -width net_interfaces 1259.It Sy apmd 1260.Sq YES 1261or 1262.Sq NO . 1263Runs 1264.Xr apmd 8 1265and passes 1266.Sy apmd_flags . 1267.It Sy irdaattach 1268.Sq YES 1269or 1270.Sq NO . 1271Runs 1272.Xr irdaattach 8 1273and passes 1274.Sy irdaattach_flags . 1275.It Sy moused 1276.Sq YES 1277or 1278.Sq NO . 1279Runs 1280.Xr moused 8 , 1281to pass serial mouse data to the wscons mouse mux. 1282Passes 1283.Sy moused_flags . 1284.It Sy poffd 1285.Sq YES 1286or 1287.Sq NO . 1288Runs 1289.Xr poffd 8 1290x68k shutdown daemon 1291(only for 1292.Nx Ns /x68k ) . 1293Passes 1294.Sy poffd_flags . 1295.It Sy screenblank 1296.Sq YES 1297or 1298.Sq NO . 1299Runs 1300.Xr screenblank 1 1301and passes 1302.Sy screenblank_flags . 1303.It Sy wscons 1304.Sq YES 1305or 1306.Sq NO . 1307Configures the 1308.Xr wscons 4 1309console driver, from the configuration file 1310.Pa /etc/wscons.conf . 1311.It Sy wsmoused 1312.Sq YES 1313or 1314.Sq NO . 1315Runs 1316.Xr wsmoused 8 , 1317to provide copy and paste text support in wscons displays. 1318Passes 1319.Sy wsmoused_flags . 1320.El 1321.Sh FILES 1322.Bl -tag -width /etc/defaults/rc.conf -compact 1323.It Pa /etc/rc.conf 1324The file 1325.Nm 1326resides in 1327.Pa /etc . 1328.It Pa /etc/defaults/rc.conf 1329Default settings for 1330.Nm , 1331sourced by 1332.Nm 1333before the end-user configuration section. 1334.It Pa /etc/rc.conf.d/ Ns Ar foo 1335.Ar foo Ns No -specific 1336.Nm 1337overrides. 1338.El 1339.Sh SEE ALSO 1340.Xr boot 8 , 1341.Xr rc 8 , 1342.Xr rc.d 8 , 1343.Xr rc.subr 8 , 1344.Xr rcorder 8 1345.Sh HISTORY 1346The 1347.Nm 1348file appeared in 1349.Nx 1.3 . 1350