On Wed, 2004-12-01 at 12:13 -0800, Florin Andrei wrote:
> Ok, so then here's my not-so-pet peeve:
> There are all kinds of clever and remarkable things that the rc.d system
> is performing, but they are useless if a sysadmin cannot figure them out
> without either reading up acres of large shell scripts in /etc or
> chancing upon a bit of documentation that has the relevant info (not
> that i've seen anything in the docs related to the issue i was
A lot does appear in /usr/share/doc/initscripts-*/sysconfig.txt, but...
> If /etc/sysconfig/nfs is checked by a system script, then please by all
> means _create_ that file, add some generic content (put in all variables
> that _could_ be present in that file, but comment out those that are not
> typically used) and include it in a Fedora Core package.
> Same for ifcfg-eth* - now i know that ESSID is a valid variable and i
> know how to use it, but only after stumbling upon it by chance, when
> reading some system scripts in /etc.
> I would say, whenever a config file in /etc/sysconfig (or wherever)
> _might_ contain a variable, then it _should_ contain it. Comment it out
> if it's not used. Add an explanation above. Comments are good - like
> chicken soup for the sysadmin's brain. Look at /etc/syslog.conf - ain't
> that thing pretty?
...this is a great idea regardless. Cf. also /etc/samba/smb.conf, I
believe. Start the ball rolling by reading the /etc/rc.d/init.d/???
script, parsing it for variable names, and reading the code to comment
it. Generate an example and Bugzilla the result.
Perhaps a good idea would be a tracking bug for this issue and then a
bug for each file. Here's what I drew up for NFS, but I will gladly
suffer accusations of carelessness if something here is stupid:
# Sysconfig default file for nfs
# All variable names appear next to their assigned defaults.
# To change the default, uncomment the line and change the value.
# NFS version 2 will be used unless MOUNTD_NFS_V2 is set to 'no'
# NFS version 3 will be used unless MOUNTD_NFS_V3 is set to 'no'
# Number of nfsd servers to launch
# Location of rpc.rquotad, or set to 'no' to disable
# RQUOTAD=`type -path rpc.rquotad`
# Extra options, other than the above
# Default is to use portmap
I haven't BZ'd this since I wasn't sure if anyone agreed with my
suggestion, but will do so if I can get a second on the motion.
Paul W. Frields, RHCE
fedora-devel-list mailing list