Bug 201475 - NETDEVICE(7) does not contain IPv6 related information
Summary: NETDEVICE(7) does not contain IPv6 related information
Status: RESOLVED CODE_FIX
Alias: None
Product: Documentation
Classification: Unclassified
Component: man-pages (show other bugs)
Hardware: All Linux
: P1 normal
Assignee: documentation_man-pages@kernel-bugs.osdl.org
URL:
Keywords:
Depends on:
Blocks:
 
Reported: 2018-10-18 22:21 UTC by alexopo.ceid
Modified: 2020-04-23 12:18 UTC (History)
1 user (show)

See Also:
Kernel Version:
Subsystem:
Regression: No
Bisected commit-id:


Attachments

Description alexopo.ceid 2018-10-18 22:21:41 UTC
NETDEVICE(7) page has the following note:

       Strictly speaking, SIOCGIFCONF and the other ioctls that accept or
       return only AF_INET socket addresses, are IP-specific and belong in
       ip(7).


This is not clear. What does "Strictly speaking" mean?
The rule that ioctls are IP-specific isn't strict? If not, then which are the exceptions to this rule?
How can someone configure IPv6 addresses using system calls? Is it anywhere documented? 


I have seen some examples in the internet where ioctl is used for IPv6, like ifconfig source code, but ifconfig is not part of kernel and I don't want to rely only on examples.
Comment 1 Michael Kerrisk 2020-04-23 12:18:15 UTC
(In reply to alexopo.ceid from comment #0)
> NETDEVICE(7) page has the following note:
> 
>        Strictly speaking, SIOCGIFCONF and the other ioctls that accept or
>        return only AF_INET socket addresses, are IP-specific and belong in
>        ip(7).
> 
> 
> This is not clear. What does "Strictly speaking" mean?

I think this is an English language understanding issue.

"Strictly speaking" in English means "To be precise"

> The rule that ioctls are IP-specific isn't strict? If not, then which are
> the exceptions to this rule?

The meaning is:
To be precise [some of these ioctls] are IP-specific and [therefore would be better documented] in ip(7).

> How can someone configure IPv6 addresses using system calls? Is it anywhere
> documented? 

I'm not aware of such documentation.

I reworded the sentence that you asked about to:

       SIOCGIFCONF  and  the  other  ioctls  that  accept  or return only
       AF_INET socket addresses are IP-specific and perhaps should rather
       be documented in ip(7).

Closing this report now.

Note You need to log in before you can comment on or make changes to this bug.