Description of problem: I'm now playing little with IP tunnels and I hit number issues with current iproute2 package in Fedora 19: - old and only partial documentation. There is package iproute-doc, but it contains only old doc from Linux 2.0/2.2 era. New features are not documented there nor in man pages, examples are missing. - Even worse, it seems as some are not mentioned in 'ip' utility help too. E.g. it seems as these command works, but are mentioned nowhere in iproute2 package: ip tuntap add dev My-TAP-Iface mode tap ip link add My-TAP-Iface type gretap - Documentation for related kernel modules as ip_tunnel, ip_gre,.. (in correlation to iproute2, mainly) is not in iproute2 nor in kernel-doc. E.g.: after 'modprobe ip_gre' appears two netwok interfaces: gre0 and gretap0. Whet they are? What are they good for? Which is their typical usage? Examples? What third interface which is created after 'ip tunnel add My-If mode gre ...' in relation to gre0 and gretap0 ? - iproute2 F19 package iproute-3.9.0-2.fc19 is relatively old, actual version is 3.12 from 23-Nov-2013 Version-Release number of selected component (if applicable): iproute-3.9.0-2.fc19.i686.rpm Actual results: Users wondering new iproute features have problem orientate oneself. Expected results: I know it is problem maintain documentation up-to-date. On other hand, it seems there are undocumented features which was included in Linux v2.6.34 or earlier (i.e. 3 years ago or earlier). What good are powerful Linux networking possibilities, when are undocumented? Each can not read source codes and imagine what means...
Still same situation on F20 with iproute-3.11.0-1.fc20.x86_64 so should this be cloned or something, is there a chance it will get fixed on F19 too? Nothing found, when I was looking for info about type gretap, even when it's supported. And it seems that such documentation exists (see archlinux version for ex.) http://manned.org/ip-link.8.
I admit the iproute documentation is an issue. Developers generally don't document the features they add here. Any help with this will be greatly appreciated, not just in Fedora :) GRETAP documentation was added in 3.12. I will issue updates for f19+ since kernel 3.13 packages are already there.
iproute-3.12.0-2.fc20 has been submitted as an update for Fedora 20. https://admin.fedoraproject.org/updates/iproute-3.12.0-2.fc20
iproute-3.12.0-2.fc19 has been submitted as an update for Fedora 19. https://admin.fedoraproject.org/updates/iproute-3.12.0-2.fc19
iproute-3.12.0-2.fc20 has been pushed to the Fedora 20 stable repository. If problems still persist, please make note of it in this bug report.
iproute-3.12.0-2.fc19 has been pushed to the Fedora 19 stable repository. If problems still persist, please make note of it in this bug report.