From owner-freebsd-doc Wed Nov 29 23: 8: 3 2000 Delivered-To: freebsd-doc@freebsd.org Received: from cfcl.com (cpe-024-221-169-054.ca.sprintbbd.net [24.221.169.54]) by hub.freebsd.org (Postfix) with ESMTP id 93CE637B400 for ; Wed, 29 Nov 2000 23:07:58 -0800 (PST) Received: from [192.168.168.205] (cerberus [192.168.168.205]) by cfcl.com (8.9.3/8.9.3) with ESMTP id XAA24542 for ; Wed, 29 Nov 2000 23:07:36 -0800 (PST) (envelope-from rdm@cfcl.com) Mime-Version: 1.0 Message-Id: In-Reply-To: <4910.975533445@axl.fw.uunet.co.za> References: <4910.975533445@axl.fw.uunet.co.za> Date: Wed, 29 Nov 2000 23:07:59 -0800 To: freebsd-doc@FreeBSD.ORG From: Rich Morin Subject: Re: documenting nonexistent files Content-Type: text/plain; charset="us-ascii" ; format="flowed" Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org 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