New: rtnetlink(7) / RTM_GETROUTE specifies incorrect structure

https://bugzilla.kernel.org/show_bug.cgi?id=115721

Bug ID: 115721
Summary: rtnetlink(7) / RTM_GETROUTE specifies incorrect
structure
Product: Documentation
Version: unspecified
Hardware: All
OS: Linux
Status: NEW
Severity: normal
Priority: P1
Component: man-pages
Assignee: documentation_man-pages-ztI5WcYan/[email protected]
Reporter: [email protected]
Regression: No

The current manpage for rtnetlink(7) states:

RTM_NEWROUTE, RTM_DELROUTE, RTM_GETROUTE
Create, remove or receive information about a network route. These messages
contain an rtmsg structure with an optional sequence of rtattr structures following.

However, this appears to be incorrect as of this commit:
https://github.com/torvalds/linux/commit/88c5b5ce5cb57af6ca2a7cf4d5715fa320448ff9

Updated by:
https://github.com/torvalds/linux/commit/e5eca6d41f53db48edd8cf88a3f59d2c30227f8e

Prior to 88c5b5ce, the correct structure was a struct rtgenmsg (not rtmsg), which only has the family parameter. On and after 88c5b5ce, this was changed to struct ifinfomsg.

iproute2 shows the usage of this before and after the change:
https://git.kernel.org/cgit/linux/kernel/git/shemminger/iproute2.git/commit/?id=63338dca45135c85c7f588bd5068e6e77ff816eb

I'm not quite sure what the text should say. ifinfomsg has a number of other fields beyond ifi_family, but they seem to be unused with this API.

Thanks.

You are receiving this mail because:
You are watching the assignee of the bug.
--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to [email protected]
More majordomo info at  http://vger.kernel.org/majordomo-info.html