1.\" Copyright (c) 1995 2.\" Jordan K. Hubbard 3.\" 4.\" Redistribution and use in source and binary forms, with or without 5.\" modification, are permitted provided that the following conditions 6.\" are met: 7.\" 1. Redistributions of source code must retain the above copyright 8.\" notice, this list of conditions and the following disclaimer. 9.\" 2. Redistributions in binary form must reproduce the above copyright 10.\" notice, this list of conditions and the following disclaimer in the 11.\" documentation and/or other materials provided with the distribution. 12.\" 13.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND 14.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 15.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 16.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE 17.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 18.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 19.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 20.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 21.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 22.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 23.\" SUCH DAMAGE. 24.\" 25.\" $FreeBSD: src/share/man/man5/rc.conf.5,v 1.197 2003/07/28 13:56:00 mbr Exp $ 26.\" 27.Dd June 9, 2016 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 installer. 42.Pp 43The purpose of 44.Nm 45is not to run commands or perform system startup actions directly. 46Instead, it is included by the various generic startup scripts in 47.Pa /etc 48which conditionalize their 49internal actions according to the settings found there. 50.Pp 51The 52.Pa /etc/defaults/rc.conf 53file specifies the default settings for all the available options, 54the 55.Pa /etc/rc.conf 56file specifies override settings. 57Options need only be specified in 58.Pa /etc/rc.conf 59when the system administrator wishes to override the defaults. 60The file 61.Pa /etc/rc.conf.local 62is used to override settings in 63.Pa /etc/rc.conf 64for historical reasons. 65In addition to 66.Pa /etc/rc.conf.local 67you can also place smaller configuration files for each 68.Xr rc 8 69script in the 70.Pa /etc/rc.conf.d 71directory, which will be included by the 72.Va load_rc_config 73function. 74For jail configurations you could use the file 75.Pa /etc/rc.conf.d/jail 76to store jail specific configuration options. 77Also see the 78.Va rc_conf_files 79variable below. 80.Pp 81The following list provides a name and short description for each 82variable that can be set in the 83.Nm 84file. 85To set a variable of 86.Vt bool 87type, specify either 88.Dq Li YES , 89.Dq Li TRUE , 90.Dq Li ON , 91or 92.Dq Li 1 . 93To unset, specify 94.Dq Li NO , 95.Dq Li FALSE , 96.Dq Li OFF , 97or 98.Dq Li 0 . 99These values are case insensitive. 100The 101.Va _enable 102postfix in the name of a variable for starting a service can be 103omitted (as in 104.Nx ) . 105.Bl -tag -width indent-two 106.It Va rc_debug 107.Pq Vt bool 108If set to 109.Dq Li YES , 110enable output of debug messages from rc scripts. 111This variable can be helpful in diagnosing mistakes when 112editing or integrating new scripts. 113Beware that this produces copious output to the terminal and 114.Xr syslog 3 . 115.It Va rc_info 116.Pq Vt bool 117If set to 118.Dq Li NO , 119disable informational messages from the rc scripts. 120Informational messages are displayed when 121a condition that is not serious enough to warrant a warning or an error occurs. 122.It Va rc_startmsgs 123.Pq Vt bool 124If set to 125.Dq Li YES , 126show 127.Dq Starting foo: 128when faststart is used (e.g., at boot time). 129.It Va swapfile 130.Pq Vt str 131If set to 132.Dq Li NO , 133no swapfile is installed, otherwise the value is used as the full 134pathname to a file to use for additional swap space. 135The 136.Xr vn 4 137driver is needed for a swapfile and will be loaded if it is not 138already compiled into the kernel or loaded via 139.Xr loader.conf 5 . 140.It Va devd_enable 141.Pq Vt bool 142Run 143.Xr devd 8 144to handle device added, removed or unknown events from the kernel. 145.It Va devd_flags 146.Pq Vt str 147If 148.Va devd_enable 149is set to 150.Dq Li YES , 151these are the flags to pass to the 152.Xr devd 8 153daemon. 154.It Va powerd_enable 155.Pq Vt bool 156Set to 157.Dq Li NO 158by default. 159Setting this to 160.Dq Li YES 161enables 162.Xr powerd 8 , 163a CPU speed control daemon. 164.It Va powerd_flags 165.Pq Vt str 166Empty by default. 167Additional flags passed to the 168.Xr powerd 8 169program. 170.It Va sensorsd_enable 171.Pq Vt bool 172Set to 173.Dq Li NO 174by default. 175Setting this to 176.Dq Li YES 177enables 178.Xr sensorsd 8 , 179a sensors monitoring and logging daemon. 180.It Va sensorsd_flags 181.Pq Vt str 182Empty by default. 183Additional flags passed to the 184.Xr sensorsd 8 185program. 186.It Va sysvipcd_enable 187.Pq Vt bool 188Set to 189.Dq Li NO 190by default. 191Setting this to 192.Dq Li YES 193enables 194.Xr sysvipcd 8 , 195a daemon needed for the userspace implementation of the XSI Interprocess 196Communication functions. 197.It Va sysvipcd_flags 198.Pq Vt str 199Empty by default. 200Additional flags passed to the 201.Xr sysvipcd 8 202program. 203.It Va hotplugd_enable 204.Pq Vt bool 205Set to 206.Dq Li NO 207by default. 208Setting this to 209.Dq Li YES 210enables 211.Xr hotplugd 8 , 212a devices hot plugging monitoring daemon. 213.It Va hotplugd_flags 214.Pq Vt str 215Empty by default. 216Additional flags passed to the 217.Xr hotplugd 8 218program. 219.It Va pccard_ifconfig 220.Pq Vt str 221List of arguments to be passed to 222.Xr ifconfig 8 223at boot time or on insertion of the card (e.g.\& 224.Dq Cm inet Li 192.168.1.1 Cm netmask Li 255.255.255.0 225for a fixed address or 226.Dq Li DHCP 227for a DHCP client). 228.It Va pccard_ether_delay 229.Pq Vt str 230Set the delay before starting 231.Xr dhclient 8 232in the 233.Pa /etc/pccard_ether 234script. 235This defaults to 5 seconds to work around a bug in the 236.Xr ed 4 237driver which can lead to system hangs when using some newer 238.Xr ed 4 239based cards. 240.It Va removable_interfaces 241.Pq Vt str 242List of removable network interfaces to be supported by 243.Pa /etc/pccard_ether . 244.It Va local_startup 245.Pq Vt str 246List of directories to search for startup script files. 247.It Va script_name_sep 248.Pq Vt str 249The field separator to use for breaking down the list of startup script files 250into individual filenames. 251The default is a space. 252It is not necessary to change this unless there are startup scripts with names 253containing spaces. 254.It Va hostname 255.Pq Vt str 256The fully qualified domain name (FQDN) of this host on the network. 257This should almost certainly be set to something meaningful, even if 258there is no network connection. 259If 260.Xr dhclient 8 261is used to set the hostname via DHCP, 262this variable should be set to an empty string. 263.It Va ipv6_enable 264.Pq Vt bool 265Enable support for IPv6 networking. 266Note that this requires that the kernel have been compiled with 267.Cd "options INET6" . 268.It Va nisdomainname 269.Pq Vt str 270The NIS domain name of this host, or 271.Dq Li NO 272if NIS is not used. 273.It Va dhclient_program 274.Pq Vt str 275Path to the DHCP client program 276(default 277.Pa /sbin/dhclient ) . 278.It Va dhclient_flags 279.Pq Vt str 280Additional flags to pass to the DHCP client program. 281.It Va pf_enable 282.Pq Vt bool 283Set to 284.Dq Li YES 285to load 286.Xr pf 4 287at startup. 288If the kernel was not built with 289.Cd "device pf" , 290the 291.Pa pf.ko 292kernel module will be loaded. 293See also 294.Va firewall_enable . 295.It Va pf_rules 296.Pq Vt str 297Path to the 298.Xr pf 4 299ruleset definition file. 300.It Va pf_program 301.Pq Vt str 302Path to 303.Xr pfctl 8 . 304.It Va pf_flags 305.Pq Vt str 306If 307.Va pf_enable 308is set to 309.Dq Li YES , 310these are the flags to pass to 311.Xr pfctl 8 312when loading the ruleset. 313.It Va pflog_enable 314.Pq Vt bool 315Set this to 316.Dq Li YES 317to enable 318.Xr pflogd 8 319which logs packets from 320.Xr pf 4 . 321.It Va pflog_logfile 322.Pq Vt str 323If 324.Va pflog_enable 325is set to 326.Dq Li YES 327this specifies the path of the log file. 328.It Va pflog_program 329.Pq Vt str 330Path to 331.Xr pflogd 8 . 332.It Va pflog_flags 333.Pq Vt str 334If 335.Va pflog_enable 336is set to 337.Dq Li YES , 338these are the flags to pass to 339.Xr pflogd 8 . 340.It Va firewall_enable 341.Pq Vt bool 342Set to 343.Dq Li YES 344to load firewall rules at startup. 345If the kernel was not built with 346.Cd "options IPFIREWALL" , 347the 348.Pa ipfw.ko 349kernel module will be loaded. 350See also 351.Va pf_enable . 352.It Va ipv6_firewall_enable 353.Pq Vt bool 354The IPv6 equivalent of 355.Va firewall_enable . 356Set to 357.Dq Li YES 358to load IPv6 firewall rules at startup. 359If the kernel was not built with 360.Cd "options IPV6FIREWALL" , 361the 362.Pa ip6fw.ko 363kernel module will be loaded. 364.It Va firewall_script 365.Pq Vt str 366The full path to the firewall script to run 367(default 368.Pa /etc/rc.firewall ) . 369.It Va ipv6_firewall_script 370.Pq Vt str 371The IPv6 equivalent of 372.Va firewall_script . 373.It Va firewall_type 374.Pq Vt str 375Names the firewall type from the selection in 376.Pa /etc/rc.firewall , 377or the file which contains the local firewall ruleset. 378Valid selections from 379.Pa /etc/rc.firewall 380are: 381.Pp 382.Bl -tag -width ".Li simple" -compact 383.It Li open 384unrestricted IP access 385.It Li closed 386all IP services disabled, except via 387.Dq Li lo0 388.It Li client 389basic protection for a workstation on a LAN 390.It Li simple 391alias for 392.Li client . 393.El 394.Pp 395If a filename is specified, the full path must be given. 396.It Va firewall_trusted_nets 397.Pq Vt str 398List of trusted networks (if 399.Va firewall_type 400is set to 401.Li client ) . 402.It Va firewall_trusted_interfaces 403.Pq Vt str 404List of trusted network interfaces (if 405.Va firewall_type 406is set to 407.Li client ) . 408.It Va firewall_allowed_icmp_types 409.Pq Vt str 410List of allowed ICMP types (if 411.Va firewall_type 412is set to 413.Li client ) . 414.It Va firewall_open_tcp_ports 415.Pq Vt str 416List of TCP ports to open (if 417.Va firewall_type 418is set to 419.Li client ) . 420.It Va firewall_open_udp_ports 421.Pq Vt str 422List of UDP ports to open (if 423.Va firewall_type 424is set to 425.Li client ) . 426.It Va ipv6_firewall_type 427.Pq Vt str 428The IPv6 equivalent of 429.Va firewall_type . 430.It Va firewall_quiet 431.Pq Vt bool 432Set to 433.Dq Li YES 434to disable the display of firewall rules on the console during boot. 435.It Va ipv6_firewall_quiet 436.Pq Vt bool 437The IPv6 equivalent of 438.Va firewall_quiet . 439.It Va firewall_logging 440.Pq Vt bool 441Set to 442.Dq Li YES 443to enable firewall event logging. 444This is equivalent to the 445.Dv IPFIREWALL_VERBOSE 446kernel option. 447.It Va ipv6_firewall_logging 448.Pq Vt bool 449The IPv6 equivalent of 450.Va firewall_logging . 451.It Va firewall_flags 452.Pq Vt str 453Flags passed to 454.Xr ipfw 8 455if 456.Va firewall_type 457specifies a filename. 458.It Va ipv6_firewall_flags 459.Pq Vt str 460The IPv6 equivalent of 461.Va firewall_flags . 462.It Va natd_program 463.Pq Vt str 464Path to 465.Xr natd 8 . 466.It Va natd_enable 467.Pq Vt bool 468Set to 469.Dq Li YES 470to enable 471.Xr natd 8 . 472.Va firewall_enable 473must also be set to 474.Dq Li YES , 475and 476.Xr divert 4 477sockets must be enabled in the kernel. 478.It Va natd_interface 479.Pq Vt str 480This is the name of the public interface on which 481.Xr natd 8 482should run. 483The interface may be given as an interface name or as an IP address. 484.It Va natd_flags 485.Pq Vt str 486Additional 487.Xr natd 8 488flags should be placed here. 489The 490.Fl n 491or 492.Fl a 493flag is automatically added with the above 494.Va natd_interface 495as an argument. 496.It Va tcp_extensions 497.Pq Vt bool 498Set to 499.Dq Li YES 500by default. 501Setting this to 502.Dq Li NO 503disables certain TCP options as described by 504.Rs 505.%T "RFC 1323" 506.Re 507Setting this to 508.Dq Li NO 509might help remedy such problems with connections as randomly hanging 510or other weird behavior. 511Some network devices are known to be broken with respect to these options. 512.It Va log_in_vain 513.Pq Vt int 514Set to 0 by default. 515The 516.Xr sysctl 8 517variables, 518.Va net.inet.tcp.log_in_vain 519and 520.Va net.inet.udp.log_in_vain , 521as described in 522.Xr tcp 4 523and 524.Xr udp 4 , 525are set to the given value. 526.It Va tcp_keepalive 527.Pq Vt bool 528Set to 529.Dq Li YES 530by default. 531Setting to 532.Dq Li NO 533will disable probing idle TCP connections to verify that the 534peer is still up and reachable. 535.It Va tcp_drop_synfin 536.Pq Vt bool 537Set to 538.Dq Li NO 539by default. 540Setting to 541.Dq Li YES 542will cause the kernel to ignore TCP frames that have both 543the SYN and FIN flags set. 544This prevents OS fingerprinting, but may break some legitimate applications. 545This option is only available if the kernel was built with the 546.Dv TCP_DROP_SYNFIN 547option. 548.It Va icmp_drop_redirect 549.Pq Vt bool 550Set to 551.Dq Li NO 552by default. 553Setting to 554.Dq Li YES 555will cause the kernel to ignore ICMP REDIRECT packets. 556Refer to 557.Xr icmp 4 558for more information. 559.It Va icmp_log_redirect 560.Pq Vt bool 561Set to 562.Dq Li NO 563by default. 564Setting to 565.Dq Li YES 566will cause the kernel to log ICMP REDIRECT packets. 567Note that 568the log messages are not rate-limited, so this option should only be used 569for troubleshooting networks. 570Refer to 571.Xr icmp 4 572for more information. 573.It Va icmp_bmcastecho 574.Pq Vt bool 575Set to 576.Dq Li YES 577to respond to broadcast or multicast ICMP ping packets. 578Refer to 579.Xr icmp 4 580for more information. 581.It Va ip_portrange_first 582.Pq Vt int 583If not set to 584.Dq Li NO , 585this is the first port in the default portrange. 586Refer to 587.Xr ip 4 588for more information. 589.It Va ip_portrange_last 590.Pq Vt int 591If not set to 592.Dq Li NO , 593this is the last port in the default portrange. 594Refer to 595.Xr ip 4 596for more information. 597.\" 598.It Va ifconfig_ Ns Aq Ar interface 599.Pq Vt str 600Configuration for 601.Dq interface . 602Typically includes IP address. 603Assuming that the interface in question was 604.Li ed0 , 605it might look something like this: 606.Bd -literal 607ifconfig_ed0="inet 10.0.0.1 netmask 0xffff0000" 608.Ed 609.Pp 610If the 611.Pa /etc/start_if. Ns Aq Ar interface 612file is present, it is read and executed by the 613.Xr sh 1 614interpreter before configuring the interface as specified in the 615.Va ifconfig_ Ns Aq Ar interface 616and 617.Va ifconfig_ Ns Ao Ar interface Ac Ns Va _alias Ns Aq Ar n 618variables. 619.Pp 620It is possible to bring up an interface with DHCP by adding 621.Dq Li DHCP 622to the 623.Va ifconfig_ Ns Aq Ar interface 624variable. 625For instance, to initialize the 626.Li ed0 627device via DHCP, it is possible to use something like: 628.Bd -literal 629ifconfig_ed0="DHCP" 630.Ed 631.Pp 632If a 633.Va vlans_ Ns Aq Ar interface 634variable is set, 635a 636.Xr vlan 4 637interface will be created for each item in the list with the 638.Ar vlandev 639argument set to 640.Ar interface . 641If a vlan interface's name is a number, 642then that number is used as the vlan tag and the new vlan interface is 643named 644.Ar interface . Ns Ar tag . 645Otherwise, 646the vlan tag must be specified via a 647.Va vlan 648parameter in the 649.Va create_args_ Ns Aq Ar interface 650variable. 651.Pp 652To create a vlan device named 653.Li em0.101 654on 655.Li em0 656with the vlan tag 101 and the optional the IPv4 address 192.0.2.1/24: 657.Bd -literal 658vlans_em0="101" 659ifconfig_em0_101="inet 192.0.2.1/24" 660.Ed 661.Pp 662To create a vlan device named 663.Li myvlan 664on 665.Li em0 666with the vlan tag 102: 667.Bd -literal 668vlans_em0="myvlan" 669create_args_myvlan="vlan 102" 670.Ed 671.Pp 672If a 673.Va wlans_ Ns Aq Ar interface 674variable is set, 675an 676.Xr wlan 4 677interface will be created for each item in the list with the 678.Ar wlandev 679argument set to 680.Ar interface . 681Further wlan cloning arguments may be passed to the 682.Xr ifconfig 8 683.Cm create 684command by setting the 685.Va create_args_ Ns Aq Ar interface 686variable. 687One or more 688.Xr wlan 4 689devices must be created for each wireless devices as of 690.Dx 2.5 . 691Debugging flags for 692.Xr wlan 4 693devices as set by 694.Xr wlandebug 8 695may be specified with an 696.Va wlandebug_ Ns Aq Ar interface 697variable. 698The contents of this variable will be passed directly to 699.Xr wlandebug 8 . 700.Pp 701Also, if your interface needs WPA authentication, it is possible to add 702.Dq Li WPA 703to the 704.Va ifconfig_ Ns Aq Ar interface 705variable. 706This will start 707.Xr wpa_supplicant 8 . 708See 709.Xr wpa_supplicant.conf 5 710for configuring authentication information. 711.Pp 712Finally, you can add 713.Xr ifconfig 8 714options in this variable, in addition to the 715.Pa /etc/start_if. Ns Aq Ar interface 716file. 717For instance, to initialize the 718.Li wi0 719device via DHCP, using WPA authentication and 802.11b mode, it is 720possible to use something like: 721.Bd -literal 722wlans_wi0="wlan0" 723ifconfig_wlan0="up DHCP WPA mode 11b" 724.Ed 725.It Va ifconfig_ Ns Ao Ar interface Ac Ns Va _alias Ns Aq Ar n 726.Pq Vt str 727Configuration to establish an additional network address for 728.Dq interface . 729Assuming that the interface in question was 730.Li ed0 , 731it might look something like this: 732.Bd -literal 733ifconfig_ed0_alias0="inet 127.0.0.253 netmask 0xffffffff" 734ifconfig_ed0_alias1="inet 127.0.0.254 netmask 0xffffffff" 735.Ed 736.Pp 737And so on. 738For each 739.Va ifconfig_ Ns Ao Ar interface Ac Ns Va _alias Ns Aq Ar n 740entry that is found, its contents are passed to 741.Xr ifconfig 8 . 742Execution stops at the first unsuccessful access, so if 743something like this is present: 744.Bd -literal 745ifconfig_ed0_alias0="inet 127.0.0.251 netmask 0xffffffff" 746ifconfig_ed0_alias1="inet 127.0.0.252 netmask 0xffffffff" 747ifconfig_ed0_alias2="inet 127.0.0.253 netmask 0xffffffff" 748ifconfig_ed0_alias4="inet 127.0.0.254 netmask 0xffffffff" 749.Ed 750.Pp 751Then note that alias4 would 752.Em not 753be added since the search would stop with the missing alias3 entry. 754.It Va ifconfig_ Ns Ao Ar interface Ac Ns Va _name 755.Pq Vt str 756New name for 757.Dq interface . 758It is possible to rename interface by doing: 759.Bd -literal 760ifconfig_ed0_name="net0" 761ifconfig_net0="inet 10.0.0.1 netmask 0xffff0000" 762.Ed 763.It Va network_interfaces 764.Pq Vt str 765The list of network interfaces to configure on this host, 766or 767.Dq Li auto 768to configure all network interfaces 769(default 770.Dq Li auto ) . 771For example, if the only network devices to be configured are the loopback device 772.Pq Li lo0 773and a NIC using the 774.Xr ed 4 775driver, this could be set to 776.Dq Li "lo0 ed0" . 777An 778.Va ifconfig_ Ns Aq Ar interface 779variable is assumed to exist for each value of 780.Ar interface . 781.It Va ipv6_network_interfaces 782.Pq Vt str 783This is the IPv6 equivalent of 784.Va network_interfaces . 785Instead of setting the ifconfig variables as 786.Va ifconfig_ Ns Aq Ar interface 787they should be set as 788.Va ipv6_ifconfig_ Ns Aq Ar interface . 789Aliases should be set as 790.Va ipv6_ifconfig_ Ns Ao Ar interface Ac Ns Va _alias Ns Aq Ar n . 791Interfaces that do not have a 792.Va ipv6_ifconfig_ Ns Aq Ar interface 793setting will be auto configured by 794.Xr rtsol 8 795if the 796.Va ipv6_gateway_enable 797is set to 798.Dq Li NO . 799Note that the IPv6 networking code does not support the 800.Pa /etc/start_if. Ns Aq Ar interface 801files. 802.It Va ipv6_prefix_ Ns Aq Ar interface 803.Pq Vt str 804Assign prefix to 805.Ar interface , 806prefixlen 64 is used. 807.It Va ipv6_default_interface 808.Pq Vt str 809If not set to 810.Dq Li NO , 811this is the default output interface for scoped addresses. 812Now this works only for IPv6 link local multicast addresses. 813.It Va cloned_interfaces 814.Pq Vt str 815Set to the list of clonable network interfaces to create on this host. 816Entries in 817.Va cloned_interfaces 818are automatically appended to 819.Va network_interfaces 820for configuration. 821.It Va gif_interfaces 822.Pq Vt str 823Set to the list of 824.Xr gif 4 825tunnel interfaces to configure on this host. 826A 827.Va gifconfig_ Ns Aq Ar interface 828variable is assumed to exist for each value of 829.Ar interface . 830The value of this variable is used to configure the link layer of the 831tunnel according to the syntax of the 832.Cm tunnel 833option to 834.Xr ifconfig 8 . 835Additionally, this option ensures that each listed interface is created via the 836.Cm create 837option to 838.Xr ifconfig 8 839before attempting to configure it. 840.It Va sppp_interfaces 841.Pq Vt str 842Set to the list of 843.Xr sppp 4 844interfaces to configure on this host. 845A 846.Va spppconfig_ Ns Aq Ar interface 847variable is assumed to exist for each value of 848.Ar interface . 849Each interface should also be configured by a general 850.Va ifconfig_ Ns Aq Ar interface 851setting. 852Refer to 853.Xr spppcontrol 8 854for more information about available options. 855.It Va ppp_enable 856.Pq Vt bool 857If set to 858.Dq Li YES , 859run the 860.Xr ppp 8 861daemon. 862.It Va ppp_mode 863.Pq Vt str 864Mode in which to run the 865.Xr ppp 8 866daemon. 867Accepted modes are 868.Dq Li auto , 869.Dq Li ddial , 870.Dq Li direct 871and 872.Dq Li dedicated . 873See the manual for a full description. 874.It Va ppp_nat 875.Pq Vt bool 876If set to 877.Dq Li YES , 878enables network address translation. 879Used in conjunction with 880.Va gateway_enable 881allows hosts on private network addresses access to the Internet using 882this host as a network address translating router. 883.It Va ppp_profile 884.Pq Vt str 885The name of the profile to use from 886.Pa /etc/ppp/ppp.conf . 887Also used for per-profile overrides of 888.Va ppp_ Ns Ao Ar profile Ac Ns _unit . 889Where the profile contains any of the characters 890.Dq Li .-/+ 891they are translated to 892.Dq Li _ 893for the purposes of the override variable names. 894.It Va ppp_ Ns Ao Ar profile Ac Ns _unit 895.Pq Vt int 896Set the unit number to be used for this profile. 897See the manual description of 898.Fl unit Ns Ar N 899in 900.Xr ppp 8 901for details. 902.It Va ppp_user 903.Pq Vt str 904The name of the user under which 905.Xr ppp 8 906should be started. 907By default, 908.Xr ppp 8 909is started as 910.Dq Li root . 911.It Va rc_conf_files 912.Pq Vt str 913This option is used to specify a list of files that will override 914the settings in 915.Pa /etc/defaults/rc.conf . 916The files will be read in the order in which they are specified and should 917include the full path to the file. 918By default, the files specified are 919.Pa /etc/rc.conf 920and 921.Pa /etc/rc.conf.local 922.It Va fsck_y_enable 923.Pq Vt bool 924If set to 925.Dq Li YES , 926.Xr fsck 8 927will be run with the 928.Fl y 929flag if the initial preen of the file systems fails. 930.It Va netfs_types 931.Pq Vt str 932List of file system types that are network-based. 933This list should generally not be modified by end users. 934Use 935.Va extra_netfs_types 936instead. 937.It Va extra_netfs_types 938.Pq Vt str 939If set to something other than 940.Dq Li NO 941(the default), this variable extends the list of file system types 942for which automatic mounting at startup by 943.Xr rc 8 944should be delayed until the network is initialized. 945It should contain 946a whitespace-separated list of network file system descriptor pairs, 947each consisting of a file system type as passed to 948.Xr mount 8 949and a human-readable, one-word description, joined with a colon 950.Pq Ql \&: . 951Extending the default list in this way is only necessary 952when third party file system types are used. 953.It Va devfs_config_files 954.Pq Vt str 955This option is used to specify a list of configuration files containing 956.Xr devfs 5 957rules that will be applied by 958.Xr devfsctl 8 959in the order in which they are specified and must include the full path 960to the file. 961.It Va syslogd_enable 962.Pq Vt bool 963If set to 964.Dq Li YES , 965run the 966.Xr syslogd 8 967daemon. 968.It Va syslogd_program 969.Pq Vt str 970Path to 971.Xr syslogd 8 972(default 973.Pa /usr/sbin/syslogd ) . 974.It Va syslogd_flags 975.Pq Vt str 976If 977.Va syslogd_enable 978is set to 979.Dq Li YES , 980these are the flags to pass to 981.Xr syslogd 8 . 982.It Va inetd_enable 983.Pq Vt bool 984If set to 985.Dq Li YES , 986run the 987.Xr inetd 8 988daemon. 989.It Va inetd_program 990.Pq Vt str 991Path to 992.Xr inetd 8 993(default 994.Pa /usr/sbin/inetd ) . 995.It Va inetd_flags 996.Pq Vt str 997If 998.Va inetd_enable 999is set to 1000.Dq Li YES , 1001these are the flags to pass to 1002.Xr inetd 8 . 1003.It Va rwhod_enable 1004.Pq Vt bool 1005If set to 1006.Dq Li YES , 1007run the 1008.Xr rwhod 8 1009daemon at boot time. 1010.It Va rwhod_flags 1011.Pq Vt str 1012If 1013.Va rwhod_enable 1014is set to 1015.Dq Li YES , 1016these are the flags to pass to it. 1017.It Va update_motd 1018.Pq Vt bool 1019If set to 1020.Dq Li YES , 1021.Pa /etc/motd 1022will be updated at boot time to reflect the kernel release being run. 1023If set to 1024.Dq Li NO , 1025.Pa /etc/motd 1026will not be updated. 1027.It Va nfs_client_enable 1028.Pq Vt bool 1029If set to 1030.Dq Li YES , 1031setup NFS client parameters at boot time. 1032.It Va nfs_access_cache 1033.Pq Vt int 1034If 1035.Va nfs_client_enable 1036is set to 1037.Dq Li YES , 1038this can be set to 1039.Dq Li 0 1040to disable NFS ACCESS RPC caching, or to the number of seconds for which 1041NFS ACCESS results should be cached. 1042A value of 2-10 seconds will substantially reduce network traffic for 1043many NFS operations. 1044The default is 5 seconds. 1045Note that the attribute cache holds stat information only. 1046The NFS data cache is independent of the attribute cache and is only 1047invalidated when the client detects that the server has modified the 1048underlying file. 1049This value specifies a maximum timeout. 1050The NFS client will automatically use a shorter timeout for files which 1051have been recently modified. 1052.It Va nfs_neg_cache 1053.Pq Vt int 1054If 1055.Va nfs_client_enable 1056is set to 1057.Dq Li YES , 1058this can be set to 1059.Dq Li 0 1060to disable the caching of NEGATIVE LOOKUPS (lookups of non-existent 1061filenames), or to the number of seconds for which negative lookups should 1062be cached. 1063A value of 2-10 seconds will substantially reduce network 1064traffic for many NFS operations, especially source code builds. 1065The default is 3 seconds. 1066.It Va nfs_server_enable 1067.Pq Vt bool 1068If set to 1069.Dq Li YES , 1070run the NFS server daemons at boot time. 1071.It Va nfs_server_flags 1072.Pq Vt str 1073If 1074.Va nfs_server_enable 1075is set to 1076.Dq Li YES , 1077these are the flags to pass to the 1078.Xr nfsd 8 1079daemon. 1080.It Va mountd_enable 1081.Pq Vt bool 1082If set to 1083.Dq Li YES , 1084and no 1085.Va nfs_server_enable 1086is set, start 1087.Xr mountd 8 , 1088but not 1089.Xr nfsd 8 1090daemon. 1091It is commonly needed to run CFS without real NFS used. 1092.It Va mountd_flags 1093.Pq Vt str 1094If 1095.Va mountd_enable 1096is set to 1097.Dq Li YES , 1098these are the flags to pass to the 1099.Xr mountd 8 1100daemon. 1101.It Va weak_mountd_authentication 1102.Pq Vt bool 1103If set to 1104.Dq Li YES , 1105allow services like PCNFSD to make non-privileged mount requests. 1106.It Va nfs_reserved_port_only 1107.Pq Vt bool 1108If set to 1109.Dq Li YES , 1110provide NFS services only on a secure port. 1111.It Va nfs_bufpackets 1112.Pq Vt int 1113If set to a number, indicates the number of packets worth of 1114socket buffer space to reserve on an NFS client. 1115The kernel default is typically 4. 1116Using a higher number may be useful on gigabit networks to improve performance. 1117The minimum value is 2 and the maximum is 64. 1118.It Va rpc_umntall_enable 1119.Pq Vt bool 1120If set to 1121.Dq Li YES 1122(default) and we are also an NFS client, run 1123.Xr rpc.umntall 8 1124at boot time to clear out old mounts on remote servers. 1125If set to 1126.Dq Li NO 1127then 1128.Xr rpc.umntall 8 1129will not be run at boot time. 1130.It Va rpc_lockd_enable 1131.Pq Vt bool 1132If set to 1133.Dq Li YES 1134and also an NFS server, run 1135.Xr rpc.lockd 8 1136at boot time. 1137.It Va rpc_lockd_flags 1138.Pq Vt str 1139If 1140.Va rpc_lockd_enable 1141is set to 1142.Dq Li YES , 1143these are the flags to pass to 1144.Xr rpc.lockd 8 . 1145.It Va rpc_statd_enable 1146.Pq Vt bool 1147If set to 1148.Dq Li YES 1149and also an NFS server, run 1150.Xr rpc.statd 8 1151at boot time. 1152.It Va rpc_statd_flags 1153.Pq Vt str 1154If 1155.Va rpc_statd_enable 1156is set to 1157.Dq Li YES , 1158these are the flags to pass to 1159.Xr rpc.statd 8 . 1160.It Va rpcbind_program 1161.Pq Vt str 1162Path to program for rpcbind daemon 1163(default 1164.Pa /usr/sbin/rpcbind ) . 1165.It Va rpcbind_enable 1166.Pq Vt bool 1167If set to 1168.Dq Li YES , 1169run 1170.Va rpcbind_program 1171at boot time. 1172.It Va rpcbind_flags 1173.Pq Vt str 1174If 1175.Va rpcbind_enable 1176is set to 1177.Dq Li YES , 1178these are the flags to pass to 1179.Va rpcbind_program . 1180.It Va keyserv_enable 1181.Pq Vt bool 1182If set to 1183.Dq Li YES , 1184run the 1185.Xr keyserv 8 1186daemon on boot for running Secure RPC. 1187.It Va keyserv_flags 1188.Pq Vt str 1189If 1190.Va keyserv_enable 1191is set to 1192.Dq Li YES , 1193these are the flags to pass to 1194.Xr keyserv 8 1195daemon. 1196.It Va pppoed_enable 1197.Pq Vt bool 1198If set to 1199.Dq Li YES , 1200run the 1201.Xr pppoed 8 1202daemon at boot time to provide PPP over Ethernet services. 1203.It Va pppoed_provider 1204.Pq Vt str 1205.Xr pppoed 8 1206listens to requests to this provider and ultimately runs 1207.Xr ppp 8 1208with a 1209.Ar system 1210argument of the same name. 1211.It Va pppoed_flags 1212.Pq Vt str 1213Additional flags to pass to 1214.Xr pppoed 8 . 1215.It Va pppoed_interface 1216.Pq Vt str 1217The network interface to run 1218.Xr pppoed 8 1219on. 1220This is mandatory when 1221.Va pppoed_enable 1222is set to 1223.Dq Li YES . 1224.It Va timed_enable 1225.Pq Vt bool 1226If set to 1227.Dq Li YES , 1228run the 1229.Xr timed 8 1230service at boot time. 1231This command is intended for networks of machines where a consistent 1232.Dq "network time" 1233for all hosts must be established. 1234This is often useful in large NFS environments where time stamps on 1235files are expected to be consistent network-wide. 1236.It Va timed_flags 1237.Pq Vt str 1238If 1239.Va timed_enable 1240is set to 1241.Dq Li YES , 1242these are the flags to pass to the 1243.Xr timed 8 1244service. 1245.It Va dntpd_enable 1246.Pq Vt bool 1247If set to 1248.Dq Li YES , 1249run 1250.Xr dntpd 8 1251at system boot time. 1252.It Va dntpd_program 1253.Pq Vt str 1254Path to 1255.Xr dntpd 8 1256(default 1257.Pa /usr/sbin/dntpd ) . 1258.It Va dntpd_flags 1259.Pq Vt str 1260If 1261.Va dntpd_enable 1262is set to 1263.Dq Li YES , 1264these are the flags to pass to the 1265.Xr dntpd 8 1266daemon. 1267.It Va btconfig_enable 1268.Pq Vt bool 1269If set to 1270.Dq Li YES , 1271configure Bluetooth devices via 1272.Xr btconfig 8 1273at system boot time. 1274.It Va btconfig_devices 1275.Pq Vt str 1276If 1277.Va btconfig_enable 1278is set to 1279.Dq Li YES , 1280this is the list of Bluetooth devices to configure. 1281If 1282.Va btconfig_devices 1283is not specified, all devices known to the system will be configured. 1284A 1285.Va btconfig_ Ns Aq Ar device 1286variable can be set to specify parameters to be passed to 1287.Ar device . 1288.It Va btconfig_args 1289.Pq Vt str 1290If 1291.Va btconfig_enable 1292is set to 1293.Dq Li YES , 1294this is the list of configuration parameters to pass to all Bluetooth 1295devices. 1296.It Va sdpd_enable 1297.Pq Vt bool 1298If set to 1299.Dq Li YES , 1300run the Service Discovery Profile daemon 1301.Xr ( sdpd 8 ) 1302at system boot time. 1303.It Va sdpd_flags 1304.Pq Vt str 1305If 1306.Va sdpd_enable 1307is set to 1308.Dq Li YES , 1309these are the flags to pass to the 1310.Xr sdpd 8 1311daemon. 1312.It Va bthcid_enable 1313.Pq Vt bool 1314If set to 1315.Dq Li YES , 1316run the Bluetooth Link Key/PIN Code Manager daemon 1317.Xr ( bthcid 8 ) 1318at system boot time. 1319.It Va bthcid_flags 1320.Pq Vt str 1321If 1322.Va bthcid_enable 1323is set to 1324.Dq Li YES , 1325these are the flags to pass to the 1326.Xr bthcid 8 1327daemon. 1328.It Va nis_client_enable 1329.Pq Vt bool 1330If set to 1331.Dq Li YES , 1332run the 1333.Xr ypbind 8 1334service at system boot time. 1335.It Va nis_client_flags 1336.Pq Vt str 1337If 1338.Va nis_client_enable 1339is set to 1340.Dq Li YES , 1341these are the flags to pass to the 1342.Xr ypbind 8 1343service. 1344.It Va nis_ypset_enable 1345.Pq Vt bool 1346If set to 1347.Dq Li YES , 1348run the 1349.Xr ypset 8 1350daemon at system boot time. 1351.It Va nis_ypset_flags 1352.Pq Vt str 1353If 1354.Va nis_ypset_enable 1355is set to 1356.Dq Li YES , 1357these are the flags to pass to the 1358.Xr ypset 8 1359daemon. 1360.It Va nis_server_enable 1361.Pq Vt bool 1362If set to 1363.Dq Li YES , 1364run the 1365.Xr ypserv 8 1366daemon at system boot time. 1367.It Va nis_server_flags 1368.Pq Vt str 1369If 1370.Va nis_server_enable 1371is set to 1372.Dq Li YES , 1373these are the flags to pass to the 1374.Xr ypserv 8 1375daemon. 1376.It Va nis_ypxfrd_enable 1377.Pq Vt bool 1378If set to 1379.Dq Li YES , 1380run the 1381.Xr rpc.ypxfrd 8 1382daemon at system boot time. 1383.It Va nis_ypxfrd_flags 1384.Pq Vt str 1385If 1386.Va nis_ypxfrd_enable 1387is set to 1388.Dq Li YES , 1389these are the flags to pass to the 1390.Xr rpc.ypxfrd 8 1391daemon. 1392.It Va nis_yppasswdd_enable 1393.Pq Vt bool 1394If set to 1395.Dq Li YES , 1396run the 1397.Xr rpc.yppasswdd 8 1398daemon at system boot time. 1399.It Va nis_yppasswdd_flags 1400.Pq Vt str 1401If 1402.Va nis_yppasswdd_enable 1403is set to 1404.Dq Li YES , 1405these are the flags to pass to the 1406.Xr rpc.yppasswdd 8 1407daemon. 1408.It Va rpc_ypupdated_enable 1409.Pq Vt bool 1410If set to 1411.Dq Li YES , 1412run the 1413.Nm rpc.ypupdated 1414daemon at system boot time. 1415.It Va defaultrouter 1416.Pq Vt str 1417If not set to 1418.Dq Li NO , 1419create a default route to this host name or IP address 1420(use an IP address if this router is also required to get to the 1421name server!). 1422.It Va ipv6_defaultrouter 1423.Pq Vt str 1424The IPv6 equivalent of 1425.Va defaultrouter . 1426.It Va static_routes 1427.Pq Vt str 1428Set to the list of static routes that are to be added at system boot time. 1429If not set to 1430.Dq Li NO 1431then for each whitespace separated 1432.Ar element 1433in the value, a 1434.Va route_ Ns Aq Ar element 1435variable is assumed to exist whose contents will later be passed to a 1436.Dq Nm route Cm add 1437operation. 1438.It Va change_routes 1439.Pq Vt str 1440Set to the list of static routes that are to be changed at system boot time 1441(such as those added by the kernel). 1442If not set to 1443.Dq Li NO 1444then for each whitespace separated 1445.Ar element 1446in the value, a 1447.Va change_route_ Ns Aq Ar element 1448variable is assumed to exist whose contents will later be passed to a 1449.Dq Nm route Cm change 1450operation. 1451.It Va ipv6_static_routes 1452.Pq Vt str 1453The IPv6 equivalent of 1454.Va static_routes . 1455If not set to 1456.Dq Li NO 1457then for each whitespace separated 1458.Ar element 1459in the value, a 1460.Va ipv6_route_ Ns Aq Ar element 1461variable is assumed to exist whose contents will later be passed to a 1462.Dq Nm route Cm add Fl inet6 1463operation. 1464.It Va gateway_enable 1465.Pq Vt bool 1466If set to 1467.Dq Li YES , 1468configure host to act as an IP router, e.g. to forward packets 1469between interfaces. 1470.It Va ipv6_gateway_enable 1471.Pq Vt bool 1472The IPv6 equivalent of 1473.Va gateway_enable . 1474.It Va router_enable 1475.Pq Vt bool 1476If set to 1477.Dq Li YES , 1478run a routing daemon of some sort, based on the settings of 1479.Va router_program 1480and 1481.Va router_flags . 1482.It Va ipv6_router_enable 1483.Pq Vt bool 1484The IPv6 equivalent of 1485.Va router_enable . 1486If set to 1487.Dq Li YES , 1488run a routing daemon of some sort, based on the settings of 1489.Va ipv6_router_program 1490and 1491.Va ipv6_router_flags . 1492.It Va router_program 1493.Pq Vt str 1494If 1495.Va router_enable 1496is set to 1497.Dq Li YES , 1498this is the name of the routing daemon to use 1499(default 1500.Pa /sbin/routed ) . 1501.It Va ipv6_router_program 1502.Pq Vt str 1503The IPv6 equivalent of 1504.Va router_program 1505(default 1506.Pa /sbin/route6d ) . 1507.It Va router_flags 1508.Pq Vt str 1509If 1510.Va router_enable 1511is set to 1512.Dq Li YES , 1513these are the flags to pass to the routing daemon. 1514.It Va ipv6_router_flags 1515.Pq Vt str 1516The IPv6 equivalent of 1517.Va router_flags . 1518.It Va mrouted_enable 1519.Pq Vt bool 1520If set to 1521.Dq Li YES , 1522run the multicast routing daemon, 1523.Xr mrouted 8 . 1524.It Va mroute6d_enable 1525.Pq Vt bool 1526The IPv6 equivalent of 1527.Va mrouted_enable . 1528If set to 1529.Dq Li YES , 1530run the IPv6 multicast routing daemon. 1531Note that no IPv6 multicast routing daemon is included in the 1532.Dx 1533base system but 1534.Xr pim6dd 8 1535can be installed from the 1536.Xr dports 7 1537collection 1538.Pa ( net/mcast-tools ) . 1539.It Va mrouted_flags 1540.Pq Vt str 1541If 1542.Va mrouted_enable 1543is set to 1544.Dq Li YES , 1545these are the flags to pass to the 1546.Xr mrouted 8 1547daemon. 1548.It Va mroute6d_flags 1549.Pq Vt str 1550The IPv6 equivalent of 1551.Va mrouted_flags . 1552If 1553.Va mroute6d_enable 1554is set to 1555.Dq Li YES , 1556these are the flags passed to the IPv6 multicast routing daemon. 1557.It Va mroute6d_program 1558.Pq Vt str 1559If 1560.Va mroute6d_enable 1561is set to 1562.Dq Li YES , 1563this is the path to the IPv6 multicast routing daemon. 1564.It Va rtadvd_enable 1565.Pq Vt bool 1566If set to 1567.Dq Li YES , 1568run the 1569.Xr rtadvd 8 1570daemon at boot time. 1571.Xr rtadvd 8 1572will only run if 1573.Va ipv6_gateway_enable 1574is also set to 1575.Dq Li YES . 1576The 1577.Xr rtadvd 8 1578utility sends router advertisement packets to the interfaces specified in 1579.Va rtadvd_interfaces . 1580.Xr rtadvd 8 1581and should only be enabled with great care. 1582You may want to fine-tune 1583.Xr rtadvd.conf 5 . 1584.It Va rtadvd_interfaces 1585.Pq Vt str 1586If 1587.Va rtadvd_enable 1588is set to 1589.Dq Li YES 1590this is the list of interfaces to use. 1591.It Va rtsold_enable 1592.Pq Vt bool 1593If set to 1594.Dq Li YES , 1595run the 1596.Xr rtsold 8 1597daemon at boot time. 1598The 1599.Xr rtsold 8 1600daemon is used for automatic discovery of non-link local addresses. 1601.It Va rtsold_flags 1602.Pq Vt str 1603If 1604.Va rtsold_enable 1605is set to 1606.Dq Li YES , 1607these are the flags to pass to the 1608.Xr rtsold 8 1609daemon. 1610.It Va arpproxy_all 1611.Pq Vt bool 1612If set to 1613.Dq Li YES , 1614enable global proxy ARP. 1615.It Va forward_sourceroute 1616.Pq Vt bool 1617If set to 1618.Dq Li YES 1619and 1620.Va gateway_enable 1621is also set to 1622.Dq Li YES , 1623source-routed packets are forwarded. 1624.It Va accept_sourceroute 1625.Pq Vt bool 1626If set to 1627.Dq Li YES , 1628the system will accept source-routed packets directed at it. 1629.It Va rarpd_enable 1630.Pq Vt bool 1631If set to 1632.Dq Li YES , 1633run the 1634.Xr rarpd 8 1635daemon at system boot time. 1636.It Va rarpd_flags 1637.Pq Vt str 1638If 1639.Va rarpd_enable 1640is set to 1641.Dq Li YES , 1642these are the flags to pass to the 1643.Xr rarpd 8 1644daemon. 1645.It Va bootparamd_enable 1646.Pq Vt bool 1647If set to 1648.Dq Li YES , 1649run the 1650.Xr bootparamd 8 1651daemon at system boot time. 1652.It Va bootparamd_flags 1653.Pq Vt str 1654If 1655.Va bootparamd_enable 1656is set to 1657.Dq Li YES , 1658these are the flags to pass to the 1659.Xr bootparamd 8 1660daemon. 1661.It Va stf_interface_ipv4addr 1662.Pq Vt str 1663If not set to 1664.Dq Li NO , 1665this is the local IPv4 address for 6to4 (IPv6 over IPv4 tunneling interface). 1666Specify this entry to enable the 6to4 interface. 1667.It Va stf_interface_ipv4plen 1668.Pq Vt int 1669Prefix length for 6to4 IPv4 addresses, to limit peer address range. 1670An effective value is 0-31. 1671.It Va stf_interface_ipv6_ifid 1672.Pq Vt str 1673IPv6 interface ID for 1674.Xr stf 4 . 1675This can be set to 1676.Dq Li AUTO . 1677.It Va stf_interface_ipv6_slaid 1678.Pq Vt str 1679IPv6 Site Level Aggregator for 1680.Xr stf 4 . 1681.It Va ipv6_faith_prefix 1682.Pq Vt str 1683If not set to 1684.Dq Li NO , 1685this is the faith prefix to enable a FAITH IPv6-to-IPv4 TCP translator. 1686You also need 1687.Xr faithd 8 1688setup. 1689.It Va keybell 1690.Pq Vt str 1691The keyboard bell sound. 1692Set to 1693.Dq Li normal , 1694.Dq Li visual , 1695.Dq Li off , 1696or 1697.Dq Li NO 1698if the default behavior is desired. 1699For details, refer to the 1700.Xr kbdcontrol 1 1701manpage. 1702.It Va keymap 1703.Pq Vt str 1704If set to 1705.Dq Li NO , 1706no keymap is installed, otherwise the value is used to install 1707the keymap file in 1708.Pa /usr/share/syscons/keymaps/ Ns Ao Ar value Ac Ns Pa .kbd . 1709.It Va keyrate 1710.Pq Vt str 1711The keyboard repeat speed. 1712Set to 1713.Dq Li slow , 1714.Dq Li normal , 1715.Dq Li fast , 1716or 1717.Dq Li NO 1718if the default behavior is desired. 1719.It Va keychange 1720.Pq Vt str 1721If not set to 1722.Dq Li NO , 1723attempt to program the function keys with the value. 1724The value should be a single string of the form: 1725.Dq Ar funkey_number new_value Op Ar funkey_number new_value ... . 1726.It Va cursor 1727.Pq Vt str 1728Can be set to the value of 1729.Dq Li normal , 1730.Dq Li blink , 1731.Dq Li destructive , 1732or 1733.Dq Li NO 1734to set the cursor behavior explicitly or choose the default behavior. 1735.It Va scrnmap 1736.Pq Vt str 1737If set to 1738.Dq Li NO , 1739no screen map is installed, otherwise the value is used to install 1740the screen map file in 1741.Pa /usr/share/syscons/scrnmaps/ Ns Aq Ar value . 1742.It Va font8x16 1743.Pq Vt str 1744If set to 1745.Dq Li NO , 1746the default 8x16 font value is used for screen size requests, otherwise 1747the value in 1748.Pa /usr/share/syscons/fonts/ Ns Aq Ar value 1749is used. 1750.It Va font8x14 1751.Pq Vt str 1752If set to 1753.Dq Li NO , 1754the default 8x14 font value is used for screen size requests, otherwise 1755the value in 1756.Pa /usr/share/syscons/fonts/ Ns Aq Ar value 1757is used. 1758.It Va font8x8 1759.Pq Vt str 1760If set to 1761.Dq Li NO , 1762the default 8x8 font value is used for screen size requests, otherwise 1763the value in 1764.Pa /usr/share/syscons/fonts/ Ns Aq Ar value 1765is used. 1766.It Va blanktime 1767.Pq Vt int 1768If set to 1769.Dq Li NO , 1770the default screen blanking interval is used, otherwise it is set to 1771.Ar value 1772seconds. 1773.It Va saver 1774.Pq Vt str 1775If not set to 1776.Dq Li NO , 1777this is the actual screen saver to use 1778.Li ( blank , snake , daemon , 1779etc). 1780.It Va moused_nondefault_enable 1781.Pq Vt str 1782If set to 1783.Dq Li NO , 1784the mouse device specified on 1785the command line is not automatically treated as enabled by the 1786.Pa /etc/rc.d/moused 1787script. 1788Having this variable set to 1789.Dq Li YES 1790allows a 1791.Xr usb 4 1792mouse, 1793for example, 1794to be enabled as soon as it is plugged in. 1795.It Va moused_enable 1796.Pq Vt str 1797If set to 1798.Dq Li YES , 1799the 1800.Xr moused 8 1801daemon is started for doing cut/paste selection on the console. 1802.It Va moused_type 1803.Pq Vt str 1804This is the protocol type of the mouse connected to this host. 1805This variable must be set if 1806.Va moused_enable 1807is set to 1808.Dq Li YES . 1809The 1810.Xr moused 8 1811daemon 1812is able to detect the appropriate mouse type automatically in many cases. 1813Set this variable to 1814.Dq Li auto 1815to let the daemon detect it, or 1816select one from the following list if the automatic detection fails. 1817.Pp 1818If the mouse is attached to the PS/2 mouse port, choose 1819.Dq Li auto 1820or 1821.Dq Li ps/2 , 1822regardless of the brand and model of the mouse. 1823Likewise, if the mouse is attached to the bus mouse port, choose 1824.Dq Li auto 1825or 1826.Dq Li busmouse . 1827All other protocols are for serial mice and will not work with 1828the PS/2 and bus mice. 1829If this is a USB mouse, 1830.Dq Li auto 1831is the only protocol type which will work. 1832.Pp 1833.Bl -tag -width ".Li x10mouseremote" -compact 1834.It Li microsoft 1835Microsoft mouse (serial) 1836.It Li intellimouse 1837Microsoft IntelliMouse (serial) 1838.It Li mousesystems 1839Mouse systems Corp. mouse (serial) 1840.It Li mmseries 1841MM Series mouse (serial) 1842.It Li logitech 1843Logitech mouse (serial) 1844.It Li busmouse 1845A bus mouse 1846.It Li mouseman 1847Logitech MouseMan and TrackMan (serial) 1848.It Li glidepoint 1849ALPS GlidePoint (serial) 1850.It Li thinkingmouse 1851Kensington ThinkingMouse (serial) 1852.It Li ps/2 1853PS/2 mouse 1854.It Li mmhittab 1855MM HitTablet (serial) 1856.It Li x10mouseremote 1857X10 MouseRemote (serial) 1858.It Li versapad 1859Interlink VersaPad (serial) 1860.El 1861.Pp 1862Even if the mouse is not in the above list, it may be compatible 1863with one in the list. 1864Refer to the man page for 1865.Xr moused 8 1866for compatibility information. 1867.Pp 1868It should also be noted that while this is enabled, any 1869other client of the mouse (such as an X server) should access 1870the mouse through the virtual mouse device, 1871.Pa /dev/sysmouse , 1872and configure it as a 1873.Dq Li sysmouse 1874type mouse, since all 1875mouse data is converted to this single canonical format when using 1876.Xr moused 8 . 1877If the client program does not support the 1878.Dq Li sysmouse 1879type, specify the 1880.Dq Li mousesystems 1881type. 1882It is the second preferred type. 1883.It Va moused_port 1884.Pq Vt str 1885If 1886.Va moused_enable 1887is set to 1888.Dq Li YES , 1889this is the actual port the mouse is on. 1890It might be 1891.Pa /dev/cuaa0 1892for a COM1 serial mouse or 1893.Pa /dev/psm0 1894for a PS/2 mouse, for example. 1895.It Va moused_flags 1896.Pq Vt str 1897If 1898.Va moused_type 1899is set, these are the additional flags to pass to the 1900.Xr moused 8 1901daemon. 1902.It Va mousechar_start 1903.Pq Vt int 1904If set to 1905.Dq Li NO , 1906the default mouse cursor character range 1907.Li 0xd0 Ns - Ns Li 0xd3 1908is used, otherwise the range start is set to 1909.Ar value 1910character, see 1911.Xr vidcontrol 1 . 1912Use if the default range is occupied in the language code table. 1913.It Va vidhistory 1914.Pq Vt int 1915Set the size of the history (scrollback) buffer in lines. 1916.It Va allscreens_flags 1917.Pq Vt str 1918If set, 1919.Xr vidcontrol 1 1920is run with these options for each of the virtual terminals 1921.Pq Pa /dev/ttyv* . 1922For example, 1923.Dq Fl m Cm on 1924will enable the mouse pointer on all virtual terminals if 1925.Va moused_enable 1926is set to 1927.Dq Li YES . 1928.It Va allscreens_kbdflags 1929.Pq Vt str 1930If set, 1931.Xr kbdcontrol 1 1932is run with these options for each of the virtual terminals 1933.Pq Pa /dev/ttyv* . 1934For example, 1935.Dq Fl h Li 200 1936will set the 1937.Xr syscons 4 1938scrollback (history) buffer to 200 lines. 1939.It Va cron_enable 1940.Pq Vt bool 1941If set to 1942.Dq Li YES , 1943run the 1944.Xr cron 8 1945daemon at system boot time. 1946.It Va cron_program 1947.Pq Vt str 1948Path to 1949.Xr cron 8 1950(default 1951.Pa /usr/sbin/cron ) . 1952.It Va cron_flags 1953.Pq Vt str 1954If 1955.Va cron_enable 1956is set to 1957.Dq Li YES , 1958these are the flags to pass to 1959.Xr cron 8 . 1960.It Va lpd_program 1961.Pq Vt str 1962Path to 1963.Xr lpd 8 1964(default 1965.Pa /usr/sbin/lpd ) . 1966.It Va lpd_enable 1967.Pq Vt bool 1968If set to 1969.Dq Li YES , 1970run the 1971.Xr lpd 8 1972daemon at system boot time. 1973.It Va lpd_flags 1974.Pq Vt str 1975If 1976.Va lpd_enable 1977is set to 1978.Dq Li YES , 1979these are the flags to pass to the 1980.Xr lpd 8 1981daemon. 1982.It Va nscd_enable 1983.Pq Vt bool 1984If set to 1985.Dq Li YES , 1986run the 1987.Xr nscd 8 1988daemon at system boot time. 1989.It Va mixer_enable 1990.Pq Vt bool 1991If set to 1992.Dq Li YES , 1993preserve 1994.Xr mixer 8 1995settings across reboots. 1996.It Va mta_start_script 1997.Pq Vt str 1998The full path to the script to run to start 1999a mail transfer agent. 2000The default is 2001.Pa /etc/rc.sendmail . 2002The 2003.Va sendmail_* 2004variables which 2005.Pa /etc/rc.sendmail 2006uses are documented in the 2007.Xr rc.sendmail 8 2008man page. 2009.It Va fixbootfile 2010.Pq Vt bool 2011In a 2012.Sq HAMMER ROOT with UFS /boot 2013setup, the boot loader will not set up the 2014.Va kern.bootfile 2015sysctl correctly. 2016The system will attempt to fix this on its own. 2017Set this variable to 2018.Dq Li NO 2019to turn this behavior off. 2020.It Va dumpdev 2021.Pq Vt str 2022Indicates the device (usually a swap partition) to which a crash dump 2023should be written in the event of a system crash. 2024The value of this variable is passed as the argument to 2025.Xr dumpon 8 2026and 2027.Xr savecore 8 . 2028To disable crash dumps, set this variable to 2029.Dq Li NO . 2030.It Va dumpdir 2031.Pq Vt str 2032When the system reboots after a crash and a crash dump is found on the 2033device specified by the 2034.Va dumpdev 2035variable, 2036.Xr savecore 8 2037will save that crash dump and a copy of the kernel to the directory 2038specified by the 2039.Va dumpdir 2040variable. 2041The default value is 2042.Pa /var/crash . 2043Set to 2044.Dq Li NO 2045to not run 2046.Xr savecore 8 2047at boot time when 2048.Va dumpdir 2049is set. 2050.It Va savecore_flags 2051.Pq Vt str 2052If crash dumps are enabled, these are the flags to pass to the 2053.Xr savecore 8 2054utility. 2055.It Va crashinfo_enable 2056.Pq Vt bool 2057Set to 2058.Dq Li YES 2059to turn on automatic crash dump summary generation using the utility 2060specified by the 2061.Va crashinfo_program 2062variable. 2063.It Va crashinfo_program 2064.Pq Vt str 2065Program to run to generate a crash dump summary if the variable 2066.Va crashinfo_enable 2067is set to 2068.Dq Li YES . 2069The default value is 2070.Pa /usr/sbin/crashinfo . 2071.It Va enable_quotas 2072.Pq Vt bool 2073Set to 2074.Dq Li YES 2075to turn on user disk quotas on system startup via the 2076.Xr quotaon 8 2077command. 2078.It Va check_quotas 2079.Pq Vt bool 2080Set to 2081.Dq Li YES 2082to enable user disk quota checking via the 2083.Xr quotacheck 8 2084command. 2085.It Va accounting_enable 2086.Pq Vt bool 2087Set to 2088.Dq Li YES 2089to enable system accounting through the 2090.Xr accton 8 2091facility. 2092.It Va linux_enable 2093.Pq Vt bool 2094Set to 2095.Dq Li YES 2096to enable Linux/ELF binary emulation at system initial boot time. 2097.\" ----- cleanvar_enable setting-------------------------------- 2098.It Va cleanvar_enable 2099.Pq Vt bool 2100Set to 2101.Dq Li YES 2102to have 2103.Pa /var/run , 2104.Pa /var/spool/lock 2105and 2106.Pa /var/spool/uucp/.Temp/* 2107cleaned at startup. 2108.\" ----- clear_tmp_enable setting------------------------------- 2109.It Va clear_tmp_enable 2110.Pq Vt bool 2111Set to 2112.Dq Li YES 2113to have 2114.Pa /tmp 2115cleaned at startup. 2116.\" ----- ldconfig_paths setting -------------------------------- 2117.It Va ldconfig_paths 2118.Pq Vt str 2119Set to the list of shared library paths to use with 2120.Xr ldconfig 8 . 2121NOTE: 2122.Pa /usr/lib 2123will always be added first, so it need not appear in this list. 2124.It Va ldconfig_insecure 2125.Pq Vt bool 2126The 2127.Xr ldconfig 8 2128utility normally refuses to use directories 2129which are writable by anyone except root. 2130Set this variable to 2131.Dq Li YES 2132to disable that security check during system startup. 2133.It Va ldconfig_local_dirs 2134.Pq Vt str 2135Set to the list of local 2136.Xr ldconfig 8 2137directories. 2138The names of all files in the directories listed will be 2139passed as arguments to 2140.Xr ldconfig 8 . 2141.It Va kern_securelevel 2142.Pq Vt int 2143The kernel security level to set at startup. 2144The allowed range of 2145.Ar value 2146ranges from \-1 (the compile time default) to 3 (the most secure). 2147See 2148.Xr init 8 2149for the list of possible security levels and their effect on system operation. 2150.It Va start_vinum 2151.Pq Vt bool 2152Set to 2153.Dq Li YES 2154to start 2155.Xr vinum 8 2156at system boot time. 2157.It Va sshd_enable 2158.Pq Vt bool 2159Set to 2160.Dq Li YES 2161to start 2162.Xr sshd 8 2163at system boot time. 2164.It Va sshd_program 2165.Pq Vt str 2166Path to the SSH server program 2167(default 2168.Pa /usr/sbin/sshd ) . 2169.It Va sshd_flags 2170.Pq Vt str 2171If 2172.Va sshd_enable 2173is set to 2174.Dq Li YES , 2175these are the flags to pass to the 2176.Xr sshd 8 2177daemon. 2178.It Va ftpd_enable 2179.Pq Vt bool 2180Set to 2181.Dq Li YES 2182to start 2183.Xr ftpd 8 2184at system boot time. 2185.It Va ftpd_flags 2186.Pq Vt str 2187If 2188.Va ftpd_enable 2189is set to 2190.Dq Li YES , 2191these are the flags to pass to the 2192.Xr ftpd 8 2193daemon. 2194.It Va watchdogd_enable 2195.Pq Vt bool 2196If set to 2197.Dq Li YES , 2198start the 2199.Xr watchdogd 8 2200daemon at boot time. 2201This requires that the kernel have been compiled with 2202.Cd "options WATCHDOG" . 2203.It Va jail_enable 2204.Pq Vt bool 2205If set to 2206.Dq Li NO , 2207any configured jails will not be started. 2208.It Va jail_list 2209.Pq Vt str 2210A space separated list of names for jails. 2211This is purely a configuration aid to help identify and 2212configure multiple jails. 2213The names specified in this list will be used to 2214identify settings common to an instance of a jail. 2215Assuming that the jail in question was named 2216.Li vjail , 2217you would have the following dependent variables: 2218.Bd -literal 2219jail_vjail_hostname="jail.example.com" 2220jail_vjail_ip="192.168.1.100" 2221jail_vjail_rootdir="/var/jails/vjail/root" 2222.Ed 2223.It Va jail_flags 2224.Pq Vt str 2225Unset by default. 2226When set, use as default value for 2227.Va jail_ Ns Ao Ar jname Ac Ns Va _flags 2228for every jail in 2229.Va jail_list . 2230.It Va jail_interface 2231.Pq Vt str 2232Unset by default. 2233When set, use as default value for 2234.Va jail_ Ns Ao Ar jname Ac Ns Va _interface 2235for every jail in 2236.Va jail_list . 2237.It Va jail_fstab 2238.Pq Vt str 2239Unset by default. 2240When set, use as default value for 2241.Va jail_ Ns Ao Ar jname Ac Ns Va _fstab 2242for every jail in 2243.Va jail_list . 2244.It Va jail_mount_enable 2245.Pq Vt bool 2246Set to 2247.Dq Li NO 2248by default. 2249When set to 2250.Dq Li YES , 2251sets 2252.Va jail_ Ns Ao Ar jname Ac Ns Va _mount_enable 2253to 2254.Dq Li YES 2255by default for every jail in 2256.Va jail_list . 2257.It Va jail_procfs_enable 2258.Pq Vt bool 2259Set to 2260.Dq Li NO 2261by default. 2262When set to 2263.Dq Li YES , 2264sets 2265.Va jail_ Ns Ao Ar jname Ac Ns Va _procfs_enable 2266to 2267.Dq Li YES 2268by default for every jail in 2269.Va jail_list . 2270.It Va jail_devfs_enable 2271.Pq Vt bool 2272Set to 2273.Dq Li NO 2274by default. 2275When set to 2276.Dq Li YES , 2277sets 2278.Va jail_ Ns Ao Ar jname Ac Ns Va _devfs_enable 2279to 2280.Dq Li YES 2281by default for every jail in 2282.Va jail_list . 2283.It Va jail_exec_start 2284.Pq Vt str 2285Unset by default. 2286When set, use as default value for 2287.Va jail_ Ns Ao Ar jname Ac Ns Va _exec_start 2288for every jail in 2289.Va jail_list . 2290.It Va jail_exec_stop 2291Unset by default. 2292When set, use as default value for 2293.Va jail_ Ns Ao Ar jname Ac Ns Va _exec_stop 2294for every jail in 2295.Va jail_list . 2296.It Va jail_ Ns Ao Ar jname Ac Ns Va _rootdir 2297.Pq Vt str 2298Unset by default. 2299Set to the root directory used by jail 2300.Va jname . 2301.It Va jail_ Ns Ao Ar jname Ac Ns Va _hostname 2302.Pq Vt str 2303Unset by default. 2304Set to the fully qualified domain name (FQDN) assigned to jail 2305.Va jname . 2306.It Va jail_ Ns Ao Ar jname Ac Ns Va _ip 2307.Pq Vt str 2308Unset by default. 2309Set to the IP address assigned to jail 2310.Va jname . 2311.It Va jail_ Ns Ao Ar jname Ac Ns Va _flags 2312.Pq Vt str 2313Set to 2314.Dq Li -l -U root 2315by default. 2316These are flags to pass to 2317.Xr jail 8 . 2318.It Va jail_ Ns Ao Ar jname Ac Ns Va _interface 2319.Pq Vt str 2320Unset by default. 2321When set, sets the interface to use when setting IP address alias. 2322Note that the alias is created at jail startup and removed at jail shutdown. 2323.It Va jail_ Ns Ao Ar jname Ac Ns Va _fstab 2324.Pq Vt str 2325Set to 2326.Pa /etc/fstab. Ns Aq Ar jname 2327by default. 2328This is the file system information file to use for jail 2329.Va jname . 2330.It Va jail_ Ns Ao Ar jname Ac Ns Va _mount_enable 2331.Pq Vt bool 2332Set to 2333.Dq Li NO 2334by default. 2335When set to 2336.Dq Li YES , 2337mount all file systems from 2338.Va jail_ Ns Ao Ar jname Ac Ns Va _fstab 2339at jail startup. 2340.It Va jail_ Ns Ao Ar jname Ac Ns Va _procfs_enable 2341.Pq Vt bool 2342Set to 2343.Dq Li NO 2344by default. 2345When set to 2346.Dq Li YES , 2347mount the process file system inside jail 2348.Ar jname 2349at jail startup. 2350.It Va jail_ Ns Ao Ar jname Ac Ns Va _devfs_enable 2351.Pq Vt bool 2352Set to 2353.Dq Li NO 2354by default. 2355When set to 2356.Dq Li YES , 2357mount the device file system inside jail 2358.Ar jname 2359at jail startup. 2360.It Va jail_ Ns Ao Ar jname Ac Ns Va _exec_start 2361.Pq Vt str 2362Set to 2363.Dq Li /bin/sh /etc/rc 2364by default. 2365This is the command executed at jail startup. 2366.It Va jail_ Ns Ao Ar jname Ac Ns Va _exec_stop 2367.Pq Vt str 2368Set to 2369.Dq Li /bin/sh /etc/rc.shutdown 2370by default. 2371This is the command executed at jail shutdown. 2372.It Va jail_set_hostname_allow 2373.Pq Vt bool 2374If set to 2375.Dq Li NO , 2376do not allow the root user in a jail to set its hostname. 2377.It Va jail_socket_unixiproute_only 2378.Pq Vt bool 2379If set to 2380.Dq Li YES , 2381do not allow any sockets, 2382besides UNIX/IP/route sockets, 2383to be used within a jail. 2384.It Va jail_sysvipc_allow 2385.Pq Vt bool 2386If set to 2387.Dq Li YES , 2388allow applications within a jail to use System V IPC. 2389.It Va lvm_enable 2390.Pq Vt bool 2391If set to 2392.Dq Li YES 2393LVM volumes will be discovered and configured on boot. 2394.It Va newsyslog_enable 2395.Pq Vt bool 2396If set to 2397.Dq Li YES , 2398run 2399.Xr newsyslog 8 2400before syslogd starts. 2401.It Va newsyslog_flags 2402.Pq Vt str 2403If 2404.Va newsyslog_enable 2405is set to 2406.Dq Li YES , 2407these are the flags passed to 2408.Xr newsyslog 8 . 2409.It Va resident_enable 2410.Pq Vt bool 2411If set to 2412.Dq Li YES , 2413make the dynamic binaries listed in 2414.Pa /etc/resident.conf 2415resident. 2416.It Va varsym_enable 2417.Pq Vt bool 2418If set to 2419.Dq Li YES , 2420process 2421.Pa /etc/varsym.conf 2422to set system-wide variables for variant symlinks. 2423.It Va rand_irqs 2424.Pq Vt str 2425Set either to 2426.Dq Li NO 2427or a whitespace separated list of IRQ numbers which will be used as a source of 2428randomness. 2429.\" ----------------------------------------------------- 2430.It Va entropy_dir 2431.Pq Vt str 2432Set to 2433.Dq Li NO 2434to disable caching entropy via 2435.Xr cron 8 . 2436Otherwise set to the directory used to store entropy files in. 2437.It Va entropy_file 2438.Pq Vt str 2439Set to 2440.Dq Li NO 2441to disable caching entropy through reboots. 2442Otherwise set to the filename used to store cached entropy through reboots. 2443This file should be located on the root file system to seed the 2444.Xr random 4 2445device as early as possible in the boot process. 2446.It Va entropy_save_sz 2447.Pq Vt int 2448Determines the size of the entropy cache files used for entropy cached 2449through reboots and also entropy cached via 2450.Xr cron 8 . 2451The entropy is fed to the system in blocks of 512 bytes, so this number 2452should be large enough to fill as many of the entropy pools in the kernel 2453CSPRNG as possible. 2454By default, it is set to 16384, which should be able to seed all 32 entropy 2455pools in the Fortuna CSPRNG. 2456.It Va ipsec_enable 2457.Pq Vt bool 2458Set to 2459.Dq Li YES 2460to run 2461.Xr setkey 8 2462on 2463.Va ipsec_file 2464at boot time. 2465.It Va ipsec_file 2466.Pq Vt str 2467Configuration file for 2468.Xr setkey 8 . 2469.It Va dmesg_enable 2470.Pq Vt bool 2471Set to 2472.Dq Li YES 2473to save 2474.Xr dmesg 8 2475to 2476.Pa /var/run/dmesg.boot 2477on boot. 2478.It Va rcshutdown_timeout 2479.Pq Vt int 2480If set, start a watchdog timer in the background which will terminate 2481.Pa rc.shutdown 2482if 2483.Xr shutdown 8 2484has not completed within the specified time (in seconds). 2485Notice that in addition to this soft timeout, 2486.Xr init 8 2487also applies a hard timeout for the execution of 2488.Pa rc.shutdown . 2489This is configured via 2490.Xr sysctl 8 2491variable 2492.Va kern.init_shutdown_timeout 2493and defaults to 120 seconds. Setting the value of 2494.Va rcshutdown_timeout 2495to more than 120 seconds will have no effect until the 2496.Xr sysctl 8 2497variable 2498.Va kern.init_shutdown_timeout 2499is also increased. 2500.It Va udevd_enable 2501.Pq Vt bool 2502If set to 2503.Dq Li YES , 2504the udevd daemon will be started on boot. 2505.It Va vfs_quota_enable 2506.Pq Vt bool 2507If set to 2508.Dq Li YES , 2509vfs quota rc.d scripts will be run on boot. 2510.It Va vfs_quota_sync 2511.Pq Vt str 2512List of mount points whose counters are to be synchronized with on-disk 2513usage during system startup. See also 2514.Xr vquota 8 . 2515.It Va vknetd_enable 2516.Pq Vt bool 2517If set to 2518.Dq Li YES , 2519.Xr vknetd 8 2520will be started on boot. 2521.It Va vknetd_flags 2522.Pq Vt bool 2523Additional flags passed to 2524.Xr vknetd 8 . 2525Usually address/cidrbits is specified here. 2526When no flags are passed, default option 2527.Fl U 2528will be used. 2529.It Va vkernel_enable 2530.Pq Vt bool 2531If set to 2532.Dq Li NO , 2533any configured vkernels will not be started. 2534.It Va vkernel_kill_timeout 2535.Pq Vt int 2536This defines the default number of seconds that we will wait for the 2537vkernel to shut down on it's own. If after this time it's still alive, 2538it will be killed with SIGKILL. 2539.It Va vkernel_bin 2540.Pq Vt str 2541Defines the default path to the vkernel binary. 2542.It Va vkernel_list 2543.Pq Vt str 2544A space separated list of names for vkernels. 2545This is purely a configuration aid to help identify and 2546configure multiple vkernels. 2547The names specified in this list will be used to 2548identify settings common to a vkernel instance. 2549Assuming that the vkernel in question was named 2550.Li example , 2551you would have the following dependent variables 2552(filled with reference values in this text): 2553.Bd -literal 2554vkernel_example_bin="/usr/obj/usr/src/sys/VKERNEL64/kernel.debug" 2555vkernel_example_memsize="64m" 2556vkernel_example_rootimg_list="/var/vkernel/rootimg.01" 2557vkernel_example_iface_list="auto:bridge0" 2558vkernel_example_logfile="/dev/null" 2559vkernel_example_flags="-U" 2560vkernel_example_kill_timeout="45" 2561.Ed 2562.Pp 2563The last five are optional. 2564They default to an empty string if not set, except for logfile which defaults to 2565.Pa /dev/null 2566if it is not set. 2567.It Va autofs_enable 2568.Pq Vt bool 2569If set to 2570.Dq Li YES , 2571start the 2572.Xr automount 8 2573utility and the 2574.Xr automountd 8 2575and 2576.Xr autounmountd 8 2577daemons at boot time. 2578.It Va automount_flags 2579.Pq Vt str 2580If 2581.Va autofs_enable 2582is set to 2583.Dq Li YES , 2584these are the flags to pass to the 2585.Xr automount 8 2586program. 2587By default no flags are passed. 2588.It Va automountd_flags 2589.Pq Vt str 2590If 2591.Va autofs_enable 2592is set to 2593.Dq Li YES , 2594these are the flags to pass to the 2595.Xr automountd 8 2596daemon. 2597By default no flags are passed. 2598.It Va autounmountd_flags 2599.Pq Vt str 2600If 2601.Va autofs_enable 2602is set to 2603.Dq Li YES , 2604these are the flags to pass to the 2605.Xr autounmountd 8 2606daemon. 2607By default no flags are passed. 2608.El 2609.Sh FILES 2610.Bl -tag -width ".Pa /etc/start_if. Ns Aq Ar interface" -compact 2611.It Pa /etc/defaults/rc.conf 2612.It Pa /etc/rc.conf 2613.It Pa /etc/rc.conf.local 2614.It Pa /etc/start_if. Ns Aq Ar interface 2615.El 2616.Sh SEE ALSO 2617.Xr catman 1 , 2618.Xr gdb 1 , 2619.Xr info 1 , 2620.Xr kbdcontrol 1 , 2621.Xr varsym 1 , 2622.Xr vidcontrol 1 , 2623.Xr ip 4 , 2624.Xr ipfw 4 , 2625.Xr kld 4 , 2626.Xr pf 4 , 2627.Xr tcp 4 , 2628.Xr udp 4 , 2629.Xr vlan 4 , 2630.Xr exports 5 , 2631.Xr motd 5 , 2632.Xr resident.conf 5 , 2633.Xr varsym.conf 5 , 2634.Xr accton 8 , 2635.Xr btconfig 8 , 2636.Xr bthcid 8 , 2637.Xr cron 8 , 2638.Xr devd 8 , 2639.Xr dhclient 8 , 2640.Xr dntpd 8 , 2641.Xr ftpd 8 , 2642.Xr ifconfig 8 , 2643.Xr inetd 8 , 2644.Xr jail 8 , 2645.Xr lpd 8 , 2646.Xr makewhatis 8 , 2647.Xr mixer 8 , 2648.Xr mountd 8 , 2649.Xr moused 8 , 2650.Xr mrouted 8 , 2651.Xr named 8 , 2652.Xr nfsd 8 , 2653.Xr pcnfsd 8 , 2654.Xr pfctl 8 , 2655.Xr pflogd 8 , 2656.Xr quotacheck 8 , 2657.Xr quotaon 8 , 2658.Xr rc 8 , 2659.Xr rc.sendmail 8 , 2660.Xr resident 8 , 2661.Xr rndcontrol 8 , 2662.Xr route 8 , 2663.Xr routed 8 , 2664.Xr rpcbind 8 , 2665.Xr rpc.lockd 8 , 2666.Xr rpc.statd 8 , 2667.Xr rtadvd 8 , 2668.Xr rtsold 8 , 2669.Xr rwhod 8 , 2670.Xr savecore 8 , 2671.Xr sdpd 8 , 2672.Xr sensorsd 8 , 2673.Xr sshd 8 , 2674.Xr swapon 8 , 2675.Xr sysctl 8 , 2676.Xr syslogd 8 , 2677.Xr sysvipcd 8 , 2678.Xr timed 8 , 2679.Xr vinum 8 , 2680.Xr yp 8 , 2681.Xr ypbind 8 , 2682.Xr ypserv 8 , 2683.Xr ypset 8 , 2684.Xr autofs 5 , 2685.Xr auto_master 5 , 2686.Xr automount 8 , 2687.Xr automountd 8 , 2688.Xr autounmountd 8 2689.Sh HISTORY 2690The 2691.Nm 2692file appeared in 2693.Fx 2.2.2 . 2694.Sh AUTHORS 2695.An Jordan K. Hubbard . 2696