Date: Wed, 29 Nov 2000 23:07:59 -0800 From: Rich Morin <rdm@cfcl.com> To: freebsd-doc@FreeBSD.ORG Subject: Re: documenting nonexistent files Message-ID: <p05001918b64b6effa13c@[192.168.168.205]> In-Reply-To: <4910.975533445@axl.fw.uunet.co.za> References: <4910.975533445@axl.fw.uunet.co.za>
next in thread | previous in thread | raw e-mail | index | archive | help
Well, I can certainly agree that the directory needs work, but it
is quite a reasonable starting point. Hmmmm; here is my take at
an updated version of its "README.example" file (ducking :-); the
directory also needs a slew of "starter" files, which I will take
on if folks like what I've done so far...
A passel of questions came up, BTW (and yes, I _did RTFM :-):
* Are hosts.{allow, deny, and trusted} and ruserok(3) now part of
the same system with hosts.equiv and rlogin(1)? (I really can't
tell from the man pages).
* What is the exact purpose of /etc/localtime? Who creates it?
* Is my characterization of /etc/make.conf.local correct?
* Is the saving of these files automated? If so, why aren't
/etc/passwd and other files being saved?
* I found a reference somewhere to pccard.sample, but now I
can't seem to locate it (sigh).
* Isn't there a man page for (Open)SSL?
-r
=====
$FreeBSD: usr/share/examples/etc/README.examples,v ...
The /usr/share/examples/etc directory contains both the original
distribution versions of the files which are shipped in /etc and
"starter" versions of files which are NOT present by default, but
which can (and occasionally should) be created for some purpose.
This is intended to make it easier to recover when the /etc versions
are accidentally deleted or broken beyond repair. A proper backup
system and regular snapshots (e.g., via RCS or CVS) is recommended,
however, for more safety.
The /etc subtree contains (and can contain) a number of files. For
more information on these files, see README2.examples and the comments
in the example files themselves (if present).
Legend:
+ generally present by default (e.g., at installation)
- generally absent by default (e.g., at installation)
/ directory
1 may be present, depending on hardware architecture.
2 extension depends on network interface hardware
adduser.conf + configuration file for adduser(8)
aliases + sendmail(8) aliases(5) file
amd.conf - configuration file for amd(8)
amd.map + filesystem automounter (see amd(8)) lookup resolution map
apmd.conf + configuration file for apmd(8)
auth.conf + authentication capability database (see auth.conf(5))
ccd.conf - startup script for ccd (4), run by /etc/rc
crontab + system scheduled command table (see crontab(5))
csh.cshrc + sample .cshrc (see csh(1))
csh.login + sample .login (see csh(1))
csh.logout + sample .logout (see csh(1))
daily.local - script, run by /etc/periodic/daily/999.local (obs.)
defaults / default configuration files
make.conf + configuration variables for system builds (see make(1))
pccard.conf + configuration file for pccardd(8)
rc.conf + system configuration info (see rc.conf(5))
disktab + disk description file (see disktab(5))
dm.conf + configuration file for games (see dm(6))
fbtab + configuration file for login(1) (see fbtab(5)
ftpusers + user restriction file for ftpd(8) (see ftp(1))
gettytab + defines port configuration for getty(8) (see gettytab(5))
group + group permissions file (see group(5))
host.conf + defines gethostbyname(3)'s name res. order a (see hosts(5))
hosts + predefines names as IP addresses (see hosts(5))
hosts.allow + defines trusted hosts for ruserok(3) (see hosts_access(5))
hosts.deny + defines denied hosts for ruserok(3) (see hosts_access(5))
hosts.equiv + defines system-wide trusted hosts (see ruserok(3))
hosts.lpd + defines trusted hosts for lpd(8)
inetd.conf + configuration file for inetd(8)
ipsec.local - startup script, run by /etc/rc (see ipsec(4))
localtime + binary reference file for localtime(3)
locate.rc + configuration file for locate(1)
login.access + configuration file for login(8) (see login.access(5))
login.conf + login class capabilities database (see login.conf(5))
mail / sendmail(8) mail transport agent control files
sendmail.cf - raw control file; presence tested by /etc/rc
* - assorted sendmail(8) control files
mail.rc + systemwide initialization files for mail(1)
make.conf - override file for defines/make.conf (see make.conf(5))
make.conf.local - make.conf(5) file, saved from before an upgrade
manpath.config + configuration file for man(1)
master.passwd + "real" user permissions file (see passwd(1), passwd(5))
modems + modem configuration database (see modems(5))
monthly.local - script, run by /etc/periodic/monthly/999.local (obs.)
motd + text of the Message of the Day (see motd(5))
mtree / mtree(8) control files
namedb / Internet domain server (DNS) control files (see named(8))
localhost.rev + reverse DNS lookup file
named.conf + configuration file for named(8)
named.root + information on root name servers
netstart + network startup script run from /etc/rc
networks + see networks(5)
newsyslog.conf + configuration for system log file rotator newsyslog(8)
pam.conf + configuration file for pam(8)
pam.d / directory (if present) of override files for /etc/pam.conf
passwd + "public" user permissions file (see passwd(1), passwd(5))
pccard.conf - override configuration file for pccardd(8)
pccard.conf.sample - sample configuration file for pccardd(8) ???
pccard_ether + configuration script for ethernet pccards (see pccardd(8))
periodic / periodically run scripts (see periodic(8))
daily / scripts that are run daily
weekly / scripts that are run monthly
monthly / scripts that are run weekly
phones + phone number database for tip(1) (see phones(5)
pim6dd.conf + configuration file for pim6dd(8) (see pim6dd.conf(5))
pim6sd.conf + configuration file for pim6sd(8) (see pim6sd.conf(5))
printcap + configuration file for lpr(1) (see printcap(5))
profile + system-wide .profile for sh(1)
protocols + protocol name data base (see protocols(5))
ptmp - password temporary lock file; presence tested by /etc/rc
rc + system startup script (see init(8), rc(8))
rc.alpha 1 startup script for (Alpha) axp-specific processing
rc.atm + networking startup script for atm(8)
rc.conf.local - script run by /etc/rc.conf
rc.devfs + startup script for devfs(5)
rc.diskless1 - general BOOTP startup script, run by /etc/rc.
rc.diskless2 - special script; run by /etc/rc per rc.diskless1.
rc.firewall + setup system for ipfw(8)
rc.i386 1 startup script for (Intel) i386-specific processing
rc.isdn + startup script for isdnd(8)
rc.local - startup script; run by /etc/rc
rc.network + network startup script
rc.pccard + startup script for PC-cards
rc.serial + sample local startup script fragments
rc.shutdown + system shutdown script (see init(8))
remote + configuration file for tip(1)
rpc + rpc(3) program number data base (see rpc(5))
security + script run from crontab to do nightly security checks
services + service name data base (see services(5))
shells + list of configurable shells (see shells(5))
skey.access + configuration file for skey(1) (see key(1), skey.access(5))
ssh / OpenSSH secure shell client control files (see ssh(1))
ssl / OpenSSL control files
start_if.* 2 script, run by /etc/rc
sysctl.conf - configuration file for sysctl(8) (see sysctl.conf(5))
syslog.conf + configuration file for syslogd(8) (see syslog.conf(5))
ttys + defines port configuration for init(8) (see ttys(5))
weekly.local - script run by /etc/periodic/weekly/999.local (obs.)
--
--
Rich Morin: rdm@cfcl.com, +1 650-873-7841, http://www.cfcl.com/rdm
Prime Time Freeware: info@ptf.com, +1 408-433-9662, http://www.ptf.com
MacPerl: http://www.macperl.com, http://www.ptf.com/ptf/products/MPPE
MkLinux: http://www.mklinux.org, http://www.ptf.com/ptf/products/MKLP
To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?p05001918b64b6effa13c>