RFC2133 日本語訳
2133 Basic Socket Interface Extensions for IPv6. R. Gilligan, S.Thomson, J. Bound, W. Stevens. April 1997. (Format: TXT=69737 bytes) (Obsoleted by RFC2553) (Status: INFORMATIONAL)
プログラムでの自動翻訳です。
RFC一覧
英語原文
Network Working Group R. Gilligan Request for Comments: 2133 Freegate Category: Informational S. Thomson Bellcore J. Bound Digital W. Stevens Consultant April 1997
コメントを求めるワーキンググループR.ギリガンの要求をネットワークでつないでください: 2133年のFreegateカテゴリ: デジタルW.スティーブンスコンサルタント1997年4月に縛られた情報のS.トムソンBellcore J.
Basic Socket Interface Extensions for IPv6
IPv6に、基本的なソケットインタフェース拡大
Status of this Memo
このMemoの状態
This memo provides information for the Internet community. This memo does not specify an Internet standard of any kind. Distribution of this memo is unlimited.
このメモはインターネットコミュニティのための情報を提供します。 このメモはどんな種類のインターネット標準も指定しません。 このメモの分配は無制限です。
Abstract
要約
The de facto standard application program interface (API) for TCP/IP applications is the "sockets" interface. Although this API was developed for Unix in the early 1980s it has also been implemented on a wide variety of non-Unix systems. TCP/IP applications written using the sockets API have in the past enjoyed a high degree of portability and we would like the same portability with IPv6 applications. But changes are required to the sockets API to support IPv6 and this memo describes these changes. These include a new socket address structure to carry IPv6 addresses, new address conversion functions, and some new socket options. These extensions are designed to provide access to the basic IPv6 features required by TCP and UDP applications, including multicasting, while introducing a minimum of change into the system and providing complete compatibility for existing IPv4 applications. Additional extensions for advanced IPv6 features (raw sockets and access to the IPv6 extension headers) are defined in another document [5].
TCP/IPアプリケーションのためのデファクトスタンダード適用業務プログラム・インタフェース(API)は「ソケット」インタフェースです。 このAPIは1980年代前半のUnixのために開発されましたが、また、それはさまざまな非unixシステムの上で実装されました。ソケットAPIを使用することで書かれたTCP/IPアプリケーションは過去に高度合いの移植性を楽しみました、そして、私たちはIPv6アプリケーションがある同じ移植性が欲しいと思います。 しかし、変化はソケットAPIにIPv6をサポートしなければなりません、そして、このメモはこれらの変化について説明します。 これらは、IPv6アドレス、新しいアドレス変換機能、およびいくつかの新しいソケットオプションを運ぶために新しいソケットアドレス構造を含んでいます。 これらの拡大はTCPとUDPアプリケーションで必要である基本のIPv6の特徴へのアクセスを提供するように設計されています、マルチキャスティングを含んでいて最小変化をシステムに取り入れて、既存のIPv4アプリケーションに完全な両立性を提供していて。 高度なIPv6の特徴(生のソケットとIPv6拡張ヘッダーへのアクセス)のための追加拡大は別のドキュメント[5]で定義されます。
Table of Contents
目次
1. Introduction ................................................ 2 2. Design Considerations ....................................... 3 2.1. What Needs to be Changed .................................. 3 2.2. Data Types ................................................ 5 2.3. Headers ................................................... 5 2.4. Structures ................................................ 5 3. Socket Interface ............................................ 5 3.1. IPv6 Address Family and Protocol Family ................... 5 3.2. IPv6 Address Structure .................................... 6
1. 序論… 2 2. 問題を設計してください… 3 2.1. Changedである必要があること… 3 2.2. データ型… 5 2.3. ヘッダー… 5 2.4. 構造… 5 3. ソケットインタフェース… 5 3.1. IPv6はファミリーとプロトコルファミリーに演説します… 5 3.2. IPv6は構造を扱います… 6
Gilligan, et. al. Informational [Page 1] RFC 2133 IPv6 Socket Interface Extensions April 1997
etギリガン、アル。 [1ページ]情報のRFC2133IPv6ソケットインタフェース拡大1997年4月
3.3. Socket Address Structure for 4.3BSD-Based Systems ......... 6 3.4. Socket Address Structure for 4.4BSD-Based Systems ......... 7 3.5. The Socket Functions ...................................... 8 3.6. Compatibility with IPv4 Applications ...................... 9 3.7. Compatibility with IPv4 Nodes ............................. 9 3.8. IPv6 Wildcard Address ..................................... 10 3.9. IPv6 Loopback Address ..................................... 11 4. Interface Identification .................................... 12 4.1. Name-to-Index ............................................. 13 4.2. Index-to-Name ............................................. 13 4.3. Return All Interface Names and Indexes .................... 14 4.4. Free Memory ............................................... 14 5. Socket Options .............................................. 14 5.1. Changing Socket Type ...................................... 15 5.2. Unicast Hop Limit ......................................... 16 5.3. Sending and Receiving Multicast Packets ................... 17 6. Library Functions ........................................... 19 6.1. Hostname-to-Address Translation ........................... 19 6.2. Address To Hostname Translation ........................... 22 6.3. Protocol-Independent Hostname and Service Name Translation 22 6.4. Socket Address Structure to Hostname and Service Name ..... 25 6.5. Address Conversion Functions .............................. 27 6.6. Address Testing Macros .................................... 28 7. Summary of New Definitions .................................. 29 8. Security Considerations ..................................... 31 9. Acknowledgments ............................................. 31 10. References ................................................. 31 11. Authors' Addresses ......................................... 32
3.3. 4.3BSDベースのシステムのためのソケットアドレス構造… 6 3.4. 4.4BSDベースのシステムのためのソケットアドレス構造… 7 3.5. ソケットは機能します… 8 3.6. IPv4アプリケーションとの互換性… 9 3.7. IPv4ノードとの互換性… 9 3.8. IPv6ワイルドカードアドレス… 10 3.9. IPv6ループバックアドレス… 11 4. 識別を連結してください… 12 4.1. 索引をつける名前… 13 4.2. 名前に索引をつけてください… 13 4.3. 名前とインデックスをすべてのインタフェースに返してください… 14 4.4. メモリを解放してください… 14 5. ソケットオプション… 14 5.1. ソケットを変えて、タイプしてください… 15 5.2. ユニキャストホップ限界… 16 5.3. 送受信マルチキャストパケット… 17 6. 図書館は機能します… 19 6.1. ホスト名からアドレス翻訳… 19 6.2. ホスト名に翻訳を扱ってください… 22 6.3. プロトコルから独立しているホスト名とサービスは翻訳22を6.4と命名します。 ホスト名とサービス名へのソケットアドレス構造… 25 6.5. 変換が機能であると扱ってください… 27 6.6. テストマクロを扱ってください… 28 7. 新しい定義の概要… 29 8. セキュリティ問題… 31 9. 承認… 31 10. 参照… 31 11. 作者のアドレス… 32
1. Introduction
1. 序論
While IPv4 addresses are 32 bits long, IPv6 interfaces are identified by 128-bit addresses. The socket interface make the size of an IP address quite visible to an application; virtually all TCP/IP applications for BSD-based systems have knowledge of the size of an IP address. Those parts of the API that expose the addresses must be changed to accommodate the larger IPv6 address size. IPv6 also introduces new features (e.g., flow label and priority), some of which must be made visible to applications via the API. This memo defines a set of extensions to the socket interface to support the larger address size and new features of IPv6.
IPv4アドレスが長さ32ビットである間、IPv6インタフェースは128ビットのアドレスによって特定されます。 ソケットインタフェースで、IPアドレスのサイズはアプリケーションにかなり目に見えるようになります。 BSDベースのシステムのほとんどすべてのTCP/IPアプリケーションには、IPアドレスのサイズに関する知識があります。 より大きいIPv6アドレスサイズを収容するためにアドレスを暴露するAPIのそれらの部分を変えなければなりません。 また、IPv6は新機能(例えば、流れラベルと優先権)を導入します。その或るものをAPIを通してアプリケーションに目に見えるようにしなければなりません。 このメモは、より大きいアドレスがIPv6に関するサイズと新機能であるとサポートするために1セットの拡大をソケットインタフェースと定義します。
Gilligan, et. al. Informational [Page 2] RFC 2133 IPv6 Socket Interface Extensions April 1997
etギリガン、アル。 [2ページ]情報のRFC2133IPv6ソケットインタフェース拡大1997年4月
2. Design Considerations
2. デザイン問題
There are a number of important considerations in designing changes to this well-worn API:
この陳腐なAPIへの変化を設計するのにおいて多くの重要な問題があります:
- The API changes should provide both source and binary compatibility for programs written to the original API. That is, existing program binaries should continue to operate when run on a system supporting the new API. In addition, existing applications that are re-compiled and run on a system supporting the new API should continue to operate. Simply put, the API changes for IPv6 should not break existing programs.
- API変化はオリジナルのAPIに書かれたプログラムにソースとバイナリ互換性の両方を供給するはずです。 新しいAPIをサポートするシステムに実行されると、すなわち、既存のプログラム2種混合毒ガスは、作動し続けるべきです。 新しいAPIをサポートする再コンパイルされて、システムで動く既存のアプリケーションは、さらに、作動し続けるべきです。 簡単に言えば、IPv6のためのAPI変化は既存のプログラムを壊すはずがありません。
- The changes to the API should be as small as possible in order to simplify the task of converting existing IPv4 applications to IPv6.
- APIへの変化は、タスクを単純化するためにできるだけ既存のIPv4アプリケーションをIPv6に変換するのにおいて小さいはずです。
- Where possible, applications should be able to use this API to interoperate with both IPv6 and IPv4 hosts. Applications should not need to know which type of host they are communicating with.
- 可能であるところでは、アプリケーションが、IPv6とIPv4ホストの両方で共同利用するのにこのAPIを使用できるべきです。 アプリケーションは、彼らがどのタイプのホストとコミュニケートしているかを知る必要はないはずです。
- IPv6 addresses carried in data structures should be 64-bit aligned. This is necessary in order to obtain optimum performance on 64-bit machine architectures.
- 並べられた状態で、データ構造で運ばれたIPv6アドレスは64ビットであるべきです。 これが、64ビットのマシンアーキテクチャに関する最適な性能を得るのに必要です。
Because of the importance of providing IPv4 compatibility in the API, these extensions are explicitly designed to operate on machines that provide complete support for both IPv4 and IPv6. A subset of this API could probably be designed for operation on systems that support only IPv6. However, this is not addressed in this memo.
APIで互換性をIPv4に供給する重要性のために、これらの拡大は、IPv4とIPv6の両方の完全なサポートを提供するマシンを作動させるように明らかに設計されています。 操作のためにたぶんIPv6だけをサポートするシステムにこのAPIの部分集合を設計できました。 しかしながら、これはこのメモで扱われません。
2.1. What Needs to be Changed
2.1. 何が、Changedである必要がありますか。
The socket interface API consists of a few distinct components:
ソケットインタフェースAPIはいくつかの異なったコンポーネントから成ります:
- Core socket functions.
- コアソケットは機能します。
- Address data structures.
- データ構造を扱ってください。
- Name-to-address translation functions.
- 名前からアドレス変換は機能します。
- Address conversion functions.
- 変換が機能であると扱ってください。
The core socket functions -- those functions that deal with such things as setting up and tearing down TCP connections, and sending and receiving UDP packets -- were designed to be transport independent. Where protocol addresses are passed as function arguments, they are carried via opaque pointers. A protocol-specific
コアソケット機能(TCP接続をセットアップして、取りこわすようなもの、および送受信UDPパケットに対処するそれらの機能)は、輸送独立者になるように設計されました。 プロトコルアドレスが機能議論として通過されるところに、それらは不透明な指針で運ばれます。 プロトコル詳細
Gilligan, et. al. Informational [Page 3] RFC 2133 IPv6 Socket Interface Extensions April 1997
etギリガン、アル。 [3ページ]情報のRFC2133IPv6ソケットインタフェース拡大1997年4月
address data structure is defined for each protocol that the socket functions support. Applications must cast pointers to these protocol-specific address structures into pointers to the generic "sockaddr" address structure when using the socket functions. These functions need not change for IPv6, but a new IPv6-specific address data structure is needed.
アドレスデータ構造はソケット機能がサポートする各プロトコルのために定義されます。 ソケット機能を使用するとき、アプリケーションはジェネリック"sockaddr"アドレス構造への指針へのこれらのプロトコル特有のアドレス構造に指針を投げかけなければなりません。 これらの機能はIPv6のために変化する必要はありませんが、新しいIPv6特有のアドレスデータ構造が必要です。
The "sockaddr_in" structure is the protocol-specific data structure for IPv4. This data structure actually includes 8-octets of unused space, and it is tempting to try to use this space to adapt the sockaddr_in structure to IPv6. Unfortunately, the sockaddr_in structure is not large enough to hold the 16-octet IPv6 address as well as the other information (address family and port number) that is needed. So a new address data structure must be defined for IPv6.
「_中のsockaddr」構造はIPv4のためのプロトコル特有のデータ構造です。 このデータ構造は実際に未使用のスペースの8八重奏を含んでいます、そして、それは構造でsockaddr_をIPv6に適合させるのにこのスペースを使用しようとするのに誘惑しています。 残念ながら、構造のsockaddr_は必要であるもう片方の情報(アドレスファミリーとポートナンバー)と同様に16八重奏のIPv6アドレスを保持できるくらいには大きくはありません。 それで、IPv6のために新しいアドレスデータ構造を定義しなければなりません。
The name-to-address translation functions in the socket interface are gethostbyname() and gethostbyaddr(). These must be modified to support IPv6 and the semantics defined must provide 100% backward compatibility for all existing IPv4 applications, along with IPv6 support for new applications. Additionally, the POSIX 1003.g work in progress [4] specifies a new hostname-to-address translation function which is protocol independent. This function can also be used with IPv6.
ソケットインタフェースでの名前からアドレス変換への機能は、gethostbyname()とgethostbyaddr()です。 IPv6をサポートするようにこれらを変更しなければなりません、そして、定義された意味論は100%の後方の互換性をすべての既存のIPv4アプリケーションに提供しなければなりません、新しいアプリケーションのIPv6サポートと共に。 さらに、POSIX 1003.g処理中の作業[4]はホスト名からアドレス変換へのプロトコル独立者である新しい機能を指定します。 また、IPv6と共にこの機能を使用できます。
The address conversion functions -- inet_ntoa() and inet_addr() -- convert IPv4 addresses between binary and printable form. These functions are quite specific to 32-bit IPv4 addresses. We have designed two analogous functions that convert both IPv4 and IPv6 addresses, and carry an address type parameter so that they can be extended to other protocol families as well.
アドレス変換機能(inet_ntoa()とinet_addr())は2進の、そして、印刷可能なフォームの間のIPv4アドレスを変換します。 これらの機能は32ビットのIPv4アドレスにかなり特定です。 私たちはIPv4とIPv6アドレスの両方を変換して、また、他のプロトコルファミリーにそれらを広げることができるようにアドレス型引数を運ぶ2つの類似の機能を設計しました。
Finally, a few miscellaneous features are needed to support IPv6. New interfaces are needed to support the IPv6 flow label, priority, and hop limit header fields. New socket options are needed to control the sending and receiving of IPv6 multicast packets.
最終的に、いくつかの種々雑多な特徴が、IPv6をサポートするのに必要です。 新しいインタフェースが、IPv6流れラベル、優先権、およびホップ限界ヘッダーフィールドを支えるのに必要です。 新しいソケットオプションが、IPv6マルチキャストパケットの送受信を制御するのに必要です。
The socket interface will be enhanced in the future to provide access to other IPv6 features. These extensions are described in [5].
ソケットインタフェースは、将来、他のIPv6の特徴へのアクセスを提供するために高められるでしょう。 これらの拡大は[5]で説明されます。
Gilligan, et. al. Informational [Page 4] RFC 2133 IPv6 Socket Interface Extensions April 1997
etギリガン、アル。 [4ページ]情報のRFC2133IPv6ソケットインタフェース拡大1997年4月
2.2. Data Types
2.2. データ型
The data types of the structure elements given in this memo are intended to be examples, not absolute requirements. Whenever possible, POSIX 1003.1g data types are used: u_intN_t means an unsigned integer of exactly N bits (e.g., u_int16_t) and u_intNm_t means an unsigned integer of at least N bits (e.g., u_int32m_t). We also assume the argument data types from 1003.1g when possible (e.g., the final argument to setsockopt() is a size_t value). Whenever buffer sizes are specified, the POSIX 1003.1 size_t data type is used (e.g., the two length arguments to getnameinfo()).
このメモで与えられた構造要素に関するデータ型は絶対条件ではなく、例であることを意図します。 可能であるときはいつも、POSIXの1003.1gのデータ型は使用されています: u_intN_tは、_tが少なくともNビット(例えば、u_int32m_t)の符号のない整数を意味することをちょうどNビット(例えば、u_int16_t)とu_intNmの符号のない整数に意味します。 また、可能であるときに、私たちは、議論が1003.1gからのデータ型であると思います(例えば、setsockopt()への最終弁論はサイズ_t値です)。 バッファサイズが指定されるときはいつも、POSIX1003.1サイズ_tデータ型は使用されています。(例えば、getnameinfo())への2つの長さの議論。
2.3. Headers
2.3. ヘッダー
When function prototypes and structures are shown we show the headers that must be #included to cause that item to be defined.
関数原型と構造が私たちがヘッダーを見せるのが示されると、それはその項目が定義されることを引き起こすために含まれていた#、に違いありません。
2.4. Structures
2.4. 構造
When structures are described the members shown are the ones that must appear in an implementation. Additional, nonstandard members may also be defined by an implementation.
構造が説明されるとき、見せられたメンバーは実装に現れなければならないものです。 また、追加していて、標準的でないメンバーは実装によって定義されるかもしれません。
The ordering shown for the members of a structure is the recommended ordering, given alignment considerations of multibyte members, but an implementation may order the members differently.
「マルチ-バイト」メンバーの整列問題を考えて、構造の部材のために示された注文はお勧めの注文ですが、実装はメンバーを異なって命令するかもしれません。
3. Socket Interface
3. ソケットインタフェース
This section specifies the socket interface changes for IPv6.
このセクションはソケットインタフェース変化をIPv6に指定します。
3.1. IPv6 Address Family and Protocol Family
3.1. IPv6アドレスファミリーとプロトコルファミリー
A new address family name, AF_INET6, is defined in <sys/socket.h>. The AF_INET6 definition distinguishes between the original sockaddr_in address data structure, and the new sockaddr_in6 data structure.
新しいアドレス姓(AF_INET6)は<sys/socket.h>で定義されます。 AF_INET6定義はアドレスデータ構造、および新しいsockaddr_in6データ構造でオリジナルのsockaddr_を見分けます。
A new protocol family name, PF_INET6, is defined in <sys/socket.h>. Like most of the other protocol family names, this will usually be defined to have the same value as the corresponding address family name:
新しいプロトコル姓(PF_INET6)は<sys/socket.h>で定義されます。 もう片方の大部分が姓について議定書の中で述べるように、通常、これは対応するアドレス姓と同じ値を持つために定義されるでしょう:
#define PF_INET6 AF_INET6
#PF_INET6 AF_INET6を定義してください。
The PF_INET6 is used in the first argument to the socket() function to indicate that an IPv6 socket is being created.
PF_INET6は、IPv6ソケットが作成されているのを示すのに最初の議論にソケット()機能に使用されます。
Gilligan, et. al. Informational [Page 5] RFC 2133 IPv6 Socket Interface Extensions April 1997
etギリガン、アル。 [5ページ]情報のRFC2133IPv6ソケットインタフェース拡大1997年4月
3.2. IPv6 Address Structure
3.2. IPv6アドレス構造
A new data structure to hold a single IPv6 address is defined as follows:
ただ一つのIPv6アドレスを保持する新しいデータ構造は以下の通り定義されます:
#include <netinet/in.h>
#<netinet/in.h>を含めてください。
struct in6_addr { u_int8_t s6_addr[16]; /* IPv6 address */ }
struct in6_addru_int8_t s6_addr[16]; /*IPv6アドレス*/
This data structure contains an array of sixteen 8-bit elements, which make up one 128-bit IPv6 address. The IPv6 address is stored in network byte order.
このデータ構造は16の8ビットの要素の配列を含んでいます。(要素は1つの128ビットのIPv6アドレスを作ります)。 IPv6アドレスはネットワークバイトオーダーで保存されます。
3.3. Socket Address Structure for 4.3BSD-Based Systems
3.3. 4.3BSDベースのシステムのためのソケットアドレス構造
In the socket interface, a different protocol-specific data structure is defined to carry the addresses for each protocol suite. Each protocol-specific data structure is designed so it can be cast into a protocol-independent data structure -- the "sockaddr" structure. Each has a "family" field that overlays the "sa_family" of the sockaddr data structure. This field identifies the type of the data structure.
ソケットインタフェースでは、異なったプロトコル特有のデータ構造は、各プロトコル群へのアドレスを運ぶために定義されます。 それぞれのプロトコル特有のデータ構造はプロトコルから独立しているデータ構造にそれを投げかけることができるように設計されています--"sockaddr"構造。 それぞれには、sockaddrデータ構造の「sa_ファミリー」をかぶせる「ファミリー」分野があります。 この分野はデータ構造のタイプを特定します。
The sockaddr_in structure is the protocol-specific address data structure for IPv4. It is used to pass addresses between applications and the system in the socket functions. The following structure is defined to carry IPv6 addresses:
構造のsockaddr_はIPv4のためのプロトコル特有のアドレスデータ構造です。 それは、ソケット機能でアプリケーションとシステムの間にアドレスを通過するのに使用されます。 以下の構造はIPv6アドレスを運ぶために定義されます:
#include <netinet/in.h>
#<netinet/in.h>を含めてください。
struct sockaddr_in6 { u_int16m_t sin6_family; /* AF_INET6 */ u_int16m_t sin6_port; /* transport layer port # */ u_int32m_t sin6_flowinfo; /* IPv6 flow information */ struct in6_addr sin6_addr; /* IPv6 address */ };
_u_int16m_t sin6_ファミリー; /*AF_INET6*/u_int16m_t sin6_ポート; /*トランスポート層ポート#*/u int32m_t sin6_flowinfo; _/*IPv6流動情報*/struct in6addr sin6_addr; /*IPv6が*/を扱うstruct sockaddr_in6。
This structure is designed to be compatible with the sockaddr data structure used in the 4.3BSD release.
この構造は、4.3BSDリリースで使用されるsockaddrデータ構造と互換性があるように設計されています。
The sin6_family field identifies this as a sockaddr_in6 structure. This field overlays the sa_family field when the buffer is cast to a sockaddr data structure. The value of this field must be AF_INET6.
sin6_ファミリー分野は、これがsockaddr_in6構造であると認識します。 バッファがsockaddrデータ構造に投げかけられるとき、この分野はsa_ファミリー分野をかぶせます。 この分野の値はAF_INET6でなければなりません。
Gilligan, et. al. Informational [Page 6] RFC 2133 IPv6 Socket Interface Extensions April 1997
etギリガン、アル。 [6ページ]情報のRFC2133IPv6ソケットインタフェース拡大1997年4月
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.
sin6_ポート分野は16ビットのUDPかTCPポートナンバーを含んでいます。 sockaddr_の罪_ポート分野と同様に、この分野は構造で使用されます。 ポートナンバーはネットワークバイトオーダーで保存されます。
The sin6_flowinfo field is a 32-bit field that contains two pieces of information: the 24-bit IPv6 flow label and the 4-bit priority field. The contents and interpretation of this member is unspecified at this time.
sin6_flowinfo分野は2つの情報を含む32ビットの分野です: 24ビットのIPv6流れラベルと4ビットの優先権分野。 このメンバーのコンテンツと解釈はこのとき、不特定です。
The sin6_addr field is a single in6_addr structure (defined in the previous section). This field holds one 128-bit IPv6 address. The address is stored in network byte order.
sin6_addr分野はただ一つのin6_addr構造(前項で、定義される)です。 この分野は1つの128ビットのIPv6アドレスを保持します。 アドレスはネットワークバイトオーダーで保存されます。
The ordering of elements in this structure is specifically designed so that the sin6_addr field will be aligned on a 64-bit boundary. This is done for optimum performance on 64-bit architectures.
sin6_addr分野が64ビットの境界で並べられるように、明確にこの構造の要素の注文を設計します。 64ビットのアーキテクチャに関する最適な性能のためにこれをします。
Notice that the sockaddr_in6 structure will normally be larger than the generic sockaddr structure. On many existing implementations the sizeof(struct sockaddr_in) equals sizeof(struct sockaddr), with both being 16 bytes. Any existing code that makes this assumption needs to be examined carefully when converting to IPv6.
通常、sockaddr_in6構造がジェネリックsockaddr構造より大きくなるのに注意してください。 多くの既存の実装では、sizeof(中にstruct sockaddr_がある状態で)はsizeof(struct sockaddr)と16バイトである両方で等しいです。 この仮定をするどんな既存のコードも、IPv6に変えるとき、慎重に調べられる必要があります。
3.4. Socket Address Structure for 4.4BSD-Based Systems
3.4. 4.4BSDベースのシステムのためのソケットアドレス構造
The 4.4BSD release includes a small, but incompatible change to the socket interface. The "sa_family" field of the sockaddr data structure 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 the newer sockaddr data structure. For this reason, the following alternative IPv6 address data structure is provided to be used on systems based on 4.4BSD:
4.4BSDリリースはソケットインタフェースへの小さい、しかし、非互換な変化を含んでいます。 「sa_len」はsockaddrデータ構造の「sa_ファミリー」分野が16ビットの値から8ビット値に変わって、スペースが長さの分野を保持するのにおいて使用されていた状態で節約されたと命名しました。 正しく前項で与えられたsockaddr_in6データ構造は、より新しいsockaddrデータ構造に投げかけることができません。 この理由で、4.4BSDに基づくシステムの上で使用されるために以下の代替のIPv6アドレスデータ構造を提供します:
#include <netinet/in.h>
#<netinet/in.h>を含めてください。
#define SIN6_LEN
#SIN6_LENを定義してください。
struct sockaddr_in6 { u_char sin6_len; /* length of this struct */ u_char sin6_family; /* AF_INET6 */ u_int16m_t sin6_port; /* transport layer port # */ u_int32m_t sin6_flowinfo; /* IPv6 flow information */ struct in6_addr sin6_addr; /* IPv6 address */ };
u_炭のsin6_len; このstruct*/u_炭のsin6_ファミリーの/*長さ; /*AF_INET6*/u_int16m_t sin6_ポート; _ポート#*/u int32m_t sin6_flowinfo; _/*トランスポート層/*IPv6流動情報*/struct in6addr sin6_addr; /*IPv6が*/を扱うstruct sockaddr_in6。
Gilligan, et. al. Informational [Page 7] RFC 2133 IPv6 Socket Interface Extensions April 1997
etギリガン、アル。 [7ページ]情報のRFC2133IPv6ソケットインタフェース拡大1997年4月
The only differences between this data structure and the 4.3BSD variant are the inclusion of the length field, and the change of the family field to a 8-bit data type. The definitions of all the other fields are identical to the structure defined in the previous section.
このデータ構造と4.3BSD異形の唯一の違いが、長さの分野の包含と、8ビットのデータタイプへのファミリー分野の変化です。 他のすべての分野の定義は前項で定義された構造と同じです。
Systems that provide this version of the sockaddr_in6 data structure must also declare SIN6_LEN as a result of including the <netinet/in.h> header. This macro allows applications to determine whether they are being built on a system that supports the 4.3BSD or 4.4BSD variants of the data structure.
また、<netinet/in.h>ヘッダーを含んでいることの結果、sockaddr_in6データ構造のこのバージョンを提供するシステムは、SIN6_がLENであると宣言しなければなりません。 このマクロで、アプリケーションは、それらがデータ構造の4.3BSDか4.4BSD異形をサポートするシステムの上に建てられているかどうか決定できます。
3.5. The Socket Functions
3.5. ソケット機能
Applications call the socket() function to create a socket descriptor that represents a communication endpoint. The arguments to the socket() function tell the system which protocol to use, and what format address structure will be used in subsequent functions. For example, to create an IPv4/TCP socket, applications make the call:
アプリケーションは、コミュニケーション終点を表すソケット記述子を作成するためにソケット()機能を呼びます。 ソケット()機能への議論は、どのプロトコルを使用するか、そして、どんな形式アドレス構造がその後の機能に使用されるかをシステムに言います。 例えば、IPv4/TCPソケットを作成するために、アプリケーションは電話をかけます:
s = socket(PF_INET, SOCK_STREAM, 0);
sはソケット(pf_INET、ソックス_ストリーム、0)と等しいです。
To create an IPv4/UDP socket, applications make the call:
IPv4/UDPソケットを作成するために、アプリケーションは電話をかけます:
s = socket(PF_INET, SOCK_DGRAM, 0);
sはソケット(pf_INET、ソックス_DGRAM、0)と等しいです。
Applications may create IPv6/TCP and IPv6/UDP sockets by simply using the constant PF_INET6 instead of PF_INET in the first argument. For example, to create an IPv6/TCP socket, applications make the call:
アプリケーションは、単に最初の議論におけるPF_INETの代わりに一定のPF_INET6を使用することによって、IPv6/TCPとIPv6/UDPソケットを作成するかもしれません。 例えば、IPv6/TCPソケットを作成するために、アプリケーションは電話をかけます:
s = socket(PF_INET6, SOCK_STREAM, 0);
sはソケット(pf_INET6、ソックス_ストリーム、0)と等しいです。
To create an IPv6/UDP socket, applications make the call:
IPv6/UDPソケットを作成するために、アプリケーションは電話をかけます:
s = socket(PF_INET6, SOCK_DGRAM, 0);
sはソケット(pf_INET6、ソックス_DGRAM、0)と等しいです。
Once the application has created a PF_INET6 socket, it must use the sockaddr_in6 address structure when passing addresses in to the system. The functions that the application uses to pass addresses into the system are:
システムにアドレスを入れるとき、アプリケーションがいったんPF_INET6ソケットを作成すると、それはsockaddr_in6アドレス構造を使用しなければなりません。 アプリケーションがアドレスをシステムに通過するのに使用する機能は以下の通りです。
bind() connect() sendmsg() sendto()
ひも()は() sendmsg() sendtoを接続します。()
Gilligan, et. al. Informational [Page 8] RFC 2133 IPv6 Socket Interface Extensions April 1997
etギリガン、アル。 [8ページ]情報のRFC2133IPv6ソケットインタフェース拡大1997年4月
The system will use the sockaddr_in6 address structure to return addresses to applications that are using PF_INET6 sockets. The functions that return an address from the system to an application are:
システムはPF_INET6ソケットを使用しているアプリケーションへの返送先にsockaddr_in6アドレス構造を使用するでしょう。 システムからアプリケーションまでアドレスを返す機能は以下の通りです。
accept() recvfrom() recvmsg() getpeername() getsockname()
() recvfrom() recvmsg() getpeername() getsocknameを受け入れてください。()
No changes to the syntax of the socket functions are needed to support IPv6, since all of the "address carrying" functions use an opaque address pointer, and carry an address length as a function argument.
IPv6はソケット機能の構文への変化が全くサポートされる必要はありません、「アドレス携帯」機能のすべてが不透明なアドレス・ポインタを使用して、機能議論としてアドレスの長さを運ぶので。
3.6. Compatibility with IPv4 Applications
3.6. IPv4アプリケーションとの互換性
In order to support the large base of applications using the original API, system implementations must provide complete source and binary compatibility with the original API. This means that systems must continue to support PF_INET sockets and the sockaddr_in address structure. Applications must be able to create IPv4/TCP and IPv4/UDP sockets using the PF_INET constant in the socket() function, as described in the previous section. Applications should be able to hold a combination of IPv4/TCP, IPv4/UDP, IPv6/TCP and IPv6/UDP sockets simultaneously within the same process.
オリジナルのAPIを使用することでアプリケーションの大きいベースをサポートするために、システムの実現は完全なソースとバイナリ互換性にオリジナルのAPIを提供しなければなりません。 これは、システムが、アドレス構造でPF_INETソケットとsockaddrが_であるとサポートし続けなければならないことを意味します。 アプリケーションはソケット()機能で一定の状態でPF_INETを使用するIPv4/TCPとIPv4/UDPソケットを作成できなければなりません、前項で説明されるように。 アプリケーションは同時に、同じプロセスの中でIPv4/TCP、IPv4/UDP、IPv6/TCP、およびIPv6/UDPソケットの組み合わせを開催できるべきです。
Applications using the original API should continue to operate as they did on systems supporting only IPv4. That is, they should continue to interoperate with IPv4 nodes.
オリジナルのAPIを使用するアプリケーションは、IPv4だけをサポートしながらシステムの上でしたように作動し続けるべきです。 すなわち、彼らは、IPv4ノードで共同利用し続けるべきです。
3.7. Compatibility with IPv4 Nodes
3.7. IPv4ノードとの互換性
The API also provides a different type of compatibility: the ability for IPv6 applications to interoperate with IPv4 applications. This feature uses the IPv4-mapped IPv6 address format defined in the IPv6 addressing architecture specification [2]. This address format allows the IPv4 address of an IPv4 node to be represented as an IPv6 address. The IPv4 address is encoded into the low-order 32 bits of the IPv6 address, and the high-order 96 bits hold the fixed prefix 0:0:0:0:0:FFFF. IPv4-mapped addresses are written as follows:
また、APIは異なったタイプの互換性を提供します: IPv6アプリケーションがIPv4アプリケーションで共同利用する能力。 この特徴はアーキテクチャが仕様[2]であると扱うIPv6で定義されたIPv4によって写像されたIPv6アドレス形式を使用します。 このアドレス形式は、IPv4ノードのIPv4アドレスがIPv6アドレスとして表されるのを許容します。 IPv4アドレスがIPv6アドレスの下位の32ビットにコード化されて、高位96ビットが固定接頭語を保持する、0:0:0 0:0::FFFF IPv4によって写像されたアドレスは以下の通り書かれています:
::FFFF:<IPv4-address>
::FFFF: <IPv4-アドレス>。
These addresses are often generated automatically by the gethostbyname() function when the specified host has only IPv4 addresses (as described in Section 6.1).
指定されたホストにIPv4アドレスしかないと(セクション6.1で説明されるように)、これらのアドレスはしばしばgethostbyname()機能によって自動的に作られます。
Gilligan, et. al. Informational [Page 9] RFC 2133 IPv6 Socket Interface Extensions April 1997
etギリガン、アル。 [9ページ]情報のRFC2133IPv6ソケットインタフェース拡大1997年4月
Applications may use PF_INET6 sockets to open TCP connections to IPv4 nodes, or send UDP packets to IPv4 nodes, by simply encoding the destination's IPv4 address as an IPv4-mapped IPv6 address, and passing that address, within a sockaddr_in6 structure, in the connect() or sendto() call. When applications use PF_INET6 sockets to accept TCP connections from IPv4 nodes, or receive UDP packets from IPv4 nodes, the system returns the peer's address to the application in the accept(), recvfrom(), or getpeername() call using a sockaddr_in6 structure encoded this way.
アプリケーションがIPv4ノードにTCP接続を開くか、またはIPv4ノードへのUDPパケット、sockaddr_in6構造の中の単にIPv4によって写像されたIPv6アドレス、および通過としての目的地のIPv4アドレスをコード化するのによるそのアドレスを送るPF_INET6ソケットを使用するかもしれない、()かsendto()呼び出しを接続してください。 いつアプリケーションがIPv4ノードからTCP接続を受け入れるか、またはIPv4ノードからUDPパケットを受けるのにPF_INET6ソケットを使用して、システムが同輩のアドレスをアプリケーションに返すか、このようにコード化されたsockaddr_in6構造を使用することで()、recvfrom()、またはgetpeername()呼び出しを受け入れてください。
Few applications will likely need to know which type of node they are interoperating with. However, for those applications that do need to know, the IN6_IS_ADDR_V4MAPPED() macro, defined in Section 6.6, is provided.
わずかなアプリケーションしか、おそらく彼らがどのタイプのノードで共同利用しているかを知る必要がないでしょう。 知る必要があるそれらのアプリケーションのためのIN6_がどのように_であっても、セクション6.6で定義されたADDR_V4MAPPED()マクロを提供します。
3.8. IPv6 Wildcard Address
3.8. IPv6ワイルドカードアドレス
While the bind() function allows applications to select the source IP address of UDP packets and TCP connections, applications often want the system to select the source address for them. With IPv4, one specifies the address as the symbolic constant INADDR_ANY (called the "wildcard" address) in the bind() call, or simply omits the bind() entirely.
アプリケーションはひも()機能でUDPパケットとTCP接続のソースIPアドレスを選択できますが、アプリケーションは、しばしばシステムがそれらのためのソースアドレスを選択する必要があります。 1つは、IPv4と共に、シンボリックな一定のINADDRとしてひも()呼び出しで_少しもアドレスを指定するか(「ワイルドカード」アドレスと呼ばれます)、またはひもを() 完全に単に省略します。
Since the IPv6 address type is a structure (struct in6_addr), a symbolic constant can be used to initialize an IPv6 address variable, but cannot be used in an assignment. Therefore systems provide the IPv6 wildcard address in two forms.
IPv6アドレスタイプが構造(struct in6_addr)であるので、シンボリックな定数はIPv6アドレス変数を初期化するのに使用できますが、課題では使用できません。 したがって、システムはIPv6ワイルドカードアドレスを2つのフォームに提供します。
The first version is a global variable named "in6addr_any" that is an in6_addr structure. The extern declaration for this variable is defined in <netinet/in.h>:
最初のバージョンが指定された大域変数である、「in6addr、_」 それはいくらか、in6_addr構造です。 この変数のための通いの人宣言は<netinet/in.h>で定義されます:
extern const struct in6_addr in6addr_any;
通いの人const struct in6_addr in6addr_、いずれも。
Gilligan, et. al. Informational [Page 10] RFC 2133 IPv6 Socket Interface Extensions April 1997
etギリガン、アル。 [10ページ]情報のRFC2133IPv6ソケットインタフェース拡大1997年4月
Applications use in6addr_any similarly to the way they use INADDR_ANY in IPv4. For example, to bind a socket to port number 23, but let the system select the source address, an application could use the following code:
アプリケーションはin6addrを使用します。_同様に、道に、いくらか、それらはIPv4で_少しもINADDRを使用します。 例えば、No.23を移植するためにソケットを縛りますが、システムにソースアドレスを選択させるように、アプリケーションは以下のコードを使用するかもしれません:
struct sockaddr_in6 sin6; . . . sin6.sin6_family = AF_INET6; sin6.sin6_flowinfo = 0; sin6.sin6_port = htons(23); sin6.sin6_addr = in6addr_any; /* structure assignment */ . . . if (bind(s, (struct sockaddr *) &sin6, sizeof(sin6)) == -1) . . .
struct sockaddr_in6 sin6。 . . . sin6.sin6_ファミリーはAF_INET6と等しいです。 sin6.sin6_flowinfo=0。 sin6.sin6_ポートはhtons(23)と等しいです。 sin6.sin6_addrがin6addr_と等しい、いずれも。 /*構造体代入*/… (ひも(sと(struct sockaddr*)とsin6、sizeof(sin6))の=-1)であるなら…
The other version is a symbolic constant named IN6ADDR_ANY_INIT and is defined in <netinet/in.h>. This constant can be used to initialize an in6_addr structure:
もう片方のバージョン、__何かIN6ADDRというシンボリックな定数はINITであり、定義されたコネは<netinet/in.h>ですか? in6_addr構造を初期化するのにこの定数を使用できます:
struct in6_addr anyaddr = IN6ADDR_ANY_INIT;
struct in6_addr anyaddrが_少しもIN6ADDRと等しい、_INIT。
Note that this constant can be used ONLY at declaration time. It can not be used to assign a previously declared in6_addr structure. For example, the following code will not work:
宣言時だけにこの定数を使用できることに注意してください。 以前に宣言しているin6_addr構造を割り当てるのにそれを使用できません。 例えば、以下のコードは働かないでしょう:
/* This is the WRONG way to assign an unspecified address */ struct sockaddr_in6 sin6; . . . sin6.sin6_addr = IN6ADDR_ANY_INIT; /* will NOT compile */
/、*これは不特定のアドレス*/struct sockaddr_in6 sin6を割り当てるWRONG方法です。 . . . sin6.sin6_addrが_少しもIN6ADDRと等しい、_INIT。 /*は*/をコンパイルしないでしょう。
Be aware that the IPv4 INADDR_xxx constants are all defined in host byte order but the IPv6 IN6ADDR_xxx constants and the IPv6 in6addr_xxx externals are defined in network byte order.
IPv4 INADDR_xxx定数がホストバイトオーダーですべて定義されますが、IPv6 IN6ADDR_xxx定数とIPv6 in6addr_xxx外観がネットワークバイトオーダーで定義されるのを意識してください。
3.9. IPv6 Loopback Address
3.9. IPv6ループバックアドレス
Applications may need to send UDP packets to, or originate TCP connections to, services residing on the local node. In IPv4, they can do this by using the constant IPv4 address INADDR_LOOPBACK in their connect(), sendto(), or sendmsg() call.
アプリケーションは、ローカルのノードの上にあるサービスに、パケットをUDPに送るのが必要である、またはTCP接続を溯源するかもしれません。 IPv4では、彼らがIPv4がINADDR_LOOPBACKを扱う定数を使用することによってこれができる、それら、()、sendto()、またはsendmsg()呼び出しを接続してください。
IPv6 also provides a loopback address to contact local TCP and UDP services. Like the unspecified address, the IPv6 loopback address is provided in two forms -- a global variable and a symbolic constant.
また、IPv6は、地方のTCPとUDPサービスに連絡するためにループバックアドレスを提供します。 不特定のアドレスのように、2つのフォームでIPv6ループバックアドレスを提供します--大域変数とシンボリックな定数。
Gilligan, et. al. Informational [Page 11] RFC 2133 IPv6 Socket Interface Extensions April 1997
Gilligan, et. al. Informational [Page 11] RFC 2133 IPv6 Socket Interface Extensions April 1997
The global variable is an in6_addr structure named "in6addr_loopback." The extern declaration for this variable is defined in <netinet/in.h>:
The global variable is an in6_addr structure named "in6addr_loopback." The extern declaration for this variable is defined in <netinet/in.h>:
extern const struct in6_addr in6addr_loopback;
extern const struct in6_addr in6addr_loopback;
Applications use in6addr_loopback as they would use INADDR_LOOPBACK in IPv4 applications (but beware of the byte ordering difference mentioned at the end of the previous section). For example, to open a TCP connection to the local telnet server, an application could use the following code:
Applications use in6addr_loopback as they would use INADDR_LOOPBACK in IPv4 applications (but beware of the byte ordering difference mentioned at the end of the previous section). For example, to open a TCP connection to the local telnet server, an application could use the following code:
struct sockaddr_in6 sin6; . . . sin6.sin6_family = AF_INET6; sin6.sin6_flowinfo = 0; sin6.sin6_port = htons(23); sin6.sin6_addr = in6addr_loopback; /* structure assignment */ . . . if (connect(s, (struct sockaddr *) &sin6, sizeof(sin6)) == -1) . . .
struct sockaddr_in6 sin6; . . . sin6.sin6_family = AF_INET6; sin6.sin6_flowinfo = 0; sin6.sin6_port = htons(23); sin6.sin6_addr = in6addr_loopback; /* structure assignment */ . . . if (connect(s, (struct sockaddr *) &sin6, sizeof(sin6)) == -1) . . .
The symbolic constant is named IN6ADDR_LOOPBACK_INIT and is defined in <netinet/in.h>. It can be used at declaration time ONLY; for example:
The symbolic constant is named IN6ADDR_LOOPBACK_INIT and is defined in <netinet/in.h>. It can be used at declaration time ONLY; for example:
struct in6_addr loopbackaddr = IN6ADDR_LOOPBACK_INIT;
struct in6_addr loopbackaddr = IN6ADDR_LOOPBACK_INIT;
Like IN6ADDR_ANY_INIT, this constant cannot be used in an assignment to a previously declared IPv6 address variable.
Like IN6ADDR_ANY_INIT, this constant cannot be used in an assignment to a previously declared IPv6 address variable.
4. Interface Identification
4. Interface Identification
This API uses an interface index (a small positive integer) to identify the local interface on which a multicast group is joined (Section 5.3). Additionally, the advanced API [5] uses these same interface indexes to identify the interface on which a datagram is received, or to specify the interface on which a datagram is to be sent.
This API uses an interface index (a small positive integer) to identify the local interface on which a multicast group is joined (Section 5.3). Additionally, the advanced API [5] uses these same interface indexes to identify the interface on which a datagram is received, or to specify the interface on which a datagram is to be sent.
Interfaces are normally known by names such as "le0", "sl1", "ppp2", and the like. On Berkeley-derived implementations, when an interface is made known to the system, the kernel assigns a unique positive integer value (called the interface index) to that interface. These are small positive integers that start at 1. (Note that 0 is never used for an interface index.) There may be gaps so that there is no current interface for a particular positive interface index.
Interfaces are normally known by names such as "le0", "sl1", "ppp2", and the like. On Berkeley-derived implementations, when an interface is made known to the system, the kernel assigns a unique positive integer value (called the interface index) to that interface. These are small positive integers that start at 1. (Note that 0 is never used for an interface index.) There may be gaps so that there is no current interface for a particular positive interface index.
Gilligan, et. al. Informational [Page 12] RFC 2133 IPv6 Socket Interface Extensions April 1997
Gilligan, et. al. Informational [Page 12] RFC 2133 IPv6 Socket Interface Extensions April 1997
This API defines two functions that map between an interface name and index, a third function that returns all the interface names and indexes, and a fourth function to return the dynamic memory allocated by the previous function. How these functions are implemented is left up to the implementation. 4.4BSD implementations can implement these functions using the existing sysctl() function with the NET_RT_LIST command. Other implementations may wish to use ioctl() for this purpose.
This API defines two functions that map between an interface name and index, a third function that returns all the interface names and indexes, and a fourth function to return the dynamic memory allocated by the previous function. How these functions are implemented is left up to the implementation. 4.4BSD implementations can implement these functions using the existing sysctl() function with the NET_RT_LIST command. Other implementations may wish to use ioctl() for this purpose.
4.1. Name-to-Index
4.1. Name-to-Index
The first function maps an interface name into its corresponding index.
The first function maps an interface name into its corresponding index.
#include <net/if.h>
#include <net/if.h>
unsigned int if_nametoindex(const char *ifname);
unsigned int if_nametoindex(const char *ifname);
If the specified interface does not exist, the return value is 0.
If the specified interface does not exist, the return value is 0.
4.2. Index-to-Name
4.2. Index-to-Name
The second function maps an interface index into its corresponding name.
The second function maps an interface index into its corresponding name.
#include <net/if.h>
#include <net/if.h>
char *if_indextoname(unsigned int ifindex, char *ifname);
char *if_indextoname(unsigned int ifindex, char *ifname);
The ifname argument must point to a buffer of at least IFNAMSIZ bytes into which the interface name corresponding to the specified index is returned. (IFNAMSIZ is also defined in <net/if.h> and its value includes a terminating null byte at the end of the interface name.) This pointer is also the return value of the function. If there is no interface corresponding to the specified index, NULL is returned.
The ifname argument must point to a buffer of at least IFNAMSIZ bytes into which the interface name corresponding to the specified index is returned. (IFNAMSIZ is also defined in <net/if.h> and its value includes a terminating null byte at the end of the interface name.) This pointer is also the return value of the function. If there is no interface corresponding to the specified index, NULL is returned.
Gilligan, et. al. Informational [Page 13] RFC 2133 IPv6 Socket Interface Extensions April 1997
Gilligan, et. al. Informational [Page 13] RFC 2133 IPv6 Socket Interface Extensions April 1997
4.3. Return All Interface Names and Indexes
4.3. Return All Interface Names and Indexes
The final function returns an array of if_nameindex structures, one structure per interface.
The final function returns an array of if_nameindex structures, one structure per interface.
#include <net/if.h>
#include <net/if.h>
struct if_nameindex { unsigned int if_index; /* 1, 2, ... */ char *if_name; /* null terminated name: "le0", ... */ };
struct if_nameindex { unsigned int if_index; /* 1, 2, ... */ char *if_name; /* null terminated name: "le0", ... */ };
struct if_nameindex *if_nameindex(void);
struct if_nameindex *if_nameindex(void);
The end of the array of structures is indicated by a structure with an if_index of 0 and an if_name of NULL. The function returns a NULL pointer upon an error.
The end of the array of structures is indicated by a structure with an if_index of 0 and an if_name of NULL. The function returns a NULL pointer upon an error.
The memory used for this array of structures along with the interface names pointed to by the if_name members is obtained dynamically. This memory is freed by the next function.
The memory used for this array of structures along with the interface names pointed to by the if_name members is obtained dynamically. This memory is freed by the next function.
4.4. Free Memory
4.4. Free Memory
The following function frees the dynamic memory that was allocated by if_nameindex().
The following function frees the dynamic memory that was allocated by if_nameindex().
#include <net/if.h>
#include <net/if.h>
void if_freenameindex(struct if_nameindex *ptr);
void if_freenameindex(struct if_nameindex *ptr);
The argument to this function must be a pointer that was returned by if_nameindex().
The argument to this function must be a pointer that was returned by if_nameindex().
5. Socket Options
5. Socket Options
A number of new socket options are defined for IPv6. All of these new options are at the IPPROTO_IPV6 level. That is, the "level" parameter in the getsockopt() and setsockopt() calls is IPPROTO_IPV6 when using these options. The constant name prefix IPV6_ is used in all of the new socket options. This serves to clearly identify these options as applying to IPv6.
A number of new socket options are defined for IPv6. All of these new options are at the IPPROTO_IPV6 level. That is, the "level" parameter in the getsockopt() and setsockopt() calls is IPPROTO_IPV6 when using these options. The constant name prefix IPV6_ is used in all of the new socket options. This serves to clearly identify these options as applying to IPv6.
The declaration for IPPROTO_IPV6, the new IPv6 socket options, and related constants defined in this section are obtained by including the header <netinet/in.h>.
The declaration for IPPROTO_IPV6, the new IPv6 socket options, and related constants defined in this section are obtained by including the header <netinet/in.h>.
Gilligan, et. al. Informational [Page 14] RFC 2133 IPv6 Socket Interface Extensions April 1997
Gilligan, et. al. Informational [Page 14] RFC 2133 IPv6 Socket Interface Extensions April 1997
5.1. Changing Socket Type
5.1. Changing Socket Type
Unix allows open sockets to be passed between processes via the exec() call and other means. It is a relatively common application practice to pass open sockets across exec() calls. Thus it is possible for an application using the original API to pass an open PF_INET socket to an application that is expecting to receive a PF_INET6 socket. Similarly, it is possible for an application using the extended API to pass an open PF_INET6 socket to an application using the original API, which would be equipped only to deal with PF_INET sockets. Either of these cases could cause problems, because the application that is passed the open socket might not know how to decode the address structures returned in subsequent socket functions.
Unix allows open sockets to be passed between processes via the exec() call and other means. It is a relatively common application practice to pass open sockets across exec() calls. Thus it is possible for an application using the original API to pass an open PF_INET socket to an application that is expecting to receive a PF_INET6 socket. Similarly, it is possible for an application using the extended API to pass an open PF_INET6 socket to an application using the original API, which would be equipped only to deal with PF_INET sockets. Either of these cases could cause problems, because the application that is passed the open socket might not know how to decode the address structures returned in subsequent socket functions.
To remedy this problem, a new setsockopt() option is defined that allows an application to "convert" a PF_INET6 socket into a PF_INET socket and vice versa.
To remedy this problem, a new setsockopt() option is defined that allows an application to "convert" a PF_INET6 socket into a PF_INET socket and vice versa.
An IPv6 application that is passed an open socket from an unknown process may use the IPV6_ADDRFORM setsockopt() option to "convert" the socket to PF_INET6. Once that has been done, the system will return sockaddr_in6 address structures in subsequent socket functions.
An IPv6 application that is passed an open socket from an unknown process may use the IPV6_ADDRFORM setsockopt() option to "convert" the socket to PF_INET6. Once that has been done, the system will return sockaddr_in6 address structures in subsequent socket functions.
An IPv6 application that is about to pass an open PF_INET6 socket to a program that is not be IPv6 capable can "downgrade" the socket to PF_INET before calling exec(). After that, the system will return sockaddr_in address structures to the application that was exec()'ed. Be aware that you cannot downgrade an IPv6 socket to an IPv4 socket unless all nonwildcard addresses already associated with the IPv6 socket are IPv4-mapped IPv6 addresses.
An IPv6 application that is about to pass an open PF_INET6 socket to a program that is not be IPv6 capable can "downgrade" the socket to PF_INET before calling exec(). After that, the system will return sockaddr_in address structures to the application that was exec()'ed. Be aware that you cannot downgrade an IPv6 socket to an IPv4 socket unless all nonwildcard addresses already associated with the IPv6 socket are IPv4-mapped IPv6 addresses.
The IPV6_ADDRFORM option is valid at both the IPPROTO_IP and IPPROTO_IPV6 levels. The only valid option values are PF_INET6 and PF_INET. For example, to convert a PF_INET6 socket to PF_INET, a program would call:
The IPV6_ADDRFORM option is valid at both the IPPROTO_IP and IPPROTO_IPV6 levels. The only valid option values are PF_INET6 and PF_INET. For example, to convert a PF_INET6 socket to PF_INET, a program would call:
int addrform = PF_INET;
int addrform = PF_INET;
if (setsockopt(s, IPPROTO_IPV6, IPV6_ADDRFORM, (char *) &addrform, sizeof(addrform)) == -1) perror("setsockopt IPV6_ADDRFORM");
if (setsockopt(s, IPPROTO_IPV6, IPV6_ADDRFORM, (char *) &addrform, sizeof(addrform)) == -1) perror("setsockopt IPV6_ADDRFORM");
Gilligan, et. al. Informational [Page 15] RFC 2133 IPv6 Socket Interface Extensions April 1997
Gilligan, et. al. Informational [Page 15] RFC 2133 IPv6 Socket Interface Extensions April 1997
An application may use IPV6_ADDRFORM with getsockopt() to learn whether an open socket is a PF_INET of PF_INET6 socket. For example:
An application may use IPV6_ADDRFORM with getsockopt() to learn whether an open socket is a PF_INET of PF_INET6 socket. For example:
int addrform; size_t len = sizeof(addrform);
int addrform; size_t len = sizeof(addrform);
if (getsockopt(s, IPPROTO_IPV6, IPV6_ADDRFORM, (char *) &addrform, &len) == -1) perror("getsockopt IPV6_ADDRFORM"); else if (addrform == PF_INET) printf("This is an IPv4 socket.\n"); else if (addrform == PF_INET6) printf("This is an IPv6 socket.\n"); else printf("This system is broken.\n");
if (getsockopt(s, IPPROTO_IPV6, IPV6_ADDRFORM, (char *) &addrform, &len) == -1) perror("getsockopt IPV6_ADDRFORM"); else if (addrform == PF_INET) printf("This is an IPv4 socket.\n"); else if (addrform == PF_INET6) printf("This is an IPv6 socket.\n"); else printf("This system is broken.\n");
5.2. Unicast Hop Limit
5.2. Unicast Hop Limit
A new setsockopt() option controls the hop limit used in outgoing unicast IPv6 packets. The name of this option is IPV6_UNICAST_HOPS, and it is used at the IPPROTO_IPV6 layer. The following example illustrates how it is used:
A new setsockopt() option controls the hop limit used in outgoing unicast IPv6 packets. The name of this option is IPV6_UNICAST_HOPS, and it is used at the IPPROTO_IPV6 layer. The following example illustrates how it is used:
int hoplimit = 10;
int hoplimit = 10;
if (setsockopt(s, IPPROTO_IPV6, IPV6_UNICAST_HOPS, (char *) &hoplimit, sizeof(hoplimit)) == -1) perror("setsockopt IPV6_UNICAST_HOPS");
if (setsockopt(s, IPPROTO_IPV6, IPV6_UNICAST_HOPS, (char *) &hoplimit, sizeof(hoplimit)) == -1) perror("setsockopt IPV6_UNICAST_HOPS");
When the IPV6_UNICAST_HOPS option is set with setsockopt(), the option value given is used as the hop limit for all subsequent unicast packets sent via that socket. If the option is not set, the system selects a default value. The integer hop limit value (called x) is interpreted as follows:
When the IPV6_UNICAST_HOPS option is set with setsockopt(), the option value given is used as the hop limit for all subsequent unicast packets sent via that socket. If the option is not set, the system selects a default value. The integer hop limit value (called x) is interpreted as follows:
x < -1: return an error of EINVAL x == -1: use kernel default 0 <= x <= 255: use x x >= 256: return an error of EINVAL
x < -1: return an error of EINVAL x == -1: use kernel default 0 <= x <= 255: use x x >= 256: return an error of EINVAL
Gilligan, et. al. Informational [Page 16] RFC 2133 IPv6 Socket Interface Extensions April 1997
Gilligan, et. al. Informational [Page 16] RFC 2133 IPv6 Socket Interface Extensions April 1997
The IPV6_UNICAST_HOPS option may be used with getsockopt() to determine the hop limit value that the system will use for subsequent unicast packets sent via that socket. For example:
The IPV6_UNICAST_HOPS option may be used with getsockopt() to determine the hop limit value that the system will use for subsequent unicast packets sent via that socket. For example:
int hoplimit; size_t len = sizeof(hoplimit);
int hoplimit; size_t len = sizeof(hoplimit);
if (getsockopt(s, IPPROTO_IPV6, IPV6_UNICAST_HOPS, (char *) &hoplimit, &len) == -1) perror("getsockopt IPV6_UNICAST_HOPS"); else printf("Using %d for hop limit.\n", hoplimit);
if (getsockopt(s, IPPROTO_IPV6, IPV6_UNICAST_HOPS, (char *) &hoplimit, &len) == -1) perror("getsockopt IPV6_UNICAST_HOPS"); else printf("Using %d for hop limit.\n", hoplimit);
5.3. Sending and Receiving Multicast Packets
5.3. Sending and Receiving Multicast Packets
IPv6 applications may send UDP multicast packets by simply specifying an IPv6 multicast address in the address argument of the sendto() function.
IPv6 applications may send UDP multicast packets by simply specifying an IPv6 multicast address in the address argument of the sendto() function.
Three socket options at the IPPROTO_IPV6 layer control some of the parameters for sending multicast packets. Setting these options is not required: applications may send multicast packets without using these options. The setsockopt() options for controlling the sending of multicast packets are summarized below:
Three socket options at the IPPROTO_IPV6 layer control some of the parameters for sending multicast packets. Setting these options is not required: applications may send multicast packets without using these options. The setsockopt() options for controlling the sending of multicast packets are summarized below:
IPV6_MULTICAST_IF
IPV6_MULTICAST_IF
Set the interface to use for outgoing multicast packets. The argument is the index of the interface to use.
Set the interface to use for outgoing multicast packets. The argument is the index of the interface to use.
Argument type: unsigned int
Argument type: unsigned int
IPV6_MULTICAST_HOPS
IPV6_MULTICAST_HOPS
Set the hop limit to use for outgoing multicast packets. (Note a separate option - IPV6_UNICAST_HOPS - is provided to set the hop limit to use for outgoing unicast packets.) The interpretation of the argument is the same as for the IPV6_UNICAST_HOPS option:
Set the hop limit to use for outgoing multicast packets. (Note a separate option - IPV6_UNICAST_HOPS - is provided to set the hop limit to use for outgoing unicast packets.) The interpretation of the argument is the same as for the IPV6_UNICAST_HOPS option:
x < -1: return an error of EINVAL x == -1: use kernel default 0 <= x <= 255: use x x >= 256: return an error of EINVAL
x < -1: return an error of EINVAL x == -1: use kernel default 0 <= x <= 255: use x x >= 256: return an error of EINVAL
Argument type: int
Argument type: int
Gilligan, et. al. Informational [Page 17] RFC 2133 IPv6 Socket Interface Extensions April 1997
Gilligan, et. al. Informational [Page 17] RFC 2133 IPv6 Socket Interface Extensions April 1997
IPV6_MULTICAST_LOOP
IPV6_MULTICAST_LOOP
Controls whether outgoing multicast packets sent should be delivered back to the local application. A toggle. If the option is set to 1, multicast packets are looped back. If it is set to 0, they are not.
Controls whether outgoing multicast packets sent should be delivered back to the local application. A toggle. If the option is set to 1, multicast packets are looped back. If it is set to 0, they are not.
Argument type: unsigned int
Argument type: unsigned int
The reception of multicast packets is controlled by the two setsockopt() options summarized below:
The reception of multicast packets is controlled by the two setsockopt() options summarized below:
IPV6_ADD_MEMBERSHIP
IPV6_ADD_MEMBERSHIP
Join a multicast group on a specified local interface. If the interface index is specified as 0, the kernel chooses the local interface. For example, some kernels look up the multicast group in the normal IPv6 routing table and using the resulting interface.
Join a multicast group on a specified local interface. If the interface index is specified as 0, the kernel chooses the local interface. For example, some kernels look up the multicast group in the normal IPv6 routing table and using the resulting interface.
Argument type: struct ipv6_mreq
Argument type: struct ipv6_mreq
IPV6_DROP_MEMBERSHIP
IPV6_DROP_MEMBERSHIP
Leave a multicast group on a specified interface.
Leave a multicast group on a specified interface.
Argument type: struct ipv6_mreq
Argument type: struct ipv6_mreq
The argument type of both of these options is the ipv6_mreq structure, defined as:
The argument type of both of these options is the ipv6_mreq structure, defined as:
#include <netinet/in.h>
#include <netinet/in.h>
struct ipv6_mreq { struct in6_addr ipv6mr_multiaddr; /* IPv6 multicast addr */ unsigned int ipv6mr_interface; /* interface index */ };
struct ipv6_mreq { struct in6_addr ipv6mr_multiaddr; /* IPv6 multicast addr */ unsigned int ipv6mr_interface; /* interface index */ };
Note that to receive multicast datagrams a process must join the multicast group and bind the UDP port to which datagrams will be sent. Some processes also bind the multicast group address to the socket, in addition to the port, to prevent other datagrams destined to that same port from being delivered to the socket.
Note that to receive multicast datagrams a process must join the multicast group and bind the UDP port to which datagrams will be sent. Some processes also bind the multicast group address to the socket, in addition to the port, to prevent other datagrams destined to that same port from being delivered to the socket.
Gilligan, et. al. Informational [Page 18] RFC 2133 IPv6 Socket Interface Extensions April 1997
Gilligan, et. al. Informational [Page 18] RFC 2133 IPv6 Socket Interface Extensions April 1997
6. Library Functions
6. Library Functions
New library functions are needed to perform a variety of operations with IPv6 addresses. Functions are needed to lookup IPv6 addresses in the Domain Name System (DNS). Both forward lookup (hostname-to- address translation) and reverse lookup (address-to-hostname translation) need to be supported. Functions are also needed to convert IPv6 addresses between their binary and textual form.
New library functions are needed to perform a variety of operations with IPv6 addresses. Functions are needed to lookup IPv6 addresses in the Domain Name System (DNS). Both forward lookup (hostname-to- address translation) and reverse lookup (address-to-hostname translation) need to be supported. Functions are also needed to convert IPv6 addresses between their binary and textual form.
6.1. Hostname-to-Address Translation
6.1. Hostname-to-Address Translation
The commonly used function gethostbyname() remains unchanged as does the hostent structure to which it returns a pointer. Existing applications that call this function continue to receive only IPv4 addresses that are the result of a query in the DNS for A records. (We assume the DNS is being used; some environments may be using a hosts file or some other name resolution system, either of which may impede renumbering. We also assume that the RES_USE_INET6 resolver option is not set, which we describe in more detail shortly.)
The commonly used function gethostbyname() remains unchanged as does the hostent structure to which it returns a pointer. Existing applications that call this function continue to receive only IPv4 addresses that are the result of a query in the DNS for A records. (We assume the DNS is being used; some environments may be using a hosts file or some other name resolution system, either of which may impede renumbering. We also assume that the RES_USE_INET6 resolver option is not set, which we describe in more detail shortly.)
Two new changes are made to support IPv6 addresses. First, the following function is new:
Two new changes are made to support IPv6 addresses. First, the following function is new:
#include <sys/socket.h> #include <netdb.h>
#include <sys/socket.h> #include <netdb.h>
struct hostent *gethostbyname2(const char *name, int af);
struct hostent *gethostbyname2(const char *name, int af);
The af argument specifies the address family. The default operation of this function is simple:
The af argument specifies the address family. The default operation of this function is simple:
- If the af argument is AF_INET, then a query is made for A records. If successful, IPv4 addresses are returned and the h_length member of the hostent structure will be 4, else the function returns a NULL pointer.
- If the af argument is AF_INET, then a query is made for A records. If successful, IPv4 addresses are returned and the h_length member of the hostent structure will be 4, else the function returns a NULL pointer.
- If the af argument is AF_INET6, then a query is made for AAAA records. If successful, IPv6 addresses are returned and the h_length member of the hostent structure will be 16, else the function returns a NULL pointer.
- If the af argument is AF_INET6, then a query is made for AAAA records. If successful, IPv6 addresses are returned and the h_length member of the hostent structure will be 16, else the function returns a NULL pointer.
Gilligan, et. al. Informational [Page 19] RFC 2133 IPv6 Socket Interface Extensions April 1997
Gilligan, et. al. Informational [Page 19] RFC 2133 IPv6 Socket Interface Extensions April 1997
The second change, that provides additional functionality, is a new resolver option RES_USE_INET6, which is defined as a result of including the <resolv.h> header. (This option is provided starting with the BIND 4.9.4 release.) There are three ways to set this option.
The second change, that provides additional functionality, is a new resolver option RES_USE_INET6, which is defined as a result of including the <resolv.h> header. (This option is provided starting with the BIND 4.9.4 release.) There are three ways to set this option.
- The first way is
- The first way is
res_init(); _res.options |= RES_USE_INET6;
res_init(); _res.options |= RES_USE_INET6;
and then call either gethostbyname() or gethostbyname2(). This option then affects only the process that is calling the resolver.
and then call either gethostbyname() or gethostbyname2(). This option then affects only the process that is calling the resolver.
- The second way to set this option is to set the environment variable RES_OPTIONS, as in RES_OPTIONS=inet6. (This example is for the Bourne and Korn shells.) This method affects any processes that see this environment variable.
- The second way to set this option is to set the environment variable RES_OPTIONS, as in RES_OPTIONS=inet6. (This example is for the Bourne and Korn shells.) This method affects any processes that see this environment variable.
- The third way is to set this option in the resolver configuration file (normally /etc/resolv.conf) and the option then affects all applications on the host. This final method should not be done until all applications on the host are capable of dealing with IPv6 addresses.
- The third way is to set this option in the resolver configuration file (normally /etc/resolv.conf) and the option then affects all applications on the host. This final method should not be done until all applications on the host are capable of dealing with IPv6 addresses.
There is no priority among these three methods. When the RES_USE_INET6 option is set, two changes occur:
There is no priority among these three methods. When the RES_USE_INET6 option is set, two changes occur:
- gethostbyname(host) first calls gethostbyname2(host, AF_INET6) looking for AAAA records, and if this fails it then calls gethostbyname2(host, AF_INET) looking for A records.
- gethostbyname(host) first calls gethostbyname2(host, AF_INET6) looking for AAAA records, and if this fails it then calls gethostbyname2(host, AF_INET) looking for A records.
- gethostbyname2(host, AF_INET) always returns IPv4-mapped IPv6 addresses with the h_length member of the hostent structure set to 16.
- gethostbyname2(host, AF_INET) always returns IPv4-mapped IPv6 addresses with the h_length member of the hostent structure set to 16.
An application must not enable the RES_USE_INET6 option until it is prepared to deal with 16-byte addresses in the returned hostent structure.
An application must not enable the RES_USE_INET6 option until it is prepared to deal with 16-byte addresses in the returned hostent structure.
Gilligan, et. al. Informational [Page 20] RFC 2133 IPv6 Socket Interface Extensions April 1997
Gilligan, et. al. Informational [Page 20] RFC 2133 IPv6 Socket Interface Extensions April 1997
The following table summarizes the operation of the existing gethostbyname() function, the new function gethostbyname2(), along with the new resolver option RES_USE_INET6.
The following table summarizes the operation of the existing gethostbyname() function, the new function gethostbyname2(), along with the new resolver option RES_USE_INET6.
+------------------+---------------------------------------------------+ | | RES_USE_INET6 option | | +-------------------------+-------------------------+ | | off | on | +------------------+-------------------------+-------------------------+ | |Search for A records. |Search for AAAA records. | | gethostbyname | If found, return IPv4 | If found, return IPv6 | | (host) | addresses (h_length=4). | addresses (h_length=16).| | | Else error. | Else search for A | | | | records. If found, | | |Provides backward | return IPv4-mapped IPv6 | | | compatibility with all | addresses (h_length=16).| | | existing IPv4 appls. | Else error. | +------------------+-------------------------+-------------------------+ | |Search for A records. |Search for A records. | | gethostbyname2 | If found, return IPv4 | If found, return | | (host, AF_INET) | addresses (h_length=4). | IPv4-mapped IPv6 | | | Else error. | addresses (h_length=16).| | | | Else error. | +------------------+-------------------------+-------------------------+ | |Search for AAAA records. |Search for AAAA records. | | gethostbyname2 | If found, return IPv6 | If found, return IPv6 | | (host, AF_INET6) | addresses (h_length=16).| addresses (h_length=16).| | | Else error. | Else error. | +------------------+-------------------------+-------------------------+
+------------------+---------------------------------------------------+ | | RES_USE_INET6 option | | +-------------------------+-------------------------+ | | off | on | +------------------+-------------------------+-------------------------+ | |Search for A records. |Search for AAAA records. | | gethostbyname | If found, return IPv4 | If found, return IPv6 | | (host) | addresses (h_length=4). | addresses (h_length=16).| | | Else error. | Else search for A | | | | records. If found, | | |Provides backward | return IPv4-mapped IPv6 | | | compatibility with all | addresses (h_length=16).| | | existing IPv4 appls. | Else error. | +------------------+-------------------------+-------------------------+ | |Search for A records. |Search for A records. | | gethostbyname2 | If found, return IPv4 | If found, return | | (host, AF_INET) | addresses (h_length=4). | IPv4-mapped IPv6 | | | Else error. | addresses (h_length=16).| | | | Else error. | +------------------+-------------------------+-------------------------+ | |Search for AAAA records. |Search for AAAA records. | | gethostbyname2 | If found, return IPv6 | If found, return IPv6 | | (host, AF_INET6) | addresses (h_length=16).| addresses (h_length=16).| | | Else error. | Else error. | +------------------+-------------------------+-------------------------+
It is expected that when a typical naive application that calls gethostbyname() today is modified to use IPv6, it simply changes the program to use IPv6 sockets and then enables the RES_USE_INET6 resolver option before calling gethostbyname(). This application will then work with either IPv4 or IPv6 peers.
It is expected that when a typical naive application that calls gethostbyname() today is modified to use IPv6, it simply changes the program to use IPv6 sockets and then enables the RES_USE_INET6 resolver option before calling gethostbyname(). This application will then work with either IPv4 or IPv6 peers.
Note that gethostbyname() and gethostbyname2() are not thread-safe, since both return a pointer to a static hostent structure. But several vendors have defined a thread-safe gethostbyname_r() function that requires four additional arguments. We expect these vendors to also define a gethostbyname2_r() function.
Note that gethostbyname() and gethostbyname2() are not thread-safe, since both return a pointer to a static hostent structure. But several vendors have defined a thread-safe gethostbyname_r() function that requires four additional arguments. We expect these vendors to also define a gethostbyname2_r() function.
Gilligan, et. al. Informational [Page 21] RFC 2133 IPv6 Socket Interface Extensions April 1997
Gilligan, et. al. Informational [Page 21] RFC 2133 IPv6 Socket Interface Extensions April 1997
6.2. Address To Hostname Translation
6.2. Address To Hostname Translation
The existing gethostbyaddr() function already requires an address family argument and can therefore work with IPv6 addresses:
The existing gethostbyaddr() function already requires an address family argument and can therefore work with IPv6 addresses:
#include <sys/socket.h> #include <netdb.h>
#include <sys/socket.h> #include <netdb.h>
struct hostent *gethostbyaddr(const char *src, int len, int af);
struct hostent *gethostbyaddr(const char *src, int len, int af);
One possible source of confusion is the handling of IPv4-mapped IPv6 addresses and IPv4-compatible IPv6 addresses. This is addressed in [6] and involves the following logic:
One possible source of confusion is the handling of IPv4-mapped IPv6 addresses and IPv4-compatible IPv6 addresses. This is addressed in [6] and involves the following logic:
1. If af is AF_INET6, and if len equals 16, and if the IPv6 address is an IPv4-mapped IPv6 address or an IPv4-compatible IPv6 address, then skip over the first 12 bytes of the IPv6 address, set af to AF_INET, and set len to 4.
1. If af is AF_INET6, and if len equals 16, and if the IPv6 address is an IPv4-mapped IPv6 address or an IPv4-compatible IPv6 address, then skip over the first 12 bytes of the IPv6 address, set af to AF_INET, and set len to 4.
2. If af is AF_INET, then query for a PTR record in the in- addr.arpa domain.
2. If af is AF_INET, then query for a PTR record in the in- addr.arpa domain.
3. If af is AF_INET6, then query for a PTR record in the ip6.int domain.
3. If af is AF_INET6, then query for a PTR record in the ip6.int domain.
4. If the function is returning success, and if af equals AF_INET, and if the RES_USE_INET6 option was set, then the single address that is returned in the hostent structure (a copy of the first argument to the function) is returned as an IPv4-mapped IPv6 address and the h_length member is set to 16.
4. If the function is returning success, and if af equals AF_INET, and if the RES_USE_INET6 option was set, then the single address that is returned in the hostent structure (a copy of the first argument to the function) is returned as an IPv4-mapped IPv6 address and the h_length member is set to 16.
All four steps listed are performed, in order. The same caveats regarding a thread-safe version of gethostbyname() that were made at the end of the previous section apply here as well.
All four steps listed are performed, in order. The same caveats regarding a thread-safe version of gethostbyname() that were made at the end of the previous section apply here as well.
6.3. Protocol-Independent Hostname and Service Name Translation
6.3. Protocol-Independent Hostname and Service Name Translation
Hostname-to-address translation is done in a protocol-independent fashion using the getaddrinfo() function that is taken from the Institute of Electrical and Electronic Engineers (IEEE) POSIX 1003.1g (Protocol Independent Interfaces) work in progress specification [4].
Hostname-to-address translation is done in a protocol-independent fashion using the getaddrinfo() function that is taken from the Institute of Electrical and Electronic Engineers (IEEE) POSIX 1003.1g (Protocol Independent Interfaces) work in progress specification [4].
The official specification for this function will be the final POSIX standard. We are providing this independent description of the function because POSIX standards are not freely available (as are IETF documents). Should there be any discrepancies between this description and the POSIX description, the POSIX description takes precedence.
The official specification for this function will be the final POSIX standard. We are providing this independent description of the function because POSIX standards are not freely available (as are IETF documents). Should there be any discrepancies between this description and the POSIX description, the POSIX description takes precedence.
Gilligan, et. al. Informational [Page 22] RFC 2133 IPv6 Socket Interface Extensions April 1997
Gilligan, et. al. Informational [Page 22] RFC 2133 IPv6 Socket Interface Extensions April 1997
#include <sys/socket.h> #include <netdb.h>
#include <sys/socket.h> #include <netdb.h>
int getaddrinfo(const char *hostname, const char *servname, const struct addrinfo *hints, struct addrinfo **res);
int getaddrinfo(const char *hostname, const char *servname, const struct addrinfo *hints, struct addrinfo **res);
The addrinfo structure is defined as:
The addrinfo structure is defined as:
#include <sys/socket.h> #include <netdb.h>
#include <sys/socket.h> #include <netdb.h>
struct addrinfo { int ai_flags; /* AI_PASSIVE, AI_CANONNAME */ int ai_family; /* PF_xxx */ int ai_socktype; /* SOCK_xxx */ int ai_protocol; /* 0 or IPPROTO_xxx for IPv4 and IPv6 */ size_t ai_addrlen; /* length of ai_addr */ char *ai_canonname; /* canonical name for hostname */ struct sockaddr *ai_addr; /* binary address */ struct addrinfo *ai_next; /* next structure in linked list */ };
struct addrinfo { int ai_flags; /* AI_PASSIVE, AI_CANONNAME */ int ai_family; /* PF_xxx */ int ai_socktype; /* SOCK_xxx */ int ai_protocol; /* 0 or IPPROTO_xxx for IPv4 and IPv6 */ size_t ai_addrlen; /* length of ai_addr */ char *ai_canonname; /* canonical name for hostname */ struct sockaddr *ai_addr; /* binary address */ struct addrinfo *ai_next; /* next structure in linked list */ };
The return value from the function is 0 upon success or a nonzero error code. The following names are the nonzero error codes from getaddrinfo(), and are defined in <netdb.h>:
The return value from the function is 0 upon success or a nonzero error code. The following names are the nonzero error codes from getaddrinfo(), and are defined in <netdb.h>:
EAI_ADDRFAMILY address family for hostname not supported EAI_AGAIN temporary failure in name resolution EAI_BADFLAGS invalid value for ai_flags EAI_FAIL non-recoverable failure in name resolution EAI_FAMILY ai_family not supported EAI_MEMORY memory allocation failure EAI_NODATA no address associated with hostname EAI_NONAME hostname nor servname provided, or not known EAI_SERVICE servname not supported for ai_socktype EAI_SOCKTYPE ai_socktype not supported EAI_SYSTEM system error returned in errno
EAI_ADDRFAMILY address family for hostname not supported EAI_AGAIN temporary failure in name resolution EAI_BADFLAGS invalid value for ai_flags EAI_FAIL non-recoverable failure in name resolution EAI_FAMILY ai_family not supported EAI_MEMORY memory allocation failure EAI_NODATA no address associated with hostname EAI_NONAME hostname nor servname provided, or not known EAI_SERVICE servname not supported for ai_socktype EAI_SOCKTYPE ai_socktype not supported EAI_SYSTEM system error returned in errno
The hostname and servname arguments are pointers to null-terminated strings or NULL. One or both of these two arguments must be a non- NULL pointer. In the normal client scenario, both the hostname and servname are specified. In the normal server scenario, only the servname is specified. A non-NULL hostname string can be either a host name or a numeric host address string (i.e., a dotted-decimal IPv4 address or an IPv6 hex address). A non-NULL servname string can be either a service name or a decimal port number.
The hostname and servname arguments are pointers to null-terminated strings or NULL. One or both of these two arguments must be a non- NULL pointer. In the normal client scenario, both the hostname and servname are specified. In the normal server scenario, only the servname is specified. A non-NULL hostname string can be either a host name or a numeric host address string (i.e., a dotted-decimal IPv4 address or an IPv6 hex address). A non-NULL servname string can be either a service name or a decimal port number.
Gilligan, et. al. Informational [Page 23] RFC 2133 IPv6 Socket Interface Extensions April 1997
etギリガン、アル。 [23ページ]情報のRFC2133IPv6ソケットインタフェース拡大1997年4月
The caller can optionally pass an addrinfo structure, pointed to by the third argument, to provide hints concerning the type of socket that the caller supports. In this hints structure all members other than ai_flags, ai_family, ai_socktype, and ai_protocol must be zero or a NULL pointer. A value of PF_UNSPEC for ai_family means the caller will accept any protocol family. A value of 0 for ai_socktype means the caller will accept any socket type. A value of 0 for ai_protocol means the caller will accept any protocol. For example, if the caller handles only TCP and not UDP, then the ai_socktype member of the hints structure should be set to SOCK_STREAM when getaddrinfo() is called. If the caller handles only IPv4 and not IPv6, then the ai_family member of the hints structure should be set to PF_INET when getaddrinfo() is called. If the third argument to getaddrinfo() is a NULL pointer, this is the same as if the caller had filled in an addrinfo structure initialized to zero with ai_family set to PF_UNSPEC.
訪問者は、訪問者が支えるソケットのタイプに関してヒントを提供するために任意に3番目の議論で示されたaddrinfo構造を通り過ぎることができます。 これのai_旗以外のすべてのメンバー、ai_家族、ai_socktype、およびai_が議定書の中で述べる構造がゼロであるに違いないというヒントかNULLポインタ。 ai_家族のためのPF_UNSPECの値は、訪問者がどんなプロトコル家族も受け入れることを意味します。 ai_socktypeのための0の値は、訪問者がどんなソケットタイプも受け入れることを意味します。 ai_プロトコルのための0の値は、訪問者がどんなプロトコルも受け入れることを意味します。 getaddrinfo()が呼ばれるとき、例えば、訪問者がUDPではなく、TCPだけを扱うなら、構造があるはずであるというヒントのai_socktypeメンバーはSOCK_STREAMにセットしました。 getaddrinfo()が呼ばれるとき、訪問者がIPv6ではなく、IPv4だけを扱うなら、構造があるはずであるというヒントのai_親族はPF_INETにセットしました。 getaddrinfo()への3番目の議論がNULLポインタであるなら、これは、_家族がPF_UNSPECに設定するaiでゼロに合わせるために訪問者が構造が初期化したaddrinfoに記入したのと同じです。
Upon successful return a pointer to a linked list of one or more addrinfo structures is returned through the final argument. The caller can process each addrinfo structure in this list by following the ai_next pointer, until a NULL pointer is encountered. In each returned addrinfo structure the three members ai_family, ai_socktype, and ai_protocol are the corresponding arguments for a call to the socket() function. In each addrinfo structure the ai_addr member points to a filled-in socket address structure whose length is specified by the ai_addrlen member.
うまくいっているリターンのときに、最終弁論を通して1つ以上のaddrinfo構造の繋がっているリストへのポインタを返します。 訪問者はこのリストでai_次ポインタに続くことによって、それぞれのaddrinfo構造を処理できます、NULLポインタが遭遇するまで。 それぞれの返されたaddrinfo構造では、ai_家族、ai_socktype、およびai_が議定書の中で述べる3人のメンバーがソケット()機能への呼び出しのための対応する議論です。 それぞれのaddrinfo構造では、ai_addrメンバーは長さがai_addrlenメンバーによって指定される記入しているソケットアドレス構造を示します。
If the AI_PASSIVE bit is set in the ai_flags member of the hints structure, then the caller plans to use the returned socket address structure in a call to bind(). In this case, if the hostname argument is a NULL pointer, then the IP address portion of the socket address structure will be set to INADDR_ANY for an IPv4 address or IN6ADDR_ANY_INIT for an IPv6 address.
AI_PASSIVEビットがaiのヒントが構造化する_がメンバーに旗を揚げさせるセットであるなら、訪問者は、()を縛るという要求に返されたソケットアドレス構造を使用するのを計画しています。 この場合、ソケットアドレス構造のIPアドレスの部分はホスト名議論がNULLポインタであるならIPv6アドレスのためにIPv4のためのいずれも記述するINADDR_かIN6ADDR_にどんな_INITも設定するためにことになるでしょう。
If the AI_PASSIVE bit is not set in the ai_flags member of the hints structure, then the returned socket address structure will be ready for a call to connect() (for a connection-oriented protocol) or either connect(), sendto(), or sendmsg() (for a connectionless protocol). In this case, if the hostname argument is a NULL pointer, then the IP address portion of the socket address structure will be set to the loopback address.
AI_PASSIVEビットがaiのヒントが構造化する_がメンバーに旗を揚げさせるセットでないなら、返されたソケットアドレス構造は()を接続するか(接続指向のプロトコルのために)、または()、sendto()、またはsendmsg()を接続するという(コネクションレスプロトコルのために)要求の準備ができるでしょう。 この場合、ソケットアドレス構造のIPアドレスの部分はホスト名議論がNULLポインタであるならループバックアドレスに設定されるでしょう。
If the AI_CANONNAME bit is set in the ai_flags member of the hints structure, then upon successful return the ai_canonname member of the first addrinfo structure in the linked list will point to a null- terminated string containing the canonical name of the specified hostname.
AI_CANONNAMEビットがaiのヒントが構造化する_がメンバーに旗を揚げさせるセットであるなら、うまくいっているリターンのときに、繋がっているリストにおける最初のaddrinfo構造のai_canonname部材は指定されたホスト名の正準な名前を含むヌルの終えられたストリングを示すでしょう。
Gilligan, et. al. Informational [Page 24] RFC 2133 IPv6 Socket Interface Extensions April 1997
etギリガン、アル。 [24ページ]情報のRFC2133IPv6ソケットインタフェース拡大1997年4月
All of the information returned by getaddrinfo() is dynamically allocated: the addrinfo structures, and the socket address structures and canonical host name strings pointed to by the addrinfo structures. To return this information to the system the function freeaddrinfo() is called:
ダイナミックにgetaddrinfo()によって返された情報のすべてを割り当てます: addrinfo構造によって示されたaddrinfo構造、ソケットアドレス構造、および正準なホスト名ストリング。 この情報をシステムに返すために、機能freeaddrinfo()は呼ばれます:
#include <sys/socket.h> #include <netdb.h>
#<sys/socket.h>#インクルード<netdb.h>を含めてください。
void freeaddrinfo(struct addrinfo *ai);
freeaddrinfo(struct addrinfo*ai)を欠如させてください。
The addrinfo structure pointed to by the ai argument is freed, along with any dynamic storage pointed to by the structure. This operation is repeated until a NULL ai_next pointer is encountered.
ai議論で示されたaddrinfo構造は解放されます、構造によって示されたどんなダイナミックストレージと共にも。 この操作は_NULL aiまで繰り返されて、次のポインタが遭遇するということです。
To aid applications in printing error messages based on the EAI_xxx codes returned by getaddrinfo(), the following function is defined.
getaddrinfo()によって返されたEAI_xxxコードに基づく印刷エラーメッセージでアプリケーションを支援するために、以下の機能は定義されます。
#include <sys/socket.h> #include <netdb.h>
#<sys/socket.h>#インクルード<netdb.h>を含めてください。
char *gai_strerror(int ecode);
*gai_strerror(int ecode)を炭にしてください。
The argument is one of the EAI_xxx values defined earlier and the eturn value points to a string describing the error. If the argument is not one of the EAI_xxx values, the function still returns a pointer to a string whose contents indicate an unknown error.
議論は、より早く定義されたEAI_xxx値の1つです、そして、eturn値は誤りについて説明するストリングを示します。 議論がEAI_xxx値の1つでないなら、機能はまだコンテンツが未知の誤りを示すストリングにポインタを返しています。
6.4. Socket Address Structure to Hostname and Service Name
6.4. ホスト名とサービス名へのソケットアドレス構造
The POSIX 1003.1g specification includes no function to perform the reverse conversion from getaddrinfo(): to look up a hostname and service name, given the binary address and port. Therefore, we define the following function:
POSIX1003.1g仕様はgetaddrinfo()からリバース・コンバージョンを実行するために機能を全く含んでいません: 2進のアドレスとポートを考えて、ホスト名とサービス名を調べるために。 したがって、私たちは以下の機能を定義します:
#include <sys/socket.h> #include <netdb.h>
#<sys/socket.h>#インクルード<netdb.h>を含めてください。
int getnameinfo(const struct sockaddr *sa, size_t salen, char *host, size_t hostlen, char *serv, size_t servlen, int flags);
int getnameinfo(サイズ_t servlen、const struct sockaddr*sa、サイズ_t salenは*ホスト(サイズ_t hostlen)炭*servを炭にして、intは弛みます)。
This function looks up an IP address and port number provided by the caller in the DNS and system-specific database, and returns text strings for both in buffers provided by the caller. The function indicates successful completion by a zero return value; a non-zero return value indicates failure.
この機能は、DNSとシステム特有のデータベースで訪問者によって提供されたIPアドレスとポートナンバーを調べて、両方のために訪問者によって提供されたバッファでテキスト文字列を返します。 機能は原点復帰値で無事終了を示します。 非原点復帰値は失敗を示します。
Gilligan, et. al. Informational [Page 25] RFC 2133 IPv6 Socket Interface Extensions April 1997
etギリガン、アル。 [25ページ]情報のRFC2133IPv6ソケットインタフェース拡大1997年4月
The first argument, sa, points to either a sockaddr_in structure (for IPv4) or a sockaddr_in6 structure (for IPv6) that holds the IP address and port number. The salen argument gives the length of the sockaddr_in or sockaddr_in6 structure.
最初の主張(sa)はIPアドレスとポートナンバーを保持する構造のsockaddr_(IPv4のための)かsockaddr_in6構造(IPv6のための)のどちらかを示します。 議論がsockaddr_の長さを与えるか、またはsockaddr_in6が構造化するsalen。
The function returns the hostname associated with the IP address in the buffer pointed to by the host argument. The caller provides the size of this buffer via the hostlen argument. The service name associated with the port number is returned in the buffer pointed to by serv, and the servlen argument gives the length of this buffer. The caller specifies not to return either string by providing a zero value for the hostlen or servlen arguments. Otherwise, the caller must provide buffers large enough to hold the hostname and the service name, including the terminating null characters.
機能はホスト議論で示されたバッファのIPアドレスに関連しているホスト名を返します。 訪問者はhostlen議論でこのバッファのサイズを提供します。 servによって示されたバッファでポートナンバーに関連しているサービス名を返します、そして、servlen議論はこのバッファの長さを与えます。 訪問者は、ゼロがhostlenのために評価する提供かservlen議論でどちらのストリングも返さないように指定します。 さもなければ、訪問者はホスト名とサービス名を保持できるくらい大きいバッファを提供しなければなりません、終端空文字を含んでいて。
Unfortunately most systems do not provide constants that specify the maximum size of either a fully-qualified domain name or a service name. Therefore to aid the application in allocating buffers for these two returned strings the following constants are defined in <netdb.h>:
残念ながらほとんどのシステムは完全修飾ドメイン名かサービス名のどちらかの最大サイズを指定する定数を提供しません。 したがって、これらの2個の返されたストリングのためのバッファを割り当てる際にアプリケーションを支援するために、以下の定数は<netdb.h>で定義されます:
#define NI_MAXHOST 1025 #define NI_MAXSERV 32
#定義、NI_MAXHOST1025#、はNI_MAXSERV32を定義します。
The first value is actually defined as the constant MAXDNAME in recent versions of BIND's <arpa/nameser.h> header (older versions of BIND define this constant to be 256) and the second is a guess based on the services listed in the current Assigned Numbers RFC.
最初の値は実際にBINDの<アルパ/nameser.h>ヘッダーの最近のバージョンで一定のMAXDNAMEと定義されます、そして、(BINDの旧式のバージョンは256になるようにこの定数を定義します)2番目は現在のAssigned民数記RFCに記載されたサービスに基づく推測です。
The final argument is a flag that changes the default actions of this function. By default the fully-qualified domain name (FQDN) for the host is looked up in the DNS and returned. If the flag bit NI_NOFQDN is set, only the hostname portion of the FQDN is returned for local hosts.
最終弁論はこの機能のデフォルト動作を変える旗です。 デフォルトで、ホストへの完全修飾ドメイン名(FQDN)をDNSで調べて、返します。 フラグビットNI_NOFQDNが用意ができているなら、ローカル・ホストのためにFQDNのホスト名一部だけを返します。
If the flag bit NI_NUMERICHOST is set, or if the host's name cannot be located in the DNS, the numeric form of the host's address is returned instead of its name (e.g., by calling inet_ntop() instead of gethostbyaddr()). If the flag bit NI_NAMEREQD is set, an error is returned if the host's name cannot be located in the DNS.
ホストの名前がDNSに位置できないならフラグビットNI_NUMERICHOSTが用意ができているなら、名前の代わりに数値フォームのホストのアドレスを返します。(例えば、inet_をgethostbyaddr())の代わりにntop()と呼ぶことによって。 フラグビットNI_NAMEREQDが用意ができて、ホストの名前がDNSに位置できないなら、誤りは返されます。
If the flag bit NI_NUMERICSERV is set, the numeric form of the service address is returned (e.g., its port number) instead of its name. The two NI_NUMERICxxx flags are required to support the "-n" flag that many commands provide.
フラグビットNI_NUMERICSERVが用意ができているなら、名前の代わりにサービスアドレスの数値フォームを返します(例えば、ポートナンバー)。 2個のNI_NUMERICxxx旗が、多くのコマンドが提供する「-n」旗を支えるのに必要です。
Gilligan, et. al. Informational [Page 26] RFC 2133 IPv6 Socket Interface Extensions April 1997
etギリガン、アル。 [26ページ]情報のRFC2133IPv6ソケットインタフェース拡大1997年4月
A fifth flag bit, NI_DGRAM, specifies that the service is a datagram service, and causes getservbyport() to be called with a second argument of "udp" instead of its default of "tcp". This is required for the few ports (512-514) that have different services for UDP and TCP.
5番目のフラグビット(NI_DGRAM)で、サービスがデータグラムサービスであると指定して、"tcp"のデフォルトの代わりに"udp"の2番目の議論でgetservbyport()を呼びます。 これがUDPとTCPのための異なったサービスを持っているわずかなポート(512-514)に必要です。
These NI_xxx flags are defined in <netdb.h> along with the AI_xxx flags already defined for getaddrinfo().
これらのNI_xxx旗はgetaddrinfo()のために既に定義されたAI_xxx旗に伴う<netdb.h>で定義されます。
6.5. Address Conversion Functions
6.5. アドレス変換機能
The two functions inet_addr() and inet_ntoa() convert an IPv4 address between binary and text form. IPv6 applications need similar functions. The following two functions convert both IPv6 and IPv4 addresses:
2の機能inet_addr()とinet_ntoa()はバイナリーとテキストフォームの間のIPv4アドレスを変換します。 IPv6アプリケーションは同様の機能を必要とします。 以下の2つの機能がIPv6とIPv4アドレスの両方を変換します:
#include <sys/socket.h> #include <arpa/inet.h>
#<sys/socket.h>#インクルード<アルパ/inet.h>を含めてください。
int inet_pton(int af, const char *src, void *dst);
int inet_pton(int af、const炭*srcは*dstを欠如させます)。
const char *inet_ntop(int af, const void *src, char *dst, size_t size);
const炭*のinet_ntop(int af、const空間*srcは*dst、サイズ_tサイズを炭にします)。
The inet_pton() function converts an address in its standard text presentation form into its numeric binary form. The af argument specifies the family of the address. Currently the AF_INET and AF_INET6 address families are supported. The src argument points to the string being passed in. The dst argument points to a buffer into which the function stores the numeric address. The address is returned in network byte order. Inet_pton() returns 1 if the conversion succeeds, 0 if the input is not a valid IPv4 dotted- decimal string or a valid IPv6 address string, or -1 with errno set to EAFNOSUPPORT if the af argument is unknown. The calling application must ensure that the buffer referred to by dst is large enough to hold the numeric address (e.g., 4 bytes for AF_INET or 16 bytes for AF_INET6).
inet_pton()機能は標準のテキスト表示形で数値二部形式にアドレスを変換します。 af議論はアドレスの家族を指定します。 現在の、AF_INETとAF_INET6アドレス家は養われます。 src議論は渡されるストリングを示します。 dst議論は機能が数値アドレスを格納するバッファを示します。 ネットワークバイトオーダーでアドレスを返します。 変換が成功するなら、Inet_pton()が1を返すか、0が入力が有効なIPv4でないなら10進ストリングか有効なIPv6アドレスストリングに点を打たせたか、またはaf議論が未知であるなら、errnoがある-1はEAFNOSUPPORTにセットしました。 呼ぶアプリケーションはdstによって示されたバッファが確実に数値アドレス(例えば、AF_INETのための4バイトかAF_INET6のための16バイト)を保持できるくらい大きくなるようにしなければなりません。
If the af argument is AF_INET, the function accepts a string in the standard IPv4 dotted-decimal form:
af議論がAF_INETであるなら、機能は標準のIPv4ドット付き10進法フォームでストリングを受け入れます:
ddd.ddd.ddd.ddd
ddd.ddd.ddd.ddd
where ddd is a one to three digit decimal number between 0 and 255. Note that many implementations of the existing inet_addr() and inet_aton() functions accept nonstandard input: octal numbers, hexadecimal numbers, and fewer than four numbers. inet_pton() does not accept these formats.
dddでは、1〜3ケタは0〜255の10進数ですか? 既存のinet_addr()とinet_aton()機能の多くの実現が標準的でない入力を受け入れることに注意してください: 8進数、16進数、および4つ未満の番号inet_pton()はこれらの形式を受け入れません。
Gilligan, et. al. Informational [Page 27] RFC 2133 IPv6 Socket Interface Extensions April 1997
etギリガン、アル。 [27ページ]情報のRFC2133IPv6ソケットインタフェース拡大1997年4月
If the af argument is AF_INET6, then the function accepts a string in one of the standard IPv6 text forms defined in Section 2.2 of the addressing architecture specification [2].
af議論がAF_INET6であるなら、機能はアドレッシング体系仕様[2]のセクション2.2で定義された標準のIPv6テキストフォームの1つでストリングを受け入れます。
The inet_ntop() function converts a numeric address into a text string suitable for presentation. The af argument specifies the family of the address. This can be AF_INET or AF_INET6. The src argument points to a buffer holding an IPv4 address if the af argument is AF_INET, or an IPv6 address if the af argument is AF_INET6. The dst argument points to a buffer where the function will store the resulting text string. The size argument specifies the size of this buffer. The application must specify a non-NULL dst argument. For IPv6 addresses, the buffer must be at least 46-octets. For IPv4 addresses, the buffer must be at least 16-octets. In order to allow applications to easily declare buffers of the proper size to store IPv4 and IPv6 addresses in string form, the following two constants are defined in <netinet/in.h>:
inet_ntop()機能はプレゼンテーションに適したテキスト文字列に数値アドレスを変換します。 af議論はアドレスの家族を指定します。 これは、AF_INETかAF_INET6であるかもしれません。 src議論はaf議論がAF_INETであるならIPv4アドレスを保持しながら、バッファを示すか、af議論であるなら、IPv6アドレスがAF_INET6です。 dst議論は機能が結果として起こるテキスト文字列を格納するバッファを示します。 サイズ議論はこのバッファのサイズを指定します。 アプリケーションは非NULL dst議論を指定しなければなりません。 IPv6アドレスのために、少なくともバッファは46八重奏でなければなりません。 IPv4アドレスのために、少なくともバッファは16八重奏でなければなりません。 アプリケーションが、適切なサイズに関するバッファがストリングフォームにIPv4とIPv6アドレスを格納すると容易に宣言するのを許容するために、以下の2つの定数が<netinet/in.h>で定義されます:
#define INET_ADDRSTRLEN 16 #define INET6_ADDRSTRLEN 46
#定義、INET_ADDRSTRLEN16#、はINET6_ADDRSTRLEN46を定義します。
The inet_ntop() function returns a pointer to the buffer containing the text string if the conversion succeeds, and NULL otherwise. Upon failure, errno is set to EAFNOSUPPORT if the af argument is invalid or ENOSPC if the size of the result buffer is inadequate.
そうでなければ、inet_ntop()機能は変換が成功するならテキスト文字列を入れてあるバッファ、およびNULLにポインタを返します。 失敗では、errnoは結果バッファのサイズが不十分であるなら、af議論が病人かENOSPCであるならEAFNOSUPPORTに用意ができています。
6.6. Address Testing Macros
6.6. アドレステストマクロ
The following macros can be used to test for special IPv6 addresses.
特別なIPv6アドレスがないかどうかテストするのに以下のマクロを使用できます。
#include <netinet/in.h>
#<netinet/in.h>を含めてください。
int IN6_IS_ADDR_UNSPECIFIED (const struct in6_addr *); int IN6_IS_ADDR_LOOPBACK (const struct in6_addr *); int IN6_IS_ADDR_MULTICAST (const struct in6_addr *); int IN6_IS_ADDR_LINKLOCAL (const struct in6_addr *); int IN6_IS_ADDR_SITELOCAL (const struct in6_addr *); int IN6_IS_ADDR_V4MAPPED (const struct in6_addr *); int IN6_IS_ADDR_V4COMPAT (const struct in6_addr *);
int IN6_は_ADDR_UNSPECIFIED(const struct in6_addr*)です。 int IN6_は_ADDR_LOOPBACK(const struct in6_addr*)です。 int IN6_は_ADDR_MULTICAST(const struct in6_addr*)です。 int IN6_は_ADDR_LINKLOCAL(const struct in6_addr*)です。 int IN6_は_ADDR_SITELOCAL(const struct in6_addr*)です。 int IN6_は_ADDR_V4MAPPED(const struct in6_addr*)です。 int IN6_は_ADDR_V4COMPAT(const struct in6_addr*)です。
int IN6_IS_ADDR_MC_NODELOCAL(const struct in6_addr *); int IN6_IS_ADDR_MC_LINKLOCAL(const struct in6_addr *); int IN6_IS_ADDR_MC_SITELOCAL(const struct in6_addr *); int IN6_IS_ADDR_MC_ORGLOCAL (const struct in6_addr *); int IN6_IS_ADDR_MC_GLOBAL (const struct in6_addr *);
int IN6_は__NODELOCAL ADDR_M.C.(const struct in6_addr*)です。 int IN6_は__LINKLOCAL ADDR_M.C.(const struct in6_addr*)です。 int IN6_は__SITELOCAL ADDR_M.C.(const struct in6_addr*)です。 int IN6_は__ORGLOCAL ADDR_M.C.(const struct in6_addr*)です。 int IN6_は__GLOBAL ADDR_M.C.(const struct in6_addr*)です。
Gilligan, et. al. Informational [Page 28] RFC 2133 IPv6 Socket Interface Extensions April 1997
etギリガン、アル。 [28ページ]情報のRFC2133IPv6ソケットインタフェース拡大1997年4月
The first seven macros return true if the address is of the specified type, or false otherwise. The last five test the scope of a multicast address and return true if the address is a multicast address of the specified scope or false if the address is either not a multicast address or not of the specified scope.
そうでなければ、アドレスが指定されたタイプにはあるか、または誤っているなら、最初の7つのマクロが本当に戻ります。 最後の5は、マルチキャストアドレスの範囲を検査して、アドレスがマルチキャストアドレスでないならアドレスが指定された範囲の指定された範囲か誤ることのマルチキャストアドレスであるなら本当に戻ります。
7. Summary of New Definitions
7. 新しい定義の概要
The following list summarizes the constants, structure, and extern definitions discussed in this memo, sorted by header.
以下のリストはヘッダーによって分類されたこのメモで議論した定数、構造、および通いの人定義をまとめます。
<net/if.h> IFNAMSIZ <net/if.h> struct if_nameindex{};
<ネット/if.h>IFNAMSIZ<ネット/if.h>structですが、_nameindexである、。
<netdb.h> AI_CANONNAME <netdb.h> AI_PASSIVE <netdb.h> EAI_ADDRFAMILY <netdb.h> EAI_AGAIN <netdb.h> EAI_BADFLAGS <netdb.h> EAI_FAIL <netdb.h> EAI_FAMILY <netdb.h> EAI_MEMORY <netdb.h> EAI_NODATA <netdb.h> EAI_NONAME <netdb.h> EAI_SERVICE <netdb.h> EAI_SOCKTYPE <netdb.h> EAI_SYSTEM <netdb.h> NI_DGRAM <netdb.h> NI_MAXHOST <netdb.h> NI_MAXSERV <netdb.h> NI_NAMEREQD <netdb.h> NI_NOFQDN <netdb.h> NI_NUMERICHOST <netdb.h> NI_NUMERICSERV <netdb.h> struct addrinfo{};
_受け身の<netdb.h>AI_CANONNAME<netdb.h>AIの>EAI_ADDRFAMILY<netdb.h><netdb.h EAI、_一方、<netdb.h>EAI_BADFLAGS<netdb.h>EAI_やり損ない<netdb.h>EAI_家族<netdb.h>EAI_メモリ<netdb.h>EAI_NODATA<netdb.h>EAI_NONAME<はnetdbします; h>EAI_SERVICE<netdb.h>EAI_SOCKTYPE<netdb.h>EAI_SYSTEM<netdb.h>NI_DGRAM<netdb.h>NI_MAXHOST<netdb.h>NI_MAXSERV<netdb.h>NI_NAMEREQD<netdb.h>NI_NOFQDN<netdb.h>NI_NUMERICHOST<netdb.h>NI_NUMERICSERV<netdb.h>struct addrinfo、。
<netinet/in.h> IN6ADDR_ANY_INIT <netinet/in.h> IN6ADDR_LOOPBACK_INIT <netinet/in.h> INET6_ADDRSTRLEN <netinet/in.h> INET_ADDRSTRLEN <netinet/in.h> IPPROTO_IPV6 <netinet/in.h> IPV6_ADDRFORM <netinet/in.h> IPV6_ADD_MEMBERSHIP <netinet/in.h> IPV6_DROP_MEMBERSHIP <netinet/in.h> IPV6_MULTICAST_HOPS <netinet/in.h> IPV6_MULTICAST_IF <netinet/in.h> IPV6_MULTICAST_LOOP <netinet/in.h> IPV6_UNICAST_HOPS
どんな_イニット<netinet/in.h>IN6ADDR_ループバック_イニット<netinet/in.h>INET6_ADDRSTRLEN<netinet/in.h>INET_ADDRSTRLEN<netinet/in.h>IPPROTO_IPV6<netinet/in.h>IPV6_ADDRFORM<も/をnetinetする<netinet/in.h>IN6ADDR_; h>IPV6_ADD_MEMBERSHIP<netinet/in.h>IPV6_DROP_MEMBERSHIP<netinet/in.h>IPV6_MULTICAST_ホップス<netinet/in.h>IPV6_MULTICAST_、<netinet/in.h>IPV6_MULTICAST_LOOP<netinet/in.h>IPV6_UNICAST_ホップスです。
Gilligan, et. al. Informational [Page 29] RFC 2133 IPv6 Socket Interface Extensions April 1997
etギリガン、アル。 [29ページ]情報のRFC2133IPv6ソケットインタフェース拡大1997年4月
<netinet/in.h> SIN6_LEN <netinet/in.h> extern const struct in6_addr in6addr_any; <netinet/in.h> extern const struct in6_addr in6addr_loopback; <netinet/in.h> struct in6_addr{}; <netinet/in.h> struct ipv6_mreq{}; <netinet/in.h> struct sockaddr_in6{};
<netinet/in.h>SIN6_LEN<netinet/in.h>通いの人const struct in6_addr in6addr_、いずれも。 <netinet/in.h>通いの人const struct in6_addr in6addr_ループバック。 <netinet/in.h>struct in6_addr、。 <netinet/in.h>struct ipv6_mreq、。 <netinet/in.h>struct sockaddr_in6、。
<resolv.h> RES_USE_INET6
<resolv.h>RES_使用_INET6
<sys/socket.h> AF_INET6 <sys/socket.h> PF_INET6
<sys/socket.h>AF_INET6<sys/socket.h>pf_INET6
The following list summarizes the function and macro prototypes discussed in this memo, sorted by header.
以下のリストはヘッダーによって分類されたこのメモで議論した機能とマクロ原型をまとめます。
<arpa/inet.h> int inet_pton(int, const char *, void *); <arpa/inet.h> const char *inet_ntop(int, const void *, char *, size_t);
<アルパ/inet.h>int inet_pton(int、const炭*は*を欠如させます)。 <アルパ/inet.hの>のconst炭*のinet_ntop(intであって、constな空間*、炭*、サイズ_t)。
<net/if.h> char *if_indextoname(unsigned int, char *); <net/if.h> unsigned int if_nametoindex(const char *); <net/if.h> void if_freenameindex(struct if_nameindex *); <net/if.h> struct if_nameindex *if_nameindex(void);
<ネット/if.h>は*_indextoname(無記名のint、炭の*)であるなら焦げます。 <ネット/if.hの>の無記名のintは_であるなら(const炭*)をnametoindexします。 _freenameindexであるなら(_nameindex*であるなら、structします)>が欠如させる<ネット/if.h。 _nameindexであるなら、*_nameindexであるなら(空の)、<ネット/if.h>はstructされます。
<netdb.h> int getaddrinfo(const char *, const char *, const struct addrinfo *, struct addrinfo **); <netdb.h> int getnameinfo(const struct sockaddr *, size_t, char *, size_t, char *, size_t, int); <netdb.h> void freeaddrinfo(struct addrinfo *); <netdb.h> char *gai_strerror(int); <netdb.h> struct hostent *gethostbyname(const char *); <netdb.h> struct hostent *gethostbyaddr(const char *, int, int); <netdb.h> struct hostent *gethostbyname2(const char *, int);
<netdb.h>int getaddrinfo(const炭*、const炭*、const struct addrinfo*、struct addrinfo**)。 <netdb.h>int getnameinfo(const struct sockaddr*、サイズ_t、炭*、サイズ_tは*、サイズ_t、intを炭にします)。 <のnetdb.hの>の空のfreeaddrinfo(struct addrinfo*)。 <netdb.h>炭*のgai_strerror(int)。 <netdb.h>struct hostent*gethostbyname(const炭*)。 <netdb.h>struct hostent*gethostbyaddr(const炭*、int、int)。 <netdb.h>struct hostent*gethostbyname2(const炭*、int)。
<netinet/in.h> int IN6_IS_ADDR_LINKLOCAL(const struct in6_addr *); <netinet/in.h> int IN6_IS_ADDR_LOOPBACK(const struct in6_addr *); <netinet/in.h> int IN6_IS_ADDR_MC_GLOBAL(const struct in6_addr *); <netinet/in.h> int IN6_IS_ADDR_MC_LINKLOCAL(const struct in6_addr *); <netinet/in.h> int IN6_IS_ADDR_MC_NODELOCAL(const struct in6_addr *); <netinet/in.h> int IN6_IS_ADDR_MC_ORGLOCAL(const struct in6_addr *); <netinet/in.h> int IN6_IS_ADDR_MC_SITELOCAL(const struct in6_addr *); <netinet/in.h> int IN6_IS_ADDR_MULTICAST(const struct in6_addr *); <netinet/in.h> int IN6_IS_ADDR_SITELOCAL(const struct in6_addr *); <netinet/in.h> int IN6_IS_ADDR_UNSPECIFIED(const struct in6_addr *); <netinet/in.h> int IN6_IS_ADDR_V4COMPAT(const struct in6_addr *); <netinet/in.h> int IN6_IS_ADDR_V4MAPPED(const struct in6_addr *);
<netinet/in.h>int IN6_は_ADDR_LINKLOCAL(const struct in6_addr*)です。 <netinet/in.h>int IN6_は_ADDR_LOOPBACK(const struct in6_addr*)です。 <netinet/in.h>int IN6_は__GLOBAL ADDR_M.C.(const struct in6_addr*)です。 <netinet/in.h>int IN6_は__LINKLOCAL ADDR_M.C.(const struct in6_addr*)です。 <netinet/in.h>int IN6_は__NODELOCAL ADDR_M.C.(const struct in6_addr*)です。 <netinet/in.h>int IN6_は__ORGLOCAL ADDR_M.C.(const struct in6_addr*)です。 <netinet/in.h>int IN6_は__SITELOCAL ADDR_M.C.(const struct in6_addr*)です。 <netinet/in.h>int IN6_は_ADDR_MULTICAST(const struct in6_addr*)です。 <netinet/in.h>int IN6_は_ADDR_SITELOCAL(const struct in6_addr*)です。 <netinet/in.h>int IN6_は_ADDR_UNSPECIFIED(const struct in6_addr*)です。 <netinet/in.h>int IN6_は_ADDR_V4COMPAT(const struct in6_addr*)です。 <netinet/in.h>int IN6_は_ADDR_V4MAPPED(const struct in6_addr*)です。
Gilligan, et. al. Informational [Page 30] RFC 2133 IPv6 Socket Interface Extensions April 1997
etギリガン、アル。 [30ページ]情報のRFC2133IPv6ソケットインタフェース拡大1997年4月
8. Security Considerations
8. セキュリティ問題
IPv6 provides a number of new security mechanisms, many of which need to be accessible to applications. A companion memo detailing the extensions to the socket interfaces to support IPv6 security is being written [3].
IPv6は多くの新しいセキュリティー対策を提供します。その多くがアプリケーションにアクセスしやすい必要があります。 IPv6セキュリティを支持するためにソケットインタフェースに拡大を詳しく述べる仲間メモは[3]に書かれています。
9. Acknowledgments
9. 承認
Thanks to the many people who made suggestions and provided feedback to to the numerous revisions of this document, including: Werner Almesberger, Ran Atkinson, Fred Baker, Dave Borman, Andrew Cherenson, Alex Conta, Alan Cox, Steve Deering, Richard Draves, Francis Dupont, Robert Elz, Marc Hasson, Tim Hartrick, Tom Herbert, Bob Hinden, Wan- Yen Hsu, Christian Huitema, Koji Imada, Markus Jork, Ron Lee, Alan Lloyd, Charles Lynn, Jack McCann, Dan McDonald, Dave Mitton, Thomas Narten, Erik Nordmark, Josh Osborne, Craig Partridge, Jean-Luc Richier, Erik Scoredos, Keith Sklower, Matt Thomas, Harvey Thompson, Dean D. Throop, Karen Tracey, Glenn Trewitt, Paul Vixie, David Waitzman, Carl Williams, and Kazuhiko Yamamoto,
多くへの感謝はこのドキュメント、包含の頻繁な改正とだれが提案をしたか、そして、提供されたフィードバックを住ませます: Throop、カレン・トレーシー、グレンTrewitt、ポールVixie、デヴィッドWaitzman、カール・ウィリアムズ、およびKazuhiko山本
The getaddrinfo() and getnameinfo() functions are taken from an earlier Work in Progress by Keith Sklower. As noted in that document, William Durst, Steven Wise, Michael Karels, and Eric Allman provided many useful discussions on the subject of protocol- independent name-to-address translation, and reviewed early versions of Keith Sklower's original proposal. Eric Allman implemented the first prototype of getaddrinfo(). The observation that specifying the pair of name and service would 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 Interface".
getaddrinfo()とgetnameinfo()機能はProgressでキースSklowerによって以前のWorkから取られます。 そのドキュメントに述べられるように、ウィリアムDurst、スティーブンWise、マイケルKarels、およびエリック・オールマンは、独立しているプロトコルの名前からアドレス変換の問題についての多くの役に立つ議論を提供して、キースSklowerの起案の早めのバージョンを見直しました。 エリック・オールマンはgetaddrinfo()の最初の原型を実行しました。 名前の、そして、サービスの組を指定するのがプロトコルの詳細の如何にかかわらずサービスに接続するのに十分であるだろうという観測は「一定のネットワーク・インターフェース」のためにマーシャル・ローズによって提案でX/Openにされました。
Craig Metz made many contributions to this document. Ramesh Govindan made a number of contributions and co-authored an earlier version of this memo.
クレイグ・メスはこのドキュメントへの多くの貢献をしました。 Ramesh Govindanは多くの貢献をして、このメモの以前のバージョンについて共同執筆しました。
10. References
10. 参照
[1] Deering, S., and R. Hinden, "Internet Protocol, Version 6 (IPv6) Specification", RFC 1883, December 1995.
[1] デアリング、S.とR.Hinden、「インターネットプロトコル、バージョン6(IPv6)仕様」、RFC1883、12月1995日
[2] Hinden, R., and S. Deering, "IP Version 6 Addressing Architecture", RFC 1884, December 1995.
[2] Hinden、R.とS.デアリング、「IPバージョン6アドレッシング体系」、RFC1884、1995年12月。
[3] McDonald, D., "A Simple IP Security API Extension to BSD Sockets", Work in Progress.
[3] マクドナルド、D.、「BSDソケットへの簡単なIPセキュリティAPI拡大」が進行中で働いています。
Gilligan, et. al. Informational [Page 31] RFC 2133 IPv6 Socket Interface Extensions April 1997
etギリガン、アル。 [31ページ]情報のRFC2133IPv6ソケットインタフェース拡大1997年4月
[4] IEEE, "Protocol Independent Interfaces", IEEE Std 1003.1g, DRAFT 6.3, November 1995.
[4] IEEE(「プロトコルインディペンデント・インタフェース」、IEEE Std1003.1g)は6.3、1995年11月を作成します。
[5] Stevens, W., and M. Thomas, "Advanced Sockets API for IPv6", Work in Progress.
[5] スティーブンス、W.とM.トーマス、「IPv6"、進行中の仕事のための高度なソケットAPI。」
[6] Vixie, P., "Reverse Name Lookups of Encapsulated IPv4 Addresses in IPv6", Work in Progress.
[6] Vixie(P.)は「IPv6"の要約のIPv4アドレス、進行中の仕事の名前ルックアップを逆にします」。
11. Authors' Addresses
11. 作者のアドレス
Robert E. Gilligan Freegate Corporation 710 Lakeway Dr. STE 230 Sunnyvale, CA 94086
ロバートE.ギリガンFreegate社710STE230Lakewayサニーベル博士、カリフォルニア 94086
Phone: +1 408 524 4804 EMail: gilligan@freegate.net
以下に電話をしてください。 +1 4804年の408 524メール: gilligan@freegate.net
Susan Thomson Bell Communications Research MRE 2P-343, 445 South Street Morristown, NJ 07960
モリスタウン、スーザントムソンベルコミュニケーションズ・リサーチMRE 2P-343、445のSouth通りニュージャージー 07960
Phone: +1 201 829 4514 EMail: set@thumper.bellcore.com
以下に電話をしてください。 +1 4514年の201 829メール: set@thumper.bellcore.com
Jim Bound Digital Equipment Corporation 110 Spitbrook Road ZK3-3/U14 Nashua, NH 03062-2698
ジム・制限されたDEC110Spitbrook道路ZK3-3/U14ナッシュア、ニューハンプシャー03062-2698
Phone: +1 603 881 0400 Email: bound@zk3.dec.com
以下に電話をしてください。 +1 0400年の603 881メール: bound@zk3.dec.com
W. Richard Stevens 1202 E. Paseo del Zorro Tucson, AZ 85718-2826
W.リチャード・スティーブンス1202・E.Paseo delゾロ・ツーソン、アリゾナ85718-2826
Phone: +1 520 297 9416 EMail: rstevens@kohala.com
以下に電話をしてください。 +1 9416年の520 297メール: rstevens@kohala.com
Gilligan, et. al. Informational [Page 32]
etギリガン、アル。 情報[32ページ]
一覧
スポンサーリンク