Add documentation for the scripts in /etc/sysconfig/network-scripts/. This has sort of been done here http://www.redhat.com/docs/manuals/enterprise/RHEL-5-manual/en-US/RHEL510/Deployment_Guide/s1-networkscripts-control.html , http://www.redhat.com/docs/manuals/enterprise/RHEL-5-manual/en-US/RHEL510/Deployment_Guide/s1-networkscripts-static-routes.html, and at http://www.redhat.com/docs/manuals/enterprise/RHEL-5-manual/en-US/RHEL510/Deployment_Guide/s1-networkscripts-functions.html. Maybe even describing options for the following would help (from ifcfg-ethx): DEVICE=eth1 ONBOOT=yes BOOTPROTO=dhcp HWADDR=xxxxxx TYPE=Ethernet USERCTL=no IPV6INIT=no PEERDNS=yes [I first tried to find this where all other /etc/sysconfig/[x] files were described...] Cheers, Murray.
*** Bug 447880 has been marked as a duplicate of this bug. ***
Hi Murray, The timeline for sorting this out is probably 5.5. I agree with you that the networking sections, and particularly those dealing with the configuration files under /etc/sysconfig/network-scripts/ and the /etc/sysconfig/network file, could be combined and made more coherent. Looking at the current 5.4 online docs, the ifcfg-ethX parameters do seem to be documented (though probably not comprehensively): See: http://www.redhat.com/docs/en-US/Red_Hat_Enterprise_Linux/5.4/html/Deployment_Guide/s1-networkscripts-interfaces.html Under: "Below is a listing of the configurable parameters in an Ethernet interface configuration file" What I would like to see is a description of how the following configuration files interact: /etc/sysconfig/network /etc/sysconfig/network-scripts /etc/dhclient-ethX.conf /etc/hosts ...especially in conjunction with system-config-network (not to mention NetworkManager). It would, IMO, be beneficial too to add the discussion of the /etc/sysconfig/network parameters to the network configuration section, and to link to that from the /etc/sysconfig/network file description (thus moving discussion of all networking config files to the place). Would you agree with this proposal? Is this what you were thinking of, or do you have an alternative/more specific proposal? Thanks, Silas
re comment #3, I had not seen that link before, which looks like it describes what I was looking for, sorry.