new draft

This commit is contained in:
Mark Andrews 2002-12-09 21:35:23 +00:00
parent c7f73fd03c
commit 44c733920a

View file

@ -1,18 +1,19 @@
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
@ -61,10 +62,10 @@ Abstract
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:
@ -127,10 +128,10 @@ Authors' Addresses.............................................31
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
@ -193,10 +194,10 @@ this well-worn API:
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.
@ -259,10 +260,10 @@ of interfaces identifying the scope for an IPv6 address.
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
@ -325,10 +326,10 @@ This section specifies the socket interface changes for IPv6.
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
@ -391,11 +392,10 @@ structure. This field identifies the type of the data structure.
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
@ -421,9 +421,12 @@ The sin6_port field contains the 16-bit UDP or TCP port number. This
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
@ -447,7 +450,6 @@ being 16 bytes. Any existing code that makes this assumption needs to
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
@ -456,11 +458,10 @@ was changed from a 16-bit value to an 8-bit value, and the space saved
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
@ -523,10 +524,10 @@ system are:
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()
@ -589,10 +590,10 @@ destination's IPv4 address as an IPv4-mapped IPv6 address, and passing
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
@ -655,10 +656,10 @@ example, the following code will not work:
/* 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;
@ -721,10 +722,10 @@ writing code that is portable across multiple address families and
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
@ -787,10 +788,10 @@ _SS_MAXSIZE (chosen value 128) and _SS_ALIGNSIZE (with chosen value 8).
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
@ -853,10 +854,10 @@ functions using the existing sysctl() function with the NET_RT_IFLIST
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.
@ -919,10 +920,10 @@ structure per interface.
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
@ -985,10 +986,10 @@ follows:
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
@ -1051,10 +1052,10 @@ used with getsockopt().
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
@ -1117,10 +1118,10 @@ delivered to the socket.
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
@ -1183,10 +1184,10 @@ is no longer part of the basic API.
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
@ -1249,10 +1250,10 @@ fashion using the getaddrinfo() function.
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
@ -1315,10 +1316,10 @@ INTERNET-DRAFT draft-ietf-ipngwg-rfc2553bis-07.txt September 2002
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
@ -1381,10 +1382,10 @@ INTERNET-DRAFT draft-ietf-ipngwg-rfc2553bis-07.txt September 2002
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
@ -1447,10 +1448,10 @@ INTERNET-DRAFT draft-ietf-ipngwg-rfc2553bis-07.txt September 2002
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.
@ -1513,10 +1514,10 @@ The salen argument holds the size of the socket address structure
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
@ -1579,10 +1580,10 @@ Note:
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
@ -1645,10 +1646,10 @@ specify the family of the address. The AF_INET and AF_INET6 address
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
@ -1711,10 +1712,10 @@ The following macros can be used to test for special IPv6 addresses.
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 *);
@ -1777,10 +1778,10 @@ definitions discussed in this memo, sorted by header.
<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
@ -1843,10 +1844,10 @@ discussed in this memo, sorted by header.
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
@ -1909,10 +1910,10 @@ suffice for connecting to a service independent of protocol details was
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".
@ -1935,7 +1936,7 @@ References
Portable Operating System Interface (POSIX)
Open Group Technical Standard: Base Specifications, Issue 6
December 2001
December 2001
ISO 9945 (pending final approval by ISO)
@ -1975,10 +1976,10 @@ References
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
@ -2041,5 +2042,5 @@ Email: Jack.McCann@hp.com
draft-ietf-ipngwg-2553bis-07.txt Expires March 2003 [Page 31]
draft-ietf-ipngwg-rfc2553bis-09.txt Expires June 2003 [Page 31]