Bug 1243352
| Summary: | [Docs][RFE] /etc/sysctl.conf contains no IPv6 parameters | ||
|---|---|---|---|
| Product: | Red Hat Enterprise Linux 6 | Reporter: | Stephen Wadeley <swadeley> |
| Component: | doc-Deployment_Guide | Assignee: | Stephen Wadeley <swadeley> |
| Status: | CLOSED CURRENTRELEASE | QA Contact: | ecs-bugs |
| Severity: | unspecified | Docs Contact: | |
| Priority: | high | ||
| Version: | 6.6 | CC: | albert, ecs-bugs, initscripts-maint-list, lnykryn, ovasik, rsandu2004 |
| Target Milestone: | rc | Keywords: | Documentation, FutureFeature |
| Target Release: | --- | ||
| Hardware: | Unspecified | ||
| OS: | Unspecified | ||
| Whiteboard: | |||
| Fixed In Version: | Doc Type: | Enhancement | |
| Doc Text: |
Cause:
Consequence:
Fix:
Result:
|
Story Points: | --- |
| Clone Of: | 995478 | Environment: | |
| Last Closed: | 2016-03-17 11:38:16 UTC | Type: | Bug |
| Regression: | --- | Mount Type: | --- |
| Documentation: | --- | CRM: | |
| Verified Versions: | Category: | --- | |
| oVirt Team: | --- | RHEL 7.3 requirements from Atomic Host: | |
| Cloudforms Team: | --- | Target Upstream Version: | |
| Embargoed: | |||
| Bug Depends On: | 995478, 1243508 | ||
| Bug Blocks: | |||
|
Description
Stephen Wadeley
2015-07-15 09:35:47 UTC
Lets review what we have: In the section "/proc/sys/net/" https://access.redhat.com/documentation/en-US/Red_Hat_Enterprise_Linux/6/html/Deployment_Guide/s2-proc-dir-sys.html#s3-proc-sys-net it says: The file called /usr/share/doc/kernel-doc-kernel_version/Documentation/networking/ip-sysctl.txt contains a complete list of files and options available in the /proc/sys/net/ipv4/ directory. However that file contains IPv6 info too. Idea 1: explain that ip-sysctl.txt also contains IPv6 info. That is where routing and forwarding settings are documented. = = = In "Using the sysctl Command" https://access.redhat.com/documentation/en-US/Red_Hat_Enterprise_Linux/6/html/Deployment_Guide/s1-proc-sysctl.html it says "For a quick overview of all settings configurable in the /proc/sys/ directory, type the /sbin/sysctl -a command as root. This creates a large, comprehensive list,....." In "Additional Resources" https://access.redhat.com/documentation/en-US/Red_Hat_Enterprise_Linux/6/html/Deployment_Guide/s1-proc-additional-resources.html It lists all the kernel docs relevant to this section and explains how to install kernel-doc. It does not mention /usr/share/doc/initscripts-*/sysconfig.txt as that does not belong to kernel. How would a new user know that /etc/sysctl.conf belongs to initscripts? Do they need to know? If all the info you need can be obtained by running '/sbin/sysctl -a ' then maybe adding that to the conf file is useful. Idea 2: Add note just after /etc/sysctl.conf file is mentioned for the first time under "Using the sysctl Command" to explain it belongs to initscripts. I see that in /usr/share/doc/initscripts-*/sysconfig.txt it explains that some values have been moved to /etc/sysctl.conf. We could ask for a review to see if any other values in /usr/share/doc/initscripts-*/sysconfig.txt need that comment. Is it necessary to refer to /usr/share/doc/initscripts-*/sysconfig.txt from /etc/sysctl.conf ? Idea 3: Mention that modules loaded after sysctl is run may override the settings [as per manual page sysctl(8)] = = = Looking in the "/etc/sysctl.conf" file I see this: # Kernel sysctl configuration file for Red Hat Linux # # For binary values, 0 is disabled, 1 is enabled. See sysctl(8) and # sysctl.conf(5) for more details. Idea 4: Explain in that section of /etc/sysctl.conf that this file is supplied by initiscripts and is being used to override default values and therefore only a small number of parameters are present by default. Add one line to /etc/sysctl.conf explain use of '/sbin/sysctl -a ' to list possible parameters. = = = Agreed additions to improve the understanding of the role of sysctl.conf: = = = The /usr/share/doc/kernel-doc-kernel_version/Documentation/networking/ip-sysctl.txt file contains a list of files and options available in the /proc/sys/net/ipv4/ and /proc/sys/net/ipv6/ directories. Use the sysctl -a command to list the parameters in the sysctl key format. = = The /etc/sysctl.conf is installed by the initscripts package to override some kernel default values and therefore only contains a few of the possible parameters. Use the sysctl -a command to list the parameters in the sysctl key format. See the /usr/share/doc/kernel-doc-kernel_version/Documentation/networking/ip-sysctl.txt file for more information on the possible settings. Note that modules loaded after sysctl has parsed this file might override the settings. = = = = = = = = = (In reply to Stephen Wadeley from comment #4) > Agreed additions to improve the understanding of the role of sysctl.conf: > > Changes are in the 6.8 beta Deployment Guide > = = = > > The > /usr/share/doc/kernel-doc-kernel_version/Documentation/networking/ip-sysctl. > txt file contains a list of files and options available in the > /proc/sys/net/ipv4/ and /proc/sys/net/ipv6/ directories. Use the sysctl -a > command to list the parameters in the sysctl key format. > > For the above, see: E.3.9.4. /proc/sys/net/ https://access.redhat.com/documentation/en-US/Red_Hat_Enterprise_Linux/6-Beta/html/Deployment_Guide/s2-proc-dir-sys.html > = = > > The /etc/sysctl.conf is installed by the initscripts package to override > some kernel default values and therefore only contains a few of the possible > parameters. Use the sysctl -a command to list the parameters in the sysctl > key format. See the > /usr/share/doc/kernel-doc-kernel_version/Documentation/networking/ip-sysctl. > txt file for more information on the possible settings. > > > Note that modules loaded after sysctl has parsed this file might override > the settings. > > for the above, see: E.4. Using the sysctl Command https://access.redhat.com/documentation/en-US/Red_Hat_Enterprise_Linux/6-Beta/html/Deployment_Guide/s1-proc-sysctl.html > = = = = = = = = = |