Bug 921476

Summary:	Please document rule6-* files inside the initscripts documentation
Product:	Red Hat Enterprise Linux 6	Reporter:	Michal Bruncko <michal.bruncko>
Component:	initscripts	Assignee:	Lukáš Nykrýn <lnykryn>
Status:	CLOSED ERRATA	QA Contact:	qe-baseos-daemons
Severity:	low	Docs Contact:
Priority:	unspecified
Version:	6.4	CC:	azelinka, jrieden, jscotka, vpavlin
Target Milestone:	rc
Target Release:	---
Hardware:	All
OS:	Unspecified
Whiteboard:
Fixed In Version:		Doc Type:	Bug Fix
Doc Text:	Cause: Documentation does not mention rule-* files. Consequence: Users are not aware of setting routing rules for ipv6 Fix: Document rule6-* files in sysconfic.txt Result: Users can find information about rule6-* files	Story Points:	---
Clone Of:		Environment:
Last Closed:	2013-11-21 22:11:59 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:

Description Michal Bruncko 2013-03-14 09:52:47 UTC

Description of problem:
I've just configured policy routing for IPv6 and I've looked for rule-* equivalent for IPv6. I decide to look inside the documentation file "/usr/share/doc/initscripts-9.03.38/sysconfig.txt" but I realized that rule6-* information is missing besides the fact, that I can use it according this information: http://rhn.redhat.com/errata/RHBA-2012-0355.html

So please document rule6-* avaliability inside sysconfig.txt documentation file. 

Version-Release number of selected component (if applicable):
initscripts-9.03.38-1.el6


Actual results:
documentation about rule6-* is missing

Expected results:
rule6-* possibility should be documented


thank you

Comment 1 Lukáš Nykrýn 2013-03-14 10:55:12 UTC

 /etc/sysconfig/network-scripts/rule-<interface-name>
+/etc/sysconfig/network-scripts/rule6-<interface-name>
 
   Contains lines that specify additional routing rules that should be added
   when the associated interface is brought up.
 
-  Each non-comment line is used directly as an argument to "/sbin/ip rule add".
+  Each non-comment line is used directly as an argument to "/sbin/ip rule add"
+  or "/sbin/ip -6 rule add" for rule6 files.

Is such change sufficient?

Comment 2 Michal Bruncko 2013-03-14 13:05:24 UTC

yes, this is fine, it makes rule6-* documented. But I personally prefer to differentiate between different configuration files like for other config files in following way: 
- keep original rule-* configuration documentation unchanged
- just append at the end of file something like this:

<snip>
/etc/sysconfig/network-scripts/rule6-<interface-name>

  Contains lines that specify additional IPv6 routing rules that should be added
  when the associated interface is brought up.

  Each non-comment line is used directly as an argument to "/sbin/ip -6 rule add".
</snip>

but in real it does not matter. I just wanted to have rule6-* in documentation. Its your choice :)

And thank you for taking this report over.

Comment 3 Lukáš Nykrýn 2013-04-02 14:29:15 UTC

Upstream commit bd80c85bc077753f7bef74c38d85cab30c8831b0

Comment 11 errata-xmlrpc 2013-11-21 22:11:59 UTC

Since the problem described in this bug report should be
resolved in a recent advisory, it has been closed with a
resolution of ERRATA.

For information on the advisory, and where to find the updated
files, follow the link below.

If the solution does not work for you, open a new bug report.

http://rhn.redhat.com/errata/RHBA-2013-1679.html