+
IPNG Working Group R.E. Gilligan
-INTERNET-DRAFT: draft-ietf-ipngwg-rfc2553bis-07.txt Cache Flow
+INTERNET-DRAFT: draft-ietf-ipngwg-rfc2553bis-09.txt Cache Flow
Obsoletes RFC 2553 S. Thomson
Cisco
J. Bound
J. McCann
Hewlett-Packard
W. R. Stevens
- September 2002
+ December 2002
Basic Socket Interface Extensions for IPv6
- <draft-ietf-ipngwg-rfc2553bis-07.txt>
+ <draft-ietf-ipngwg-rfc2553bis-09.txt>
Status of this Memo
extension headers) are defined in another document [4].
-draft-ietf-ipngwg-2553bis-07.txt Expires March 2003 [Page 1]
+draft-ietf-ipngwg-rfc2553bis-09.txt Expires June 2003 [Page 1]
-INTERNET-DRAFT draft-ietf-ipngwg-rfc2553bis-07.txt September 2002
+INTERNET-DRAFT draft-ietf-ipngwg-rfc2553bis-09.txt December 2002
Table of Contents:
-draft-ietf-ipngwg-2553bis-07.txt Expires March 2003 [Page 2]
+draft-ietf-ipngwg-rfc2553bis-09.txt Expires June 2003 [Page 2]
-INTERNET-DRAFT draft-ietf-ipngwg-rfc2553bis-07.txt September 2002
+INTERNET-DRAFT draft-ietf-ipngwg-rfc2553bis-09.txt December 2002
1. Introduction
to simplify the task of converting existing IPv4 applications to
-draft-ietf-ipngwg-2553bis-07.txt Expires March 2003 [Page 3]
+draft-ietf-ipngwg-rfc2553bis-09.txt Expires June 2003 [Page 3]
-INTERNET-DRAFT draft-ietf-ipngwg-rfc2553bis-07.txt September 2002
+INTERNET-DRAFT draft-ietf-ipngwg-rfc2553bis-09.txt December 2002
IPv6.
The IPv4 name-to-address translation functions in the socket interface
-draft-ietf-ipngwg-2553bis-07.txt Expires March 2003 [Page 4]
+draft-ietf-ipngwg-rfc2553bis-09.txt Expires June 2003 [Page 4]
-INTERNET-DRAFT draft-ietf-ipngwg-rfc2553bis-07.txt September 2002
+INTERNET-DRAFT draft-ietf-ipngwg-rfc2553bis-09.txt December 2002
are gethostbyname() and gethostbyaddr(). These are left as is, and new
-draft-ietf-ipngwg-2553bis-07.txt Expires March 2003 [Page 5]
+draft-ietf-ipngwg-rfc2553bis-09.txt Expires June 2003 [Page 5]
-INTERNET-DRAFT draft-ietf-ipngwg-rfc2553bis-07.txt September 2002
+INTERNET-DRAFT draft-ietf-ipngwg-rfc2553bis-09.txt December 2002
3.1 IPv6 Address Family and Protocol Family
The sockaddr_in structure is the protocol-specific address data
-draft-ietf-ipngwg-2553bis-07.txt Expires March 2003 [Page 6]
-
+draft-ietf-ipngwg-rfc2553bis-09.txt Expires June 2003 [Page 6]
-INTERNET-DRAFT draft-ietf-ipngwg-rfc2553bis-07.txt September 2002
+INTERNET-DRAFT draft-ietf-ipngwg-rfc2553bis-09.txt December 2002
structure for IPv4. It is used to pass addresses between applications
and the system in the socket functions. The following sockaddr_in6
field is used in the same way as the sin_port field of the sockaddr_in
structure. The port number is stored in network byte order.
-The sin6_flowinfo field is a 32-bit field that contains two pieces of
-information: the traffic class and the flow label. The contents and
-interpretation of this member is specified in [1].
+The sin6_flowinfo field is a 32-bit field intended to contain flow-
+related information. The exact way this field is mapped to or from a
+packet is not currently specified. Until such time as its use is
+specified, applications should set this field to zero when constructing
+a sockaddr_in6, and ignore this field in a sockaddr_in6 structure
+constructed by the system.
The sin6_addr field is a single in6_addr structure (defined in the
previous section). This field holds one 128-bit IPv6 address. The
be examined carefully when converting to IPv6.
-
3.4 Socket Address Structure for 4.4BSD-Based Systems
The 4.4BSD release includes a small, but incompatible change to the
used to hold a length field, named "sa_len". The sockaddr_in6 data
structure given in the previous section cannot be correctly cast into
-
-draft-ietf-ipngwg-2553bis-07.txt Expires March 2003 [Page 7]
+draft-ietf-ipngwg-rfc2553bis-09.txt Expires June 2003 [Page 7]
-INTERNET-DRAFT draft-ietf-ipngwg-rfc2553bis-07.txt September 2002
+INTERNET-DRAFT draft-ietf-ipngwg-rfc2553bis-09.txt December 2002
the newer sockaddr data structure. For this reason, the following
bind()
-draft-ietf-ipngwg-2553bis-07.txt Expires March 2003 [Page 8]
+draft-ietf-ipngwg-rfc2553bis-09.txt Expires June 2003 [Page 8]
-INTERNET-DRAFT draft-ietf-ipngwg-rfc2553bis-07.txt September 2002
+INTERNET-DRAFT draft-ietf-ipngwg-rfc2553bis-09.txt December 2002
connect()
that address, within a sockaddr_in6 structure, in the connect() or
-draft-ietf-ipngwg-2553bis-07.txt Expires March 2003 [Page 9]
+draft-ietf-ipngwg-rfc2553bis-09.txt Expires June 2003 [Page 9]
-INTERNET-DRAFT draft-ietf-ipngwg-rfc2553bis-07.txt September 2002
+INTERNET-DRAFT draft-ietf-ipngwg-rfc2553bis-09.txt December 2002
sendto() call. When applications use AF_INET6 sockets to accept TCP
/* This is the WRONG way to assign an unspecified address */
-draft-ietf-ipngwg-2553bis-07.txt Expires March 2003 [Page 10]
+draft-ietf-ipngwg-rfc2553bis-09.txt Expires June 2003 [Page 10]
-INTERNET-DRAFT draft-ietf-ipngwg-rfc2553bis-07.txt September 2002
+INTERNET-DRAFT draft-ietf-ipngwg-rfc2553bis-09.txt December 2002
struct sockaddr_in6 sin6;
platforms. This data structure is designed with the following goals.
-draft-ietf-ipngwg-2553bis-07.txt Expires March 2003 [Page 11]
+draft-ietf-ipngwg-rfc2553bis-09.txt Expires June 2003 [Page 11]
-INTERNET-DRAFT draft-ietf-ipngwg-rfc2553bis-07.txt September 2002
+INTERNET-DRAFT draft-ietf-ipngwg-rfc2553bis-09.txt December 2002
- Large enough to accommodate all supported protocol-specific address
Constants _SS_PAD1SIZE (derived value 6) and _SS_PAD2SIZE (derived value
-draft-ietf-ipngwg-2553bis-07.txt Expires March 2003 [Page 12]
+draft-ietf-ipngwg-rfc2553bis-09.txt Expires June 2003 [Page 12]
-INTERNET-DRAFT draft-ietf-ipngwg-rfc2553bis-07.txt September 2002
+INTERNET-DRAFT draft-ietf-ipngwg-rfc2553bis-09.txt December 2002
112) are also for illustration and not required. The derived values
command. Other implementations may wish to use ioctl() for this
-draft-ietf-ipngwg-2553bis-07.txt Expires March 2003 [Page 13]
+draft-ietf-ipngwg-rfc2553bis-09.txt Expires June 2003 [Page 13]
-INTERNET-DRAFT draft-ietf-ipngwg-rfc2553bis-07.txt September 2002
+INTERNET-DRAFT draft-ietf-ipngwg-rfc2553bis-09.txt December 2002
purpose.
The end of the array of structures is indicated by a structure with an
-draft-ietf-ipngwg-2553bis-07.txt Expires March 2003 [Page 14]
+draft-ietf-ipngwg-rfc2553bis-09.txt Expires June 2003 [Page 14]
-INTERNET-DRAFT draft-ietf-ipngwg-rfc2553bis-07.txt September 2002
+INTERNET-DRAFT draft-ietf-ipngwg-rfc2553bis-09.txt December 2002
if_index of 0 and an if_name of NULL. The function returns a NULL
-draft-ietf-ipngwg-2553bis-07.txt Expires March 2003 [Page 15]
+draft-ietf-ipngwg-rfc2553bis-09.txt Expires June 2003 [Page 15]
-INTERNET-DRAFT draft-ietf-ipngwg-rfc2553bis-07.txt September 2002
+INTERNET-DRAFT draft-ietf-ipngwg-rfc2553bis-09.txt December 2002
x < -1: return an error of EINVAL
-draft-ietf-ipngwg-2553bis-07.txt Expires March 2003 [Page 16]
+draft-ietf-ipngwg-rfc2553bis-09.txt Expires June 2003 [Page 16]
-INTERNET-DRAFT draft-ietf-ipngwg-rfc2553bis-07.txt September 2002
+INTERNET-DRAFT draft-ietf-ipngwg-rfc2553bis-09.txt December 2002
If IPV6_MULTICAST_HOPS is not set, the default is 1
-draft-ietf-ipngwg-2553bis-07.txt Expires March 2003 [Page 17]
+draft-ietf-ipngwg-rfc2553bis-09.txt Expires June 2003 [Page 17]
-INTERNET-DRAFT draft-ietf-ipngwg-rfc2553bis-07.txt September 2002
+INTERNET-DRAFT draft-ietf-ipngwg-rfc2553bis-09.txt December 2002
5.3 IPV6_V6ONLY option for AF_INET6 Sockets
-draft-ietf-ipngwg-2553bis-07.txt Expires March 2003 [Page 18]
+draft-ietf-ipngwg-rfc2553bis-09.txt Expires June 2003 [Page 18]
-INTERNET-DRAFT draft-ietf-ipngwg-rfc2553bis-07.txt September 2002
+INTERNET-DRAFT draft-ietf-ipngwg-rfc2553bis-09.txt December 2002
6.1 Protocol-Independent Nodename and Service Name Translation
for use with the address family or families. If the specified address
-draft-ietf-ipngwg-2553bis-07.txt Expires March 2003 [Page 19]
+draft-ietf-ipngwg-rfc2553bis-09.txt Expires June 2003 [Page 19]
-INTERNET-DRAFT draft-ietf-ipngwg-rfc2553bis-07.txt September 2002
+INTERNET-DRAFT draft-ietf-ipngwg-rfc2553bis-09.txt December 2002
family is AF_INET, AF_INET6 or AF_UNSPEC, the service can be
string supplied shall be a numeric port string. Otherwise, an
-draft-ietf-ipngwg-2553bis-07.txt Expires March 2003 [Page 20]
+draft-ietf-ipngwg-rfc2553bis-09.txt Expires June 2003 [Page 20]
-INTERNET-DRAFT draft-ietf-ipngwg-rfc2553bis-07.txt September 2002
+INTERNET-DRAFT draft-ietf-ipngwg-rfc2553bis-09.txt December 2002
[EAI_NONAME] error shall be returned. This flag shall prevent any
then addresses are returned for use only with the specified address
-draft-ietf-ipngwg-2553bis-07.txt Expires March 2003 [Page 21]
+draft-ietf-ipngwg-rfc2553bis-09.txt Expires June 2003 [Page 21]
-INTERNET-DRAFT draft-ietf-ipngwg-rfc2553bis-07.txt September 2002
+INTERNET-DRAFT draft-ietf-ipngwg-rfc2553bis-09.txt December 2002
family and protocol; the value of ai_protocol shall be interpreted as
-draft-ietf-ipngwg-2553bis-07.txt Expires March 2003 [Page 22]
+draft-ietf-ipngwg-rfc2553bis-09.txt Expires June 2003 [Page 22]
-INTERNET-DRAFT draft-ietf-ipngwg-rfc2553bis-07.txt September 2002
+INTERNET-DRAFT draft-ietf-ipngwg-rfc2553bis-09.txt December 2002
[EAI_BADFLAGS] The flags parameter had an invalid value.
pointed to by sa.
-draft-ietf-ipngwg-2553bis-07.txt Expires March 2003 [Page 23]
+draft-ietf-ipngwg-rfc2553bis-09.txt Expires June 2003 [Page 23]
-INTERNET-DRAFT draft-ietf-ipngwg-rfc2553bis-07.txt September 2002
+INTERNET-DRAFT draft-ietf-ipngwg-rfc2553bis-09.txt December 2002
If the socket address structure contains an IPv4-mapped IPv6 address or
2. The NI_DGRAM flag is required for the few AF_INET and AF_INET6 port
-draft-ietf-ipngwg-2553bis-07.txt Expires March 2003 [Page 24]
+draft-ietf-ipngwg-rfc2553bis-09.txt Expires June 2003 [Page 24]
-INTERNET-DRAFT draft-ietf-ipngwg-rfc2553bis-07.txt September 2002
+INTERNET-DRAFT draft-ietf-ipngwg-rfc2553bis-09.txt December 2002
numbers (for example, [512,514]) that represent different services
families shall be supported. The src argument points to the string
-draft-ietf-ipngwg-2553bis-07.txt Expires March 2003 [Page 25]
+draft-ietf-ipngwg-rfc2553bis-09.txt Expires June 2003 [Page 25]
-INTERNET-DRAFT draft-ietf-ipngwg-rfc2553bis-07.txt September 2002
+INTERNET-DRAFT draft-ietf-ipngwg-rfc2553bis-09.txt December 2002
being passed in. The dst argument points to a buffer into which the
int IN6_IS_ADDR_LINKLOCAL (const struct in6_addr *);
-draft-ietf-ipngwg-2553bis-07.txt Expires March 2003 [Page 26]
+draft-ietf-ipngwg-rfc2553bis-09.txt Expires June 2003 [Page 26]
-INTERNET-DRAFT draft-ietf-ipngwg-rfc2553bis-07.txt September 2002
+INTERNET-DRAFT draft-ietf-ipngwg-rfc2553bis-09.txt December 2002
int IN6_IS_ADDR_SITELOCAL (const struct in6_addr *);
<netinet/in.h> IN6ADDR_ANY_INIT
-draft-ietf-ipngwg-2553bis-07.txt Expires March 2003 [Page 27]
+draft-ietf-ipngwg-rfc2553bis-09.txt Expires June 2003 [Page 27]
-INTERNET-DRAFT draft-ietf-ipngwg-rfc2553bis-07.txt September 2002
+INTERNET-DRAFT draft-ietf-ipngwg-rfc2553bis-09.txt December 2002
<netinet/in.h> IN6ADDR_LOOPBACK_INIT
-draft-ietf-ipngwg-2553bis-07.txt Expires March 2003 [Page 28]
+draft-ietf-ipngwg-rfc2553bis-09.txt Expires June 2003 [Page 28]
-INTERNET-DRAFT draft-ietf-ipngwg-rfc2553bis-07.txt September 2002
+INTERNET-DRAFT draft-ietf-ipngwg-rfc2553bis-09.txt December 2002
8. Security Considerations
made by Marshall Rose in a proposal to X/Open for a "Uniform Network
-draft-ietf-ipngwg-2553bis-07.txt Expires March 2003 [Page 29]
+draft-ietf-ipngwg-rfc2553bis-09.txt Expires June 2003 [Page 29]
-INTERNET-DRAFT draft-ietf-ipngwg-rfc2553bis-07.txt September 2002
+INTERNET-DRAFT draft-ietf-ipngwg-rfc2553bis-09.txt December 2002
Interface".
Portable Operating System Interface (POSIX)
Open Group Technical Standard: Base Specifications, Issue 6
- December 2001
+ December 2001
ISO 9945 (pending final approval by ISO)
-draft-ietf-ipngwg-2553bis-07.txt Expires March 2003 [Page 30]
+draft-ietf-ipngwg-rfc2553bis-09.txt Expires June 2003 [Page 30]
-INTERNET-DRAFT draft-ietf-ipngwg-rfc2553bis-07.txt September 2002
+INTERNET-DRAFT draft-ietf-ipngwg-rfc2553bis-09.txt December 2002
Authors' Addresses
-draft-ietf-ipngwg-2553bis-07.txt Expires March 2003 [Page 31]
+draft-ietf-ipngwg-rfc2553bis-09.txt Expires June 2003 [Page 31]