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