diff options
| author | Michael Kerrisk <mtk.manpages@gmail.com> | 2007-06-23 07:56:56 +0000 |
|---|---|---|
| committer | Michael Kerrisk <mtk.manpages@gmail.com> | 2007-06-23 07:56:56 +0000 |
| commit | f19a0f03eefac77a52687989582a5bcba2e109d3 (patch) | |
| tree | 3fed6b3b2dfd6230eda1c873b043bb68967a283b /man7/ipv6.7 | |
| parent | 66ee0c7e89fe01348878638515edb8b2a51b9a2e (diff) | |
| download | man-pages-f19a0f03eefac77a52687989582a5bcba2e109d3.tar.gz | |
ffix
Diffstat (limited to 'man7/ipv6.7')
| -rw-r--r-- | man7/ipv6.7 | 59 |
1 files changed, 32 insertions, 27 deletions
diff --git a/man7/ipv6.7 b/man7/ipv6.7 index 4ac72c60a0..ced663f5ea 100644 --- a/man7/ipv6.7 +++ b/man7/ipv6.7 @@ -31,9 +31,9 @@ v4 API. Only differences are described in this man page. .PP To bind an -.I AF_INET6 +.B AF_INET6 socket to any process the local address should be copied from the -.B in6addr_any +.I in6addr_any variable which has .I in6_addr type. @@ -43,7 +43,7 @@ may also be used, which expands to a constant expression. Both of them are in network order. .PP The IPv6 loopback address (::1) is available in the global -.B in6addr_loopback +.I in6addr_loopback variable. For initializations .B IN6ADDR_LOOPBACK_INIT @@ -78,19 +78,19 @@ struct in6_addr { .fi .RE .sp -.B sin6_family +.I sin6_family is always set to .BR AF_INET6 ; -.B sin6_port +.I sin6_port is the protocol port (see -.B sin_port +.I sin_port in .BR ip (7)); -.B sin6_flowinfo +.I sin6_flowinfo is the IPv6 flow identifier; -.B sin6_addr -is the 128bit IPv6 address. -.B sin6_scope_id +.I sin6_addr +is the 128-bit IPv6 address. +.I sin6_scope_id is an ID of depending of on the scope of the address. It is new in Linux 2.4. Linux only supports it for link scope addresses, in that case @@ -121,10 +121,10 @@ A boolean integer flag is zero when it is false, otherwise true. .TP .B IPV6_ADDRFORM Turn an -.I AF_INET6 +.B AF_INET6 socket into a socket of a different address family. Only -.I AF_INET +.B AF_INET is currently supported for that. It is only allowed for IPv6 sockets that are connected and bound to a v4-mapped-on-v6 address. @@ -156,7 +156,7 @@ Argument is a pointer to integer. .B IPV6_MTU_DISCOVER Control path mtu discovery on the socket. See -.I IP_MTU_DISCOVER +.B IP_MTU_DISCOVER in .BR ip (7) for details. @@ -172,9 +172,9 @@ between 0 and 255. Set the device for outgoing multicast packets on the socket. This is only allowed for -.I SOCK_DGRAM +.B SOCK_DGRAM and -.I SOCK_RAW +.B SOCK_RAW socket. The argument is an pointer to an interface index (see .BR netdevice (7)) @@ -200,17 +200,17 @@ Argument is a pointer to a boolean value in an integer. .hy Set delivery of control messages for incoming datagrams containing extension headers from the received packet. -.I IPV6_RTHDR +.B IPV6_RTHDR delivers the routing header, -.I IPV6_AUTHHDR +.B IPV6_AUTHHDR delivers the authentication header, -.I IPV6_DSTOPTS +.B IPV6_DSTOPTS delivers the destination options, -.I IPV6_HOPOPTS +.B IPV6_HOPOPTS delivers the hop options, -.I IPV6_FLOWINFO +.B IPV6_FLOWINFO delivers an integer containing the flow ID, -.I IPV6_HOPLIMIT +.B IPV6_HOPLIMIT delivers an integer containing the hop count of the packet. The control messages have the same type as the socket option. All these header options can also be set for outgoing packets @@ -226,7 +226,7 @@ Argument is a pointer to a boolean value. .B IPV6_RECVERR Control receiving of asynchronous error options. See -.I IP_RECVERR +.B IP_RECVERR in .BR ip (7) for details. @@ -250,19 +250,24 @@ The older libc5 based IPv6 API implementation for Linux is not described here and may vary in details. .PP -Linux 2.4 will break binary compatibility for the sockaddr_in6 for 64bit +Linux 2.4 will break binary compatibility for the +.I sockaddr_in6 +for 64-bit hosts by changing the alignment of .I in6_addr and adding an additional .I sin6_scope_id field. The kernel interfaces stay compatible, but a program including -sockaddr_in6 or in6_addr into other structures may not be. +.I sockaddr_in6 +or +.I in6_addr +into other structures may not be. This is not -a problem for 32bit hosts like i386. +a problem for 32-bit hosts like i386. .PP The -.B sin6_flowinfo +.I sin6_flowinfo field is new in Linux 2.4. It is transparently passed/read by the kernel when the passed address length contains it. @@ -272,7 +277,7 @@ check the outgoing address length may break. The .I sockaddr_in6 structure is bigger than the generic -.BR sockaddr . +.IR sockaddr . Programs that assume that all address types can be stored safely in a .I struct sockaddr need to be changed to use |