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 November 9, 2004 28.Dt RC.CONF 5 29.Os 30.Sh NAME 31.Nm rc.conf 32.Nd system configuration information 33.Sh DESCRIPTION 34The file 35.Nm 36contains descriptive information about the local host name, configuration 37details for any potential network interfaces and which services should be 38started up at system initial boot time. 39In new installations, the 40.Nm 41file is generally initialized by the system installation utility, 42.Xr sysinstall 8 . 43.Pp 44The purpose of 45.Nm 46is not to run commands or perform system startup actions 47directly. 48Instead, it is included by the 49various generic startup scripts in 50.Pa /etc 51which conditionalize their 52internal actions according to the settings found there. 53.Pp 54The 55.Pa /etc/rc.conf 56file is included from the file 57.Pa /etc/defaults/rc.conf , 58which specifies the default settings for all the available options. 59Options need only be specified in 60.Pa /etc/rc.conf 61when the system administrator wishes to override these defaults. 62The file 63.Pa /etc/rc.conf.local 64is used to override settings in 65.Pa /etc/rc.conf 66for historical reasons. 67See the 68.Va rc_conf_files 69variable below. 70.Pp 71The following list provides a name and short description for each 72variable that can be set in the 73.Nm 74file: 75.Bl -tag -width indent-two 76.It Va rc_debug 77.Pq Vt bool 78If set to 79.Dq Li YES , 80enable output of debug messages from rc scripts. 81This variable can be helpful in diagnosing mistakes when 82editing or integrating new scripts. 83Beware that this produces copious output to the terminal and 84.Xr syslog 3 . 85.It Va rc_info 86.Pq Vt bool 87If set to 88.Dq Li NO , 89disable informational messages from the rc scripts. 90Informational messages are displayed when 91a condition that is not serious enough to warrant a warning or 92an error occurs. 93.It Va swapfile 94.Pq Vt str 95If set to 96.Dq Li NO , 97no swapfile is installed, otherwise the value is used as the full 98pathname to a file to use for additional swap space. 99.It Va apm_enable 100.Pq Vt bool 101If set to 102.Dq Li YES , 103enable support for Automatic Power Management with 104the 105.Xr apm 8 106command. 107.It Va apmd_enable 108.Pq Vt bool 109Run 110.Xr apmd 8 111to handle APM event from userland. 112This also enables support for APM. 113.It Va apmd_flags 114.Pq Vt str 115If 116.Va apmd_enable 117is set to 118.Dq Li YES , 119these are the flags to pass to the 120.Xr apmd 8 121daemon. 122.It Va devd_enable 123.Pq Vt bool 124Run 125.Xr devd 8 126to handle device added, removed or unknown events from the kernel. 127.It Va kldxref_enable 128.Pq Vt bool 129Set to 130.Dq Li NO 131by default. 132Set to 133.Dq Li YES 134to automatically rebuild 135.Pa linker.hints 136files with 137.Xr kldxref 8 138at boot time. 139.It Va kldxref_clobber 140.Pq Vt bool 141Set to 142.Dq Li NO 143by default. 144If 145.Va kldxref_enable 146is true, 147setting to 148.Dq Li YES 149will overwrite existing 150.Pa linker.hints 151files at boot time. 152Otherwise, 153only missing 154.Pa linker.hints 155files are generated. 156.It Va kldxref_module_path 157.Pq Vt str 158Empty by default. 159A semi-colon 160.Pq Ql \&; 161delimited list of paths containing 162.Xr kld 4 163modules. 164If empty, 165the contents of the 166.Va kern.module_path 167.Xr sysctl 8 168are used. 169.It Va pccard_enable 170.Pq Vt bool 171If set to 172.Dq Li YES , 173enable PCCARD support at boot time. 174.It Va pccard_mem 175.Pq Vt str 176Set to PCCARD controller memory address or 177.Dq Li DEFAULT 178for the default value. 179.It Va pccard_ifconfig 180.Pq Vt str 181List of arguments to be passed to 182.Xr ifconfig 8 183at boot time or on 184insertion of the card (e.g.\& 185.Dq Cm inet Li 192.168.1.1 Cm netmask Li 255.255.255.0 186for a fixed address or 187.Dq Li DHCP 188for a DHCP client). 189.It Va pccard_beep 190.Pq Vt int 191If 0, 192set the PCCARD controller to silent mode. 193If 1, 194set it to beep mode. 195If 2, 196set it to melody mode. 197.It Va pccard_conf 198.Pq Vt str 199Path to the configuration file for the 200.Xr pccardd 8 201daemon (e.g.\& 202.Pa /etc/pccard.conf.sample ) . 203.It Va pccardd_flags 204.Pq Vt str 205If 206.Va pccard_enable 207is set to 208.Dq Li YES , 209these are the flags to pass to the 210.Xr pccardd 8 211daemon. 212.It Va pccard_ether_delay 213.Pq Vt str 214Set the delay before starting 215.Xr dhclient 8 216in the 217.Pa /etc/pccard_ether 218script. 219This defaults to 5 seconds to work around a bug in the 220.Xr ed 4 221driver which can lead to system hangs when using some newer 222.Xr ed 4 223based cards. 224.It Va removable_interfaces 225.Pq Vt str 226List of removable network interfaces to be supported by 227.Pa /etc/pccard_ether . 228.It Va tmpmfs 229Controls the creation of a 230.Pa /tmp 231memory file system. 232Always happens if set to 233.Dq Li YES 234and never happens if set to 235.Dq Li NO . 236If set to anything else, a memory file system is created if 237.Pa /tmp 238is not writable. 239.It Va tmpsize 240Controls the size of a created 241.Pa /tmp 242memory file system. 243.It Va tmpmfs_flags 244Extra options passed to the 245.Xr mdmfs 8 246utility when the memory file system for 247.Pa /tmp 248is created. 249The default is 250.Dq Li -S , 251which inhibits the use of softupdates on 252.Pa /tmp 253to waste as little space as possible. 254See 255.Xr mdmfs 8 256for other options you can use in 257.Va tmpmfs_flags . 258.It Va varmfs 259Controls the creation of a 260.Pa /var 261memory file system. 262Always happens if set to 263.Dq Li YES 264and never happens if set to 265.Dq Li NO . 266If set to anything else, a memory file system is created if 267.Pa /var 268is not writable. 269.It Va varsize 270Controls the size of a created 271.Pa /var 272memory file system. 273.It Va varmfs_flags 274Extra options passed to the 275.Xr mdmfs 8 276utility when the memory file system for 277.Pa /var 278is created. 279The default is 280.Dq Li -S , 281which inhibits the use of softupdates on 282.Pa /var 283to waste as little space as possible. 284See 285.Xr mdmfs 8 286for other options you can use in 287.Va varmfs_flags . 288.It Va populate_var 289Controls the automatic population of the 290.Pa /var 291file system. 292Always happens if set to 293.Dq Li YES 294and never happens if set to 295.Dq Li NO . 296If set to anything else, a memory file system is created if 297.Pa /var 298is not writable. 299Note that this process requires access to certain commands in 300.Pa /usr 301before 302.Pa /usr 303is mounted on normal systems. 304.It Va local_startup 305.Pq Vt str 306List of directories to search for startup script files. 307.It Va script_name_sep 308.Pq Vt str 309The field separator to use for breaking down the list of startup script files 310into individual filenames. 311The default is a space. 312It is not necessary to change this unless there are startup scripts with names 313containing spaces. 314.It Va hostname 315.Pq Vt str 316The fully qualified domain name (FQDN) of this host on the network. 317This should almost certainly be set to something meaningful, even if 318there is no network connection. 319If 320.Xr dhclient 8 321is used to set the hostname via DHCP, 322this variable should be set to an empty string. 323.It Va ipv6_enable 324.Pq Vt bool 325Enable support for IPv6 networking. 326Note that this requires that the kernel have been compiled with 327.Cd "options INET6" . 328.It Va nisdomainname 329.Pq Vt str 330The NIS domain name of this host, or 331.Dq Li NO 332if NIS is not used. 333.It Va dhclient_program 334.Pq Vt str 335Path to the DHCP client program 336.Pa ( /sbin/dhclient , 337the ISC DHCP client, 338is the default). 339.It Va dhclient_flags 340.Pq Vt str 341Additional flags to pass to the DHCP client program. 342For the ISC DHCP client, see the 343.Xr dhclient 8 344manpage for a description of the command line options available. 345.It Va background_dhclient 346.Pq Vt bool 347Set to 348.Dq Li YES 349to start the dhcp client in background. 350This can cause trouble with applications depending on 351a working network, but it will provide a faster startup 352in many cases. 353.It Va firewall_enable 354.Pq Vt bool 355Set to 356.Dq Li YES 357to load firewall rules at startup. 358If the kernel was not built with 359.Cd "options IPFIREWALL" , 360the 361.Pa ipfw.ko 362kernel module will be loaded. 363See also 364.Va ipfilter_enable . 365.It Va ipv6_firewall_enable 366.Pq Vt bool 367The IPv6 equivalent of 368.Va firewall_enable . 369Set to 370.Dq Li YES 371to load IPv6 firewall rules at startup. 372If the kernel was not built with 373.Cd "options IPV6FIREWALL" , 374the 375.Pa ip6fw.ko 376kernel module will be loaded. 377.It Va firewall_script 378.Pq Vt str 379This variable specifies the full path to the firewall script to run. 380The default is 381.Pa /etc/rc.firewall . 382.It Va ipv6_firewall_script 383.Pq Vt str 384The IPv6 equivalent of 385.Va firewall_script . 386.It Va firewall_type 387.Pq Vt str 388Names the firewall type from the selection in 389.Pa /etc/rc.firewall , 390or the file which contains the local firewall ruleset. 391Valid selections from 392.Pa /etc/rc.firewall 393are: 394.Pp 395.Bl -tag -width ".Li simple" -compact 396.It Li open 397unrestricted IP access 398.It Li closed 399all IP services disabled, except via 400.Dq Li lo0 401.It Li client 402basic protection for a workstation 403.It Li simple 404basic protection for a LAN. 405.El 406.Pp 407If a filename is specified, the full path 408must be given. 409.It Va ipv6_firewall_type 410.Pq Vt str 411The IPv6 equivalent of 412.Va firewall_type . 413.It Va firewall_quiet 414.Pq Vt bool 415Set to 416.Dq Li YES 417to disable the display of firewall rules on the console during boot. 418.It Va ipv6_firewall_quiet 419.Pq Vt bool 420The IPv6 equivalent of 421.Va firewall_quiet . 422.It Va firewall_logging 423.Pq Vt bool 424Set to 425.Dq Li YES 426to enable firewall event logging. 427This is equivalent to the 428.Dv IPFIREWALL_VERBOSE 429kernel option. 430.It Va ipv6_firewall_logging 431.Pq Vt bool 432The IPv6 equivalent of 433.Va firewall_logging . 434.It Va firewall_flags 435.Pq Vt str 436Flags passed to 437.Xr ipfw 8 438if 439.Va firewall_type 440specifies a filename. 441.It Va ipv6_firewall_flags 442.Pq Vt str 443The IPv6 equivalent of 444.Va firewall_flags . 445.It Va natd_program 446.Pq Vt str 447Path to 448.Xr natd 8 . 449.It Va natd_enable 450.Pq Vt bool 451Set to 452.Dq Li YES 453to enable 454.Xr natd 8 . 455.Va firewall_enable 456must also be set to 457.Dq Li YES , 458and 459.Xr divert 4 460sockets must be enabled in the kernel. 461If the kernel was not built with 462.Cd "options IPDIVERT" , 463the 464.Pa ipdivert.ko 465kernel module will be loaded. 466.It Va natd_interface 467.Pq Vt str 468This is the name of the public interface on which 469.Xr natd 8 470should run. 471The interface may be given as an interface name or as an IP address. 472.It Va natd_flags 473.Pq Vt str 474Additional 475.Xr natd 8 476flags should be placed here. 477The 478.Fl n 479or 480.Fl a 481flag is automatically added with the above 482.Va natd_interface 483as an argument. 484.\" ----- ipfilter_enable setting -------------------------------- 485.It Va ipfilter_enable 486.Pq Vt bool 487Set to 488.Dq Li NO 489by default. 490Setting this to 491.Dq Li YES 492enables 493.Xr ipf 8 494packet filtering. 495.Pp 496Typical usage will require putting 497.Bd -literal 498ipfilter_enable="YES" 499ipnat_enable="YES" 500ipmon_enable="YES" 501ipfs_enable="YES" 502.Ed 503.Pp 504into 505.Pa /etc/rc.conf 506and editing 507.Pa /etc/ipf.rules 508and 509.Pa /etc/ipnat.rules 510appropriately. 511.Pp 512Note that 513.Va ipfilter_enable 514and 515.Va ipnat_enable 516can be enabled independently. 517.Va ipmon_enable 518and 519.Va ipfs_enable 520both require at least one of 521.Va ipfilter_enable 522and 523.Va ipnat_enable 524to be enabled. 525.Pp 526Having 527.Bd -literal 528options IPFILTER 529options IPFILTER_LOG 530options IPFILTER_DEFAULT_BLOCK 531.Ed 532.Pp 533in the kernel configuration file is a good idea, too. 534.\" ----- ipfilter_program setting ------------------------------ 535.It Va ipfilter_program 536.Pq Vt str 537Path to 538.Xr ipf 8 539(default 540.Pa /sbin/ipf ) . 541.\" ----- ipfilter_rules setting -------------------------------- 542.It Va ipfilter_rules 543.Pq Vt str 544Set to 545.Pa /etc/ipf.rules 546by default. 547This variable contains the name of the filter rule definition file. 548The file is expected to be readable for the 549.Xr ipf 8 550command to execute. 551.\" ----- ipv6_ipfilter_rules setting --------------------------- 552.It Va ipv6_ipfilter_rules 553.Pq Vt str 554Set to 555.Pa /etc/ipf6.rules 556by default. 557This variable contains the IPv6 filter rule definition file. 558The file is expected to be readable for the 559.Xr ipf 8 560command to execute. 561.\" ----- ipfilter_flags setting -------------------------------- 562.It Va ipfilter_flags 563.Pq Vt str 564Empty by default. 565This variable contains flags passed to the 566.Xr ipf 8 567program. 568.\" ----- ipnat_enable setting ---------------------------------- 569.It Va ipnat_enable 570.Pq Vt bool 571Set to 572.Dq Li NO 573by default. 574Set it to 575.Dq Li YES 576to enable 577.Xr ipnat 1 578network address translation. 579See 580.Va ipfilter_enable 581for a detailed discussion. 582.\" ----- ipnat_program setting --------------------------------- 583.It Va ipnat_program 584.Pq Vt str 585Path to 586.Xr ipnat 1 587(default 588.Pa /sbin/ipnat ) . 589.\" ----- ipnat_rules setting ----------------------------------- 590.It Va ipnat_rules 591.Pq Vt str 592Set to 593.Pa /etc/ipnat.rules 594by default. 595This variable contains the name of the file 596holding the network address translation definition. 597This file is expected to be readable for the 598.Xr ipnat 1 599command to execute. 600.\" ----- ipnat_flags setting ----------------------------------- 601.It Va ipnat_flags 602.Pq Vt str 603Empty by default. 604This variable contains flags passed to the 605.Xr ipnat 1 606program. 607.\" ----- ipmon_enable setting ---------------------------------- 608.It Va ipmon_enable 609.Pq Vt bool 610Set to 611.Dq Li NO 612by default. 613Set it to 614.Dq Li YES 615to enable 616.Xr ipmon 8 617monitoring (logging 618.Xr ipf 8 619and 620.Xr ipnat 1 621events). 622Setting this variable needs setting 623.Va ipfilter_enable 624or 625.Va ipnat_enable 626too. 627See 628.Va ipfilter_enable 629for a detailed discussion. 630.\" ----- ipmon_program setting --------------------------------- 631.It Va ipmon_program 632.Pq Vt str 633Path to 634.Xr ipmon 8 635(default 636.Pa /sbin/ipmon ) . 637.\" ----- ipmon_flags setting ----------------------------------- 638.It Va ipmon_flags 639.Pq Vt str 640Set to 641.Dq Li -Ds 642by default. 643This variable contains flags passed to the 644.Xr ipmon 8 645program. 646Another typical example would be 647.Dq Fl D Pa /var/log/ipflog 648to have 649.Xr ipmon 8 650log directly to a file bypassing 651.Xr syslogd 8 . 652Make sure to adjust 653.Pa /etc/newsyslog.conf 654in such case like this: 655.Bd -literal 656/var/log/ipflog 640 10 100 * Z /var/run/ipmon.pid 657.Ed 658.\" ----- ipfs_enable setting ----------------------------------- 659.It Va ipfs_enable 660.Pq Vt bool 661Set to 662.Dq Li NO 663by default. 664Set it to 665.Dq Li YES 666to enable 667.Xr ipfs 8 668saving the filter and NAT state tables during shutdown 669and reloading them during startup again. 670Setting this variable needs setting 671.Va ipfilter_enable 672or 673.Va ipnat_enable 674to 675.Dq Li YES 676too. 677See 678.Va ipfilter_enable 679for a detailed discussion. 680Note that if 681.Va kern_securelevel 682is set to 3, 683.Va ipfs_enable 684cannot be used 685because the raised securelevel will prevent 686.Xr ipfs 8 687from saving the state tables at shutdown time. 688.\" ----- ipfs_program setting ---------------------------------- 689.It Va ipfs_program 690.Pq Vt str 691Path to 692.Xr ipfs 8 693(default 694.Pa /sbin/ipfs ) . 695.\" ----- ipfs_flags setting ------------------------------------ 696.It Va ipfs_flags 697.Pq Vt str 698Empty by default. 699This variable contains flags passed to the 700.Xr ipfs 8 701program. 702.\" ----- end of added ipf hook --------------------------------- 703.It Va pf_enable 704.Pq Vt bool 705Set to 706.Dq Li NO 707by default. 708Setting this to 709.Dq Li YES 710enables 711.Xr pf 4 712packet filtering. 713.Pp 714Typical usage will require putting 715.Pp 716.Dl pf_enable="YES" 717.Pp 718into 719.Pa /etc/rc.conf 720and editing 721.Pa /etc/pf.conf 722appropriately. 723.Pp 724.Dl "device pf" 725.Pp 726builds 727.Xr pf 4 728into the kernel. 729Otherwise it is loaded from a module. 730.It Va pf_rules 731.Pq Vt str 732Path to 733.Xr pf 4 734ruleset configuration file 735(default 736.Pa /etc/pf.conf ) . 737.It Va pf_program 738.Pq Vt str 739Path to 740.Xr pfctl 8 741(default 742.Pa /sbin/pfctl ) . 743.It Va pf_flags 744.Pq Vt str 745If 746.Va pf_enable 747is set to 748.Dq Li YES , 749these flags are passed to the 750.Xr pfctl 8 751program when loading the ruleset. 752.It Va pflog_enable 753.Pq Vt bool 754Set to 755.Dq Li NO 756by default. 757Setting this to 758.Dq Li YES 759enables 760.Xr pflogd 8 761which logs packtes from the 762.Xr pf 4 763packet filter. 764.It Va pflog_logfile 765.Pq Vt str 766If 767.Va pflog_enable 768is set to 769.Dq Li YES 770this controls where 771.Xr pflogd 8 772stores the logfile 773(default 774.Pa /var/log/pflog ) . 775Check 776.Pa /etc/newsyslog.conf 777to adjust logfile rotation for this. 778.It Va pflog_program 779.Pq Vt str 780Path to 781.Xr pflogd 8 782(default 783.Pa /sbin/pflogd ) . 784.It Va pflog_flags 785.Pq Vt str 786Empty by default. 787This variable contains additional flags passed to the 788.Xr pflogd 8 789program. 790.It Va tcp_extensions 791.Pq Vt bool 792Set to 793.Dq Li YES 794by default. 795Setting this to 796.Dq Li NO 797disables certain TCP options as described by 798.Rs 799.%T "RFC 1323" 800.Re 801Setting this to 802.Dq Li NO 803might help remedy such problems with connections as randomly hanging 804or other weird behavior. 805Some network devices are known 806to be broken with respect to these options. 807.It Va log_in_vain 808.Pq Vt int 809Set to 0 by default. 810The 811.Xr sysctl 8 812variables, 813.Va net.inet.tcp.log_in_vain 814and 815.Va net.inet.udp.log_in_vain , 816as described in 817.Xr tcp 4 818and 819.Xr udp 4 , 820are set to the given value. 821.It Va tcp_keepalive 822.Pq Vt bool 823Set to 824.Dq Li YES 825by default. 826Setting to 827.Dq Li NO 828will disable probing idle TCP connections to verify that the 829peer is still up and reachable. 830.It Va tcp_drop_synfin 831.Pq Vt bool 832Set to 833.Dq Li NO 834by default. 835Setting to 836.Dq Li YES 837will cause the kernel to ignore TCP frames that have both 838the SYN and FIN flags set. 839This prevents OS fingerprinting, but may 840break some legitimate applications. 841This option is only available if the 842kernel was built with the 843.Dv TCP_DROP_SYNFIN 844option. 845.It Va icmp_drop_redirect 846.Pq Vt bool 847Set to 848.Dq Li NO 849by default. 850Setting to 851.Dq Li YES 852will cause the kernel to ignore ICMP REDIRECT packets. 853Refer to 854.Xr icmp 4 855for more information. 856.It Va icmp_log_redirect 857.Pq Vt bool 858Set to 859.Dq Li NO 860by default. 861Setting to 862.Dq Li YES 863will cause the kernel to log ICMP REDIRECT packets. 864Note that 865the log messages are not rate-limited, so this option should only be used 866for troubleshooting networks. 867Refer to 868.Xr icmp 4 869for more information. 870.It Va icmp_bmcastecho 871.Pq Vt bool 872Set to 873.Dq Li YES 874to respond to broadcast or multicast ICMP ping packets. 875Refer to 876.Xr icmp 4 877for more information. 878.It Va ip_portrange_first 879.Pq Vt int 880If not set to 881.Dq Li NO , 882this is the first port in the default portrange. 883Refer to 884.Xr ip 4 885for more information. 886.It Va ip_portrange_last 887.Pq Vt int 888If not set to 889.Dq Li NO , 890this is the last port in the default portrange. 891Refer to 892.Xr ip 4 893for more information. 894.It Va network_interfaces 895.Pq Vt str 896Set to the list of network interfaces to configure on this host. 897For example, if the only network devices in the system are the loopback 898device 899.Pq Li lo0 900and a NIC using the 901.Xr ed 4 902driver, 903this could be set to 904.Dq Li "lo0 ed0" . 905An 906.Va ifconfig_ Ns Aq Ar interface 907variable is also assumed to exist for each value of 908.Ar interface . 909It is also possible to add IP alias entries here in cases where 910multiple IP addresses registered against a single interface 911are desired. 912Assuming that the interface in question was 913.Li ed0 , 914it might look 915something like this: 916.Bd -literal 917ifconfig_ed0_alias0="inet 127.0.0.253 netmask 0xffffffff" 918ifconfig_ed0_alias1="inet 127.0.0.254 netmask 0xffffffff" 919.Ed 920.Pp 921And so on. 922For each 923.Va ifconfig_ Ns Ao Ar interface Ac Ns Va _alias Ns Aq Ar n 924entry that is found, 925its contents are passed to 926.Xr ifconfig 8 . 927Execution stops at the first unsuccessful access, so if 928something like this is present: 929.Bd -literal 930ifconfig_ed0_alias0="inet 127.0.0.251 netmask 0xffffffff" 931ifconfig_ed0_alias1="inet 127.0.0.252 netmask 0xffffffff" 932ifconfig_ed0_alias2="inet 127.0.0.253 netmask 0xffffffff" 933ifconfig_ed0_alias4="inet 127.0.0.254 netmask 0xffffffff" 934.Ed 935.Pp 936Then note that alias4 would 937.Em not 938be added since the search would 939stop with the missing alias3 entry. 940.Pp 941If the 942.Pa /etc/start_if. Ns Aq Ar interface 943file is present, it is read and executed by the 944.Xr sh 1 945interpreter 946before configuring the interface as specified in the 947.Va ifconfig_ Ns Aq Ar interface 948and 949.Va ifconfig_ Ns Ao Ar interface Ac Ns Va _alias Ns Aq Ar n 950variables. 951.Pp 952It is possible to bring up an interface with DHCP by setting the 953.Va ifconfig_ Ns Aq Ar interface 954variable to 955.Dq Li DHCP . 956For instance, to initialize the 957.Li ed0 958device via DHCP, 959it is possible to use something like: 960.Bd -literal 961ifconfig_ed0="DHCP" 962.Ed 963.Pp 964It is also possible to rename interface by doing: 965.Bd -literal 966ifconfig_ed0_name="net0" 967ifconfig_net0="inet 10.0.0.1 netmask 0xffff0000" 968.Ed 969.It Va ipv6_network_interfaces 970.Pq Vt str 971This is the IPv6 equivalent of 972.Va network_interfaces . 973Instead of setting the ifconfig variables as 974.Va ifconfig_ Ns Aq Ar interface 975they should be set as 976.Va ipv6_ifconfig_ Ns Aq Ar interface . 977Aliases should be set as 978.Va ipv6_ifconfig_ Ns Ao Ar interface Ac Ns Va _alias Ns Aq Ar n . 979.Va ipv6_prefix_ Ns Aq Ar interface 980does something. 981Interfaces that do not have a 982.Va ipv6_ifconfig_ Ns Aq Ar interface 983setting will be auto configured by 984.Xr rtsol 8 985if the 986.Va ipv6_gateway_enable 987is set to 988.Dq Li NO . 989Note that the IPv6 networking code does not support the 990.Pa /etc/start_if. Ns Aq Ar interface 991files. 992.It Va ipv6_default_interface 993.Pq Vt str 994If not set to 995.Dq Li NO , 996this is the default output interface for scoped addresses. 997Now this works only for IPv6 link local multicast addresses. 998.It Va cloned_interfaces 999.Pq Vt str 1000Set to the list of clonable network interfaces to create on this host. 1001Entries in 1002.Va cloned_interfaces 1003are automatically appended to 1004.Va network_interfaces 1005for configuration. 1006.It Va gif_interfaces 1007.Pq Vt str 1008Set to the list of 1009.Xr gif 4 1010tunnel interfaces to configure on this host. 1011A 1012.Va gifconfig_ Ns Aq Ar interface 1013variable is assumed to exist for each value of 1014.Ar interface . 1015The value of this variable is used to configure the link layer of the 1016tunnel according to the syntax of the 1017.Cm tunnel 1018option to 1019.Xr ifconfig 8 . 1020Additionally, this option ensures that each listed interface is created 1021via the 1022.Cm create 1023option to 1024.Xr ifconfig 8 1025before attempting to configure it. 1026.It Va sppp_interfaces 1027.Pq Vt str 1028Set to the list of 1029.Xr sppp 4 1030interfaces to configure on this host. 1031A 1032.Va spppconfig_ Ns Aq Ar interface 1033variable is assumed to exist for each value of 1034.Ar interface . 1035Each interface should also be configured by a general 1036.Va ifconfig_ Ns Aq Ar interface 1037setting. 1038Refer to 1039.Xr spppcontrol 8 1040for more information about available options. 1041.It Va ppp_enable 1042.Pq Vt bool 1043If set to 1044.Dq Li YES , 1045run the 1046.Xr ppp 8 1047daemon. 1048.It Va ppp_mode 1049.Pq Vt str 1050Mode in which to run the 1051.Xr ppp 8 1052daemon. 1053Accepted modes are 1054.Dq Li auto , 1055.Dq Li ddial , 1056.Dq Li direct 1057and 1058.Dq Li dedicated . 1059See the manual for a full description. 1060.It Va ppp_nat 1061.Pq Vt bool 1062If set to 1063.Dq Li YES , 1064enables network address translation. 1065Used in conjunction with 1066.Va gateway_enable 1067allows hosts on private network addresses access to the Internet using 1068this host as a network address translating router. 1069.It Va ppp_profile 1070.Pq Vt str 1071The name of the profile to use from 1072.Pa /etc/ppp/ppp.conf . 1073.It Va ppp_user 1074.Pq Vt str 1075The name of the user under which 1076.Xr ppp 8 1077should be started. 1078By 1079default, 1080.Xr ppp 8 1081is started as 1082.Dq Li root . 1083.It Va rc_conf_files 1084.Pq Vt str 1085This option is used to specify a list of files that will override 1086the settings in 1087.Pa /etc/defaults/rc.conf . 1088The files will be read in the order in which they are specified and should 1089include the full path to the file. 1090By default, the files specified are 1091.Pa /etc/rc.conf 1092and 1093.Pa /etc/rc.conf.local 1094.It Va gbde_autoattach_all 1095.Pq Vt bool 1096If set to 1097.Dq Li YES , 1098.Pa /etc/rc.d/gbde 1099will attempt to automatically initialize your .bde devices in 1100.Pa /etc/fstab . 1101.It Va gbde_devices 1102.Pq Vt str 1103List the devices that the script should try to attach, 1104or 1105.Dq Li AUTO . 1106.It Va gbde_lockdir 1107.Pq Vt str 1108The directory where the 1109.Xr gbde 4 1110lockfiles are located. 1111The default lockfile directory is 1112.Pa /etc . 1113.Pp 1114The lockfile for each individual 1115.Xr gbde 4 1116device can be overridden by setting the variable 1117.Va gbde_lock_ Ns Aq Ar device , 1118where 1119.Ar device 1120is the encrypted device without the 1121.Dq Pa /dev/ 1122and 1123.Dq Pa .bde 1124parts. 1125.It Va gbde_attach_attempts 1126.Pq Vt int 1127Number of times to attempt attaching to a 1128.Xr gbde 4 1129device, i.e., how many times the user is asked for the pass-phrase. 1130Default is 3. 1131.It Va gbde_swap_enable 1132.Pq Vt bool 1133If set to 1134.Dq Li YES , 1135any .bde swap devices listed in 1136.Pa /etc/fstab 1137will be initialized with a random, one-shot key. 1138Note that this makes recovery of kernel dumps impossible. 1139.It Va root_rw_mount 1140.Pq Vt bool 1141Set to 1142.Dq Li YES 1143by default. 1144After the file systems are checked at boot time, the root file system 1145is remounted as read-write if this is set to 1146.Dq Li YES . 1147Diskless systems that mount their root file system from a read-only remote 1148NFS share should set this to 1149.Dq Li NO 1150in their 1151.Pa rc.conf . 1152.It Va fsck_y_enable 1153.Pq Vt bool 1154If set to 1155.Dq Li YES , 1156.Xr fsck 8 1157will be run with the 1158.Fl y 1159flag if the initial preen 1160of the file systems fails. 1161.It Va background_fsck 1162.Pq Vt bool 1163If set to 1164.Dq Li YES , 1165the system will attempt to run 1166.Xr fsck 8 1167in the background where possible. 1168.It Va background_fsck_delay 1169.Pq Vt int 1170The amount of time in seconds to sleep before starting a background 1171.Xr fsck 8 . 1172It defaults to sixty seconds to allow large applications such as 1173the X server to start before disk I/O bandwidth is monopolized by 1174.Xr fsck 8 . 1175.It Va netfs_types 1176.Pq Vt str 1177List of file system types that are network-based. 1178This list should generally not be modified by end users. 1179Use 1180.Va extra_netfs_types 1181instead. 1182.It Va extra_netfs_types 1183.Pq Vt str 1184If set to something other than 1185.Dq Li NO 1186(the default), 1187this variable extends the list of file system types 1188for which automatic mounting at startup by 1189.Xr rc 8 1190should be delayed until the network is initialized. 1191It should contain 1192a whitespace-separated list of network file system descriptor pairs, 1193each consisting of a file system type as passed to 1194.Xr mount 8 1195and a human-readable, one-word description, 1196joined with a colon 1197.Pq Ql \&: . 1198Extending the default list in this way is only necessary 1199when third party file system types are used. 1200.It Va syslogd_enable 1201.Pq Vt bool 1202If set to 1203.Dq Li YES , 1204run the 1205.Xr syslogd 8 1206daemon. 1207.It Va syslogd_program 1208.Pq Vt str 1209Path to 1210.Xr syslogd 8 1211(default 1212.Pa /usr/sbin/syslogd ) . 1213.It Va syslogd_flags 1214.Pq Vt str 1215If 1216.Va syslogd_enable 1217is set to 1218.Dq Li YES , 1219these are the flags to pass to 1220.Xr syslogd 8 . 1221.It Va inetd_enable 1222.Pq Vt bool 1223If set to 1224.Dq Li YES , 1225run the 1226.Xr inetd 8 1227daemon. 1228.It Va inetd_program 1229.Pq Vt str 1230Path to 1231.Xr inetd 8 1232(default 1233.Pa /usr/sbin/inetd ) . 1234.It Va inetd_flags 1235.Pq Vt str 1236If 1237.Va inetd_enable 1238is set to 1239.Dq Li YES , 1240these are the flags to pass to 1241.Xr inetd 8 . 1242.It Va named_enable 1243.Pq Vt bool 1244If set to 1245.Dq Li YES , 1246run the 1247.Xr named 8 1248daemon. 1249.It Va named_program 1250.Pq Vt str 1251Path to 1252.Xr named 8 1253(default 1254.Pa /usr/sbin/named ) . 1255.It Va named_flags 1256.Pq Vt str 1257If 1258.Va named_enable 1259is set to 1260.Dq Li YES , 1261these are the flags to pass to 1262.Xr named 8 . 1263.It Va named_pidfile 1264.Pq Vt str 1265This is the default path to the 1266.Xr named 8 1267daemon's PID file. 1268Change it if you change the location in 1269.Xr named.conf 5 . 1270.It Va named_chrootdir 1271.Pq Vt str 1272The root directory for a name server run in a 1273.Xr chroot 8 1274environment (default 1275.Pa /var/named ) . 1276If left empty 1277.Xr named 8 1278will not be run in a 1279.Xr chroot 8 1280environment. 1281.It Va named_chroot_autoupdate 1282.Pq Vt bool 1283Set to 1284.Dq Li NO 1285to disable automatic update of the 1286.Xr chroot 8 1287environment. 1288.It Va named_symlink_enable 1289.Pq Vt bool 1290Set to 1291.Dq Li NO 1292to disable symlinking of 1293daemon's PID file 1294into the 1295.Xr chroot 8 1296environment. 1297.It Va kerberos5_server_enable 1298.Pq Vt bool 1299Set to 1300.Dq Li YES 1301to start a Kerberos 5 authentication server 1302at boot time. 1303.It Va kerberos5_server 1304.Pq Vt str 1305If 1306.Va kerberos5_server_enable 1307is set to 1308.Dq Li YES 1309this is the path to Kerberos 5 Authentication Server. 1310.It Va kadmind5_server_enable 1311.Pq Vt bool 1312Set to 1313.Dq Li YES 1314to start 1315.Xr kadmind 8 , 1316the Kerberos 5 Administration Daemon; set to 1317.Dq Li NO 1318on a slave server. 1319.It Va kadmind5_server 1320.Pq Vt str 1321If 1322.Va kadmind5_server_enable 1323is set to 1324.Dq Li YES 1325this is the path to Kerberos 5 Administration Daemon. 1326.It Va kpasswdd_server_enable 1327.Pq Vt bool 1328Set to 1329.Dq Li YES 1330to start 1331.Xr kpasswdd 8 , 1332the Kerberos 5 Password-Changing Daemon; set to 1333.Dq Li NO 1334on a slave server. 1335.It Va kpasswdd_server 1336.Pq Vt str 1337If 1338.Va kpasswdd_server_enable 1339is set to 1340.Dq Li YES 1341this is the path to Kerberos 5 Password-Changing Daemon. 1342.It Va rwhod_enable 1343.Pq Vt bool 1344If set to 1345.Dq Li YES , 1346run the 1347.Xr rwhod 8 1348daemon at boot time. 1349.It Va rwhod_flags 1350.Pq Vt str 1351If 1352.Va rwhod_enable 1353is set to 1354.Dq Li YES , 1355these are the flags to pass to it. 1356.It Va amd_enable 1357.Pq Vt bool 1358If set to 1359.Dq Li YES , 1360run the 1361.Xr amd 8 1362daemon at boot time. 1363.It Va amd_flags 1364.Pq Vt str 1365If 1366.Va amd_enable 1367is set to 1368.Dq Li YES , 1369these are the flags to pass to it. 1370See the 1371.Xr amd 8 1372manpage for more information. 1373.It Va amd_map_program 1374.Pq Vt str 1375If set, 1376the specified program is run to get the list of 1377.Xr amd 8 1378maps. 1379For example, if the 1380.Xr amd 8 1381maps are stored in NIS, one can set this to 1382run 1383.Xr ypcat 1 1384to get a list of 1385.Xr amd 8 1386maps from the 1387.Pa amd.master 1388NIS map. 1389.It Va update_motd 1390.Pq Vt bool 1391If set to 1392.Dq Li YES , 1393.Pa /etc/motd 1394will be updated at boot time to reflect the kernel release 1395being run. 1396If set to 1397.Dq Li NO , 1398.Pa /etc/motd 1399will not be updated. 1400.It Va nfs_client_enable 1401.Pq Vt bool 1402If set to 1403.Dq Li YES , 1404run the NFS client daemons at boot time. 1405.It Va nfs_access_cache 1406.Pq Vt int 1407If 1408.Va nfs_client_enable 1409is set to 1410.Dq Li YES , 1411this can be set to 1412.Dq Li 0 1413to disable NFS ACCESS RPC caching, or to the number of seconds for which 1414NFS ACCESS 1415results should be cached. 1416A value of 2-10 seconds will substantially reduce network 1417traffic for many NFS operations. 1418.It Va nfs_server_enable 1419.Pq Vt bool 1420If set to 1421.Dq Li YES , 1422run the NFS server daemons at boot time. 1423.It Va nfs_server_flags 1424.Pq Vt str 1425If 1426.Va nfs_server_enable 1427is set to 1428.Dq Li YES , 1429these are the flags to pass to the 1430.Xr nfsd 8 1431daemon. 1432.It Va mountd_enable 1433.Pq Vt bool 1434If set to 1435.Dq Li YES , 1436and no 1437.Va nfs_server_enable 1438is set, start 1439.Xr mountd 8 , 1440but not 1441.Xr nfsd 8 1442daemon. 1443It is commonly needed to run CFS without real NFS used. 1444.It Va mountd_flags 1445.Pq Vt str 1446If 1447.Va mountd_enable 1448is set to 1449.Dq Li YES , 1450these are the flags to pass to the 1451.Xr mountd 8 1452daemon. 1453.It Va weak_mountd_authentication 1454.Pq Vt bool 1455If set to 1456.Dq Li YES , 1457allow services like PCNFSD to make non-privileged mount 1458requests. 1459.It Va nfs_reserved_port_only 1460.Pq Vt bool 1461If set to 1462.Dq Li YES , 1463provide NFS services only on a secure port. 1464.It Va nfs_bufpackets 1465.Pq Vt int 1466If set to a number, indicates the number of packets worth of 1467socket buffer space to reserve on an NFS client. 1468The kernel default is typically 4. 1469Using a higher number may be 1470useful on gigabit networks to improve performance. 1471The minimum value is 14722 and the maximum is 64. 1473.It Va rpc_lockd_enable 1474.Pq Vt bool 1475If set to 1476.Dq Li YES 1477and also an NFS server, run 1478.Xr rpc.lockd 8 1479at boot time. 1480.It Va rpc_statd_enable 1481.Pq Vt bool 1482If set to 1483.Dq Li YES 1484and also an NFS server, run 1485.Xr rpc.statd 8 1486at boot time. 1487.It Va rpcbind_program 1488.Pq Vt str 1489Path to 1490.Xr rpcbind 8 1491(default 1492.Pa /usr/sbin/rpcbind ) . 1493.It Va rpcbind_enable 1494.Pq Vt bool 1495If set to 1496.Dq Li YES , 1497run the 1498.Xr rpcbind 8 1499service at boot time. 1500.It Va rpcbind_flags 1501.Pq Vt str 1502If 1503.Va rpcbind_enable 1504is set to 1505.Dq Li YES , 1506these are the flags to pass to the 1507.Xr rpcbind 8 1508daemon. 1509.It Va keyserv_enable 1510.Pq Vt bool 1511If set to 1512.Dq Li YES , 1513run the 1514.Xr keyserv 8 1515daemon on boot for running Secure RPC. 1516.It Va keyserv_flags 1517.Pq Vt str 1518If 1519.Va keyserv_enable 1520is set to 1521.Dq Li YES , 1522these are the flags to pass to 1523.Xr keyserv 8 1524daemon. 1525.It Va pppoed_enable 1526.Pq Vt bool 1527If set to 1528.Dq Li YES , 1529run the 1530.Xr pppoed 8 1531daemon at boot time to provide PPP over Ethernet services. 1532.It Va pppoed_ Ns Ar provider 1533.Pq Vt str 1534.Xr pppoed 8 1535listens to requests to this 1536.Ar provider 1537and ultimately runs 1538.Xr ppp 8 1539with a 1540.Ar system 1541argument of the same name. 1542.It Va pppoed_flags 1543.Pq Vt str 1544Additional flags to pass to 1545.Xr pppoed 8 . 1546.It Va pppoed_interface 1547.Pq Vt str 1548The network interface to run 1549.Xr pppoed 8 1550on. 1551This is mandatory when 1552.Va pppoed_enable 1553is set to 1554.Dq Li YES . 1555.It Va timed_enable 1556.Pq Vt bool 1557If set to 1558.Dq Li YES , 1559run the 1560.Xr timed 8 1561service at boot time. 1562This command is intended for networks of 1563machines where a consistent 1564.Dq "network time" 1565for all hosts must be established. 1566This is often useful in large NFS 1567environments where time stamps on files are expected to be consistent 1568network-wide. 1569.It Va timed_flags 1570.Pq Vt str 1571If 1572.Va timed_enable 1573is set to 1574.Dq Li YES , 1575these are the flags to pass to the 1576.Xr timed 8 1577service. 1578.It Va ntpdate_enable 1579.Pq Vt bool 1580If set to 1581.Dq Li YES , 1582run 1583.Xr ntpdate 8 1584at system startup. 1585This command is intended to 1586synchronize the system clock only 1587.Em once 1588from some standard reference. 1589An option to set this up initially 1590(from a list of known servers) is also provided by the 1591.Xr sysinstall 8 1592program when the system is first installed. 1593.It Va ntpdate_hosts 1594.Pq Vt str 1595A whitespace-separated list of NTP servers to synchronize with at startup. 1596The default is to use the servers listed in 1597.Pa /etc/ntp.conf , 1598if that file exists. 1599.It Va ntpdate_program 1600.Pq Vt str 1601Path to 1602.Xr ntpdate 8 1603(default 1604.Pa /usr/sbin/ntpdate ) . 1605.It Va ntpdate_flags 1606.Pq Vt str 1607If 1608.Va ntpdate_enable 1609is set to 1610.Dq Li YES , 1611these are the flags to pass to the 1612.Xr ntpdate 8 1613command (typically a hostname). 1614.It Va ntpd_enable 1615.Pq Vt bool 1616If set to 1617.Dq Li YES , 1618run the 1619.Xr ntpd 8 1620command at boot time. 1621.It Va ntpd_program 1622.Pq Vt str 1623Path to 1624.Xr ntpd 8 1625(default 1626.Pa /usr/sbin/ntpd ) . 1627.It Va ntpd_flags 1628.Pq Vt str 1629If 1630.Va ntpd_enable 1631is set to 1632.Dq Li YES , 1633these are the flags to pass to the 1634.Xr ntpd 8 1635daemon. 1636.It Va ntpd_sync_on_start 1637.Pq Vt bool 1638If set to 1639.Dq Li YES , 1640.Xr ntpd 8 1641is run with the 1642.Fl g 1643flag, which syncs the system's clock on startup. 1644See 1645.Xr ntpd 8 1646for more information regarding the 1647.Fl g 1648option. 1649This is a preferred alternative to using 1650.Xr ntpdate 8 1651or specifying the 1652.Va ntpdate_enable 1653variable. 1654.It Va nis_client_enable 1655.Pq Vt bool 1656If set to 1657.Dq Li YES , 1658run the 1659.Xr ypbind 8 1660service at system boot time. 1661.It Va nis_client_flags 1662.Pq Vt str 1663If 1664.Va nis_client_enable 1665is set to 1666.Dq Li YES , 1667these are the flags to pass to the 1668.Xr ypbind 8 1669service. 1670.It Va nis_ypset_enable 1671.Pq Vt bool 1672If set to 1673.Dq Li YES , 1674run the 1675.Xr ypset 8 1676daemon at system boot time. 1677.It Va nis_ypset_flags 1678.Pq Vt str 1679If 1680.Va nis_ypset_enable 1681is set to 1682.Dq Li YES , 1683these are the flags to pass to the 1684.Xr ypset 8 1685daemon. 1686.It Va nis_server_enable 1687.Pq Vt bool 1688If set to 1689.Dq Li YES , 1690run the 1691.Xr ypserv 8 1692daemon at system boot time. 1693.It Va nis_server_flags 1694.Pq Vt str 1695If 1696.Va nis_server_enable 1697is set to 1698.Dq Li YES , 1699these are the flags to pass to the 1700.Xr ypserv 8 1701daemon. 1702.It Va nis_ypxfrd_enable 1703.Pq Vt bool 1704If set to 1705.Dq Li YES , 1706run the 1707.Xr rpc.ypxfrd 8 1708daemon at system boot time. 1709.It Va nis_ypxfrd_flags 1710.Pq Vt str 1711If 1712.Va nis_ypxfrd_enable 1713is set to 1714.Dq Li YES , 1715these are the flags to pass to the 1716.Xr rpc.ypxfrd 8 1717daemon. 1718.It Va nis_yppasswdd_enable 1719.Pq Vt bool 1720If set to 1721.Dq Li YES , 1722run the 1723.Xr rpc.yppasswdd 8 1724daemon at system boot time. 1725.It Va nis_yppasswdd_flags 1726.Pq Vt str 1727If 1728.Va nis_yppasswdd_enable 1729is set to 1730.Dq Li YES , 1731these are the flags to pass to the 1732.Xr rpc.yppasswdd 8 1733daemon. 1734.It Va rpc_ypupdated_enable 1735.Pq Vt bool 1736If set to 1737.Dq Li YES , 1738run the 1739.Nm rpc.ypupdated 1740daemon at system boot time. 1741.It Va defaultrouter 1742.Pq Vt str 1743If not set to 1744.Dq Li NO , 1745create a default route to this host name or IP address 1746(use an IP address if this router is also required to get to the 1747name server!). 1748.It Va ipv6_defaultrouter 1749.Pq Vt str 1750The IPv6 equivalent of 1751.Va defaultrouter . 1752.It Va static_routes 1753.Pq Vt str 1754Set to the list of static routes that are to be added at system 1755boot time. 1756If not set to 1757.Dq Li NO 1758then for each whitespace separated 1759.Ar element 1760in the value, a 1761.Va route_ Ns Aq Ar element 1762variable is assumed to exist 1763whose contents will later be passed to a 1764.Dq Nm route Cm add 1765operation. 1766For example: 1767.Bd -literal 1768static_routes="mcast gif0local" 1769route_mcast="-net 224.0.0.0/4 -iface gif0" 1770route_gif0local="-host 169.254.1.1 -iface lo0" 1771.Ed 1772.It Va ipv6_static_routes 1773.Pq Vt str 1774The IPv6 equivalent of 1775.Va static_routes . 1776If not set to 1777.Dq Li NO 1778then for each whitespace separated 1779.Ar element 1780in the value, a 1781.Va ipv6_route_ Ns Aq Ar element 1782variable is assumed to exist 1783whose contents will later be passed to a 1784.Dq Nm route Cm add Fl inet6 1785operation. 1786.It Va natm_static_routes 1787.Pq Vt str 1788The 1789.Xr natmip 4 1790equivalent of 1791.Va static_routes . 1792If not empty then for each whitespace separated 1793.Ar element 1794in the value, a 1795.Va route_ Ns Aq Ar element 1796variable is assumed to exist whose contents will later be passed to a 1797.Dq Nm atmconfig Cm natm Cm add 1798operation. 1799.It Va gateway_enable 1800.Pq Vt bool 1801If set to 1802.Dq Li YES , 1803configure host to act as an IP router, e.g.\& to forward packets 1804between interfaces. 1805.It Va ipv6_gateway_enable 1806.Pq Vt bool 1807The IPv6 equivalent of 1808.Va gateway_enable . 1809.It Va router_enable 1810.Pq Vt bool 1811If set to 1812.Dq Li YES , 1813run a routing daemon of some sort, based on the 1814settings of 1815.Va router 1816and 1817.Va router_flags . 1818.It Va ipv6_router_enable 1819.Pq Vt bool 1820The IPv6 equivalent of 1821.Va router_enable . 1822If set to 1823.Dq Li YES , 1824run a routing daemon of some sort, based on the 1825settings of 1826.Va ipv6_router 1827and 1828.Va ipv6_router_flags . 1829.It Va router 1830.Pq Vt str 1831If 1832.Va router_enable 1833is set to 1834.Dq Li YES , 1835this is the name of the routing daemon to use. 1836.It Va ipv6_router 1837.Pq Vt str 1838The IPv6 equivalent of 1839.Va router . 1840.It Va router_flags 1841.Pq Vt str 1842If 1843.Va router_enable 1844is set to 1845.Dq Li YES , 1846these are the flags to pass to the routing daemon. 1847.It Va ipv6_router_flags 1848.Pq Vt str 1849The IPv6 equivalent of 1850.Va router_flags . 1851.It Va mrouted_enable 1852.Pq Vt bool 1853If set to 1854.Dq Li YES , 1855run the multicast routing daemon, 1856.Xr mrouted 8 . 1857.It Va mroute6d_enable 1858.Pq Vt bool 1859The IPv6 equivalent of 1860.Va mrouted_enable . 1861If set to 1862.Dq Li YES , 1863run the IPv6 multicast routing daemon. 1864Note that no IPv6 multicast routing daemon is included in the 1865.Fx 1866base system but 1867.Xr pim6dd 8 1868can be installed from the 1869.Fx 1870Ports Collection. 1871.It Va mrouted_flags 1872.Pq Vt str 1873If 1874.Va mrouted_enable 1875is set to 1876.Dq Li YES , 1877these are the flags to pass to the 1878.Xr mrouted 8 1879daemon. 1880.It Va mroute6d_flags 1881.Pq Vt str 1882The IPv6 equivalent of 1883.Va mrouted_flags . 1884If 1885.Va mroute6d_enable 1886is set to 1887.Dq Li YES , 1888these are the flags passed to the IPv6 multicast routing daemon. 1889.It Va mroute6d_program 1890.Pq Vt str 1891If 1892.Va mroute6d_enable 1893is set to 1894.Dq Li YES , 1895this is the path to the IPv6 multicast routing daemon. 1896.It Va rtadvd_enable 1897.Pq Vt bool 1898If set to 1899.Dq Li YES , 1900run the 1901.Xr rtadvd 8 1902daemon at boot time. 1903.Xr rtadvd 8 1904will only run if 1905.Va ipv6_gateway_enable 1906is also set to 1907.Dq Li YES . 1908The 1909.Xr rtadvd 8 1910utility sends router advertisement packets to the interfaces specified in 1911.Va rtadvd_interfaces 1912and should only be enabled with great care. 1913You may want to fine-tune 1914.Xr rtadvd.conf 5 . 1915.It Va rtadvd_interfaces 1916.Pq Vt str 1917If 1918.Va rtadvd_enable 1919is set to 1920.Dq Li YES 1921this is the list of interfaces to use. 1922.It Va ipxgateway_enable 1923.Pq Vt bool 1924If set to 1925.Dq Li YES , 1926enable the routing of IPX traffic. 1927.It Va ipxrouted_enable 1928.Pq Vt bool 1929If set to 1930.Dq Li YES , 1931run the 1932.Xr IPXrouted 8 1933daemon at system boot time. 1934.It Va ipxrouted_flags 1935.Pq Vt str 1936If 1937.Va ipxrouted_enable 1938is set to 1939.Dq Li YES , 1940these are the flags to pass to the 1941.Xr IPXrouted 8 1942daemon. 1943.It Va arpproxy_all 1944.Pq Vt bool 1945If set to 1946.Dq Li YES , 1947enable global proxy ARP. 1948.It Va forward_sourceroute 1949.Pq Vt bool 1950If set to 1951.Dq Li YES 1952and 1953.Va gateway_enable 1954is also set to 1955.Dq Li YES , 1956source-routed packets are forwarded. 1957.It Va accept_sourceroute 1958.Pq Vt bool 1959If set to 1960.Dq Li YES , 1961the system will accept source-routed packets directed at it. 1962.It Va rarpd_enable 1963.Pq Vt bool 1964If set to 1965.Dq Li YES , 1966run the 1967.Xr rarpd 8 1968daemon at system boot time. 1969.It Va rarpd_flags 1970.Pq Vt str 1971If 1972.Va rarpd_enable 1973is set to 1974.Dq Li YES , 1975these are the flags to pass to the 1976.Xr rarpd 8 1977daemon. 1978.It Va bootparamd_enable 1979.Pq Vt bool 1980If set to 1981.Dq Li YES , 1982run the 1983.Xr bootparamd 8 1984daemon at system boot time. 1985.It Va bootparamd_flags 1986.Pq Vt str 1987If 1988.Va bootparamd_enable 1989is set to 1990.Dq Li YES , 1991these are the flags to pass to the 1992.Xr bootparamd 8 1993daemon. 1994.It Va stf_interface_ipv4addr 1995.Pq Vt str 1996If not set to 1997.Dq Li NO , 1998this is the local IPv4 address for 6to4 (IPv6 over IPv4 tunneling 1999interface). 2000Specify this entry to enable the 6to4 interface. 2001.It Va stf_interface_ipv4plen 2002.Pq Vt int 2003Prefix length for 6to4 IPv4 addresses, to limit peer address range. 2004An effective value is 0-31. 2005.It Va stf_interface_ipv6_ifid 2006.Pq Vt str 2007IPv6 interface ID for 2008.Xr stf 4 . 2009This can be set to 2010.Dq Li AUTO . 2011.It Va stf_interface_ipv6_slaid 2012.Pq Vt str 2013IPv6 Site Level Aggregator for 2014.Xr stf 4 . 2015.It Va ipv6_faith_prefix 2016.Pq Vt str 2017If not set to 2018.Dq Li NO , 2019this is the faith prefix to enable a FAITH IPv6-to-IPv4 TCP 2020translator. 2021You also need 2022.Xr faithd 8 2023setup. 2024.It Va ipv6_ipv4mapping 2025.Pq Vt bool 2026If set to 2027.Dq Li YES 2028this enables IPv4 mapped IPv6 address communication (like 2029.Li ::ffff:a.b.c.d ) . 2030.It Va atm_enable 2031.Pq Vt bool 2032Set to 2033.Dq Li YES 2034to enable the configuration of ATM interfaces at system boot time. 2035For all of the ATM variables described below, please refer to the 2036.Xr atm 8 2037man page for further details on the available command parameters. 2038Also refer to the files in 2039.Pa /usr/share/examples/atm 2040for more detailed configuration information. 2041.It Va atm_load 2042.Pq Vt str 2043This is a list of physical ATM interface drivers to load. 2044Typical values are 2045.Dq Li hfa_pci 2046and/or 2047.Dq Li hea_pci . 2048.It Va atm_netif_ Ns Aq Ar intf 2049.Pq Vt str 2050For the ATM physical interface 2051.Ar intf , 2052this variable defines the name prefix and count for the ATM network 2053interfaces to be created. 2054The value will be passed as the parameters of an 2055.Dq Nm atm Cm "set netif" Ar intf 2056command. 2057.It Va atm_sigmgr_ Ns Aq Ar intf 2058.Pq Vt str 2059For the ATM physical interface 2060.Ar intf , 2061this variable defines the ATM signalling manager to be used. 2062The value will be passed as the parameters of an 2063.Dq Nm atm Cm attach Ar intf 2064command. 2065.It Va atm_prefix_ Ns Aq Ar intf 2066.Pq Vt str 2067For the ATM physical interface 2068.Ar intf , 2069this variable defines the NSAP prefix for interfaces using a UNI signalling 2070manager. 2071If set to 2072.Dq Li ILMI , 2073the prefix will automatically be set via the 2074.Xr ilmid 8 2075daemon. 2076Otherwise, the value will be passed as the parameters of an 2077.Dq Nm atm Cm "set prefix" Ar intf 2078command. 2079.It Va atm_macaddr_ Ns Aq Ar intf 2080.Pq Vt str 2081For the ATM physical interface 2082.Ar intf , 2083this variable defines the MAC address for interfaces using a UNI signalling 2084manager. 2085If set to 2086.Dq Li NO , 2087the hardware MAC address contained in the ATM interface card will be used. 2088Otherwise, the value will be passed as the parameters of an 2089.Dq Nm atm Cm "set mac" Ar intf 2090command. 2091.It Va atm_arpserver_ Ns Aq Ar netif 2092.Pq Vt str 2093For the ATM network interface 2094.Ar netif , 2095this variable defines the ATM address for a host which is to provide ATMARP 2096service. 2097This variable is only applicable to interfaces using a UNI signalling 2098manager. 2099If set to 2100.Dq Li local , 2101this host will become an ATMARP server. 2102The value will be passed as the parameters of an 2103.Dq Nm atm Cm "set arpserver" Ar netif 2104command. 2105.It Va atm_scsparp_ Ns Aq Ar netif 2106.Pq Vt bool 2107If set to 2108.Dq Li YES , 2109SCSP/ATMARP service for the network interface 2110.Ar netif 2111will be initiated using the 2112.Xr scspd 8 2113and 2114.Xr atmarpd 8 2115daemons. 2116This variable is only applicable if 2117.Va atm_arpserver_ Ns Aq Ar netif 2118is set to 2119.Dq Li local . 2120.It Va atm_pvcs 2121.Pq Vt str 2122Set to the list of ATM PVCs to be added at system 2123boot time. 2124For each whitespace separated 2125.Ar element 2126in the value, an 2127.Va atm_pvc_ Ns Aq Ar element 2128variable is assumed to exist. 2129The value of each of these variables 2130will be passed as the parameters of an 2131.Dq Nm atm Cm "add pvc" 2132command. 2133.It Va atm_arps 2134.Pq Vt str 2135Set to the list of permanent ATM ARP entries to be added 2136at system boot time. 2137For each whitespace separated 2138.Ar element 2139in the value, an 2140.Va atm_arp_ Ns Aq Ar element 2141variable is assumed to exist. 2142The value of each of these variables 2143will be passed as the parameters of an 2144.Dq Nm atm Cm "add arp" 2145command. 2146.It Va natm_interfaces 2147.Pq Vt str 2148Set to the list of 2149.Xr natm 4 2150interfaces that will also be used for HARP through 2151.Xr harp 4 . 2152If this list is not empty all interfaces in the list will be brought up 2153with 2154.Xr ifconfig 8 2155and 2156.Xr harp 4 2157will be loaded. 2158For this to work the interface drivers must be either compiled into the 2159kernel or must reside on the root partition. 2160.It Va keybell 2161.Pq Vt str 2162The keyboard bell sound. 2163Set to 2164.Dq Li normal , 2165.Dq Li visual , 2166.Dq Li off , 2167or 2168.Dq Li NO 2169if the default behavior is desired. 2170For details, refer to the 2171.Xr kbdcontrol 1 2172manpage. 2173.It Va keyboard 2174.Pq Vt str 2175If set to a non-null string, the virtual console's keyboard input is 2176set to this device. 2177.It Va keymap 2178.Pq Vt str 2179If set to 2180.Dq Li NO , 2181no keymap is installed, otherwise the value is used to install 2182the keymap file in 2183.Pa /usr/share/syscons/keymaps/ Ns Ao Ar value Ac Ns Pa .kbd . 2184.It Va keyrate 2185.Pq Vt str 2186The keyboard repeat speed. 2187Set to 2188.Dq Li slow , 2189.Dq Li normal , 2190.Dq Li fast , 2191or 2192.Dq Li NO 2193if the default behavior is desired. 2194.It Va keychange 2195.Pq Vt str 2196If not set to 2197.Dq Li NO , 2198attempt to program the function keys with the value. 2199The value should 2200be a single string of the form: 2201.Dq Ar funkey_number new_value Op Ar funkey_number new_value ... . 2202.It Va cursor 2203.Pq Vt str 2204Can be set to the value of 2205.Dq Li normal , 2206.Dq Li blink , 2207.Dq Li destructive , 2208or 2209.Dq Li NO 2210to set the cursor behavior explicitly or choose the default behavior. 2211.It Va scrnmap 2212.Pq Vt str 2213If set to 2214.Dq Li NO , 2215no screen map is installed, otherwise the value is used to install 2216the screen map file in 2217.Pa /usr/share/syscons/scrnmaps/ Ns Aq Ar value . 2218.It Va font8x16 2219.Pq Vt str 2220If set to 2221.Dq Li NO , 2222the default 8x16 font value is used for screen size requests, otherwise 2223the value in 2224.Pa /usr/share/syscons/fonts/ Ns Aq Ar value 2225is used. 2226.It Va font8x14 2227.Pq Vt str 2228If set to 2229.Dq Li NO , 2230the default 8x14 font value is used for screen size requests, otherwise 2231the value in 2232.Pa /usr/share/syscons/fonts/ Ns Aq Ar value 2233is used. 2234.It Va font8x8 2235.Pq Vt str 2236If set to 2237.Dq Li NO , 2238the default 8x8 font value is used for screen size requests, otherwise 2239the value in 2240.Pa /usr/share/syscons/fonts/ Ns Aq Ar value 2241is used. 2242.It Va blanktime 2243.Pq Vt int 2244If set to 2245.Dq Li NO , 2246the default screen blanking interval is used, otherwise it is set 2247to 2248.Ar value 2249seconds. 2250.It Va saver 2251.Pq Vt str 2252If not set to 2253.Dq Li NO , 2254this is the actual screen saver to use 2255.Li ( blank , snake , daemon , 2256etc). 2257.It Va moused_nondefault_enable 2258.Pq Vt str 2259If set to 2260.Dq Li NO , 2261the mouse device specified on 2262the command line is not automatically treated as enabled by the 2263.Pa /etc/rc.d/moused 2264script. 2265Having this variable set to 2266.Dq Li YES 2267allows a 2268.Xr usb 4 2269mouse, 2270for example, 2271to be enabled as soon as it is plugged in. 2272.It Va moused_enable 2273.Pq Vt str 2274If set to 2275.Dq Li YES , 2276the 2277.Xr moused 8 2278daemon is started for doing cut/paste selection on the console. 2279.It Va moused_type 2280.Pq Vt str 2281This is the protocol type of the mouse connected to this host. 2282This variable must be set if 2283.Va moused_enable 2284is set to 2285.Dq Li YES . 2286The 2287.Xr moused 8 2288daemon 2289is able to detect the appropriate mouse type automatically in many cases. 2290Set this variable to 2291.Dq Li auto 2292to let the daemon detect it, or 2293select one from the following list if the automatic detection fails. 2294.Pp 2295If the mouse is attached to the PS/2 mouse port, choose 2296.Dq Li auto 2297or 2298.Dq Li ps/2 , 2299regardless of the brand and model of the mouse. 2300Likewise, if the 2301mouse is attached to the bus mouse port, choose 2302.Dq Li auto 2303or 2304.Dq Li busmouse . 2305All other protocols are for serial mice and will not work with 2306the PS/2 and bus mice. 2307If this is a USB mouse, 2308.Dq Li auto 2309is the only protocol type which will work. 2310.Pp 2311.Bl -tag -width ".Li x10mouseremote" -compact 2312.It Li microsoft 2313Microsoft mouse (serial) 2314.It Li intellimouse 2315Microsoft IntelliMouse (serial) 2316.It Li mousesystems 2317Mouse systems Corp.\& mouse (serial) 2318.It Li mmseries 2319MM Series mouse (serial) 2320.It Li logitech 2321Logitech mouse (serial) 2322.It Li busmouse 2323A bus mouse 2324.It Li mouseman 2325Logitech MouseMan and TrackMan (serial) 2326.It Li glidepoint 2327ALPS GlidePoint (serial) 2328.It Li thinkingmouse 2329Kensington ThinkingMouse (serial) 2330.It Li ps/2 2331PS/2 mouse 2332.It Li mmhittab 2333MM HitTablet (serial) 2334.It Li x10mouseremote 2335X10 MouseRemote (serial) 2336.It Li versapad 2337Interlink VersaPad (serial) 2338.El 2339.Pp 2340Even if the mouse is not in the above list, it may be compatible 2341with one in the list. 2342Refer to the man page for 2343.Xr moused 8 2344for compatibility information. 2345.Pp 2346It should also be noted that while this is enabled, any 2347other client of the mouse (such as an X server) should access 2348the mouse through the virtual mouse device, 2349.Pa /dev/sysmouse , 2350and configure it as a 2351.Dq Li sysmouse 2352type mouse, since all 2353mouse data is converted to this single canonical format when 2354using 2355.Xr moused 8 . 2356If the client program does not support the 2357.Dq Li sysmouse 2358type, 2359specify the 2360.Dq Li mousesystems 2361type. 2362It is the second preferred type. 2363.It Va moused_port 2364.Pq Vt str 2365If 2366.Va moused_enable 2367is set to 2368.Dq Li YES , 2369this is the actual port the mouse is on. 2370It might be 2371.Pa /dev/cuad0 2372for a COM1 serial mouse, 2373.Pa /dev/psm0 2374for a PS/2 mouse or 2375.Pa /dev/mse0 2376for a bus mouse, for example. 2377.It Va moused_flags 2378.Pq Vt str 2379If 2380.Va moused_type 2381is set, these are the additional flags to pass to the 2382.Xr moused 8 2383daemon. 2384.It Va mousechar_start 2385.Pq Vt int 2386If set to 2387.Dq Li NO , 2388the default mouse cursor character range 2389.Li 0xd0 Ns - Ns Li 0xd3 2390is used, 2391otherwise the range start is set 2392to 2393.Ar value 2394character, see 2395.Xr vidcontrol 1 . 2396Use if the default range is occupied in the language code table. 2397.It Va allscreens_flags 2398.Pq Vt str 2399If set, 2400.Xr vidcontrol 1 2401is run with these options for each of the virtual terminals 2402.Pq Pa /dev/ttyv* . 2403For example, 2404.Dq Fl m Cm on 2405will enable the mouse pointer on all virtual terminals 2406if 2407.Va moused_enable 2408is set to 2409.Dq Li YES . 2410.It Va allscreens_kbdflags 2411.Pq Vt str 2412If set, 2413.Xr kbdcontrol 1 2414is run with these options for each of the virtual terminals 2415.Pq Pa /dev/ttyv* . 2416For example, 2417.Dq Fl h Li 200 2418will set the 2419.Xr syscons 4 2420scrollback (history) buffer to 200 lines. 2421.It Va cron_enable 2422.Pq Vt bool 2423If set to 2424.Dq Li YES , 2425run the 2426.Xr cron 8 2427daemon at system boot time. 2428.It Va cron_program 2429.Pq Vt str 2430Path to 2431.Xr cron 8 2432(default 2433.Pa /usr/sbin/cron ) . 2434.It Va cron_flags 2435.Pq Vt str 2436If 2437.Va cron_enable 2438is set to 2439.Dq Li YES , 2440these are the flags to pass to 2441.Xr cron 8 . 2442.It Va cron_dst 2443.Pq Vt bool 2444If set to 2445.Dq Li YES , 2446enable the special handling of transitions to and from the 2447Daylight Saving Time in 2448.Xr cron 8 2449(equivalent to using the flag 2450.Fl s ) . 2451.It Va lpd_program 2452.Pq Vt str 2453Path to 2454.Xr lpd 8 2455(default 2456.Pa /usr/sbin/lpd ) . 2457.It Va lpd_enable 2458.Pq Vt bool 2459If set to 2460.Dq Li YES , 2461run the 2462.Xr lpd 8 2463daemon at system boot time. 2464.It Va lpd_flags 2465.Pq Vt str 2466If 2467.Va lpd_enable 2468is set to 2469.Dq Li YES , 2470these are the flags to pass to the 2471.Xr lpd 8 2472daemon. 2473.It Va mta_start_script 2474.Pq Vt str 2475This variable specifies the full path to the script to run to start 2476a mail transfer agent. 2477The default is 2478.Pa /etc/rc.sendmail . 2479The 2480.Va sendmail_* 2481variables which 2482.Pa /etc/rc.sendmail 2483uses are documented in the 2484.Xr rc.sendmail 8 2485man page. 2486.It Va dumpdev 2487.Pq Vt str 2488Indicates the device (usually a swap partition) to which a crash dump 2489should be written in the event of a system crash. 2490If the value of this variable is 2491.Dq Li AUTO , 2492the first suitable swap device listed in 2493.Pa /etc/fstab 2494will be used as dump device. 2495Otherwise, the value of this variable is passed as the argument to 2496.Xr dumpon 8 . 2497To disable crash dumps, set this variable to 2498.Dq Li NO . 2499.It Va dumpdir 2500.Pq Vt str 2501When the system reboots after a crash and a crash dump is found on the 2502device specified by the 2503.Va dumpdev 2504variable, 2505.Xr savecore 8 2506will save that crash dump and a copy of the kernel to the directory 2507specified by the 2508.Va dumpdir 2509variable. 2510The default value is 2511.Pa /var/crash . 2512Set to 2513.Dq Li NO 2514to not run 2515.Xr savecore 8 2516at boot time when 2517.Va dumpdir 2518is set. 2519.It Va savecore_flags 2520.Pq Vt str 2521If crash dumps are enabled, these are the flags to pass to the 2522.Xr savecore 8 2523utility. 2524.It Va enable_quotas 2525.Pq Vt bool 2526Set to 2527.Dq Li YES 2528to turn on user disk quotas on system startup via the 2529.Xr quotaon 8 2530command. 2531.It Va check_quotas 2532.Pq Vt bool 2533Set to 2534.Dq Li YES 2535to enable user disk quota checking via the 2536.Xr quotacheck 8 2537command. 2538.It Va accounting_enable 2539.Pq Vt bool 2540Set to 2541.Dq Li YES 2542to enable system accounting through the 2543.Xr accton 8 2544facility. 2545.It Va ibcs2_enable 2546.Pq Vt bool 2547Set to 2548.Dq Li YES 2549to enable iBCS2 (SCO) binary emulation at system initial boot 2550time. 2551.It Va ibcs2_loaders 2552.Pq Vt str 2553If not set to 2554.Dq Li NO 2555and if 2556.Va ibcs2_enable 2557is set to 2558.Dq Li YES , 2559this specifies a list of additional iBCS2 loaders to enable. 2560.It Va linux_enable 2561.Pq Vt bool 2562Set to 2563.Dq Li YES 2564to enable Linux/ELF binary emulation at system initial 2565boot time. 2566.It Va osf1_enable 2567.Pq Vt bool 2568Set to 2569.Dq Li YES 2570to enable OSF/1 (Digital UNIX) binary emulation at system 2571initial boot time. 2572(alpha) 2573.It Va svr4_enable 2574.Pq Vt bool 2575If set to 2576.Dq Li YES , 2577enable SysVR4 emulation at boot time. 2578.It Va sysvipc_enable 2579.Pq Vt bool 2580If set to 2581.Dq Li YES , 2582load System V IPC primitives at boot time. 2583.It Va clear_tmp_enable 2584.Pq Vt bool 2585Set to 2586.Dq Li YES 2587to have 2588.Pa /tmp 2589cleaned at startup. 2590.It Va ldconfig_paths 2591.Pq Vt str 2592Set to the list of shared library paths to use with 2593.Xr ldconfig 8 . 2594NOTE: 2595.Pa /usr/lib 2596will always be added first, so it need not appear in this list. 2597.It Va ldconfig_paths_aout 2598.Pq Vt str 2599Set to the list of shared library paths to use with 2600.Xr ldconfig 8 2601legacy 2602.Xr a.out 5 2603support. 2604.It Va ldconfig_insecure 2605.Pq Vt bool 2606The 2607.Xr ldconfig 8 2608utility normally refuses to use directories 2609which are writable by anyone except root. 2610Set this variable to 2611.Dq Li YES 2612to disable that security check during system startup. 2613.It Va kern_securelevel_enable 2614.Pq Vt bool 2615Set to 2616.Dq Li YES 2617to set the kernel security level at system startup. 2618.It Va kern_securelevel 2619.Pq Vt int 2620The kernel security level to set at startup. 2621The allowed range of 2622.Ar value 2623ranges from \-1 (the compile time default) to 3 (the 2624most secure). 2625See 2626.Xr init 8 2627for the list of possible security levels and their effect 2628on system operation. 2629.It Va lomac_enable 2630.Pq Vt bool 2631Set to 2632.Dq Li YES 2633to enable Low Watermark Mandatory Access Control (LOMAC) at boot time. 2634This security model enforces integrity constraints for system processes; 2635see 2636.Xr mac_lomac 4 2637for a complete description of the LOMAC model, as well as its impact 2638on system operation. 2639.It Va sshd_program 2640.Pq Vt str 2641Path to the SSH server program 2642.Pa ( /usr/sbin/sshd 2643is the default). 2644.It Va sshd_enable 2645.Pq Vt bool 2646Set to 2647.Dq Li YES 2648to start 2649.Xr sshd 8 2650at system boot time. 2651.It Va sshd_flags 2652.Pq Vt str 2653If 2654.Va sshd_enable 2655is set to 2656.Dq Li YES , 2657these are the flags to pass to the 2658.Xr sshd 8 2659daemon. 2660.It Va usbd_enable 2661.Pq Vt bool 2662If set to 2663.Dq Li YES , 2664run the 2665.Xr usbd 8 2666daemon at boot time. 2667.It Va usbd_flags 2668.Pq Vt str 2669If 2670.Va usbd_enable 2671is set to 2672.Dq Li YES , 2673these are the flags passed to the 2674.Xr usbd 8 2675daemon. 2676.It Va watchdogd_enable 2677.Pq Vt bool 2678If set to 2679.Dq Li YES , 2680start the 2681.Xr watchdogd 8 2682daemon at boot time. 2683This requires that the kernel have been compiled with a 2684.Xr watchdog 4 2685compatible device. 2686.It Va watchdogd_flags 2687.Pq Vt str 2688If 2689.Va watchdogd_enable 2690is set to 2691.Dq Li YES , 2692these are the flags passed to the 2693.Xr watchdogd 8 2694daemon. 2695.It Va performance_cx_lowest 2696.Pq Vt str 2697CPU idle state to use while on AC power. 2698The string 2699.Dq Li LOW 2700indicates that 2701.Xr acpi 4 2702should use the lowest power state available while 2703.Dq Li HIGH 2704indicates that the lowest latency state (less power savings) should be used. 2705.It Va performance_cpu_freq 2706.Pq Vt str 2707CPU clock frequency to use while on AC power. 2708The string 2709.Dq Li LOW 2710indicates that 2711.Xr cpufreq 4 2712should use the lowest frequency available while 2713.Dq Li HIGH 2714indicates that the highest frequency (less power savings) should be used. 2715.It Va economy_cx_lowest 2716.Pq Vt str 2717CPU idle state to use when off AC power. 2718The string 2719.Dq Li LOW 2720indicates that 2721.Xr acpi 4 2722should use the lowest power state available while 2723.Dq Li HIGH 2724indicates that the lowest latency state (less power savings) should be used. 2725.It Va economy_cpu_freq 2726.Pq Vt str 2727CPU clock frequency to use when off AC power. 2728The string 2729.Dq Li LOW 2730indicates that 2731.Xr cpufreq 4 2732should use the lowest frequency available while 2733.Dq Li HIGH 2734indicates that the highest frequency (less power savings) should be used. 2735.It Va jail_enable 2736.Pq Vt bool 2737If set to 2738.Dq Li NO , 2739any configured jails will not be started. 2740.It Va jail_list 2741.Pq Vt str 2742A space separated list of names for jails. 2743This is purely a configuration aid to help identify and 2744configure multiple jails. 2745The names specified in this list will be used to 2746identify settings common to an instance of a jail. 2747Assuming that the jail in question was named 2748.Li vjail , 2749you would have the following dependant variables: 2750.Bd -literal 2751jail_vjail_hostname="jail.example.com" 2752jail_vjail_ip="192.168.1.100" 2753jail_vjail_rootdir="/var/jails/vjail/root" 2754jail_vjail_exec="/bin/sh /etc/rc" 2755.Ed 2756.Pp 2757The last one is optional. 2758It defaults to 2759.Pa /etc/rc 2760if it is not set. 2761.It Va jail_set_hostname_allow 2762.Pq Vt bool 2763If set to 2764.Dq Li NO , 2765do not allow the root user in a jail to set its hostname. 2766.It Va jail_socket_unixiproute_only 2767.Pq Vt bool 2768If set to 2769.Dq Li NO , 2770do not allow any protocol, 2771besides TCP/IP, 2772to be used within a jail. 2773.It Va jail_sysvipc_allow 2774.Pq Vt bool 2775If set to 2776.Dq Li YES , 2777allow applications within a jail to use System V IPC. 2778.It Va unaligned_print 2779.Pq Vt bool 2780If set to 2781.Dq Li NO , 2782unaligned access warnings will not be printed. 2783(alpha) 2784.\" ----- isdn settings --------------------------------- 2785.It Va isdn_enable 2786.Pq Vt bool 2787Set to 2788.Dq Li NO 2789by default. 2790When set to 2791.Dq Li YES , 2792starts the 2793.Xr isdnd 8 2794daemon 2795at system boot time. 2796.It Va isdn_flags 2797.Pq Vt str 2798Set to 2799.Dq Fl d Ns Cm n Fl d Ns Li 0x1f9 2800by default. 2801Additional flags to pass to 2802.Xr isdnd 8 2803(but see 2804.Va isdn_fsdev 2805and 2806.Va isdn_ttype 2807for certain tunable parameters). 2808.It Va isdn_ttype 2809.Pq Vt str 2810Set to 2811.Dq Li cons25 2812by default. 2813The terminal type of the output device when 2814.Xr isdnd 8 2815operates in full-screen mode. 2816.It Va isdn_screenflags 2817.Pq Vt str 2818Set to 2819.Dq Li NO 2820by default. 2821The video mode for full-screen mode (only for 2822.Xr syscons 4 2823console driver, see 2824.Xr vidcontrol 1 2825for valid modes). 2826.It Va isdn_fsdev 2827.Pq Vt str 2828Set to 2829.Dq Li NO 2830by default. 2831The output device for 2832.Xr isdnd 8 2833in full-screen mode (or 2834.Dq Li NO 2835for daemon mode). 2836.It Va isdn_trace 2837.Pq Vt bool 2838Set to 2839.Dq Li NO 2840by default. 2841When set to 2842.Dq Li YES , 2843enables the ISDN protocol trace utility 2844.Xr isdntrace 8 2845at system boot time. 2846.It Va isdn_traceflags 2847.Pq Vt str 2848Set to 2849.Dq Fl f Pa /var/tmp/isdntrace0 2850by default. 2851Flags for 2852.Xr isdntrace 8 . 2853.\" ----------------------------------------------------- 2854.It Va pcvt_verbose 2855.Pq Vt bool 2856Set to 2857.Dq Li NO 2858by default. 2859When set to 2860.Dq Li YES , 2861verbose messages about the actions done by the start script are displayed. 2862.Em Note : 2863the 2864.Xr pcvt 4 2865driver must be compiled into the kernel before the 2866.Xr pcvt 4 2867related 2868options described here take any effect. 2869.It Va pcvt_keymap 2870.Pq Vt str 2871Set to 2872.Dq Li NO 2873by default. 2874Use this to configure a national keyboard mapping found in the 2875.Pa /usr/share/misc/keycap.pcvt 2876file of keyboard mappings. 2877(See also the manual pages 2878.Xr keycap 5 2879and 2880.Xr keycap 3 2881for usage of 2882.Xr pcvt 4 Ns 's 2883keycap database and the manual page 2884.Xr kcon 1 2885option 2886.Fl m 2887for national keyboard mapping configuration.) 2888.It Va pcvt_keydel 2889.Pq Vt int 2890Set to 2891.Dq Li NO 2892by default. 2893Used to set the keyboard key repeat delay value. 2894Valid values are 2895in the range 0..3 for delay values of 250, 500, 750 and 1000 msec. 2896(See also the 2897.Xr kcon 1 2898manual page.) 2899.It Va pcvt_keyrate 2900.Pq Vt int 2901Set to 2902.Dq Li NO 2903by default. 2904Used to set the keyboard key repetition rate value. 2905Valid values are 2906in the range 0..31 for repetition values of 2..30 characters per second. 2907.It Va pcvt_keyrepeat 2908.Pq Vt bool 2909Set to 2910.Dq Li NO 2911by default. 2912Set to 2913.Dq Li YES 2914to enable automatic keyboard key repeating. 2915.It Va pcvt_force24 2916.Pq Vt bool 2917Set to 2918.Dq Li NO 2919by default. 2920Set to 2921.Dq Li YES 2922to force 2923.Xr pcvt 4 2924to use 24 lines only (in 25 lines mode) for compatibility 2925with the original 2926.Tn VT220 2927terminal. 2928.It Va pcvt_hpext 2929.Pq Vt bool 2930Set to 2931.Dq Li NO 2932by default. 2933Set to 2934.Dq Li YES 2935to enable the display and functionality of function key labels (as found 2936on 2937.Tn Hewlett-Packard 2938terminals such as the 2939.Tn HP2392A 2940and the 2941.Tn HP700/92 2942in 2943.Tn ANSI 2944mode). 2945.It Va pcvt_lines 2946.Pq Vt int 2947Set to 2948.Dq Li NO 2949by default resulting in a value of 25. 2950Used to set the number of lines on the screen. 2951For VGA displays, valid 2952values are 25, 28, 40 and 50 lines. 2953(See also the 2954.Xr scon 1 2955manual page.) 2956.It Va pcvt_blanktime 2957.Pq Vt int 2958Set to 2959.Dq Li NO 2960by default. 2961Used to set the screen saver timeout in seconds for values greater than 2962zero. 2963.It Va pcvt_cursorh 2964.Pq Vt int 2965Set to 2966.Dq Li NO 2967by default. 2968Used to set the cursor top scanline. 2969(See also the 2970.Xr cursor 1 2971manual page.) 2972.It Va pcvt_cursorl 2973.Pq Vt int 2974Set to 2975.Dq Li NO 2976by default. 2977Used to set the cursor bottom scanline. 2978.It Va pcvt_monohigh 2979.Pq Vt bool 2980Set to 2981.Dq Li NO 2982by default. 2983Set to 2984.Dq Li YES 2985to set intensity to high on monochrome monitors. 2986(See also the 2987.Xr scon 1 2988manual page, option 2989.Fl p , 2990for more information on changing VGA palette 2991values.) 2992.It Va harvest_interrupt 2993.Pq Vt bool 2994Set to 2995.Dq Li YES 2996to use hardware interrupts as an entropy source. 2997Refer to 2998.Xr random 4 2999for more information. 3000.It Va harvest_ethernet 3001.Pq Vt bool 3002Set to 3003.Dq Li YES 3004to use LAN traffic as an entropy source. 3005Refer to 3006.Xr random 4 3007for more information. 3008.It Va harvest_p_to_p 3009.Pq Vt bool 3010Set to 3011.Dq Li YES 3012to use serial line traffic as an entropy source. 3013Refer to 3014.Xr random 4 3015for more information. 3016.It Va entropy_dir 3017.Pq Vt str 3018Set to 3019.Dq Li NO 3020to disable caching entropy via 3021.Xr cron 8 . 3022Otherwise set to the directory used to store entropy files in. 3023.It Va entropy_file 3024.Pq Vt str 3025Set to 3026.Dq Li NO 3027to disable caching entropy through reboots. 3028Otherwise set to the filename used to store cached entropy through 3029reboots. 3030This file should be located on the root file system to seed the 3031.Xr random 4 3032device as early as possible in the boot process. 3033.It Va entropy_save_sz 3034.Pq Vt int 3035Size of the entropy cache files saved by 3036.Nm save-entropy 3037periodically. 3038.It Va entropy_save_num 3039.Pq Vt int 3040Number of entropy cache files to save by 3041.Nm save-entropy 3042periodically. 3043.It Va ipsec_enable 3044.Pq Vt bool 3045Set to 3046.Dq Li YES 3047to run 3048.Xr setkey 8 3049on 3050.Va ipsec_file 3051at boot time. 3052.It Va ipsec_file 3053.Pq Vt str 3054Configuration file for 3055.Xr setkey 8 . 3056.It Va dmesg_enable 3057.Pq Vt bool 3058Set to 3059.Dq Li YES 3060to save 3061.Xr dmesg 8 3062to 3063.Pa /var/run/dmesg.boot 3064on boot. 3065.It Va rcshutdown_timeout 3066.Pq Vt int 3067If set, start a watchdog timer in the background which will terminate 3068.Pa rc.shutdown 3069if 3070.Xr shutdown 8 3071has not completed within the specified time (in seconds). 3072.It Va virecover_enable 3073.Pq Vt bool 3074Set to 3075.Dq Li NO 3076to prevent the system from trying to 3077recover pre-maturely terminated 3078.Xr vi 1 3079sessions. 3080.It Va ugidfw_enable 3081.Pq Vt bool 3082Set to 3083.Dq Li YES 3084to load the 3085.Xr mac_bsdextended 4 3086module upon system initialization and load a default 3087ruleset file. 3088.It Va bsdextended_script 3089.Pq Vt str 3090The default 3091.Xr mac_bsdextended 4 3092ruleset file to load. 3093The default value of this variable is 3094.Pa /etc/rc.bsdextended . 3095.It Va ramdisk_units 3096.Pq Vt str 3097A list of one or more ramdisk units to configure with 3098.Xr mdconfig 8 3099and 3100.Xr newfs 8 3101in time to be mounted from 3102.Xr fstab 5 . 3103Each listed unit 3104.Ar X 3105must specify at least a 3106.Ar type 3107in a 3108.Va ramdisk_ Ns Ao Ar X Ac Ns Va _config 3109variable. 3110.It Va ramdisk_ Ns Ao Ar X Ac Ns Va _config 3111.Pq Vt str 3112Arguments to 3113.Xr mdconfig 8 3114for ramdisk 3115.Ar X . 3116At minimum a 3117.Fl t Ar type 3118must be specified, where 3119.Ar type 3120must be one of 3121.Cm malloc 3122or 3123.Cm swap . 3124.It Va ramdisk_ Ns Ao Ar X Ac Ns Va _newfs 3125.Pq Vt str 3126Optional arguments passed to 3127.Xr newfs 8 3128to initialize ramdisk 3129.Ar X . 3130.It Va ramdisk_ Ns Ao Ar X Ac Ns Va _owner 3131.Pq Vt str 3132An ownership specification passed to 3133.Xr chown 8 3134after the specified ramdisk unit 3135.Ar X 3136has been mounted. 3137Both the 3138.Xr md 4 3139device and the mount point will be changed. 3140.It Va ramdisk_ Ns Ao Ar X Ac Ns Va _perms 3141.Pq Vt str 3142A mode string passed to 3143.Xr chmod 1 3144after the specified ramdisk unit 3145.Ar X 3146has been mounted. 3147Both the 3148.Xr md 4 3149device and the mount point will be changed. 3150.El 3151.Sh FILES 3152.Bl -tag -width ".Pa /etc/defaults/rc.conf" -compact 3153.It Pa /etc/defaults/rc.conf 3154.It Pa /etc/rc.conf 3155.It Pa /etc/rc.conf.local 3156.El 3157.Sh SEE ALSO 3158.Xr catman 1 , 3159.Xr chmod 1 , 3160.Xr gdb 1 , 3161.Xr info 1 , 3162.Xr kbdcontrol 1 , 3163.Xr makewhatis 1 , 3164.Xr vi 1 , 3165.Xr vidcontrol 1 , 3166.Xr ip 4 , 3167.Xr kld 4 , 3168.Xr tcp 4 , 3169.Xr udp 4 , 3170.Xr exports 5 , 3171.Xr motd 5 , 3172.Xr newsyslog.conf 5 , 3173.Xr accton 8 , 3174.Xr amd 8 , 3175.Xr apm 8 , 3176.Xr atm 8 , 3177.Xr chown 8 , 3178.Xr cron 8 , 3179.Xr dhclient 8 , 3180.Xr ifconfig 8 , 3181.Xr inetd 8 , 3182.Xr isdnd 8 , 3183.Xr isdntrace 8 , 3184.Xr kldxref 8 , 3185.Xr lpd 8 , 3186.Xr mdconfig 8 , 3187.Xr mdmfs 8 , 3188.Xr mountd 8 , 3189.Xr moused 8 , 3190.Xr mrouted 8 , 3191.Xr named 8 , 3192.Xr newfs 8 , 3193.Xr nfsd 8 , 3194.Xr ntpd 8 , 3195.Xr ntpdate 8 , 3196.Xr pcnfsd 8 , 3197.Xr quotacheck 8 , 3198.Xr quotaon 8 , 3199.Xr rc 8 , 3200.Xr rc.sendmail 8 , 3201.Xr route 8 , 3202.Xr routed 8 , 3203.Xr rpcbind 8 , 3204.Xr rpc.lockd 8 , 3205.Xr rpc.statd 8 , 3206.Xr rwhod 8 , 3207.Xr savecore 8 , 3208.Xr sshd 8 , 3209.Xr swapon 8 , 3210.Xr sysctl 8 , 3211.Xr syslogd 8 , 3212.Xr timed 8 , 3213.Xr usbd 8 , 3214.Xr yp 8 , 3215.Xr ypbind 8 , 3216.Xr ypserv 8 , 3217.Xr ypset 8 3218.Sh HISTORY 3219The 3220.Nm 3221file appeared in 3222.Fx 2.2.2 . 3223.Sh AUTHORS 3224.An Jordan K. Hubbard . 3225