diff options
author | jkh <jkh@FreeBSD.org> | 1997-09-11 14:30:35 +0000 |
---|---|---|
committer | jkh <jkh@FreeBSD.org> | 1997-09-11 14:30:35 +0000 |
commit | 9f6d1c5c42556e20d49109fa28733e49839ea7b1 (patch) | |
tree | a0200e29daa05625fcab34f9d709d0b6c8a5c78f /share/man | |
parent | 347e2e3c367cf81b878169973f92ca840bdc2f79 (diff) | |
download | FreeBSD-src-9f6d1c5c42556e20d49109fa28733e49839ea7b1.zip FreeBSD-src-9f6d1c5c42556e20d49109fa28733e49839ea7b1.tar.gz |
OK, it's time to introduce the rc.conf(5) man page and kick the
now-obsolete sysconfig(5) man page out. If you add new rc.conf variables,
folks, please try to remember to keep the man page up to date. Thanks!
PR: 4398
Diffstat (limited to 'share/man')
-rw-r--r-- | share/man/man5/Makefile | 6 | ||||
-rw-r--r-- | share/man/man5/sysconfig.5 | 371 |
2 files changed, 3 insertions, 374 deletions
diff --git a/share/man/man5/Makefile b/share/man/man5/Makefile index a34dcdf..df1b712 100644 --- a/share/man/man5/Makefile +++ b/share/man/man5/Makefile @@ -3,9 +3,9 @@ #MISSING: dump.5 plot.5 MAN5= a.out.5 acct.5 core.5 devfs.5 dir.5 disktab.5 ethers.5 fs.5 fbtab.5 \ fdesc.5 forward.5 fstab.5 group.5 hosts.5 intro.5 link.5 kernfs.5 \ - motd.5 networks.5 passwd.5 pbm.5 phones.5 \ - printcap.5 procfs.5 protocols.5 remote.5 resolver.5 services.5 \ - shells.5 stab.5 sysconfig.5 types.5 utmp.5 hosts.equiv.5 hosts.lpd.5 + motd.5 networks.5 passwd.5 pbm.5 phones.5 printcap.5 \ + procfs.5 protocols.5 rc.conf.5 remote.5 resolver.5 services.5 \ + shells.5 stab.5 types.5 utmp.5 hosts.equiv.5 hosts.lpd.5 MLINKS= fs.5 inode.5 utmp.5 wtmp.5 utmp.5 lastlog.5 dir.5 dirent.5 \ resolver.5 resolv.conf.5 hosts.equiv.5 rhosts.5 diff --git a/share/man/man5/sysconfig.5 b/share/man/man5/sysconfig.5 deleted file mode 100644 index c28ac4e..0000000 --- a/share/man/man5/sysconfig.5 +++ /dev/null @@ -1,371 +0,0 @@ -.\" Copyright (c) 1995 -.\" Jordan K. Hubbard -.\" -.\" Redistribution and use in source and binary forms, with or without -.\" modification, are permitted provided that the following conditions -.\" are met: -.\" 1. Redistributions of source code must retain the above copyright -.\" notice, this list of conditions and the following disclaimer. -.\" 2. Redistributions in binary form must reproduce the above copyright -.\" notice, this list of conditions and the following disclaimer in the -.\" documentation and/or other materials provided with the distribution. -.\" -.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND -.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE -.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE -.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE -.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL -.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS -.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) -.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT -.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY -.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF -.\" SUCH DAMAGE. -.\" -.\" $Id$ -.\" -.Dd December 18, 1995 -.Dt SYSCONFIG 5 -.Os FreeBSD 2.0.5 -.Sh NAME -.Nm sysconfig -.Nd local configuration information. -.Sh DESCRIPTION -The file -.Nm sysconfig -contains descriptive information about the local host name, configuration -details for any potential network interfaces and which services should be -started up at system initial boot time. In new installations, the -.Nm sysconfig -file is generally initialized by the system installation utility: -.Pa /stand/sysinstall . -.Pp -It is the duty of the system administrator to properly maintain this file -as changes occur on the local host. -.Sh FILES -.Bl -tag -width /etc/sysconfig -compact -.It Pa /etc/sysconfig -.El -.Sh DESCRIPTION -The purpose of -.Nm -is not to run commands or perform system startup actions -directly. Instead, it is included by the -various generic startup scripts in -.Pa /etc -which conditionalize their -internal actions according to the settings found there. -.Pp -The following list provides a name and short description for each -variable you can set in the -.Nm -file: -.Bl -tag -width Ar -.It Ar keymap -(str) If set to -.Ar NO -then no keymap is installed, otherwise the value is used to install -the keymap file in -.Pa /usr/share/syscons/keymaps/value.kbd -.It Ar keyrate -(str) The keyboard repeat speed. Set to -.Ar slow , -.Ar normal , -.Ar fast -or -.Ar NO -if the default behavior is desired. -.It Ar keychange -(str) If not set to -.Ar NO , -attempt to program the function keys with the value. The value should -be a single string of the form: -.Qq Ar "<funkey_number> <new_value> [<funkey_number> <new_value>]..." -.It Ar cursor -(str) Can be set to the value of -.Ar normal , -.Ar blink , -.Ar destructive -or -.Ar NO -to set the cursor behavior explicitly or chose the default behavior. -.It Ar scrnmap -(str) If set to -.Ar NO -then no screen map is installed, otherwise the value is used to install -the screen map file in -.Pa /usr/share/syscons/scrnmaps/value . -.It Ar font8x16 -(str) If set to -.Ar NO -then the default 8x16 font value is used for screen size requests, otherwise -the value in -.Pa /usr/share/syscons/fonts/value -is used. -.It Ar font8x14 -(str) If set to -.Ar NO -then the default 8x14 font value is used for screen size requests, otherwise -the value in -.Pa /usr/share/syscons/fonts/value -is used. -.It Ar font8x8 -(str) If set to -.Ar NO -then the default 8x8 font value is used for screen size requests, otherwise -the value in -.Pa /usr/share/syscons/fonts/value -is used. -.It Ar blanktime -(int) If set to -.Ar NO -then the default screen blanking interval is used, otherwise it is set -to -.Ar value -seconds. -.It Ar hostname -(str) The Fully Qualified Domain Name of your host on the network. -This should almost certainly be set to something meaningful, even if -you've no network connected. -.It Ar defaultdomainname -(str) The NIS domainname of your host, or -.Ar NO -if you're not running NIS. -.It Ar tcp_extensions -(bool) Set to -.Ar YES -by default, this enables certain TCP options as described by -Internet RFCs 1323 and 1644. If you have problems with connections -randomly hanging or other weird behavior of such nature, you might -try setting this to -.Ar NO -and seeing if that helps. Some hardware/software out there is known -to be broken with respect to these options. -.It Ar network_interfaces -(str) Set to the list of network interfaces to configure on this host. -For example, if you had a loopback device (standard) and an SMC Elite -Ultra NIC, you might have this set to -.Qq Ar "lo0 ed0" -for the two interfaces. An -.No ifconfig_ Ns Em interface -variable is also assumed to exist for each value of -.Em interface . -.It Ar static_routes -(str) Set to the list of static routes you would like to add at system -boot time. If not set to -.Ar NO -then for each whitespace separated element in the value, -a -.No route_ Ns em element -variable is assumed to exist for each instance -of -.Em element , -and will later be passed to a ``route add'' operation. -.It Ar defaultrouter -(str) If not set to -.Ar NO -then create a default route to this host name or IP address (use IP -address value if you also require this router to get to a name -server!) -.It Ar routedflags -(str) Set to the arguments you wish to invoke the -.Xr routed 8 -command -with or -.Ar NO -if you do not wish to run routed. This command is generally only -useful in networks where the active exchange of RIP information is encouraged. -.It Ar timedflags -(str) Set to the arguments you wish to invoke the -.Xr timed 8 -command with or -.Ar NO -if you do not wish to run timed. This command is intended for networks -of machines where a consistent -.Qq "network time" -for all of them must be -established. This is often useful in large NFS environments where -time stamps on files are expected to be consistent network-wide. -.It Ar xntpdflags -(str) Set to the arguments you wish to invoke the -.Xr xntpd 8 -command -with or -.Ar NO -if you do not wish to run xntpd. This command is intended for applications -where more precise time synchronization is required. -.It Ar ntpdate -(str) Set to the arguments you wish to invoke the -.Xr ntpdate 8 -command with or -.Ar NO -if you do not wish to initialize the time with ntpdate. This command is -intended to synchronize the system clock only -.Ar once -from some standard -server. An option to set this up initially (from a list of known servers) -is also provided by the -.Pa /stand/sysinstall -program when the system -is first installed. -.It Ar rwhod -(bool) Set to -.Ar YES -if you want to run the -.Xr rwhod 8 -command. -.It Ar sendmail_flags -(str) Set to the arguments you wish to invoke the -.Xr sendmail 8 -command with or -.Ar NO -if you do not wish to run sendmail. This command should be run by any -host wishing to send and receive electronic mail and is enabled by -default. -.It Ar amdflags -(str) Set to the arguments you wish to invoke the -.Xr amd 8 -command with or -.Ar NO -if you do not wish to run amd. This command implements an -`auto-mount' scheme using NFS and can help prevent the ``spaghetti -mount'' problem often encountered in large computational clusters. -Read the man page or see the -.Xr info 1 -section for AMD. -.It Ar nfs_client -(bool) Set to -.Ar YES -if this host will be an NFS client. -.It Ar nfs_server -(bool) Set to -.Ar YES -if this host will be an NFS server. Note: This also requires an -.Xr exports 5 -file. -.It Ar nis_ypsetflags -(str) Set to the arguments you wish to invoke the -.Xr ypset 8 -command with or -.Ar NO -if you do not wish to run NIS as a client. -.It Ar nis_serverflags -(str) Set to the arguments you wish to invoke the -.Xr ypserv 8 -command with or -.Ar NO -if you do not wish to run an NIS server. -.It Ar namedflags -(str) Set to the arguments you wish to invoke the -.Xr named 8 -command with or -.Ar NO -if you do not wish to run a name server (if you don't even know what -this means, then you definitely don't). -.It Ar pcnfsd -(str) Set to the arguments you wish to invoke the -.Xr pcnfsd 8 -command with or -.Ar NO -if you do not wish to support ONC clients on DOS, OS/2, Macintosh, -etc) machines. Note that enabling this currently also requires that -you install the optional pcnfsd package. See the networking section -of any reasonably recent package archive or the net subdirectory of -the ports collection. -.It Ar apache_httpd -(bool) If set to -.Ar YES -then the -.Ar "Apache web server" -will be started at system initial -boot time. Note that enabling this currently also requires that you -install the optional apache WWW server package. See the net or www sections -of any reasonably recent package archive or the www subdirectory of -the ports collection. -.It Ar xtend -(bool) If set to -.Ar YES -then the X-10 power controller daemon (the -.Xr xtend 8 -command) will be started -at system initial boot time. -.It Ar dumpdev -(str) If not set to -.Ar NO -then point kernel crash-dumps at the swap device -specified as -.Em value . -.It Ar savecore -(bool) Set to -.Ar YES -if you want kernel crash-dumps to go to -.Ar dumpdev -for later post-mortem diagnosis with the -.Xr gdb 1 -command's -.Fl k -flag. -.It Ar kerberos_server -(bool) Set to -.Ar YES -if you want to run a Kerberos authentication server. -.It Ar gateway -(bool) Set to -.Ar YES -if this host is expected to gateway packets between interfaces (e.g. serve as -some sort of packet router). -.It Ar gated -(bool) Set to -.Ar YES -if you want to run the -.Xr gated 8 -route management system at system -initial boot time. Note that enabling this currently also requires that -you install the optional gated package. See the networking section -of any reasonably recent package archive or the net subdirectory of -the ports collection. -.It Ar check_quotas -(bool) Set to -.Ar YES -if you want to enable user disk quota checking via the -.Xr quotacheck 8 -command. -.It Ar accounting -(bool) Set to -.Ar YES -if you wish to enable system accounting through the -.Xr accton 8 -facility. -.It Ar ibcs2 -(bool) Set to -.Ar YES -if you wish to enable iBCS2 (SCO) binary emulation at system initial boot -time. -.Sh SEE ALSO -.Xr gdb 1 , -.Xr info 1 , -.Xr exports 5 , -.Xr accton 8 , -.Xr amd 8 , -.Xr gated 8 , -.Xr named 8 , -.Xr ntpdate 8 , -.Xr pcnfsd 8 , -.Xr quotacheck 8 , -.Xr rc 8 , -.Xr route 8 , -.Xr routed 8 , -.Xr rwhod 8 , -.Xr sendmail 8 , -.Xr timed 8 , -.Xr xntpd 8 , -.Xr xtend 8 , -.Xr ypserv 8 , -.Xr ypset 8 -.Sh HISTORY -The -.Nm -file appeared in -.Fx 2.0.5 . -.Sh AUTHOR -Jordan K. Hubbard. |