Annotation of src/share/man/man5/rc.conf.5, Revision 1.54
1.54 ! lukem 1: .\" $NetBSD: rc.conf.5,v 1.53 2002/02/24 13:00:41 lukem Exp $
1.1 mrg 2: .\"
3: .\" Copyright (c) 1996 Matthew R. Green
1.5 cjs 4: .\" Copyright (c) 1997 Curt J. Sampson
1.8 mikel 5: .\" Copyright (c) 1997 Michael W. Long
1.54 ! lukem 6: .\" Copyright (c) 1998-2002 The NetBSD Foundation, Inc.
1.1 mrg 7: .\" All rights reserved.
8: .\"
1.27 lukem 9: .\" This document is derived from works contributed to The NetBSD Foundation
10: .\" by Luke Mewburn.
11: .\"
1.1 mrg 12: .\" Redistribution and use in source and binary forms, with or without
13: .\" modification, are permitted provided that the following conditions
14: .\" are met:
15: .\" 1. Redistributions of source code must retain the above copyright
16: .\" notice, this list of conditions and the following disclaimer.
17: .\" 2. Redistributions in binary form must reproduce the above copyright
18: .\" notice, this list of conditions and the following disclaimer in the
19: .\" documentation and/or other materials provided with the distribution.
1.12 mrg 20: .\" 3. The name of the author may not be used to endorse or promote products
1.1 mrg 21: .\" derived from this software without specific prior written permission.
22: .\"
23: .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
24: .\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
25: .\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
26: .\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
27: .\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
28: .\" BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
29: .\" LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
30: .\" AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
31: .\" OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
32: .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
33: .\" SUCH DAMAGE.
34: .\"
1.54 ! lukem 35: .Dd February 25, 2002
1.1 mrg 36: .Dt RC.CONF 5
1.21 garbled 37: .Os
1.5 cjs 38: .\" turn off hyphenation
39: .hym 999
1.1 mrg 40: .Sh NAME
41: .Nm rc.conf
42: .Nd system startup configuration file
43: .Sh DESCRIPTION
44: The
45: .Nm
46: file specifies which services are enabled during system startup by
1.35 lukem 47: the startup scripts invoked by
1.1 mrg 48: .Pa /etc/rc .
49: The
50: .Nm
51: file is a shell script that is sourced by
52: .Pa /etc/rc
1.11 mikel 53: if it exists, meaning that
1.1 mrg 54: .Nm
1.8 mikel 55: must contain valid shell commands.
1.1 mrg 56: .Pp
1.4 cjs 57: Listed below are the
1.8 mikel 58: .Nm
1.11 mikel 59: variables that may be set, the values to which each may be set,
1.8 mikel 60: a brief description of what each variable does, and a reference to
1.10 cjs 61: relevant manual pages.
62: .Pp
63: Most variables are one of two types: enabling variables or flags
1.17 fair 64: variables.
65: Enabling variables, such as
1.10 cjs 66: .Sy inetd ,
67: are generally named after the program or the system they enable,
1.35 lukem 68: and are set to
69: .Sq YES
70: or
71: .Sq NO .
1.17 fair 72: Flags variables, such as
1.10 cjs 73: .Sy inetd_flags
74: have the same name with "_flags" appended, and determine what
75: arguments are passed to the program if it is enabled.
76: .Pp
77: If a variable that
78: .Pa /etc/rc
79: expects to be set is not set, or the value is not one of the allowed
80: values, a warning will be printed.
1.49 wiz 81: .Ss Overall control
1.35 lukem 82: .Bl -tag -width net_interfaces
83: .It Sy rc_configured
1.50 lukem 84: .Sq YES
85: or
86: .Sq NO .
87: If not set to
1.35 lukem 88: .Sq YES
89: then the system will drop into single-user mode during boot.
1.50 lukem 90: .It Sy rc_fast_and_loose
1.54 ! lukem 91: If set to a non-empty string,
1.50 lukem 92: each script in
93: .Pa /etc/rc.d
94: will be executed in the current shell rather than a sub shell.
95: This may be faster on slow machines that have an expensive
96: .Xr fork 2
97: operation.
98: .Bl -hang
1.51 wiz 99: .It Em Note :
1.50 lukem 100: Use this at your own risk!
101: A rogue command or script may inadvertently prevent boot to multiuser.
102: .El
1.35 lukem 103: .It Sy do_rcshutdown
1.50 lukem 104: .Sq YES
105: or
106: .Sq NO .
1.35 lukem 107: If set to
108: .Sq NO ,
109: .Xr shutdown 8
110: will not run
111: .Pa /etc/rc.shutdown .
1.47 lukem 112: .It Sy rcshutdown_timeout
1.50 lukem 113: A number.
1.47 lukem 114: If non-blank, use this as the number of seconds to run a watchdog timer for
115: which will terminate
116: .Pa /etc/rc.shutdown
117: if the timer expires before the shutdown script completes.
1.35 lukem 118: .El
1.49 wiz 119: .Ss Basic network configuration
1.11 mikel 120: .Bl -tag -width net_interfaces
1.9 lukem 121: .It Sy hostname
1.50 lukem 122: A string.
1.9 lukem 123: Name of host.
124: If empty or not set, then the contents of
125: .Pa /etc/myname
126: (if it exists) are used.
1.50 lukem 127: .It Sy defaultroute
128: A string.
129: Default network route.
130: If empty or not set, then the contents of
131: .Pa /etc/mygate
132: (if it exists) are used.
1.9 lukem 133: .It Sy domainname
1.50 lukem 134: A string.
1.18 lukem 135: .Tn NIS
136: (YP) domain of host.
1.9 lukem 137: If empty or not set, then the contents of
138: .Pa /etc/defaultdomain
139: (if it exists) are used.
1.15 mrg 140: .El
1.49 wiz 141: .Ss Boottime file-system and swap configuration
1.35 lukem 142: .Bl -tag -width net_interfaces
143: .It Sy critical_filesystems_beforenet
1.50 lukem 144: A string.
1.35 lukem 145: File systems mounted very early in the system boot before networking
146: services are available.
147: Usually
148: .Pa /var
149: is part of this, because it is needed by services such as
1.44 wiz 150: .Xr dhclient 8
1.35 lukem 151: which may be required to get the network operational.
1.15 mrg 152: .It Sy critical_filesystems
1.50 lukem 153: A string.
1.35 lukem 154: File systems such as
1.15 mrg 155: .Pa /usr
1.35 lukem 156: that may require network services to be available to mount,
157: that must be available early in the system boot for general services to use.
1.15 mrg 158: .It Sy no_swap
1.50 lukem 159: .Sq YES
160: or
161: .Sq NO .
1.15 mrg 162: Set the
163: .Sy no_swap
1.35 lukem 164: variable to
165: .Sq YES
166: if you have configured your system with no swap on purpose.
1.50 lukem 167: If not set to
1.35 lukem 168: .Sq YES ,
169: and no swap devices
1.17 fair 170: are configured, the system will warn you.
1.9 lukem 171: .El
1.49 wiz 172: .Ss One-time actions to perform or programs to run on boot-up
1.11 mikel 173: .Bl -tag -width net_interfaces
1.10 cjs 174: .It Sy lkm
1.35 lukem 175: .Sq YES
176: or
177: .Sq NO .
1.17 fair 178: Runs
1.11 mikel 179: .Pa /etc/rc.lkm .
1.10 cjs 180: .It Sy savecore
1.35 lukem 181: .Sq YES
182: or
183: .Sq NO .
1.17 fair 184: Runs the
1.10 cjs 185: .Xr savecore 8
1.17 fair 186: utility.
187: Passes
1.10 cjs 188: .Sy savecore_flags .
1.34 enami 189: .It Sy clear_tmp
1.35 lukem 190: .Sq YES
191: or
192: .Sq NO .
1.34 enami 193: Clear /tmp after reboot.
1.8 mikel 194: .It Sy update_motd
1.35 lukem 195: .Sq YES
196: or
197: .Sq NO .
1.17 fair 198: Updates the
1.8 mikel 199: .Nx
200: version string in the
201: .Pa /etc/motd
1.17 fair 202: file to reflect the version of the running kernel.
203: See
1.8 mikel 204: .Xr motd 5 .
1.27 lukem 205: .It Sy dmesg
1.35 lukem 206: .Sq YES
207: or
208: .Sq NO .
1.27 lukem 209: Create
210: .Pa /var/run/dmesg.boot
211: from the output of
212: .Xr dmesg 8 .
213: Passes
214: .Sy dmesg_flags .
215: .It Sy accounting
1.35 lukem 216: .Sq YES
217: or
218: .Sq NO .
1.27 lukem 219: Enables process accounting with
220: .Xr accton 8 .
221: Requires
222: .Pa /var/account/acct
223: to exist.
1.48 ad 224: .It Sy newsyslog
225: .Sq YES
226: or
227: .Sq NO .
228: Run
229: .Nm newsyslog
230: to trim logfiles before syslogd starts. Intended for laptop users.
1.50 lukem 231: Passes
232: .Sy newsyslog_flags .
1.19 mrg 233: .El
1.49 wiz 234: .Ss System security setting
1.35 lukem 235: .Bl -tag -width net_interfaces
1.19 mrg 236: .It Sy securelevel
1.34 enami 237: A number.
238: The system securelevel is set to the specified value early
1.19 mrg 239: in the boot process, before any external logins, or other programs
1.34 enami 240: that run users job, are started.
1.46 mjl 241: If set to nothing, the default action is taken, as described in
1.19 mrg 242: .Xr init 8 ,
1.46 mjl 243: which contains definitive information about the system securelevel.
1.8 mikel 244: .El
1.49 wiz 245: .Ss Networking startup
1.11 mikel 246: .Bl -tag -width net_interfaces
1.7 cjs 247: .It Sy ipfilter
1.35 lukem 248: .Sq YES
249: or
250: .Sq NO .
1.17 fair 251: Runs
1.7 cjs 252: .Xr ipf 8
1.11 mikel 253: to load in packet filter specifications from
1.7 cjs 254: .Pa /etc/ipf.conf
1.17 fair 255: at network boot time, before any interfaces are configured.
256: See
1.35 lukem 257: .Xr ipf.conf 5 .
258: .It Sy ipnat
1.50 lukem 259: .Sq YES
260: or
261: .Sq NO .
1.35 lukem 262: Runs
263: .Xr ipnat 8
264: to load in the IP network address translation (NAT) rules from
265: .Pa /etc/ipnat.conf
266: at network boot time, before any interfaces are configured.
267: See
268: .Xr ipnat.conf 5 .
1.52 martti 269: .It Sy ipfs
270: .Sq YES
271: or
272: .Sq NO .
273: Runs
274: .Xr ipfs 8
275: to save and restore information for ipnat and ipfilter state tables.
276: The information is stored in
277: .Pa /var/db/ipf/ipstate.ipf
278: and
279: .Pa /var/db/ipf/ipnat.ipf .
280: Passes
281: .Sy ipfs_flags .
1.32 itojun 282: .It Sy ipsec
1.35 lukem 283: .Sq YES
284: or
285: .Sq NO .
1.32 itojun 286: Runs
287: .Xr setkey 8
288: to load in IPsec manual keys and policies from
289: .Pa /etc/ipsec.conf
290: at network boot time, before any interfaces are configured.
1.35 lukem 291: .It Sy ipmon
292: .Sq YES
293: or
294: .Sq NO .
295: Runs
296: .Xr ipmon 8
297: to read
298: .Xr ipf 8
299: packet log information and log it to a file or the system log.
300: Passes
301: .Sy ipmon_flags .
1.50 lukem 302: .It Sy racoon
303: .Sq YES
304: or
305: .Sq NO .
306: Runs
307: .Xr racoon 8 ,
308: the IKE (ISAKMP/Oakley) key management daemon.
1.10 cjs 309: .It Sy auto_ifconfig
1.35 lukem 310: .Sq YES
311: or
312: .Sq NO .
1.17 fair 313: Sets the
1.10 cjs 314: .Sy net_interfaces
315: variable (see below) to the output of
1.6 perry 316: .Xr ifconfig 8
317: with the
1.40 lukem 318: .Dq Li -l
1.10 cjs 319: flag and suppresses warnings about interfaces in this list that
320: do not have an ifconfig file or variable.
321: .It Sy net_interfaces
1.50 lukem 322: A string.
1.10 cjs 323: The list of network interfaces to be configured at boot time.
1.42 itojun 324: For each interface "xxN", the system first looks for ifconfig
1.10 cjs 325: parameters in
1.42 itojun 326: .Pa /etc/ifconfig.xxN
1.10 cjs 327: and then in the variable
1.42 itojun 328: .Sy ifconfig_xxN .
1.10 cjs 329: The contents of the file or the variable are handed to ifconfig
1.17 fair 330: after the interface name.
331: If
1.10 cjs 332: .Sy auto_ifconfig
333: is set to "NO" and neither the file nor the variable is found,
334: a warning is printed.
1.42 itojun 335: Refer to
336: .Xr ifconfig.if 5
337: for more details on
338: .Pa /etc/ifconfig.xxN .
1.9 lukem 339: .It Sy ifaliases_*
1.50 lukem 340: A string.
1.9 lukem 341: List of
1.40 lukem 342: .Sq Em "address netmask"
1.9 lukem 343: pairs to configure additional network addresses for the given
344: configured interface
345: .Dq *
346: (e.g.
347: .Sy ifaliases_le0 ) .
348: If
1.40 lukem 349: .Em netmask
1.9 lukem 350: is
351: .Dq - ,
352: then use the default netmask for the interface.
1.28 itojun 353: .Pp
354: .Sy ifaliases_*
1.30 itojun 355: covers limited cases only and considered unrecommended.
1.28 itojun 356: We recommend using
357: .Pa /etc/ifconfig.xxN
358: with multiple lines instead.
1.10 cjs 359: .It Sy flushroutes
1.35 lukem 360: .Sq YES
361: or
362: .Sq NO .
1.17 fair 363: Flushes the route table on networking startup.
364: Useful when coming up to multiuser mode after going down to
365: single-user mode.
1.23 mellon 366: .It Sy dhclient
1.35 lukem 367: .Sq YES
368: or
369: .Sq NO .
370: Set to
371: .Sq YES
372: to configure some or all network interfaces using
1.34 enami 373: the DHCP client.
374: If you set
1.23 mellon 375: .Sy dhclient
1.35 lukem 376: to
377: .Sq YES ,
378: you must either have
379: .Pa /var
380: in
381: .Sy critical_filesystems_beforenet ,
382: as part of
383: .Pa / ,
384: or direct the DHCP client to store the leases file on the root
1.51 wiz 385: file system by modifying the
1.23 mellon 386: .Sy dhclient_flags
1.34 enami 387: variable.
388: You must not provide ifconfig information or ifaliases
389: information for any interface that is to be configured using the DHCP client.
390: Interface aliases can be set up in the DHCP client configuration
1.23 mellon 391: file if needed - see
392: .Xr dhclient.conf 5
393: for details.
1.35 lukem 394: .Pp
395: Passes
396: .Sy dhclient_flags
397: to the DHCP client.
1.34 enami 398: See
1.23 mellon 399: .Xr dhclient 8
1.34 enami 400: for complete documentation.
401: If you wish to configure all broadcast
1.23 mellon 402: network interfaces using the DHCP client, you can leave this blank.
403: To configure only specific interfaces, name the interfaces to be configured
404: on the command line.
405: .Pp
406: If you must run the DHCP client before mounting critical filesystems,
407: then you should specify an alternate location for the DHCP client's lease
408: file in the
409: .Sy dhclient_flags
410: variable - for example, "-lf /tmp/dhclient.leases".
1.10 cjs 411: .It Sy ntpdate
1.35 lukem 412: .Sq YES
413: or
414: .Sq NO .
1.17 fair 415: Runs
1.10 cjs 416: .Xr ntpdate 8
417: to set the system time from one of the hosts in
418: .Sy ntpdate_hosts .
419: If
420: .Sy ntpdate_hosts
421: is empty, it will attempt to find a list of hosts in
422: .Pa /etc/ntp.conf .
1.50 lukem 423: Passes
424: .Sy ntpdate_flags .
1.14 mrg 425: .It Sy ppp_peers
1.50 lukem 426: A string.
1.14 mrg 427: If
428: .Sy ppp_peers
429: is not empty, then
1.50 lukem 430: .Pa /etc/rc.d/ppp
1.14 mrg 431: will check each word in
432: .Sy ppp_peers
1.50 lukem 433: for a corresponding ppp configuration file in
1.14 mrg 434: .Pa /etc/ppp/peers
435: and will call
436: .Xr pppd 8
437: with the
438: .Dq call Sy peer
439: option.
1.29 itojun 440: .It Sy ip6mode
1.50 lukem 441: A string.
1.24 itojun 442: An IPv6 node can be a router
443: .Pq nodes that forward packet for others
444: or host
445: .Pq nodes that do not forward .
1.29 itojun 446: A host can be autoconfigured
447: based on the information advertised by adjacent IPv6 router.
1.24 itojun 448: By setting
1.29 itojun 449: .Sy ip6mode
450: to
451: .Dq Li router ,
452: .Dq Li host ,
453: or
454: .Dq Li autohost ,
455: you can configure your node as a router,
456: a non-autoconfigured host, or an autoconfigured host.
457: Invalid values will be ignored, and the node will be configured as
458: a non-autoconfigured host.
459: You may want to check
460: .Sy rtsol
461: and
462: .Sy rtsold
463: as well, if you set the variable to
1.40 lukem 464: .Dq Li autohost .
1.41 itojun 465: .It Sy ip6sitelocal
466: .Sq YES
467: or
468: .Sq NO .
469: If you intend to use IPv6 site-local address in your site, set it to
470: .Sq YES .
471: Otherwise, reject route will get installed on boot to avoid misconfiguration
472: regarding to site-local addresses.
1.24 itojun 473: .It Sy rtsol
1.35 lukem 474: .Sq YES
475: or
476: .Sq NO .
1.24 itojun 477: Run
478: .Xr rtsol 8 ,
479: router solicitation command for IPv6 host.
1.25 itojun 480: On nomadic host like notebook computers, you may want to enable
481: .Sy rtsold
482: as well.
1.24 itojun 483: Passes
484: .Sy rtsol_flags .
1.29 itojun 485: This is only for autoconfigured IPv6 host, so set
486: .Sy ip6mode
487: to autohost if you use it.
1.50 lukem 488: .It Sy ifwatchd
489: .Sq YES
490: or
491: .Sq NO .
492: Monitor dynamic interfaces and perform actions upon address changes.
493: Passes
494: .Sy ifwatchd_flags .
495: .It Sy altq
496: .Sq YES
497: or
498: .Sq NO .
499: ALTQ configuration/monitoring daemon.
500: Passes
501: .Sy altqd_flags .
1.6 perry 502: .El
1.49 wiz 503: .Ss Daemons required by other daemons
1.11 mikel 504: .Bl -tag -width net_interfaces
1.10 cjs 505: .It Sy inetd
1.35 lukem 506: .Sq YES
507: or
508: .Sq NO .
1.17 fair 509: Runs the
1.10 cjs 510: .Xr inetd 8
1.11 mikel 511: daemon to start network server processes (as listed in
1.5 cjs 512: .Pa /etc/inetd.conf )
1.17 fair 513: as necessary.
514: Passes
1.10 cjs 515: .Sy inetd_flags .
516: The
1.40 lukem 517: .Dq Li -l
1.10 cjs 518: flag turns on libwrap connection logging.
1.34 enami 519: .It Sy rpcbind
1.35 lukem 520: .Sq YES
521: or
522: .Sq NO .
1.17 fair 523: The
1.34 enami 524: .Xr rpcbind 8
1.8 mikel 525: daemon is required for any
526: .Xr rpc 3
1.17 fair 527: services.
1.18 lukem 528: These include NFS,
529: .Tn NIS ,
1.5 cjs 530: .Xr bootparamd 8 ,
531: .Xr rstatd 8 ,
532: .Xr rusersd 8 ,
533: and
534: .Xr rwalld 8 .
1.50 lukem 535: Passes
536: .Sy rpcbind_flags .
1.5 cjs 537: .El
1.49 wiz 538: .Ss Commonly used daemons
1.11 mikel 539: .Bl -tag -width net_interfaces
1.10 cjs 540: .It Sy syslogd
1.35 lukem 541: .Sq YES
542: or
543: .Sq NO .
1.17 fair 544: Runs
1.10 cjs 545: .Xr syslogd 8
546: and passes
547: .Sy syslogd_flags .
1.35 lukem 548: .It Sy cron
549: .Sq YES
550: or
551: .Sq NO .
552: Run
553: .Xr cron 8 .
1.10 cjs 554: .It Sy named
1.35 lukem 555: .Sq YES
556: or
557: .Sq NO .
1.17 fair 558: Runs
1.10 cjs 559: .Xr named 8
560: and passes
561: .Sy named_flags .
1.50 lukem 562: .It Sy named_chrootdir
563: A string.
564: If non-blank and
565: .Sy named
566: is
567: .Sq YES ,
568: run
569: .Xr named 8
570: as the unprivileged user and group
571: .Sq named ,
572: .Xr chroot 2 Ns ed
573: to
574: .Sy named_chrootdir .
575: .Pa Sy named_chrootdir Ns /var/run/log
576: will be added to the list of log sockets that
577: .Xr syslogd 8
578: listens to.
1.10 cjs 579: .It Sy timed
1.35 lukem 580: .Sq YES
581: or
582: .Sq NO .
1.17 fair 583: Runs
1.10 cjs 584: .Xr timed 8
585: and passes
586: .Sy timed_flags .
587: The
1.40 lukem 588: .Dq Li -M
1.10 cjs 589: option allows
590: .Xr timed 8
1.17 fair 591: to be a master time source as well as a slave.
592: If you are also running
1.34 enami 593: .Xr ntpd 8 ,
1.10 cjs 594: only one machine running both should have the
1.40 lukem 595: .Dq Li -M
1.10 cjs 596: flag given to
1.5 cjs 597: .Xr timed 8 .
1.34 enami 598: .It Sy ntpd
1.35 lukem 599: .Sq YES
600: or
601: .Sq NO .
1.17 fair 602: Runs
1.34 enami 603: .Xr ntpd 8
1.10 cjs 604: and passes
1.34 enami 605: .Sy ntpd_flags .
1.50 lukem 606: .It Sy ntpd_chrootdir
607: A string.
608: If non-blank and
609: .Sy ntpd
610: is
611: .Sq YES ,
612: run
613: .Xr ntpd 8
614: as the unprivileged user and group
615: .Sq ntpd ,
616: .Xr chroot 2 Ns ed
617: to
618: .Sy ntpd_chrootdir .
1.51 wiz 619: .Pa Sy ntpd_chrootdir Ns Pa /var/run/log
1.50 lukem 620: will be added to the list of log sockets that
621: .Xr syslogd 8
622: listens to.
1.10 cjs 623: .It Sy sendmail
1.35 lukem 624: .Sq YES
625: or
626: .Sq NO .
1.17 fair 627: Runs
1.11 mikel 628: .Xr sendmail 8
629: and passes
1.10 cjs 630: .Sy sendmail_flags .
1.34 enami 631: .It Sy postfix
1.35 lukem 632: .Sq YES
633: or
634: .Sq NO .
1.34 enami 635: Starts
1.44 wiz 636: .Xr postfix 1
1.34 enami 637: mail system.
1.10 cjs 638: .It Sy lpd
1.35 lukem 639: .Sq YES
640: or
641: .Sq NO .
1.17 fair 642: Runs
1.10 cjs 643: .Xr lpd 8
644: and passes
645: .Sy lpd_flags .
1.5 cjs 646: The
1.40 lukem 647: .Dq Li -l
1.10 cjs 648: flag will turn on extra logging.
1.36 lukem 649: .It Sy sshd
650: .Sq YES
651: or
652: .Sq NO .
653: Runs
654: .Xr sshd 8
655: and passes
656: .Sy sshd_flags .
1.53 lukem 657: .It Sy sshd_conf_dir
658: Location for
659: .Xr sshd 8
660: configuration and key files.
1.5 cjs 661: .El
1.49 wiz 662: .Ss Routing daemons
1.11 mikel 663: .Bl -tag -width net_interfaces
1.10 cjs 664: .It Sy routed
1.35 lukem 665: .Sq YES
666: or
667: .Sq NO .
1.17 fair 668: Runs
1.10 cjs 669: .Xr routed 8 ,
1.17 fair 670: the RIP routing protocol daemon.
671: Passes
1.10 cjs 672: .Sy routed_flags .
1.45 wiz 673: .\" This should be
674: .\" .Sq NO
675: .\" if
676: .\" .Sy gated
677: .\" is
678: .\" .Sq YES .
1.10 cjs 679: .It Sy mrouted
1.35 lukem 680: .Sq YES
681: or
682: .Sq NO .
1.17 fair 683: Runs
1.10 cjs 684: .Xr mrouted 8 ,
1.17 fair 685: the DVMRP multicast routing protocol daemon.
686: Passes
1.10 cjs 687: .Sy mrouted_flags .
1.24 itojun 688: .It Sy route6d
1.35 lukem 689: .Sq YES
690: or
691: .Sq NO .
1.24 itojun 692: Runs
693: .Xr route6d 8 ,
694: the RIPng routing protocol daemon for IPv6.
695: Passes
696: .Sy route6d_flags .
1.25 itojun 697: .It Sy rtsold
1.35 lukem 698: .Sq YES
699: or
700: .Sq NO .
1.25 itojun 701: Runs
702: .Xr rtsold 8 ,
703: the IPv6 router solicitation daemon.
704: .Xr rtsold 8
705: periodically transmits router solicitation packet
706: to find IPv6 router on the network.
707: This configuration is mainly for nomadic host like notebook computers.
708: Stationary host should work fine with
709: .Sy rtsol
710: only.
711: Passes
712: .Sy rtsold_flags .
1.29 itojun 713: This is only for autoconfigured IPv6 host, so set
714: .Sy ip6mode
715: to autohost if you use it.
1.5 cjs 716: .El
1.49 wiz 717: .Ss Daemons used to boot other hosts over a network
1.11 mikel 718: .Bl -tag -width net_interfaces
1.10 cjs 719: .It Sy rarpd
1.35 lukem 720: .Sq YES
721: or
722: .Sq NO .
1.17 fair 723: Runs
1.10 cjs 724: .Xr rarpd 8 ,
725: the reverse ARP daemon, often used to boot
1.8 mikel 726: .Nx
1.17 fair 727: and Sun workstations.
728: Passes
1.10 cjs 729: .Sy rarpd_flags .
730: .It Sy bootparamd
1.35 lukem 731: .Sq YES
732: or
733: .Sq NO .
1.17 fair 734: Runs
1.10 cjs 735: .Xr bootparamd 8 ,
736: the boot parameter server, with
1.11 mikel 737: .Sy bootparamd_flags
1.17 fair 738: as options.
739: Used to boot
1.8 mikel 740: .Nx
1.17 fair 741: and
742: .Tn "SunOS 4.x"
743: systems.
1.10 cjs 744: .It Sy dhcpd
1.35 lukem 745: .Sq YES
746: or
747: .Sq NO .
1.17 fair 748: Runs
1.10 cjs 749: .Xr dhcpd 8 ,
1.17 fair 750: the Dynamic Host Configuration Protocol (DHCP) daemon,
751: for assigning IP addresses to hosts and passing boot information.
752: Passes
1.10 cjs 753: .Sy dhcpd_flags .
1.35 lukem 754: .It Sy dhcrelay
755: .Sq YES
756: or
757: .Sq NO .
758: Runs
759: .Xr dhcrelay 8 .
760: Passes
761: .Sy dhcrelay_flags .
1.10 cjs 762: .It Sy rbootd
1.35 lukem 763: .Sq YES
764: or
765: .Sq NO .
1.17 fair 766: Runs
1.10 cjs 767: .Xr rbootd 8 ,
1.17 fair 768: the
769: .Tn HP
770: boot protocol daemon; used for booting
771: .Tn HP
772: workstations.
773: Passes
1.10 cjs 774: .Sy rbootd_flags .
775: .It Sy mopd
1.35 lukem 776: .Sq YES
777: or
778: .Sq NO .
1.17 fair 779: Runs
1.10 cjs 780: .Xr mopd 8 ,
1.17 fair 781: the
782: .Tn DEC
783: .Tn MOP
784: protocol daemon; used for booting
785: .Tn VAX
786: and other
787: .Tn DEC
788: machines.
1.10 cjs 789: Passes
790: .Sy mopd_flags .
1.50 lukem 791: .It Sy ndbootd
792: .Sq YES
793: or
794: .Sq NO .
795: Runs
796: .Xr ndbootd 8 ,
797: the Sun Network Disk (ND) Protocol server.
798: Passes
799: .Sy ndbootd_flags .
1.24 itojun 800: .It Sy rtadvd
1.35 lukem 801: .Sq YES
802: or
803: .Sq NO .
1.24 itojun 804: Runs
805: .Xr rtadvd 8 ,
806: the IPv6 router advertisement daemon, which is used to advertise
807: information about the subnet to IPv6 end hosts.
808: Passes
809: .Sy rtadvd_flags .
1.25 itojun 810: This is only for IPv6 router, so set
811: .Sy ip6forwarding
1.35 lukem 812: to
813: .Sq YES
814: if you use it.
815: .El
1.49 wiz 816: .Ss X Window System daemons
1.35 lukem 817: .Bl -tag -width net_interfaces
818: .It Sy xfs
819: .Sq YES
820: or
821: .Sq NO .
822: Runs the
823: .Xr xfs 1
824: X11 font server, which supplies local X font files to X terminals.
825: .It Sy xdm
826: .Sq YES
827: or
828: .Sq NO .
829: Runs the
830: .Xr xdm 1
831: X display manager.
832: These X daemons are available only with the optional X distribution of
833: .Nx .
1.5 cjs 834: .El
1.49 wiz 835: .Ss NIS (YP) daemons
1.11 mikel 836: .Bl -tag -width net_interfaces
1.10 cjs 837: .It Sy ypbind
1.35 lukem 838: .Sq YES
839: or
840: .Sq NO .
1.17 fair 841: Runs
1.10 cjs 842: .Xr ypbind 8 ,
1.18 lukem 843: which lets
844: .Tn NIS
845: (YP) clients use information from a
846: .Tn NIS
847: server.
1.17 fair 848: Passes
1.10 cjs 849: .Sy ypbind_flags .
850: .It Sy ypserv
1.35 lukem 851: .Sq YES
852: or
853: .Sq NO .
1.17 fair 854: Runs
1.10 cjs 855: .Xr ypserv 8 ,
1.18 lukem 856: the
857: .Tn NIS
858: (YP) server for distributing information from certain files in
1.5 cjs 859: .Pa /etc .
1.10 cjs 860: Passes
861: .Sy ypserv_flags .
862: The
1.40 lukem 863: .Dq Li -d
1.10 cjs 864: flag causes it to use DNS for lookups in
865: .Pa /etc/hosts
866: that fail.
867: .It Sy yppasswdd
1.35 lukem 868: .Sq YES
869: or
870: .Sq NO .
1.17 fair 871: Runs
1.10 cjs 872: .Xr yppasswdd 8 ,
1.18 lukem 873: which allows remote
874: .Tn NIS
875: users to update password on master server.
1.17 fair 876: Passes
1.10 cjs 877: .Sy yppasswdd_flags .
1.1 mrg 878: .El
1.49 wiz 879: .Ss NFS daemons and parameters
1.11 mikel 880: .Bl -tag -width net_interfaces
1.47 lukem 881: .It Sy mountd
882: .Sq YES
883: or
884: .Sq NO .
885: Runs
886: .Xr mountd 8
887: and passes
888: .Sy mountd_flags .
1.5 cjs 889: .It Sy nfs_client
1.35 lukem 890: .Sq YES
891: or
892: .Sq NO .
1.34 enami 893: The number of local NFS asynchronous I/O server is now controlled via
894: .Xr sysctl 8 .
1.1 mrg 895: .It Sy nfs_server
1.35 lukem 896: .Sq YES
897: or
898: .Sq NO .
1.17 fair 899: Sets up a host to be a NFS server by running
1.47 lukem 900: .Xr nfsd 8
1.17 fair 901: and passing
1.47 lukem 902: .Sy nfsd_flags .
1.10 cjs 903: .It Sy lockd
1.35 lukem 904: .Sq YES
905: or
906: .Sq NO .
1.17 fair 907: Runs
1.10 cjs 908: .Xr rpc.lockd 8
1.50 lukem 909: if
1.1 mrg 910: .Sy nfs_server
1.50 lukem 911: and/or
1.1 mrg 912: .Sy nfs_client
1.50 lukem 913: are set to
1.35 lukem 914: .Sq YES .
1.17 fair 915: Passes
1.10 cjs 916: .Sy lockd_flags .
917: .It Sy statd
1.35 lukem 918: .Sq YES
919: or
920: .Sq NO .
1.17 fair 921: Runs
1.10 cjs 922: .Xr rpc.statd 8 ,
923: a status monitoring daemon used when
1.17 fair 924: .Xr rpc.lockd 8
1.50 lukem 925: is running, if
1.3 scottr 926: .Sy nfs_server
1.50 lukem 927: and/or
1.3 scottr 928: .Sy nfs_client
1.50 lukem 929: are set to
1.35 lukem 930: .Sq YES .
1.17 fair 931: Passes
1.10 cjs 932: .Sy statd_flags .
933: .It Sy amd
1.35 lukem 934: .Sq YES
935: or
936: .Sq NO .
1.17 fair 937: Runs
1.1 mrg 938: .Xr amd 8 ,
1.10 cjs 939: the automounter daemon, which automatically mounts NFS file systems
1.51 wiz 940: whenever a file or directory within that file system is accessed.
1.17 fair 941: Passes
1.10 cjs 942: .Sy amd_flags .
1.1 mrg 943: .It Sy amd_dir
1.50 lukem 944: A string.
1.1 mrg 945: The
1.17 fair 946: .Xr amd 8
947: mount directory.
1.5 cjs 948: Used only if
1.10 cjs 949: .Sy amd
1.35 lukem 950: is set to
951: .Sq YES .
1.13 jonathan 952: .El
1.49 wiz 953: .Ss Other daemons
1.11 mikel 954: .Bl -tag -width net_interfaces
1.50 lukem 955: .It Sy kdc
956: .Sq YES
957: or
958: .Sq NO .
959: Runs the
960: .Xr kdc 8
961: Kerberos v4 and v5 server.
962: This should be run on Kerberos master and slave servers.
963: .It Sy isdnd
964: .Sq YES
965: or
966: .Sq NO .
967: Runs
968: .Xr isdnd 8 ,
969: the isdn4bsd ISDN connection management daemon.
970: Passes
971: .Sy isdnd_flags .
972: .It Sy isdn_autoupdown
973: .Sq YES
974: or
975: .Sq NO .
976: Set all configured ISDN interfaces to
977: .Dq up .
978: If
979: .Sy isdn_interfaces
980: is not blank, only the listed interfaces will be modified.
981: Used only if
982: .Sy isdnd
983: is set to
984: .Sq YES .
1.5 cjs 985: .It Sy rwhod
1.35 lukem 986: .Sq YES
987: or
988: .Sq NO .
1.17 fair 989: Runs
1.11 mikel 990: .Xr rwhod 8
1.10 cjs 991: to support the
1.11 mikel 992: .Xr rwho 1
1.17 fair 993: and
994: .Xr ruptime 1
995: commands.
1.35 lukem 996: .El
1.49 wiz 997: .Ss Hardware daemons
1.35 lukem 998: .Bl -tag -width net_interfaces
999: .It Sy apmd
1000: .Sq YES
1001: or
1002: .Sq NO .
1003: Runs
1004: .Xr apmd 8
1005: and passes
1006: .Sy apmd_flags .
1.50 lukem 1007: .It Sy poffd
1008: .Sq YES
1009: or
1010: .Sq NO .
1011: Runs
1012: .Xr poffd 8
1013: x68k shutdown daemon
1014: (only for
1.51 wiz 1015: .Nx Ns /x86k ) .
1.50 lukem 1016: Passes
1017: .Sy poffd_flags .
1.16 mrg 1018: .It Sy screenblank
1.35 lukem 1019: .Sq YES
1020: or
1021: .Sq NO .
1.17 fair 1022: Runs
1023: .Xr screenblank 1
1.16 mrg 1024: and passes
1025: .Sy screenblank_flags .
1.50 lukem 1026: .It Sy moused
1027: .Sq YES
1028: or
1029: .Sq NO .
1030: Runs
1031: .Xr moused 8 ,
1032: to pass serial mouse data to the wscons mouse mux.
1033: Passes
1034: .Sy moused_flags .
1.35 lukem 1035: .It Sy wscons
1036: .Sq YES
1037: or
1038: .Sq NO .
1039: Configures the
1040: .Xr wscons 4
1041: console driver, from the configuration file
1042: .Pa /etc/wscons.conf .
1.1 mrg 1043: .El
1044: .Sh FILES
1.39 lukem 1045: .Bl -tag -width /etc/defaults/rc.conf -compact
1046: .It Pa /etc/rc.conf
1047: The file
1048: .Nm
1049: resides in
1050: .Pa /etc .
1051: .It Pa /etc/defaults/rc.conf
1052: Default settings for
1053: .Nm "" .
1054: .El
1.1 mrg 1055: .Sh SEE ALSO
1.42 itojun 1056: .Xr ifconfig.if 5 ,
1.8 mikel 1057: .Xr boot 8 ,
1.34 enami 1058: .Xr rc 8 ,
1059: .Xr sysctl 8
1.1 mrg 1060: .Sh HISTORY
1061: The
1062: .Nm
1063: file appeared in
1064: .Nx 1.3 .
CVSweb <webmaster@jp.NetBSD.org>