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 -o noexec,nosuid,nodev , 251which inhibits the use of softupdates on 252.Pa /tmp 253to waste as little space as possible and mounts the memory file system 254.Dq Li noexec,nosuid,nodev . 255See 256.Xr mdmfs 8 257for other options you can use in 258.Li tmpmfs_flags . 259.It Va varmfs 260Controls the creation of a 261.Pa /var 262memory file system. 263Always happens if set to 264.Dq Li YES 265and never happens if set to 266.Dq Li NO . 267If set to anything else, a memory file system is created if 268.Pa /var 269is not writable. 270.It Va varsize 271Controls the size of a created 272.Pa /var 273memory file system. 274.It Va varmfs_flags 275Extra options passed to the 276.Xr mdmfs 8 277utility when the memory file system for 278.Pa /var 279is created. 280The default is 281.Dq Li -S , 282which inhibits the use of softupdates on 283.Pa /var 284to waste as little space as possible. 285See 286.Xr mdmfs 8 287for other options you can use in 288.Li varmfs_flags . 289.It Va populate_var 290Controls the automatic population of the 291.Pa /var 292file system. 293Always happens if set to 294.Dq Li YES 295and never happens if set to 296.Dq Li NO . 297If set to anything else, a memory file system is created if 298.Pa /var 299is not writable. 300Note that this process requires access to certain commands in 301.Pa /usr 302before 303.Pa /usr 304is mounted on normal systems. 305.It Va local_startup 306.Pq Vt str 307List of directories to search for startup script files. 308.It Va script_name_sep 309.Pq Vt str 310The field separator to use for breaking down the list of startup script files 311into individual filenames. 312The default is a space. 313It is not necessary to change this unless there are startup scripts with names 314containing spaces. 315.It Va hostname 316.Pq Vt str 317The fully qualified domain name (FQDN) of this host on the network. 318This should almost certainly be set to something meaningful, even if 319there is no network connection. 320If 321.Xr dhclient 8 322is used to set the hostname via DHCP, 323this variable should be set to an empty string. 324.It Va ipv6_enable 325.Pq Vt bool 326Enable support for IPv6 networking. 327Note that this requires that the kernel have been compiled with 328.Cd "options INET6" . 329.It Va nisdomainname 330.Pq Vt str 331The NIS domain name of this host, or 332.Dq Li NO 333if NIS is not used. 334.It Va dhclient_program 335.Pq Vt str 336Path to the DHCP client program 337.Pa ( /sbin/dhclient , 338the ISC DHCP client, 339is the default). 340.It Va dhclient_flags 341.Pq Vt str 342Additional flags to pass to the DHCP client program. 343For the ISC DHCP client, see the 344.Xr dhclient 8 345manpage for a description of the command line options available. 346.It Va background_dhclient 347.Pq Vt bool 348Set to 349.Dq Li YES 350to start the dhcp client in background. 351This can cause trouble with applications depending on 352a working network, but it will provide a faster startup 353in many cases. 354.It Va firewall_enable 355.Pq Vt bool 356Set to 357.Dq Li YES 358to load firewall rules at startup. 359If the kernel was not built with 360.Cd "options IPFIREWALL" , 361the 362.Pa ipfw.ko 363kernel module will be loaded. 364See also 365.Va ipfilter_enable . 366.It Va ipv6_firewall_enable 367.Pq Vt bool 368The IPv6 equivalent of 369.Va firewall_enable . 370Set to 371.Dq Li YES 372to load IPv6 firewall rules at startup. 373If the kernel was not built with 374.Cd "options IPV6FIREWALL" , 375the 376.Pa ip6fw.ko 377kernel module will be loaded. 378.It Va firewall_script 379.Pq Vt str 380This variable specifies the full path to the firewall script to run. 381The default is 382.Pa /etc/rc.firewall . 383.It Va ipv6_firewall_script 384.Pq Vt str 385The IPv6 equivalent of 386.Va firewall_script . 387.It Va firewall_type 388.Pq Vt str 389Names the firewall type from the selection in 390.Pa /etc/rc.firewall , 391or the file which contains the local firewall ruleset. 392Valid selections from 393.Pa /etc/rc.firewall 394are: 395.Pp 396.Bl -tag -width ".Li simple" -compact 397.It Li open 398unrestricted IP access 399.It Li closed 400all IP services disabled, except via 401.Dq Li lo0 402.It Li client 403basic protection for a workstation 404.It Li simple 405basic protection for a LAN. 406.El 407.Pp 408If a filename is specified, the full path 409must be given. 410.It Va ipv6_firewall_type 411.Pq Vt str 412The IPv6 equivalent of 413.Va firewall_type . 414.It Va firewall_quiet 415.Pq Vt bool 416Set to 417.Dq Li YES 418to disable the display of firewall rules on the console during boot. 419.It Va ipv6_firewall_quiet 420.Pq Vt bool 421The IPv6 equivalent of 422.Va firewall_quiet . 423.It Va firewall_logging 424.Pq Vt bool 425Set to 426.Dq Li YES 427to enable firewall event logging. 428This is equivalent to the 429.Dv IPFIREWALL_VERBOSE 430kernel option. 431.It Va ipv6_firewall_logging 432.Pq Vt bool 433The IPv6 equivalent of 434.Va firewall_logging . 435.It Va firewall_flags 436.Pq Vt str 437Flags passed to 438.Xr ipfw 8 439if 440.Va firewall_type 441specifies a filename. 442.It Va ipv6_firewall_flags 443.Pq Vt str 444The IPv6 equivalent of 445.Va firewall_flags . 446.It Va natd_program 447.Pq Vt str 448Path to 449.Xr natd 8 . 450.It Va natd_enable 451.Pq Vt bool 452Set to 453.Dq Li YES 454to enable 455.Xr natd 8 . 456.Va firewall_enable 457must also be set to 458.Dq Li YES , 459and 460.Xr divert 4 461sockets must be enabled in the kernel. 462If the kernel was not built with 463.Cd "options IPDIVERT" , 464the 465.Pa ipdivert.ko 466kernel module will be loaded. 467.It Va natd_interface 468.Pq Vt str 469This is the name of the public interface on which 470.Xr natd 8 471should run. 472The interface may be given as an interface name or as an IP address. 473.It Va natd_flags 474.Pq Vt str 475Additional 476.Xr natd 8 477flags should be placed here. 478The 479.Fl n 480or 481.Fl a 482flag is automatically added with the above 483.Va natd_interface 484as an argument. 485.\" ----- ipfilter_enable setting -------------------------------- 486.It Va ipfilter_enable 487.Pq Vt bool 488Set to 489.Dq Li NO 490by default. 491Setting this to 492.Dq Li YES 493enables 494.Xr ipf 8 495packet filtering. 496.Pp 497Typical usage will require putting 498.Bd -literal 499ipfilter_enable="YES" 500ipnat_enable="YES" 501ipmon_enable="YES" 502ipfs_enable="YES" 503.Ed 504.Pp 505into 506.Pa /etc/rc.conf 507and editing 508.Pa /etc/ipf.rules 509and 510.Pa /etc/ipnat.rules 511appropriately. 512.Pp 513Note that 514.Va ipfilter_enable 515and 516.Va ipnat_enable 517can be enabled independently. 518.Va ipmon_enable 519and 520.Va ipfs_enable 521both require at least one of 522.Va ipfilter_enable 523and 524.Va ipnat_enable 525to be enabled. 526.Pp 527Having 528.Bd -literal 529options IPFILTER 530options IPFILTER_LOG 531options IPFILTER_DEFAULT_BLOCK 532.Ed 533.Pp 534in the kernel configuration file is a good idea, too. 535.\" ----- ipfilter_program setting ------------------------------ 536.It Va ipfilter_program 537.Pq Vt str 538Path to 539.Xr ipf 8 540(default 541.Pa /sbin/ipf ) . 542.\" ----- ipfilter_rules setting -------------------------------- 543.It Va ipfilter_rules 544.Pq Vt str 545Set to 546.Pa /etc/ipf.rules 547by default. 548This variable contains the name of the filter rule definition file. 549The file is expected to be readable for the 550.Xr ipf 8 551command to execute. 552.\" ----- ipv6_ipfilter_rules setting --------------------------- 553.It Va ipv6_ipfilter_rules 554.Pq Vt str 555Set to 556.Pa /etc/ipf6.rules 557by default. 558This variable contains the IPv6 filter rule definition file. 559The file is expected to be readable for the 560.Xr ipf 8 561command to execute. 562.\" ----- ipfilter_flags setting -------------------------------- 563.It Va ipfilter_flags 564.Pq Vt str 565Empty by default. 566This variable contains flags passed to the 567.Xr ipf 8 568program. 569.\" ----- ipnat_enable setting ---------------------------------- 570.It Va ipnat_enable 571.Pq Vt bool 572Set to 573.Dq Li NO 574by default. 575Set it to 576.Dq Li YES 577to enable 578.Xr ipnat 1 579network address translation. 580See 581.Va ipfilter_enable 582for a detailed discussion. 583.\" ----- ipnat_program setting --------------------------------- 584.It Va ipnat_program 585.Pq Vt str 586Path to 587.Xr ipnat 1 588(default 589.Pa /sbin/ipnat ) . 590.\" ----- ipnat_rules setting ----------------------------------- 591.It Va ipnat_rules 592.Pq Vt str 593Set to 594.Pa /etc/ipnat.rules 595by default. 596This variable contains the name of the file 597holding the network address translation definition. 598This file is expected to be readable for the 599.Xr ipnat 1 600command to execute. 601.\" ----- ipnat_flags setting ----------------------------------- 602.It Va ipnat_flags 603.Pq Vt str 604Empty by default. 605This variable contains flags passed to the 606.Xr ipnat 1 607program. 608.\" ----- ipmon_enable setting ---------------------------------- 609.It Va ipmon_enable 610.Pq Vt bool 611Set to 612.Dq Li NO 613by default. 614Set it to 615.Dq Li YES 616to enable 617.Xr ipmon 8 618monitoring (logging 619.Xr ipf 8 620and 621.Xr ipnat 1 622events). 623Setting this variable needs setting 624.Va ipfilter_enable 625or 626.Va ipnat_enable 627too. 628See 629.Va ipfilter_enable 630for a detailed discussion. 631.\" ----- ipmon_program setting --------------------------------- 632.It Va ipmon_program 633.Pq Vt str 634Path to 635.Xr ipmon 8 636(default 637.Pa /sbin/ipmon ) . 638.\" ----- ipmon_flags setting ----------------------------------- 639.It Va ipmon_flags 640.Pq Vt str 641Set to 642.Dq Li -Ds 643by default. 644This variable contains flags passed to the 645.Xr ipmon 8 646program. 647Another typical example would be 648.Dq Fl D Pa /var/log/ipflog 649to have 650.Xr ipmon 8 651log directly to a file bypassing 652.Xr syslogd 8 . 653Make sure to adjust 654.Pa /etc/newsyslog.conf 655in such case like this: 656.Bd -literal 657/var/log/ipflog 640 10 100 * Z /var/run/ipmon.pid 658.Ed 659.\" ----- ipfs_enable setting ----------------------------------- 660.It Va ipfs_enable 661.Pq Vt bool 662Set to 663.Dq Li NO 664by default. 665Set it to 666.Dq Li YES 667to enable 668.Xr ipfs 8 669saving the filter and NAT state tables during shutdown 670and reloading them during startup again. 671Setting this variable needs setting 672.Va ipfilter_enable 673or 674.Va ipnat_enable 675to 676.Dq Li YES 677too. 678See 679.Va ipfilter_enable 680for a detailed discussion. 681Note that if 682.Va kern_securelevel 683is set to 3, 684.Va ipfs_enable 685cannot be used 686because the raised securelevel will prevent 687.Xr ipfs 8 688from saving the state tables at shutdown time. 689.\" ----- ipfs_program setting ---------------------------------- 690.It Va ipfs_program 691.Pq Vt str 692Path to 693.Xr ipfs 8 694(default 695.Pa /sbin/ipfs ) . 696.\" ----- ipfs_flags setting ------------------------------------ 697.It Va ipfs_flags 698.Pq Vt str 699Empty by default. 700This variable contains flags passed to the 701.Xr ipfs 8 702program. 703.\" ----- end of added ipf hook --------------------------------- 704.It Va pf_enable 705.Pq Vt bool 706Set to 707.Dq Li NO 708by default. 709Setting this to 710.Dq Li YES 711enables 712.Xr pf 4 713packet filtering. 714.Pp 715Typical usage will require putting 716.Pp 717.Dl pf_enable="YES" 718.Pp 719into 720.Pa /etc/rc.conf 721and editing 722.Pa /etc/pf.conf 723appropriately. 724.Pp 725.Dl "device pf" 726.Pp 727builds pf into the kernel. 728Otherwise it is loaded from a module. 729.It Va pf_rules 730.Pq Vt str 731Path to 732.Xr pf 4 733ruleset configuration file 734(default 735.Pa /etc/pf.conf ) . 736.It Va pf_program 737.Pq Vt str 738Path to 739.Xr pfctl 8 740(default 741.Pa /sbin/pfctl ) . 742.It Va pf_flags 743.Pq Vt str 744If 745.Va pf_enable 746is set to 747.Dq Li YES , 748these flags are passed to the 749.Xr pfctl 8 750program when loading the ruleset. 751.It Va pflog_enable 752.Pq Vt bool 753Set to 754.Dq Li NO 755by default. 756Setting this to 757.Dq Li YES 758enables 759.Xr pflogd 8 760which logs packtes from the 761.Xr pf 4 762packet filter. 763.It Va pflog_logfile 764.Pq Vt str 765If 766.Va pflog_enable 767is set to 768.Dq Li YES 769this controls where 770.Xr pflogd 8 771stores the logfile 772(default 773.Pa /var/log/pflog ) . 774Check 775.Pa /etc/newsyslog.conf 776to adjust logfile rotation for this. 777.It Va pflog_program 778.Pq Vt str 779Path to 780.Xr pflogd 8 781(default 782.Pa /sbin/pflogd ) . 783.It Va pflog_flags 784.Pq Vt str 785Empty by default. 786This variable contains additional flags passed to the 787.Xr pflogd 8 788program. 789.It Va tcp_extensions 790.Pq Vt bool 791Set to 792.Dq Li YES 793by default. 794Setting this to 795.Dq Li NO 796disables certain TCP options as described by 797.Rs 798.%T "RFC 1323" 799.Re 800Setting this to 801.Dq Li NO 802might help remedy such problems with connections as randomly hanging 803or other weird behavior. 804Some network devices are known 805to be broken with respect to these options. 806.It Va log_in_vain 807.Pq Vt int 808Set to 0 by default. 809The 810.Xr sysctl 8 811variables, 812.Va net.inet.tcp.log_in_vain 813and 814.Va net.inet.udp.log_in_vain , 815as described in 816.Xr tcp 4 817and 818.Xr udp 4 , 819are set to the given value. 820.It Va tcp_keepalive 821.Pq Vt bool 822Set to 823.Dq Li YES 824by default. 825Setting to 826.Dq Li NO 827will disable probing idle TCP connections to verify that the 828peer is still up and reachable. 829.It Va tcp_drop_synfin 830.Pq Vt bool 831Set to 832.Dq Li NO 833by default. 834Setting to 835.Dq Li YES 836will cause the kernel to ignore TCP frames that have both 837the SYN and FIN flags set. 838This prevents OS fingerprinting, but may 839break some legitimate applications. 840This option is only available if the 841kernel was built with the 842.Dv TCP_DROP_SYNFIN 843option. 844.It Va icmp_drop_redirect 845.Pq Vt bool 846Set to 847.Dq Li NO 848by default. 849Setting to 850.Dq Li YES 851will cause the kernel to ignore ICMP REDIRECT packets. 852Refer to 853.Xr icmp 4 854for more information. 855.It Va icmp_log_redirect 856.Pq Vt bool 857Set to 858.Dq Li NO 859by default. 860Setting to 861.Dq Li YES 862will cause the kernel to log ICMP REDIRECT packets. 863Note that 864the log messages are not rate-limited, so this option should only be used 865for troubleshooting networks. 866Refer to 867.Xr icmp 4 868for more information. 869.It Va icmp_bmcastecho 870.Pq Vt bool 871Set to 872.Dq Li YES 873to respond to broadcast or multicast ICMP ping packets. 874Refer to 875.Xr icmp 4 876for more information. 877.It Va ip_portrange_first 878.Pq Vt int 879If not set to 880.Dq Li NO , 881this is the first port in the default portrange. 882Refer to 883.Xr ip 4 884for more information. 885.It Va ip_portrange_last 886.Pq Vt int 887If not set to 888.Dq Li NO , 889this is the last port in the default portrange. 890Refer to 891.Xr ip 4 892for more information. 893.It Va network_interfaces 894.Pq Vt str 895Set to the list of network interfaces to configure on this host. 896For example, if the only network devices in the system are the loopback 897device 898.Pq Li lo0 899and a NIC using the 900.Xr ed 4 901driver, 902this could be set to 903.Dq Li "lo0 ed0" . 904An 905.Va ifconfig_ Ns Aq Ar interface 906variable is also assumed to exist for each value of 907.Ar interface . 908It is also possible to add IP alias entries here in cases where 909multiple IP addresses registered against a single interface 910are desired. 911Assuming that the interface in question was 912.Li ed0 , 913it might look 914something like this: 915.Bd -literal 916ifconfig_ed0_alias0="inet 127.0.0.253 netmask 0xffffffff" 917ifconfig_ed0_alias1="inet 127.0.0.254 netmask 0xffffffff" 918.Ed 919.Pp 920And so on. 921For each 922.Va ifconfig_ Ns Ao Ar interface Ac Ns Va _alias Ns Aq Ar n 923entry that is found, 924its contents are passed to 925.Xr ifconfig 8 . 926Execution stops at the first unsuccessful access, so if 927something like this is present: 928.Bd -literal 929ifconfig_ed0_alias0="inet 127.0.0.251 netmask 0xffffffff" 930ifconfig_ed0_alias1="inet 127.0.0.252 netmask 0xffffffff" 931ifconfig_ed0_alias2="inet 127.0.0.253 netmask 0xffffffff" 932ifconfig_ed0_alias4="inet 127.0.0.254 netmask 0xffffffff" 933.Ed 934.Pp 935Then note that alias4 would 936.Em not 937be added since the search would 938stop with the missing alias3 entry. 939.Pp 940If the 941.Pa /etc/start_if. Ns Aq Ar interface 942file is present, it is read and executed by the 943.Xr sh 1 944interpreter 945before configuring the interface as specified in the 946.Va ifconfig_ Ns Aq Ar interface 947and 948.Va ifconfig_ Ns Ao Ar interface Ac Ns Va _alias Ns Aq Ar n 949variables. 950.Pp 951It is possible to bring up an interface with DHCP by setting the 952.Va ifconfig_ Ns Aq Ar interface 953variable to 954.Dq Li DHCP . 955For instance, to initialize the 956.Li ed0 957device via DHCP, 958it is possible to use something like: 959.Bd -literal 960ifconfig_ed0="DHCP" 961.Ed 962.Pp 963It is also possible to rename interface by doing: 964.Bd -literal 965ifconfig_ed0_name="net0" 966ifconfig_net0="inet 10.0.0.1 netmask 0xffff0000" 967.Ed 968.It Va ipv6_network_interfaces 969.Pq Vt str 970This is the IPv6 equivalent of 971.Va network_interfaces . 972Instead of setting the ifconfig variables as 973.Va ifconfig_ Ns Aq Ar interface 974they should be set as 975.Va ipv6_ifconfig_ Ns Aq Ar interface . 976Aliases should be set as 977.Va ipv6_ifconfig_ Ns Ao Ar interface Ac Ns Va _alias Ns Aq Ar n . 978.Va ipv6_prefix_ Ns Aq Ar interface 979does something. 980Interfaces that do not have a 981.Va ipv6_ifconfig_ Ns Aq Ar interface 982setting will be auto configured by 983.Xr rtsol 8 984if the 985.Va ipv6_gateway_enable 986is set to 987.Dq Li NO . 988Note that the IPv6 networking code does not support the 989.Pa /etc/start_if. Ns Aq Ar interface 990files. 991.It Va ipv6_default_interface 992.Pq Vt str 993If not set to 994.Dq Li NO , 995this is the default output interface for scoped addresses. 996Now this works only for IPv6 link local multicast addresses. 997.It Va cloned_interfaces 998.Pq Vt str 999Set to the list of clonable network interfaces to create on this host. 1000Entries in 1001.Va cloned_interfaces 1002are automatically appended to 1003.Va network_interfaces 1004for configuration. 1005.It Va gif_interfaces 1006.Pq Vt str 1007Set to the list of 1008.Xr gif 4 1009tunnel interfaces to configure on this host. 1010A 1011.Va gifconfig_ Ns Aq Ar interface 1012variable is assumed to exist for each value of 1013.Ar interface . 1014The value of this variable is used to configure the link layer of the 1015tunnel according to the syntax of the 1016.Cm tunnel 1017option to 1018.Xr ifconfig 8 . 1019Additionally, this option ensures that each listed interface is created 1020via the 1021.Cm create 1022option to 1023.Xr ifconfig 8 1024before attempting to configure it. 1025.It Va sppp_interfaces 1026.Pq Vt str 1027Set to the list of 1028.Xr sppp 4 1029interfaces to configure on this host. 1030A 1031.Va spppconfig_ Ns Aq Ar interface 1032variable is assumed to exist for each value of 1033.Ar interface . 1034Each interface should also be configured by a general 1035.Va ifconfig_ Ns Aq Ar interface 1036setting. 1037Refer to 1038.Xr spppcontrol 8 1039for more information about available options. 1040.It Va ppp_enable 1041.Pq Vt bool 1042If set to 1043.Dq Li YES , 1044run the 1045.Xr ppp 8 1046daemon. 1047.It Va ppp_mode 1048.Pq Vt str 1049Mode in which to run the 1050.Xr ppp 8 1051daemon. 1052Accepted modes are 1053.Dq Li auto , 1054.Dq Li ddial , 1055.Dq Li direct 1056and 1057.Dq Li dedicated . 1058See the manual for a full description. 1059.It Va ppp_nat 1060.Pq Vt bool 1061If set to 1062.Dq Li YES , 1063enables network address translation. 1064Used in conjunction with 1065.Va gateway_enable 1066allows hosts on private network addresses access to the Internet using 1067this host as a network address translating router. 1068.It Va ppp_profile 1069.Pq Vt str 1070The name of the profile to use from 1071.Pa /etc/ppp/ppp.conf . 1072.It Va ppp_user 1073.Pq Vt str 1074The name of the user under which 1075.Xr ppp 8 1076should be started. 1077By 1078default, 1079.Xr ppp 8 1080is started as 1081.Dq Li root . 1082.It Va rc_conf_files 1083.Pq Vt str 1084This option is used to specify a list of files that will override 1085the settings in 1086.Pa /etc/defaults/rc.conf . 1087The files will be read in the order in which they are specified and should 1088include the full path to the file. 1089By default, the files specified are 1090.Pa /etc/rc.conf 1091and 1092.Pa /etc/rc.conf.local 1093.It Va gbde_autoattach_all 1094.Pq Vt bool 1095If set to 1096.Dq Li YES , 1097.Pa /etc/rc.d/gbde 1098will attempt to automatically initialize your .bde devices in 1099.Pa /etc/fstab . 1100.It Va gbde_devices 1101.Pq Vt str 1102List the devices that the script should try to attach, 1103or 1104.Dq Li AUTO . 1105.It Va gbde_lockdir 1106.Pq Vt str 1107The directory where the 1108.Xr gbde 4 1109lockfiles are located. 1110The default lockfile directory is 1111.Pa /etc . 1112.Pp 1113The lockfile for each individual 1114.Xr gbde 4 1115device can be overridden by setting the variable 1116.Va gbde_lock_ Ns Aq Ar device , 1117where 1118.Ar device 1119is the encrypted device without the 1120.Dq Pa /dev/ 1121and 1122.Dq Pa .bde 1123parts. 1124.It Va gbde_attach_attempts 1125.Pq Vt int 1126Number of times to attempt attaching to a 1127.Xr gbde 4 1128device, i.e. how many times the user is asked for the pass-phrase. 1129Default is 3. 1130.It Va gbde_swap_enable 1131.Pq Vt bool 1132If set to 1133.Dq Li YES , 1134any .bde swap devices listed in 1135.Pa /etc/fstab 1136will be initialized with a random, one-shot key. 1137Note that this makes recovery of kernel dumps impossible. 1138.It Va root_rw_mount 1139.Pq Vt bool 1140Set to 1141.Dq Li YES 1142by default. 1143After the file systems are checked at boot time, the root file system 1144is remounted as read-write if this is set to 1145.Dq Li YES . 1146Diskless systems that mount their root file system from a read-only remote 1147NFS share should set this to 1148.Dq Li NO 1149in their 1150.Pa rc.conf . 1151.It Va fsck_y_enable 1152.Pq Vt bool 1153If set to 1154.Dq Li YES , 1155.Xr fsck 8 1156will be run with the 1157.Fl y 1158flag if the initial preen 1159of the file systems fails. 1160.It Va background_fsck 1161.Pq Vt bool 1162If set to 1163.Dq Li YES , 1164the system will attempt to run 1165.Xr fsck 8 1166in the background where possible. 1167.It Va background_fsck_delay 1168.Pq Vt int 1169The amount of time in seconds to sleep before starting a background 1170.Xr fsck 8 . 1171It defaults to sixty seconds to allow large applications such as 1172the X server to start before disk I/O bandwidth is monopolized by 1173.Xr fsck 8 . 1174.It Va netfs_types 1175.Pq Vt str 1176List of file system types that are network-based. 1177This list should generally not be modified by end users. 1178Use 1179.Va extra_netfs_types 1180instead. 1181.It Va extra_netfs_types 1182.Pq Vt str 1183If set to something other than 1184.Dq Li NO 1185(the default), 1186this variable extends the list of file system types 1187for which automatic mounting at startup by 1188.Xr rc 8 1189should be delayed until the network is initialized. 1190It should contain 1191a whitespace-separated list of network file system descriptor pairs, 1192each consisting of a file system type as passed to 1193.Xr mount 8 1194and a human-readable, one-word description, 1195joined with a colon 1196.Pq Ql \&: . 1197Extending the default list in this way is only necessary 1198when third party file system types are used. 1199.It Va syslogd_enable 1200.Pq Vt bool 1201If set to 1202.Dq Li YES , 1203run the 1204.Xr syslogd 8 1205daemon. 1206.It Va syslogd_program 1207.Pq Vt str 1208Path to 1209.Xr syslogd 8 1210(default 1211.Pa /usr/sbin/syslogd ) . 1212.It Va syslogd_flags 1213.Pq Vt str 1214If 1215.Va syslogd_enable 1216is set to 1217.Dq Li YES , 1218these are the flags to pass to 1219.Xr syslogd 8 . 1220.It Va inetd_enable 1221.Pq Vt bool 1222If set to 1223.Dq Li YES , 1224run the 1225.Xr inetd 8 1226daemon. 1227.It Va inetd_program 1228.Pq Vt str 1229Path to 1230.Xr inetd 8 1231(default 1232.Pa /usr/sbin/inetd ) . 1233.It Va inetd_flags 1234.Pq Vt str 1235If 1236.Va inetd_enable 1237is set to 1238.Dq Li YES , 1239these are the flags to pass to 1240.Xr inetd 8 . 1241.It Va named_enable 1242.Pq Vt bool 1243If set to 1244.Dq Li YES , 1245run the 1246.Xr named 8 1247daemon. 1248.It Va named_program 1249.Pq Vt str 1250Path to 1251.Xr named 8 1252(default 1253.Pa /usr/sbin/named ) . 1254.It Va named_flags 1255.Pq Vt str 1256If 1257.Va named_enable 1258is set to 1259.Dq Li YES , 1260these are the flags to pass to 1261.Xr named 8 . 1262.It Va named_pidfile 1263.Pq Vt str 1264This is the default path to the 1265.Xr named 8 1266daemon's PID file. 1267Change it if you change the location in 1268.Xr named.conf 5 . 1269.It Va named_chrootdir 1270.Pq Vt str 1271The root directory for a name server run in a 1272.Xr chroot 8 1273environment (default 1274.Pa /var/named ) . 1275If left empty 1276.Xr named 8 1277will not be run in a 1278.Xr chroot 8 1279environment. 1280.It Va named_chroot_autoupdate 1281.Pq Vt bool 1282Set to 1283.Dq Li NO 1284to disable automatic update of the 1285.Xr chroot 8 1286environment. 1287.It Va named_symlink_enable 1288.Pq Vt bool 1289Set to 1290.Dq Li NO 1291to disable symlinking of 1292daemon's PID file 1293into the 1294.Xr chroot 8 1295environment. 1296.It Va kerberos5_server_enable 1297.Pq Vt bool 1298Set to 1299.Dq Li YES 1300to start a Kerberos 5 authentication server 1301at boot time. 1302.It Va kerberos5_server 1303.Pq Vt str 1304If 1305.Va kerberos5_server_enable 1306is set to 1307.Dq Li YES 1308this is the path to Kerberos 5 Authentication Server. 1309.It Va kadmind5_server_enable 1310.Pq Vt bool 1311Set to 1312.Dq Li YES 1313to start 1314.Xr kadmind 8 , 1315the Kerberos 5 Administration Daemon; set to 1316.Dq Li NO 1317on a slave server. 1318.It Va kadmind5_server 1319.Pq Vt str 1320If 1321.Va kadmind5_server_enable 1322is set to 1323.Dq Li YES 1324this is the path to Kerberos 5 Administration Daemon. 1325.It Va kpasswdd_server_enable 1326.Pq Vt bool 1327Set to 1328.Dq Li YES 1329to start 1330.Xr kpasswdd 8 , 1331the Kerberos 5 Password-Changing Daemon; set to 1332.Dq Li NO 1333on a slave server. 1334.It Va kpasswdd_server 1335.Pq Vt str 1336If 1337.Va kpasswdd_server_enable 1338is set to 1339.Dq Li YES 1340this is the path to Kerberos 5 Password-Changing Daemon. 1341.It Va rwhod_enable 1342.Pq Vt bool 1343If set to 1344.Dq Li YES , 1345run the 1346.Xr rwhod 8 1347daemon at boot time. 1348.It Va rwhod_flags 1349.Pq Vt str 1350If 1351.Va rwhod_enable 1352is set to 1353.Dq Li YES , 1354these are the flags to pass to it. 1355.It Va amd_enable 1356.Pq Vt bool 1357If set to 1358.Dq Li YES , 1359run the 1360.Xr amd 8 1361daemon at boot time. 1362.It Va amd_flags 1363.Pq Vt str 1364If 1365.Va amd_enable 1366is set to 1367.Dq Li YES , 1368these are the flags to pass to it. 1369See the 1370.Xr amd 8 1371manpage for more information. 1372.It Va amd_map_program 1373.Pq Vt str 1374If set, 1375the specified program is run to get the list of 1376.Xr amd 8 1377maps. 1378For example, if the 1379.Xr amd 8 1380maps are stored in NIS, one can set this to 1381run 1382.Xr ypcat 1 1383to get a list of 1384.Xr amd 8 1385maps from the 1386.Pa amd.master 1387NIS map. 1388.It Va update_motd 1389.Pq Vt bool 1390If set to 1391.Dq Li YES , 1392.Pa /etc/motd 1393will be updated at boot time to reflect the kernel release 1394being run. 1395If set to 1396.Dq Li NO , 1397.Pa /etc/motd 1398will not be updated. 1399.It Va nfs_client_enable 1400.Pq Vt bool 1401If set to 1402.Dq Li YES , 1403run the NFS client daemons at boot time. 1404.It Va nfs_access_cache 1405.Pq Vt int 1406If 1407.Va nfs_client_enable 1408is set to 1409.Dq Li YES , 1410this can be set to 1411.Dq Li 0 1412to disable NFS ACCESS RPC caching, or to the number of seconds for which 1413NFS ACCESS 1414results should be cached. 1415A value of 2-10 seconds will substantially reduce network 1416traffic for many NFS operations. 1417.It Va nfs_server_enable 1418.Pq Vt bool 1419If set to 1420.Dq Li YES , 1421run the NFS server daemons at boot time. 1422.It Va nfs_server_flags 1423.Pq Vt str 1424If 1425.Va nfs_server_enable 1426is set to 1427.Dq Li YES , 1428these are the flags to pass to the 1429.Xr nfsd 8 1430daemon. 1431.It Va mountd_enable 1432.Pq Vt bool 1433If set to 1434.Dq Li YES , 1435and no 1436.Va nfs_server_enable 1437is set, start 1438.Xr mountd 8 , 1439but not 1440.Xr nfsd 8 1441daemon. 1442It is commonly needed to run CFS without real NFS used. 1443.It Va mountd_flags 1444.Pq Vt str 1445If 1446.Va mountd_enable 1447is set to 1448.Dq Li YES , 1449these are the flags to pass to the 1450.Xr mountd 8 1451daemon. 1452.It Va weak_mountd_authentication 1453.Pq Vt bool 1454If set to 1455.Dq Li YES , 1456allow services like PCNFSD to make non-privileged mount 1457requests. 1458.It Va nfs_reserved_port_only 1459.Pq Vt bool 1460If set to 1461.Dq Li YES , 1462provide NFS services only on a secure port. 1463.It Va nfs_bufpackets 1464.Pq Vt int 1465If set to a number, indicates the number of packets worth of 1466socket buffer space to reserve on an NFS client. 1467The kernel default is typically 4. 1468Using a higher number may be 1469useful on gigabit networks to improve performance. 1470The minimum value is 14712 and the maximum is 64. 1472.It Va rpc_lockd_enable 1473.Pq Vt bool 1474If set to 1475.Dq Li YES 1476and also an NFS server, run 1477.Xr rpc.lockd 8 1478at boot time. 1479.It Va rpc_statd_enable 1480.Pq Vt bool 1481If set to 1482.Dq Li YES 1483and also an NFS server, run 1484.Xr rpc.statd 8 1485at boot time. 1486.It Va rpcbind_program 1487.Pq Vt str 1488Path to 1489.Xr rpcbind 8 1490(default 1491.Pa /usr/sbin/rpcbind ) . 1492.It Va rpcbind_enable 1493.Pq Vt bool 1494If set to 1495.Dq Li YES , 1496run the 1497.Xr rpcbind 8 1498service at boot time. 1499.It Va rpcbind_flags 1500.Pq Vt str 1501If 1502.Va rpcbind_enable 1503is set to 1504.Dq Li YES , 1505these are the flags to pass to the 1506.Xr rpcbind 8 1507daemon. 1508.It Va keyserv_enable 1509.Pq Vt bool 1510If set to 1511.Dq Li YES , 1512run the 1513.Xr keyserv 8 1514daemon on boot for running Secure RPC. 1515.It Va keyserv_flags 1516.Pq Vt str 1517If 1518.Va keyserv_enable 1519is set to 1520.Dq Li YES , 1521these are the flags to pass to 1522.Xr keyserv 8 1523daemon. 1524.It Va pppoed_enable 1525.Pq Vt bool 1526If set to 1527.Dq Li YES , 1528run the 1529.Xr pppoed 8 1530daemon at boot time to provide PPP over Ethernet services. 1531.It Va pppoed_ Ns Ar provider 1532.Pq Vt str 1533.Xr pppoed 8 1534listens to requests to this 1535.Ar provider 1536and ultimately runs 1537.Xr ppp 8 1538with a 1539.Ar system 1540argument of the same name. 1541.It Va pppoed_flags 1542.Pq Vt str 1543Additional flags to pass to 1544.Xr pppoed 8 . 1545.It Va pppoed_interface 1546.Pq Vt str 1547The network interface to run 1548.Xr pppoed 8 1549on. 1550This is mandatory when 1551.Va pppoed_enable 1552is set to 1553.Dq Li YES . 1554.It Va timed_enable 1555.Pq Vt bool 1556If set to 1557.Dq Li YES , 1558run the 1559.Xr timed 8 1560service at boot time. 1561This command is intended for networks of 1562machines where a consistent 1563.Dq "network time" 1564for all hosts must be established. 1565This is often useful in large NFS 1566environments where time stamps on files are expected to be consistent 1567network-wide. 1568.It Va timed_flags 1569.Pq Vt str 1570If 1571.Va timed_enable 1572is set to 1573.Dq Li YES , 1574these are the flags to pass to the 1575.Xr timed 8 1576service. 1577.It Va ntpdate_enable 1578.Pq Vt bool 1579If set to 1580.Dq Li YES , 1581run 1582.Xr ntpdate 8 1583at system startup. 1584This command is intended to 1585synchronize the system clock only 1586.Em once 1587from some standard reference. 1588An option to set this up initially 1589(from a list of known servers) is also provided by the 1590.Xr sysinstall 8 1591program when the system is first installed. 1592.It Va ntpdate_hosts 1593.Pq Vt str 1594A whitespace-separated list of NTP servers to synchronize with at startup. 1595The default is to use the servers listed in 1596.Pa /etc/ntp.conf , 1597if that file exists. 1598.It Va ntpdate_program 1599.Pq Vt str 1600Path to 1601.Xr ntpdate 8 1602(default 1603.Pa /usr/sbin/ntpdate ) . 1604.It Va ntpdate_flags 1605.Pq Vt str 1606If 1607.Va ntpdate_enable 1608is set to 1609.Dq Li YES , 1610these are the flags to pass to the 1611.Xr ntpdate 8 1612command (typically a hostname). 1613.It Va ntpd_enable 1614.Pq Vt bool 1615If set to 1616.Dq Li YES , 1617run the 1618.Xr ntpd 8 1619command at boot time. 1620.It Va ntpd_program 1621.Pq Vt str 1622Path to 1623.Xr ntpd 8 1624(default 1625.Pa /usr/sbin/ntpd ) . 1626.It Va ntpd_flags 1627.Pq Vt str 1628If 1629.Va ntpd_enable 1630is set to 1631.Dq Li YES , 1632these are the flags to pass to the 1633.Xr ntpd 8 1634daemon. 1635.It Va ntpd_sync_on_start 1636.Pq Vt bool 1637If set to 1638.Dq Li YES , 1639.Xr ntpd 8 1640is run with the 1641.Op Fl g 1642flag, which syncs the system's clock on startup. 1643See 1644.Xr ntpd 8 1645for more information regarding the 1646.Op Fl g 1647option. 1648This is a preferred alternative to using 1649.Xr ntpdate 1 1650or specifying the 1651.Pa /etc/rc.conf 1652tunable 1653.Op Ar ntpdate_enable . 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/cuaa0 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 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 jail_enable 2696.Pq Vt bool 2697If set to 2698.Dq Li NO , 2699any configured jails will not be started. 2700.It Va jail_list 2701.Pq Vt str 2702A space separated list of names for jails. 2703This is purely a configuration aid to help identify and 2704configure multiple jails. 2705The names specified in this list will be used to 2706identify settings common to an instance of a jail. 2707Assuming that the jail in question was named 2708.Li vjail , 2709you would have the following dependant variables: 2710.Bd -literal 2711jail_vjail_hostname="jail.example.com" 2712jail_vjail_ip="192.168.1.100" 2713jail_vjail_rootdir="/var/jails/vjail/root" 2714jail_vjail_exec="/bin/sh /etc/rc" 2715.Ed 2716.Pp 2717The last one is optional. 2718It defaults to 2719.Pa /etc/rc 2720if it is not set. 2721.It Va jail_set_hostname_allow 2722.Pq Vt bool 2723If set to 2724.Dq Li NO , 2725do not allow the root user in a jail to set its hostname. 2726.It Va jail_socket_unixiproute_only 2727.Pq Vt bool 2728If set to 2729.Dq Li NO , 2730do not allow any protocol, 2731besides TCP/IP, 2732to be used within a jail. 2733.It Va jail_sysvipc_allow 2734.Pq Vt bool 2735If set to 2736.Dq Li YES , 2737allow applications within a jail to use System V IPC. 2738.It Va unaligned_print 2739.Pq Vt bool 2740If set to 2741.Dq Li NO , 2742unaligned access warnings will not be printed. 2743(alpha) 2744.\" ----- isdn settings --------------------------------- 2745.It Va isdn_enable 2746.Pq Vt bool 2747Set to 2748.Dq Li NO 2749by default. 2750When set to 2751.Dq Li YES , 2752starts the 2753.Xr isdnd 8 2754daemon 2755at system boot time. 2756.It Va isdn_flags 2757.Pq Vt str 2758Set to 2759.Dq Fl d Ns Cm n Fl d Ns Li 0x1f9 2760by default. 2761Additional flags to pass to 2762.Xr isdnd 8 2763(but see 2764.Va isdn_fsdev 2765and 2766.Va isdn_ttype 2767for certain tunable parameters). 2768.It Va isdn_ttype 2769.Pq Vt str 2770Set to 2771.Dq Li cons25 2772by default. 2773The terminal type of the output device when 2774.Xr isdnd 8 2775operates in full-screen mode. 2776.It Va isdn_screenflags 2777.Pq Vt str 2778Set to 2779.Dq Li NO 2780by default. 2781The video mode for full-screen mode (only for 2782.Xr syscons 4 2783console driver, see 2784.Xr vidcontrol 1 2785for valid modes). 2786.It Va isdn_fsdev 2787.Pq Vt str 2788Set to 2789.Dq Li NO 2790by default. 2791The output device for 2792.Xr isdnd 8 2793in full-screen mode (or 2794.Dq Li NO 2795for daemon mode). 2796.It Va isdn_trace 2797.Pq Vt bool 2798Set to 2799.Dq Li NO 2800by default. 2801When set to 2802.Dq Li YES , 2803enables the ISDN protocol trace utility 2804.Xr isdntrace 8 2805at system boot time. 2806.It Va isdn_traceflags 2807.Pq Vt str 2808Set to 2809.Dq Fl f Pa /var/tmp/isdntrace0 2810by default. 2811Flags for 2812.Xr isdntrace 8 . 2813.\" ----------------------------------------------------- 2814.It Va pcvt_verbose 2815.Pq Vt bool 2816Set to 2817.Dq Li NO 2818by default. 2819When set to 2820.Dq Li YES , 2821verbose messages about the actions done by the start script are displayed. 2822.Em Note : 2823the 2824.Xr pcvt 4 2825driver must be compiled into the kernel before the 2826.Xr pcvt 4 2827related 2828options described here take any effect. 2829.It Va pcvt_keymap 2830.Pq Vt str 2831Set to 2832.Dq Li NO 2833by default. 2834Use this to configure a national keyboard mapping found in the 2835.Pa /usr/share/misc/keycap.pcvt 2836file of keyboard mappings. 2837(See also the manual pages 2838.Xr keycap 5 2839and 2840.Xr keycap 3 2841for usage of 2842.Xr pcvt 4 Ns 's 2843keycap database and the manual page 2844.Xr kcon 1 2845option 2846.Fl m 2847for national keyboard mapping configuration.) 2848.It Va pcvt_keydel 2849.Pq Vt int 2850Set to 2851.Dq Li NO 2852by default. 2853Used to set the keyboard key repeat delay value. 2854Valid values are 2855in the range 0..3 for delay values of 250, 500, 750 and 1000 msec. 2856(See also the 2857.Xr kcon 1 2858manual page.) 2859.It Va pcvt_keyrate 2860.Pq Vt int 2861Set to 2862.Dq Li NO 2863by default. 2864Used to set the keyboard key repetition rate value. 2865Valid values are 2866in the range 0..31 for repetition values of 2..30 characters per second. 2867.It Va pcvt_keyrepeat 2868.Pq Vt bool 2869Set to 2870.Dq Li NO 2871by default. 2872Set to 2873.Dq Li YES 2874to enable automatic keyboard key repeating. 2875.It Va pcvt_force24 2876.Pq Vt bool 2877Set to 2878.Dq Li NO 2879by default. 2880Set to 2881.Dq Li YES 2882to force 2883.Xr pcvt 4 2884to use 24 lines only (in 25 lines mode) for compatibility 2885with the original 2886.Tn VT220 2887terminal. 2888.It Va pcvt_hpext 2889.Pq Vt bool 2890Set to 2891.Dq Li NO 2892by default. 2893Set to 2894.Dq Li YES 2895to enable the display and functionality of function key labels (as found 2896on 2897.Tn Hewlett-Packard 2898terminals such as the 2899.Tn HP2392A 2900and the 2901.Tn HP700/92 2902in 2903.Tn ANSI 2904mode). 2905.It Va pcvt_lines 2906.Pq Vt int 2907Set to 2908.Dq Li NO 2909by default resulting in a value of 25. 2910Used to set the number of lines on the screen. 2911For VGA displays, valid 2912values are 25, 28, 40 and 50 lines. 2913(See also the 2914.Xr scon 1 2915manual page.) 2916.It Va pcvt_blanktime 2917.Pq Vt int 2918Set to 2919.Dq Li NO 2920by default. 2921Used to set the screen saver timeout in seconds for values greater than 2922zero. 2923.It Va pcvt_cursorh 2924.Pq Vt int 2925Set to 2926.Dq Li NO 2927by default. 2928Used to set the cursor top scanline. 2929(See also the 2930.Xr cursor 1 2931manual page.) 2932.It Va pcvt_cursorl 2933.Pq Vt int 2934Set to 2935.Dq Li NO 2936by default. 2937Used to set the cursor bottom scanline. 2938.It Va pcvt_monohigh 2939.Pq Vt bool 2940Set to 2941.Dq Li NO 2942by default. 2943Set to 2944.Dq Li YES 2945to set intensity to high on monochrome monitors. 2946(See also the 2947.Xr scon 1 2948manual page, option 2949.Fl p , 2950for more information on changing VGA palette 2951values.) 2952.It Va harvest_interrupt 2953.Pq Vt bool 2954Set to 2955.Dq Li YES 2956to use hardware interrupts as an entropy source. 2957Refer to 2958.Xr random 4 2959for more information. 2960.It Va harvest_ethernet 2961.Pq Vt bool 2962Set to 2963.Dq Li YES 2964to use LAN traffic as an entropy source. 2965Refer to 2966.Xr random 4 2967for more information. 2968.It Va harvest_p_to_p 2969.Pq Vt bool 2970Set to 2971.Dq Li YES 2972to use serial line traffic as an entropy source. 2973Refer to 2974.Xr random 4 2975for more information. 2976.It Va entropy_dir 2977.Pq Vt str 2978Set to 2979.Dq Li NO 2980to disable caching entropy via 2981.Xr cron 8 . 2982Otherwise set to the directory used to store entropy files in. 2983.It Va entropy_file 2984.Pq Vt str 2985Set to 2986.Dq Li NO 2987to disable caching entropy through reboots. 2988Otherwise set to the filename used to store cached entropy through 2989reboots. 2990This file should be located on the root file system to seed the 2991.Xr random 4 2992device as early as possible in the boot process. 2993.It Va entropy_save_sz 2994.Pq Vt int 2995Size of the entropy cache files saved by 2996.Nm save-entropy 2997periodically. 2998.It Va entropy_save_num 2999.Pq Vt int 3000Number of entropy cache files to save by 3001.Nm save-entropy 3002periodically. 3003.It Va ipsec_enable 3004.Pq Vt bool 3005Set to 3006.Dq Li YES 3007to run 3008.Xr setkey 8 3009on 3010.Va ipsec_file 3011at boot time. 3012.It Va ipsec_file 3013.Pq Vt str 3014Configuration file for 3015.Xr setkey 8 . 3016.It Va dmesg_enable 3017.Pq Vt bool 3018Set to 3019.Dq Li YES 3020to save 3021.Xr dmesg 8 3022to 3023.Pa /var/run/dmesg.boot 3024on boot. 3025.It Va rcshutdown_timeout 3026.Pq Vt int 3027If set, start a watchdog timer in the background which will terminate 3028.Pa rc.shutdown 3029if 3030.Xr shutdown 8 3031has not completed within the specified time (in seconds). 3032.It Va virecover_enable 3033.Pq Vt bool 3034Set to 3035.Dq Li NO 3036to prevent the system from trying to 3037recover pre-maturely terminated 3038.Xr vi 1 3039sessions. 3040.It Va ugidfw_enable 3041.Dq Li NO 3042Load the 3043.Xr mac_bsdextended 4 3044module upon system initialization and load a default 3045ruleset file. 3046.It Va bsdextended_script 3047.Dq Pa /etc/rc.bsdextended 3048The default 3049.Xr mac_bsdextended 4 3050ruleset file to load. 3051.It Va ramdisk_units 3052.Pq Vt str 3053A list of one or more ramdisk units to configure with 3054.Xr mdconfig 8 3055and 3056.Xr newfs 8 3057in time to be mounted from 3058.Xr fstab 5 . 3059Each listed unit 3060.Ar X 3061must specify at least a 3062.Ar type 3063in a 3064.Va ramdisk_ Ns Ao Ar X Ac Ns Va _config 3065variable. 3066.It Va ramdisk_ Ns Ao Ar X Ac Ns Va _config 3067.Pq Vt str 3068Arguments to 3069.Xr mdconfig 8 3070for ramdisk 3071.Ar X . 3072At minimum a 3073.Fl t Ar type 3074must be specified, where 3075.Ar type 3076must be one of 3077.Cm malloc 3078or 3079.Cm swap . 3080.It Va ramdisk_ Ns Ao Ar X Ac Ns Va _newfs 3081.Pq Vt str 3082Optional arguments passed to 3083.Xr newfs 8 3084to initialize ramdisk 3085.Ar X . 3086.It Va ramdisk_ Ns Ao Ar X Ac Ns Va _owner 3087.Pq Vt str 3088An ownership specification passed to 3089.Xr chown 8 3090after the specified ramdisk unit 3091.Ar X 3092has been mounted. 3093Both the 3094.Xr md 4 3095device and the mount point will be changed. 3096.It Va ramdisk_ Ns Ao Ar X Ac Ns Va _perms 3097.Pq Vt str 3098A mode string passed to 3099.Xr chmod 1 3100after the specified ramdisk unit 3101.Ar X 3102has been mounted. 3103Both the 3104.Xr md 4 3105device and the mount point will be changed. 3106.El 3107.Sh FILES 3108.Bl -tag -width ".Pa /etc/defaults/rc.conf" -compact 3109.It Pa /etc/defaults/rc.conf 3110.It Pa /etc/rc.conf 3111.It Pa /etc/rc.conf.local 3112.El 3113.Sh SEE ALSO 3114.Xr catman 1 , 3115.Xr chmod 1 , 3116.Xr gdb 1 , 3117.Xr info 1 , 3118.Xr kbdcontrol 1 , 3119.Xr makewhatis 1 , 3120.Xr vi 1 , 3121.Xr vidcontrol 1 , 3122.Xr ip 4 , 3123.Xr kld 4 , 3124.Xr tcp 4 , 3125.Xr udp 4 , 3126.Xr exports 5 , 3127.Xr motd 5 , 3128.Xr newsyslog.conf 5 , 3129.Xr accton 8 , 3130.Xr amd 8 , 3131.Xr apm 8 , 3132.Xr atm 8 , 3133.Xr chown 8 , 3134.Xr cron 8 , 3135.Xr dhclient 8 , 3136.Xr ifconfig 8 , 3137.Xr inetd 8 , 3138.Xr isdnd 8 , 3139.Xr isdntrace 8 , 3140.Xr kldxref 8 , 3141.Xr lpd 8 , 3142.Xr mdconfig 8 , 3143.Xr mdmfs 8 , 3144.Xr mountd 8 , 3145.Xr moused 8 , 3146.Xr mrouted 8 , 3147.Xr named 8 , 3148.Xr newfs 8 , 3149.Xr nfsd 8 , 3150.Xr ntpd 8 , 3151.Xr ntpdate 8 , 3152.Xr pcnfsd 8 , 3153.Xr quotacheck 8 , 3154.Xr quotaon 8 , 3155.Xr rc 8 , 3156.Xr rc.sendmail 8 , 3157.Xr route 8 , 3158.Xr routed 8 , 3159.Xr rpcbind 8 , 3160.Xr rpc.lockd 8 , 3161.Xr rpc.statd 8 , 3162.Xr rwhod 8 , 3163.Xr savecore 8 , 3164.Xr sshd 8 , 3165.Xr swapon 8 , 3166.Xr sysctl 8 , 3167.Xr syslogd 8 , 3168.Xr timed 8 , 3169.Xr usbd 8 , 3170.Xr yp 8 , 3171.Xr ypbind 8 , 3172.Xr ypserv 8 , 3173.Xr ypset 8 3174.Sh HISTORY 3175The 3176.Nm 3177file appeared in 3178.Fx 2.2.2 . 3179.Sh AUTHORS 3180.An Jordan K. Hubbard . 3181