Annotation of src/share/man/man5/rc.conf.5, Revision 1.56
1.56 ! lukem 1: .\" $NetBSD: rc.conf.5,v 1.55 2002/03/01 16:52:04 mrg 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.56 ! lukem 35: .Dd March 22, 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.56 ! lukem 171: .It Sy swapoff
! 172: .Sq YES
! 173: or
! 174: .Sq NO .
! 175: Remove block-type swap devices at shutdown time.
! 176: Useful if swapping onto RAIDframe devices.
1.9 lukem 177: .El
1.49 wiz 178: .Ss One-time actions to perform or programs to run on boot-up
1.11 mikel 179: .Bl -tag -width net_interfaces
1.10 cjs 180: .It Sy lkm
1.35 lukem 181: .Sq YES
182: or
183: .Sq NO .
1.17 fair 184: Runs
1.11 mikel 185: .Pa /etc/rc.lkm .
1.10 cjs 186: .It Sy savecore
1.35 lukem 187: .Sq YES
188: or
189: .Sq NO .
1.17 fair 190: Runs the
1.10 cjs 191: .Xr savecore 8
1.17 fair 192: utility.
193: Passes
1.10 cjs 194: .Sy savecore_flags .
1.34 enami 195: .It Sy clear_tmp
1.35 lukem 196: .Sq YES
197: or
198: .Sq NO .
1.34 enami 199: Clear /tmp after reboot.
1.8 mikel 200: .It Sy update_motd
1.35 lukem 201: .Sq YES
202: or
203: .Sq NO .
1.17 fair 204: Updates the
1.8 mikel 205: .Nx
206: version string in the
207: .Pa /etc/motd
1.17 fair 208: file to reflect the version of the running kernel.
209: See
1.8 mikel 210: .Xr motd 5 .
1.27 lukem 211: .It Sy dmesg
1.35 lukem 212: .Sq YES
213: or
214: .Sq NO .
1.27 lukem 215: Create
216: .Pa /var/run/dmesg.boot
217: from the output of
218: .Xr dmesg 8 .
219: Passes
220: .Sy dmesg_flags .
221: .It Sy accounting
1.35 lukem 222: .Sq YES
223: or
224: .Sq NO .
1.27 lukem 225: Enables process accounting with
226: .Xr accton 8 .
227: Requires
228: .Pa /var/account/acct
229: to exist.
1.48 ad 230: .It Sy newsyslog
231: .Sq YES
232: or
233: .Sq NO .
234: Run
235: .Nm newsyslog
236: to trim logfiles before syslogd starts. Intended for laptop users.
1.50 lukem 237: Passes
238: .Sy newsyslog_flags .
1.19 mrg 239: .El
1.49 wiz 240: .Ss System security setting
1.35 lukem 241: .Bl -tag -width net_interfaces
1.19 mrg 242: .It Sy securelevel
1.34 enami 243: A number.
244: The system securelevel is set to the specified value early
1.19 mrg 245: in the boot process, before any external logins, or other programs
1.34 enami 246: that run users job, are started.
1.46 mjl 247: If set to nothing, the default action is taken, as described in
1.19 mrg 248: .Xr init 8 ,
1.46 mjl 249: which contains definitive information about the system securelevel.
1.55 mrg 250: Note that setting
251: .Sy securelevel
252: to 0 in
253: .Nm
254: will actually result in the system booting with securelevel set to 1, as
255: .Xr init 8
256: will raise the level when
257: .Pa /etc/rc
258: finishes.
1.8 mikel 259: .El
1.49 wiz 260: .Ss Networking startup
1.11 mikel 261: .Bl -tag -width net_interfaces
1.7 cjs 262: .It Sy ipfilter
1.35 lukem 263: .Sq YES
264: or
265: .Sq NO .
1.17 fair 266: Runs
1.7 cjs 267: .Xr ipf 8
1.11 mikel 268: to load in packet filter specifications from
1.7 cjs 269: .Pa /etc/ipf.conf
1.17 fair 270: at network boot time, before any interfaces are configured.
271: See
1.35 lukem 272: .Xr ipf.conf 5 .
273: .It Sy ipnat
1.50 lukem 274: .Sq YES
275: or
276: .Sq NO .
1.35 lukem 277: Runs
278: .Xr ipnat 8
279: to load in the IP network address translation (NAT) rules from
280: .Pa /etc/ipnat.conf
281: at network boot time, before any interfaces are configured.
282: See
283: .Xr ipnat.conf 5 .
1.52 martti 284: .It Sy ipfs
285: .Sq YES
286: or
287: .Sq NO .
288: Runs
289: .Xr ipfs 8
290: to save and restore information for ipnat and ipfilter state tables.
291: The information is stored in
292: .Pa /var/db/ipf/ipstate.ipf
293: and
294: .Pa /var/db/ipf/ipnat.ipf .
295: Passes
296: .Sy ipfs_flags .
1.32 itojun 297: .It Sy ipsec
1.35 lukem 298: .Sq YES
299: or
300: .Sq NO .
1.32 itojun 301: Runs
302: .Xr setkey 8
303: to load in IPsec manual keys and policies from
304: .Pa /etc/ipsec.conf
305: at network boot time, before any interfaces are configured.
1.35 lukem 306: .It Sy ipmon
307: .Sq YES
308: or
309: .Sq NO .
310: Runs
311: .Xr ipmon 8
312: to read
313: .Xr ipf 8
314: packet log information and log it to a file or the system log.
315: Passes
316: .Sy ipmon_flags .
1.50 lukem 317: .It Sy racoon
318: .Sq YES
319: or
320: .Sq NO .
321: Runs
322: .Xr racoon 8 ,
323: the IKE (ISAKMP/Oakley) key management daemon.
1.10 cjs 324: .It Sy auto_ifconfig
1.35 lukem 325: .Sq YES
326: or
327: .Sq NO .
1.17 fair 328: Sets the
1.10 cjs 329: .Sy net_interfaces
330: variable (see below) to the output of
1.6 perry 331: .Xr ifconfig 8
332: with the
1.40 lukem 333: .Dq Li -l
1.10 cjs 334: flag and suppresses warnings about interfaces in this list that
335: do not have an ifconfig file or variable.
336: .It Sy net_interfaces
1.50 lukem 337: A string.
1.10 cjs 338: The list of network interfaces to be configured at boot time.
1.42 itojun 339: For each interface "xxN", the system first looks for ifconfig
1.10 cjs 340: parameters in
1.42 itojun 341: .Pa /etc/ifconfig.xxN
1.10 cjs 342: and then in the variable
1.42 itojun 343: .Sy ifconfig_xxN .
1.10 cjs 344: The contents of the file or the variable are handed to ifconfig
1.17 fair 345: after the interface name.
346: If
1.10 cjs 347: .Sy auto_ifconfig
348: is set to "NO" and neither the file nor the variable is found,
349: a warning is printed.
1.42 itojun 350: Refer to
351: .Xr ifconfig.if 5
352: for more details on
353: .Pa /etc/ifconfig.xxN .
1.9 lukem 354: .It Sy ifaliases_*
1.50 lukem 355: A string.
1.9 lukem 356: List of
1.40 lukem 357: .Sq Em "address netmask"
1.9 lukem 358: pairs to configure additional network addresses for the given
359: configured interface
360: .Dq *
361: (e.g.
362: .Sy ifaliases_le0 ) .
363: If
1.40 lukem 364: .Em netmask
1.9 lukem 365: is
366: .Dq - ,
367: then use the default netmask for the interface.
1.28 itojun 368: .Pp
369: .Sy ifaliases_*
1.30 itojun 370: covers limited cases only and considered unrecommended.
1.28 itojun 371: We recommend using
372: .Pa /etc/ifconfig.xxN
373: with multiple lines instead.
1.10 cjs 374: .It Sy flushroutes
1.35 lukem 375: .Sq YES
376: or
377: .Sq NO .
1.17 fair 378: Flushes the route table on networking startup.
379: Useful when coming up to multiuser mode after going down to
380: single-user mode.
1.23 mellon 381: .It Sy dhclient
1.35 lukem 382: .Sq YES
383: or
384: .Sq NO .
385: Set to
386: .Sq YES
387: to configure some or all network interfaces using
1.34 enami 388: the DHCP client.
389: If you set
1.23 mellon 390: .Sy dhclient
1.35 lukem 391: to
392: .Sq YES ,
393: you must either have
394: .Pa /var
395: in
396: .Sy critical_filesystems_beforenet ,
397: as part of
398: .Pa / ,
399: or direct the DHCP client to store the leases file on the root
1.51 wiz 400: file system by modifying the
1.23 mellon 401: .Sy dhclient_flags
1.34 enami 402: variable.
403: You must not provide ifconfig information or ifaliases
404: information for any interface that is to be configured using the DHCP client.
405: Interface aliases can be set up in the DHCP client configuration
1.23 mellon 406: file if needed - see
407: .Xr dhclient.conf 5
408: for details.
1.35 lukem 409: .Pp
410: Passes
411: .Sy dhclient_flags
412: to the DHCP client.
1.34 enami 413: See
1.23 mellon 414: .Xr dhclient 8
1.34 enami 415: for complete documentation.
416: If you wish to configure all broadcast
1.23 mellon 417: network interfaces using the DHCP client, you can leave this blank.
418: To configure only specific interfaces, name the interfaces to be configured
419: on the command line.
420: .Pp
421: If you must run the DHCP client before mounting critical filesystems,
422: then you should specify an alternate location for the DHCP client's lease
423: file in the
424: .Sy dhclient_flags
425: variable - for example, "-lf /tmp/dhclient.leases".
1.10 cjs 426: .It Sy ntpdate
1.35 lukem 427: .Sq YES
428: or
429: .Sq NO .
1.17 fair 430: Runs
1.10 cjs 431: .Xr ntpdate 8
432: to set the system time from one of the hosts in
433: .Sy ntpdate_hosts .
434: If
435: .Sy ntpdate_hosts
436: is empty, it will attempt to find a list of hosts in
437: .Pa /etc/ntp.conf .
1.50 lukem 438: Passes
439: .Sy ntpdate_flags .
1.14 mrg 440: .It Sy ppp_peers
1.50 lukem 441: A string.
1.14 mrg 442: If
443: .Sy ppp_peers
444: is not empty, then
1.50 lukem 445: .Pa /etc/rc.d/ppp
1.14 mrg 446: will check each word in
447: .Sy ppp_peers
1.50 lukem 448: for a corresponding ppp configuration file in
1.14 mrg 449: .Pa /etc/ppp/peers
450: and will call
451: .Xr pppd 8
452: with the
453: .Dq call Sy peer
454: option.
1.29 itojun 455: .It Sy ip6mode
1.50 lukem 456: A string.
1.24 itojun 457: An IPv6 node can be a router
458: .Pq nodes that forward packet for others
459: or host
460: .Pq nodes that do not forward .
1.29 itojun 461: A host can be autoconfigured
462: based on the information advertised by adjacent IPv6 router.
1.24 itojun 463: By setting
1.29 itojun 464: .Sy ip6mode
465: to
466: .Dq Li router ,
467: .Dq Li host ,
468: or
469: .Dq Li autohost ,
470: you can configure your node as a router,
471: a non-autoconfigured host, or an autoconfigured host.
472: Invalid values will be ignored, and the node will be configured as
473: a non-autoconfigured host.
474: You may want to check
475: .Sy rtsol
476: and
477: .Sy rtsold
478: as well, if you set the variable to
1.40 lukem 479: .Dq Li autohost .
1.41 itojun 480: .It Sy ip6sitelocal
481: .Sq YES
482: or
483: .Sq NO .
484: If you intend to use IPv6 site-local address in your site, set it to
485: .Sq YES .
486: Otherwise, reject route will get installed on boot to avoid misconfiguration
487: regarding to site-local addresses.
1.24 itojun 488: .It Sy rtsol
1.35 lukem 489: .Sq YES
490: or
491: .Sq NO .
1.24 itojun 492: Run
493: .Xr rtsol 8 ,
494: router solicitation command for IPv6 host.
1.25 itojun 495: On nomadic host like notebook computers, you may want to enable
496: .Sy rtsold
497: as well.
1.24 itojun 498: Passes
499: .Sy rtsol_flags .
1.29 itojun 500: This is only for autoconfigured IPv6 host, so set
501: .Sy ip6mode
502: to autohost if you use it.
1.50 lukem 503: .It Sy ifwatchd
504: .Sq YES
505: or
506: .Sq NO .
507: Monitor dynamic interfaces and perform actions upon address changes.
508: Passes
509: .Sy ifwatchd_flags .
510: .It Sy altq
511: .Sq YES
512: or
513: .Sq NO .
514: ALTQ configuration/monitoring daemon.
515: Passes
516: .Sy altqd_flags .
1.6 perry 517: .El
1.49 wiz 518: .Ss Daemons required by other daemons
1.11 mikel 519: .Bl -tag -width net_interfaces
1.10 cjs 520: .It Sy inetd
1.35 lukem 521: .Sq YES
522: or
523: .Sq NO .
1.17 fair 524: Runs the
1.10 cjs 525: .Xr inetd 8
1.11 mikel 526: daemon to start network server processes (as listed in
1.5 cjs 527: .Pa /etc/inetd.conf )
1.17 fair 528: as necessary.
529: Passes
1.10 cjs 530: .Sy inetd_flags .
531: The
1.40 lukem 532: .Dq Li -l
1.10 cjs 533: flag turns on libwrap connection logging.
1.34 enami 534: .It Sy rpcbind
1.35 lukem 535: .Sq YES
536: or
537: .Sq NO .
1.17 fair 538: The
1.34 enami 539: .Xr rpcbind 8
1.8 mikel 540: daemon is required for any
541: .Xr rpc 3
1.17 fair 542: services.
1.18 lukem 543: These include NFS,
544: .Tn NIS ,
1.5 cjs 545: .Xr bootparamd 8 ,
546: .Xr rstatd 8 ,
547: .Xr rusersd 8 ,
548: and
549: .Xr rwalld 8 .
1.50 lukem 550: Passes
551: .Sy rpcbind_flags .
1.5 cjs 552: .El
1.49 wiz 553: .Ss Commonly used daemons
1.11 mikel 554: .Bl -tag -width net_interfaces
1.10 cjs 555: .It Sy syslogd
1.35 lukem 556: .Sq YES
557: or
558: .Sq NO .
1.17 fair 559: Runs
1.10 cjs 560: .Xr syslogd 8
561: and passes
562: .Sy syslogd_flags .
1.35 lukem 563: .It Sy cron
564: .Sq YES
565: or
566: .Sq NO .
567: Run
568: .Xr cron 8 .
1.10 cjs 569: .It Sy named
1.35 lukem 570: .Sq YES
571: or
572: .Sq NO .
1.17 fair 573: Runs
1.10 cjs 574: .Xr named 8
575: and passes
576: .Sy named_flags .
1.50 lukem 577: .It Sy named_chrootdir
578: A string.
579: If non-blank and
580: .Sy named
581: is
582: .Sq YES ,
583: run
584: .Xr named 8
585: as the unprivileged user and group
586: .Sq named ,
587: .Xr chroot 2 Ns ed
588: to
589: .Sy named_chrootdir .
590: .Pa Sy named_chrootdir Ns /var/run/log
591: will be added to the list of log sockets that
592: .Xr syslogd 8
593: listens to.
1.10 cjs 594: .It Sy timed
1.35 lukem 595: .Sq YES
596: or
597: .Sq NO .
1.17 fair 598: Runs
1.10 cjs 599: .Xr timed 8
600: and passes
601: .Sy timed_flags .
602: The
1.40 lukem 603: .Dq Li -M
1.10 cjs 604: option allows
605: .Xr timed 8
1.17 fair 606: to be a master time source as well as a slave.
607: If you are also running
1.34 enami 608: .Xr ntpd 8 ,
1.10 cjs 609: only one machine running both should have the
1.40 lukem 610: .Dq Li -M
1.10 cjs 611: flag given to
1.5 cjs 612: .Xr timed 8 .
1.34 enami 613: .It Sy ntpd
1.35 lukem 614: .Sq YES
615: or
616: .Sq NO .
1.17 fair 617: Runs
1.34 enami 618: .Xr ntpd 8
1.10 cjs 619: and passes
1.34 enami 620: .Sy ntpd_flags .
1.50 lukem 621: .It Sy ntpd_chrootdir
622: A string.
623: If non-blank and
624: .Sy ntpd
625: is
626: .Sq YES ,
627: run
628: .Xr ntpd 8
629: as the unprivileged user and group
630: .Sq ntpd ,
631: .Xr chroot 2 Ns ed
632: to
633: .Sy ntpd_chrootdir .
1.51 wiz 634: .Pa Sy ntpd_chrootdir Ns Pa /var/run/log
1.50 lukem 635: will be added to the list of log sockets that
636: .Xr syslogd 8
637: listens to.
1.10 cjs 638: .It Sy sendmail
1.35 lukem 639: .Sq YES
640: or
641: .Sq NO .
1.17 fair 642: Runs
1.11 mikel 643: .Xr sendmail 8
644: and passes
1.10 cjs 645: .Sy sendmail_flags .
1.34 enami 646: .It Sy postfix
1.35 lukem 647: .Sq YES
648: or
649: .Sq NO .
1.34 enami 650: Starts
1.44 wiz 651: .Xr postfix 1
1.34 enami 652: mail system.
1.10 cjs 653: .It Sy lpd
1.35 lukem 654: .Sq YES
655: or
656: .Sq NO .
1.17 fair 657: Runs
1.10 cjs 658: .Xr lpd 8
659: and passes
660: .Sy lpd_flags .
1.5 cjs 661: The
1.40 lukem 662: .Dq Li -l
1.10 cjs 663: flag will turn on extra logging.
1.36 lukem 664: .It Sy sshd
665: .Sq YES
666: or
667: .Sq NO .
668: Runs
669: .Xr sshd 8
670: and passes
671: .Sy sshd_flags .
1.53 lukem 672: .It Sy sshd_conf_dir
673: Location for
674: .Xr sshd 8
675: configuration and key files.
1.5 cjs 676: .El
1.49 wiz 677: .Ss Routing daemons
1.11 mikel 678: .Bl -tag -width net_interfaces
1.10 cjs 679: .It Sy routed
1.35 lukem 680: .Sq YES
681: or
682: .Sq NO .
1.17 fair 683: Runs
1.10 cjs 684: .Xr routed 8 ,
1.17 fair 685: the RIP routing protocol daemon.
686: Passes
1.10 cjs 687: .Sy routed_flags .
1.45 wiz 688: .\" This should be
689: .\" .Sq NO
690: .\" if
691: .\" .Sy gated
692: .\" is
693: .\" .Sq YES .
1.10 cjs 694: .It Sy mrouted
1.35 lukem 695: .Sq YES
696: or
697: .Sq NO .
1.17 fair 698: Runs
1.10 cjs 699: .Xr mrouted 8 ,
1.17 fair 700: the DVMRP multicast routing protocol daemon.
701: Passes
1.10 cjs 702: .Sy mrouted_flags .
1.24 itojun 703: .It Sy route6d
1.35 lukem 704: .Sq YES
705: or
706: .Sq NO .
1.24 itojun 707: Runs
708: .Xr route6d 8 ,
709: the RIPng routing protocol daemon for IPv6.
710: Passes
711: .Sy route6d_flags .
1.25 itojun 712: .It Sy rtsold
1.35 lukem 713: .Sq YES
714: or
715: .Sq NO .
1.25 itojun 716: Runs
717: .Xr rtsold 8 ,
718: the IPv6 router solicitation daemon.
719: .Xr rtsold 8
720: periodically transmits router solicitation packet
721: to find IPv6 router on the network.
722: This configuration is mainly for nomadic host like notebook computers.
723: Stationary host should work fine with
724: .Sy rtsol
725: only.
726: Passes
727: .Sy rtsold_flags .
1.29 itojun 728: This is only for autoconfigured IPv6 host, so set
729: .Sy ip6mode
730: to autohost if you use it.
1.5 cjs 731: .El
1.49 wiz 732: .Ss Daemons used to boot other hosts over a network
1.11 mikel 733: .Bl -tag -width net_interfaces
1.10 cjs 734: .It Sy rarpd
1.35 lukem 735: .Sq YES
736: or
737: .Sq NO .
1.17 fair 738: Runs
1.10 cjs 739: .Xr rarpd 8 ,
740: the reverse ARP daemon, often used to boot
1.8 mikel 741: .Nx
1.17 fair 742: and Sun workstations.
743: Passes
1.10 cjs 744: .Sy rarpd_flags .
745: .It Sy bootparamd
1.35 lukem 746: .Sq YES
747: or
748: .Sq NO .
1.17 fair 749: Runs
1.10 cjs 750: .Xr bootparamd 8 ,
751: the boot parameter server, with
1.11 mikel 752: .Sy bootparamd_flags
1.17 fair 753: as options.
754: Used to boot
1.8 mikel 755: .Nx
1.17 fair 756: and
757: .Tn "SunOS 4.x"
758: systems.
1.10 cjs 759: .It Sy dhcpd
1.35 lukem 760: .Sq YES
761: or
762: .Sq NO .
1.17 fair 763: Runs
1.10 cjs 764: .Xr dhcpd 8 ,
1.17 fair 765: the Dynamic Host Configuration Protocol (DHCP) daemon,
766: for assigning IP addresses to hosts and passing boot information.
767: Passes
1.10 cjs 768: .Sy dhcpd_flags .
1.35 lukem 769: .It Sy dhcrelay
770: .Sq YES
771: or
772: .Sq NO .
773: Runs
774: .Xr dhcrelay 8 .
775: Passes
776: .Sy dhcrelay_flags .
1.10 cjs 777: .It Sy rbootd
1.35 lukem 778: .Sq YES
779: or
780: .Sq NO .
1.17 fair 781: Runs
1.10 cjs 782: .Xr rbootd 8 ,
1.17 fair 783: the
784: .Tn HP
785: boot protocol daemon; used for booting
786: .Tn HP
787: workstations.
788: Passes
1.10 cjs 789: .Sy rbootd_flags .
790: .It Sy mopd
1.35 lukem 791: .Sq YES
792: or
793: .Sq NO .
1.17 fair 794: Runs
1.10 cjs 795: .Xr mopd 8 ,
1.17 fair 796: the
797: .Tn DEC
798: .Tn MOP
799: protocol daemon; used for booting
800: .Tn VAX
801: and other
802: .Tn DEC
803: machines.
1.10 cjs 804: Passes
805: .Sy mopd_flags .
1.50 lukem 806: .It Sy ndbootd
807: .Sq YES
808: or
809: .Sq NO .
810: Runs
811: .Xr ndbootd 8 ,
812: the Sun Network Disk (ND) Protocol server.
813: Passes
814: .Sy ndbootd_flags .
1.24 itojun 815: .It Sy rtadvd
1.35 lukem 816: .Sq YES
817: or
818: .Sq NO .
1.24 itojun 819: Runs
820: .Xr rtadvd 8 ,
821: the IPv6 router advertisement daemon, which is used to advertise
822: information about the subnet to IPv6 end hosts.
823: Passes
824: .Sy rtadvd_flags .
1.25 itojun 825: This is only for IPv6 router, so set
826: .Sy ip6forwarding
1.35 lukem 827: to
828: .Sq YES
829: if you use it.
830: .El
1.49 wiz 831: .Ss X Window System daemons
1.35 lukem 832: .Bl -tag -width net_interfaces
833: .It Sy xfs
834: .Sq YES
835: or
836: .Sq NO .
837: Runs the
838: .Xr xfs 1
839: X11 font server, which supplies local X font files to X terminals.
840: .It Sy xdm
841: .Sq YES
842: or
843: .Sq NO .
844: Runs the
845: .Xr xdm 1
846: X display manager.
847: These X daemons are available only with the optional X distribution of
848: .Nx .
1.5 cjs 849: .El
1.49 wiz 850: .Ss NIS (YP) daemons
1.11 mikel 851: .Bl -tag -width net_interfaces
1.10 cjs 852: .It Sy ypbind
1.35 lukem 853: .Sq YES
854: or
855: .Sq NO .
1.17 fair 856: Runs
1.10 cjs 857: .Xr ypbind 8 ,
1.18 lukem 858: which lets
859: .Tn NIS
860: (YP) clients use information from a
861: .Tn NIS
862: server.
1.17 fair 863: Passes
1.10 cjs 864: .Sy ypbind_flags .
865: .It Sy ypserv
1.35 lukem 866: .Sq YES
867: or
868: .Sq NO .
1.17 fair 869: Runs
1.10 cjs 870: .Xr ypserv 8 ,
1.18 lukem 871: the
872: .Tn NIS
873: (YP) server for distributing information from certain files in
1.5 cjs 874: .Pa /etc .
1.10 cjs 875: Passes
876: .Sy ypserv_flags .
877: The
1.40 lukem 878: .Dq Li -d
1.10 cjs 879: flag causes it to use DNS for lookups in
880: .Pa /etc/hosts
881: that fail.
882: .It Sy yppasswdd
1.35 lukem 883: .Sq YES
884: or
885: .Sq NO .
1.17 fair 886: Runs
1.10 cjs 887: .Xr yppasswdd 8 ,
1.18 lukem 888: which allows remote
889: .Tn NIS
890: users to update password on master server.
1.17 fair 891: Passes
1.10 cjs 892: .Sy yppasswdd_flags .
1.1 mrg 893: .El
1.49 wiz 894: .Ss NFS daemons and parameters
1.11 mikel 895: .Bl -tag -width net_interfaces
1.47 lukem 896: .It Sy mountd
897: .Sq YES
898: or
899: .Sq NO .
900: Runs
901: .Xr mountd 8
902: and passes
903: .Sy mountd_flags .
1.5 cjs 904: .It Sy nfs_client
1.35 lukem 905: .Sq YES
906: or
907: .Sq NO .
1.34 enami 908: The number of local NFS asynchronous I/O server is now controlled via
909: .Xr sysctl 8 .
1.1 mrg 910: .It Sy nfs_server
1.35 lukem 911: .Sq YES
912: or
913: .Sq NO .
1.17 fair 914: Sets up a host to be a NFS server by running
1.47 lukem 915: .Xr nfsd 8
1.17 fair 916: and passing
1.47 lukem 917: .Sy nfsd_flags .
1.10 cjs 918: .It Sy lockd
1.35 lukem 919: .Sq YES
920: or
921: .Sq NO .
1.17 fair 922: Runs
1.10 cjs 923: .Xr rpc.lockd 8
1.50 lukem 924: if
1.1 mrg 925: .Sy nfs_server
1.50 lukem 926: and/or
1.1 mrg 927: .Sy nfs_client
1.50 lukem 928: are set to
1.35 lukem 929: .Sq YES .
1.17 fair 930: Passes
1.10 cjs 931: .Sy lockd_flags .
932: .It Sy statd
1.35 lukem 933: .Sq YES
934: or
935: .Sq NO .
1.17 fair 936: Runs
1.10 cjs 937: .Xr rpc.statd 8 ,
938: a status monitoring daemon used when
1.17 fair 939: .Xr rpc.lockd 8
1.50 lukem 940: is running, if
1.3 scottr 941: .Sy nfs_server
1.50 lukem 942: and/or
1.3 scottr 943: .Sy nfs_client
1.50 lukem 944: are set to
1.35 lukem 945: .Sq YES .
1.17 fair 946: Passes
1.10 cjs 947: .Sy statd_flags .
948: .It Sy amd
1.35 lukem 949: .Sq YES
950: or
951: .Sq NO .
1.17 fair 952: Runs
1.1 mrg 953: .Xr amd 8 ,
1.10 cjs 954: the automounter daemon, which automatically mounts NFS file systems
1.51 wiz 955: whenever a file or directory within that file system is accessed.
1.17 fair 956: Passes
1.10 cjs 957: .Sy amd_flags .
1.1 mrg 958: .It Sy amd_dir
1.50 lukem 959: A string.
1.1 mrg 960: The
1.17 fair 961: .Xr amd 8
962: mount directory.
1.5 cjs 963: Used only if
1.10 cjs 964: .Sy amd
1.35 lukem 965: is set to
966: .Sq YES .
1.13 jonathan 967: .El
1.49 wiz 968: .Ss Other daemons
1.11 mikel 969: .Bl -tag -width net_interfaces
1.50 lukem 970: .It Sy kdc
971: .Sq YES
972: or
973: .Sq NO .
974: Runs the
975: .Xr kdc 8
976: Kerberos v4 and v5 server.
977: This should be run on Kerberos master and slave servers.
978: .It Sy isdnd
979: .Sq YES
980: or
981: .Sq NO .
982: Runs
983: .Xr isdnd 8 ,
984: the isdn4bsd ISDN connection management daemon.
985: Passes
986: .Sy isdnd_flags .
987: .It Sy isdn_autoupdown
988: .Sq YES
989: or
990: .Sq NO .
991: Set all configured ISDN interfaces to
992: .Dq up .
993: If
994: .Sy isdn_interfaces
995: is not blank, only the listed interfaces will be modified.
996: Used only if
997: .Sy isdnd
998: is set to
999: .Sq YES .
1.5 cjs 1000: .It Sy rwhod
1.35 lukem 1001: .Sq YES
1002: or
1003: .Sq NO .
1.17 fair 1004: Runs
1.11 mikel 1005: .Xr rwhod 8
1.10 cjs 1006: to support the
1.11 mikel 1007: .Xr rwho 1
1.17 fair 1008: and
1009: .Xr ruptime 1
1010: commands.
1.35 lukem 1011: .El
1.49 wiz 1012: .Ss Hardware daemons
1.35 lukem 1013: .Bl -tag -width net_interfaces
1014: .It Sy apmd
1015: .Sq YES
1016: or
1017: .Sq NO .
1018: Runs
1019: .Xr apmd 8
1020: and passes
1021: .Sy apmd_flags .
1.50 lukem 1022: .It Sy poffd
1023: .Sq YES
1024: or
1025: .Sq NO .
1026: Runs
1027: .Xr poffd 8
1028: x68k shutdown daemon
1029: (only for
1.51 wiz 1030: .Nx Ns /x86k ) .
1.50 lukem 1031: Passes
1032: .Sy poffd_flags .
1.16 mrg 1033: .It Sy screenblank
1.35 lukem 1034: .Sq YES
1035: or
1036: .Sq NO .
1.17 fair 1037: Runs
1038: .Xr screenblank 1
1.16 mrg 1039: and passes
1040: .Sy screenblank_flags .
1.50 lukem 1041: .It Sy moused
1042: .Sq YES
1043: or
1044: .Sq NO .
1045: Runs
1046: .Xr moused 8 ,
1047: to pass serial mouse data to the wscons mouse mux.
1048: Passes
1049: .Sy moused_flags .
1.35 lukem 1050: .It Sy wscons
1051: .Sq YES
1052: or
1053: .Sq NO .
1054: Configures the
1055: .Xr wscons 4
1056: console driver, from the configuration file
1057: .Pa /etc/wscons.conf .
1.1 mrg 1058: .El
1059: .Sh FILES
1.39 lukem 1060: .Bl -tag -width /etc/defaults/rc.conf -compact
1061: .It Pa /etc/rc.conf
1062: The file
1063: .Nm
1064: resides in
1065: .Pa /etc .
1066: .It Pa /etc/defaults/rc.conf
1067: Default settings for
1068: .Nm "" .
1069: .El
1.1 mrg 1070: .Sh SEE ALSO
1.42 itojun 1071: .Xr ifconfig.if 5 ,
1.8 mikel 1072: .Xr boot 8 ,
1.34 enami 1073: .Xr rc 8 ,
1074: .Xr sysctl 8
1.1 mrg 1075: .Sh HISTORY
1076: The
1077: .Nm
1078: file appeared in
1079: .Nx 1.3 .
CVSweb <webmaster@jp.NetBSD.org>