名称

書式

int
socket( AF_INET, SOCK_RAW, proto);

解説

いくつかの IP レベルの setsockopt(2) と getsockopt(2) オプションがあります。 IP_OPTIONS は、それぞれの発信パケットの IP ヘッダで送信されるか、または着信パケット上でヘッダオプションを調べるための IP オプションを提供するために使用されます。 IP オプションは、インターネットファミリのどんなソケットタイプでも使用されます。送信される IP オプションのフォーマットは、次の 1 つを例外として IP プロトコル仕様 (RFC-791) で明記されています: 指定経路制御 (ソースルート) オプションのためのアドレスのリストは、ゲートウェイのリストの先頭に最初の中継点 (ホップ) ゲートウェイを含まなければなりません。最初の中継点 (ホップ) ゲートウェイアドレスは、オプションリストから引き出され、サイズは、使用する前にそれに従って調整されます。以前に指定されたオプションを無効にするには、長さ 0 のバッファを使用してください:

setsockopt(s, IPPROTO_IP, IP_OPTIONS, NULL, 0);

IP_TOS と IP_TTL は、 SOCK_STREAM, SOCK_DGRAM とあるタイプの SOCK_RAW ソケットのための IP ヘッダでのサービスタイプ (type-of-service) と生存時間 (time-to-live) フィールドを設定するために使用されます。例えば、次のようです。

int tos = IPTOS_LOWDELAY;       /* <netinet/ip.h>参照 */ 
setsockopt(s, IPPROTO_IP, IP_TOS, &tos, sizeof(tos)); 
 
int ttl = 60;                   /* 最大 = 255 */ 
setsockopt(s, IPPROTO_IP, IP_TTL, &ttl, sizeof(ttl));

IP_MINTTL は、ソケット上で受信するとき、パケットが持たなければならない最小の受け付け可能な TTL を設定するために使用されます。 TTL より少ないすべてのパケットは、静かに落とされます。このオプションは、ソケットでローカルの listener (接続を受け付け者) に到達する直接接続されたネットワークの外側からパケットを防ぐ 255 に設定されるときのみ、本当に役に立ちます。

IP_DONTFRAG は、IP パケットで Don't Fragment フラグを設定するために使用されます。現在、このオプションは、 IP_HDRINCL オプションが設定されていない場合、 udp(4) と生の ip(4) ソケットだけで順守されます。 tcp(4) ソケットでは、 Don't Fragment フラグは、Path MTU Discovery オプションによって制御されます。宛先 (終点) アドレスによって決定される、 egress (出口) インタフェースの MTU サイズより大きい送信パケットは、 EMSGSIZE エラーが返されます。

IP_RECVDSTADDR オプションが SOCK_DGRAM ソケットで有効にされると、 recvmsg(2) 呼び出しは、 UDP データグラムのための宛先 (終点) IP アドレスを返します。 msghdr 構造体の msg_control フィールドは、 IP アドレスが続く cmsghdr 構造体を含むバッファを指します。 cmsghdr フィールドには、次の値があります:

cmsg_len = CMSG_LEN(sizeof(struct in_addr)) 
cmsg_level = IPPROTO_IP 
cmsg_type = IP_RECVDSTADDR

IP_SENDSRCADDR のタイプコードを持つ補助データとして、ソケットの発信 UDP データグラムのために使用される発信元 (始点) アドレスを指定することができます。 msghdr 構造体の msg_control フィールドは、 IP アドレスがあとに続く cmsghdr 構造体を含んでいるバッファを指すすべきです。 cmsghdr フィールドは、次の値を持つべきです:

cmsg_len = CMSG_LEN(sizeof(struct in_addr)) 
cmsg_level = IPPROTO_IP 
cmsg_type = IP_SENDSRCADDR

ソケットは、 INADDR_ANY とローカルポートのいずれかにバインドされるべきで、 IP_SENDSRCADDR で供給されたアドレスは、 INADDR_ANY であるべきでなく、またはソケットは、ローカルアドレスにバインドされるべきで、 IP_SENDSRCADDR で供給されたアドレスは、 INADDR_ANY であるべきです。後者の場合で、バインドされたアドレスは、宛先に近いインタフェースの IP アドレスを選択する、一般的なソースアドレスの選択ロジックを通して上書きされます。

便宜上、 IP_SENDSRCADDR は、 IP_RECVDSTADDR と同じ値を持つように定義されるので、 recvmsg(2) からの IP_RECVDSTADDR コントロールメッセージは、 sendmsg(2) のための制御メッセージとして直接使用することができます。

IP_ONESBCAST オプションが SOCK_DGRAM か SOCK_RAW ソケットで有効にされると、そのソケット上の発信ブロードキャストデータグラムの宛先 (終点) アドレスは、送信の前に、方向づけのないブロードキャストアドレス、 INADDR_BROADCAST に強制されます。 IFF_BROADCAST フラグのセットとの最初のネットワークインタフェースを通して方向づけのないブロードキャストを送信するシステムのデフォルトの振る舞いと対照的です。

このオプションで、方向づけのないブロードキャストデータグラムを送信するためにどのインタフェースが使用されるかをアプリケーションは、選ぶことができます。例えば、次のコードは、方向づけのないブロードキャストがブロードキャストアドレス 192.168.2.255 に設定されたインタフェースを通して強制的に送信されます:

char msg[512]; 
struct sockaddr_in sin; 
int onesbcast = 1; /* 0 = 無効 (デフォルト), 1 = 有効 */ 
 
setsockopt(s, IPPROTO_IP, IP_ONESBCAST, &onesbcast, sizeof(onesbcast)); 
sin.sin_addr.s_addr = inet_addr("192.168.2.255"); 
sin.sin_port = htons(1234); 
sendto(s, msg, sizeof(msg), 0, &sin, sizeof(sin));

ブロードキャストの嵐を防ぐために適切な値に IP_TTL オプションを設定するのは、アプリケーションの責任です。アプリケーションには、 SO_BROADCAST ソケットレベルオプションを設定するための十分な証明書がなければなりません。そうでなければ IP_ONESBCAST オプションには、まったく効果がありません。

IP_BINDANY オプションが SOCK_STREAM, SOCK_DGRAM または SOCK_RAW ソケットで有効にされるなら、システムの任意の利用可能なネットワークインタフェースにもバインドされなかったものさえ、任意のアドレスに bind(2) (バインド) することができます。透明なプロキシを実装するために、(特別なファイアウォール規則に関連した) この機能を使用することができます。 PRIV_NETINET_BINDANY 特権は、このオプションを設定するために必要です。

IP_RECVTTL オプションが SOCK_DGRAM ソケットで有効にされるなら、 recvmsg(2) 呼び出しは、 UDP データグラムのために IP TTL (有効期間) フィールドを返します。 msghdr 構造体の msg_control フィールドは、 TTL が後に続く cmsghdr 構造体を含んでいるバッファを指します。 cmsghdr フィールドには、次の値があります:

cmsg_len = CMSG_LEN(sizeof(u_char)) 
cmsg_level = IPPROTO_IP 
cmsg_type = IP_RECVTTL

IP_RECVTOS オプションが SOCK_DGRAM ソケットで有効にされるなら、 recvmsg(2) 呼び出しは、 UDP データグラムのために IP TOS (type of service) フィールドを返します。 TOS が後続する cmsghdr 構造体を含むバッファを指す msghdr 構造体の msg_control フィールド。 cmsghdr フィールドには、次の値があります:

cmsg_len = CMSG_LEN(sizeof(u_char)) 
cmsg_level = IPPROTO_IP 
cmsg_type = IP_RECVTOS

IP_RECVIF オプションが SOCK_DGRAM ソケットで有効にされるなら、 recvmsg(2) 呼び出しは、パケットが受信されたインタフェースに対応する struct sockaddr_dl を返します。 msghdr 構造体の msg_control フィールドは、 struct sockaddr_dl が後に続く cmsghdr 構造体を含んでいるバッファを指します。 cmsghdr フィールドには、次の値があります:

cmsg_len = CMSG_LEN(sizeof(struct sockaddr_dl)) 
cmsg_level = IPPROTO_IP 
cmsg_type = IP_RECVIF

IP_PORTRANGE は、特定されていない (0) のポート番号のソケットでローカルポート番号を選択するために使用されるポート範囲を設定するために使用されます。それは、次の考えられる値があります:

IP_PORTRANGE_DEFAULT

通常 IPPORT_HIFIRSTAUTO から IPPORT_HILASTAUTO のデフォルト範囲の値を使用します。これは、次の sysctl 設定を通して調整できます: net.inet.ip.portrange.first と net.inet.ip.portrange.last です。

IP_PORTRANGE_HIGH

通常 IPPORT_HIFIRSTAUTO から IPPORT_HILASTAUTO の高い範囲の値を使用します。これは、次の sysctl 設定を通して調整できます: net.inet.ip.portrange.hifirst と net.inet.ip.portrange.hilast です。

IP_PORTRANGE_LOW

通常 UNIX システム上の特権があるプロセスに制限される、低い範囲のポートを使用します。範囲は、通常、降順で IPPORT_RESERVED - 1 から IPPORT_RESERVEDSTART までです。これは、次の sysctl 設定を通して調整できます: net.inet.ip.portrange.lowfirst と net.inet.ip.portrange.lowlast です。

ルートで所有されているプロセスでオープンされるだけの特権ポートの範囲は、 net.inet.ip.portrange.reservedlow と net.inet.ip.portrange.reservedhigh sysctl 設定によって変更されるかもしれません。伝統的な範囲のデフォルトの値は、それぞれ、0 から IPPORT_RESERVED - 1 (0 から 1023) です。これらの設定は、使用または上記の他の net.inet.ip.portrange 値の計算で影響しないて、説明されないことに注意してください。これらの値を変更することは、 UNIX 伝統から出発して、これらの設定を変更する前に管理者が慎重に評価するべきであるセキュリティ重要性があります。

ポートは、ランダムなりすまし攻撃の困難を増加させるために、指定されたポート範囲中でランダムに割り付けられます。ベンチマーキングのようなシナリオでは、この振る舞いは、望ましくないかもしれません。これらの場合、 net.inet.ip.portrange.randomized は、ランダム化をオフに切り換えるために使用することができます。最後の瞬間に net.inet.ip.portrange.randomcps ポート以上が割り付けられたなら、シリアルポート割り付けが返されます。少なくとも net.inet.ip.portrange.randomtime 秒のためにいったん net.inet.ip.portrange.randomcps を下まわる現在のポート割り付け率のみランダム割り付けを返します。 net.inet.ip.portrange.randomcps と net.inet.ip.portrange.randomtime のデフォルト値は、秒あたり 10 ポート割り付けと対応する 45 秒です。

u_char ttl; /* 範囲: 0 から 255, デフォルト = 1 */ 
setsockopt(s, IPPROTO_IP, IP_MULTICAST_TTL, &ttl, sizeof(ttl));

struct in_addr addr; 
setsockopt(s, IPPROTO_IP, IP_MULTICAST_IF, &addr, sizeof(addr));

u_char loop; /* 0 = 無効, 1 = 有効 (デフォルト) */ 
setsockopt(s, IPPROTO_IP, IP_MULTICAST_LOOP, &loop, sizeof(loop));

struct ip_mreq mreq; 
setsockopt(s, IPPROTO_IP, IP_ADD_MEMBERSHIP, &mreq, sizeof(mreq));

struct ip_mreq { 
    struct in_addr imr_multiaddr; /* グループの IP 
                                     マルチキャストアドレス */ 
    struct in_addr imr_interface; /* インタフェースの 
                                     ローカル IP アドレス */ 
}

struct ip_mreq mreq; 
setsockopt(s, IPPROTO_IP, IP_DROP_MEMBERSHIP, &mreq, sizeof(mreq));

struct ip_mreq_source mreqs; 
setsockopt(s, IPPROTO_IP, IP_BLOCK_SOURCE, &mreqs, sizeof(mreqs));

struct ip_mreq_source { 
    struct in_addr imr_multiaddr; /* グループの IP マルチキャストアドレス */ 
    struct in_addr imr_sourceaddr; /* ソースの IP アドレス */ 
    struct in_addr imr_interface; /* インタフェースのローカル IP アドレス */ 
}

struct ip_mreq_source mreqs; 
setsockopt(s, IPPROTO_IP, IP_UNBLOCK_SOURCE, &mreqs, sizeof(mreqs));

struct ip_mreq_source mreqs; 
setsockopt(s, IPPROTO_IP, IP_ADD_SOURCE_MEMBERSHIP, &mreqs, sizeof(mreqs));

struct ip_mreq_source mreqs; 
setsockopt(s, IPPROTO_IP, IP_DROP_SOURCE_MEMBERSHIP, &mreqs, sizeof(mreqs));

#include <netinet/in_systm.h> 
#include <netinet/ip.h> 
 
int hincl = 1;                  /* 1 = オン, 0 = オフ */ 
setsockopt(s, IPPROTO_IP, IP_HDRINCL, &hincl, sizeof(hincl));

ip->ip_v = IPVERSION; 
ip->ip_hl = hlen >> 2; 
ip->ip_id = 0;  /* 0 は、カーネルが適切な値を設定したことを意味します */ 
ip->ip_off = offset;

エラー

[ EISCONN]

既に接続があるソケットに接続を確立しようとしたとき、または宛先 (終点) アドレスが指定されたデータグラムを送信しようとし、ソケットが既に接続されているとき。

[ ENOTCONN]

データグラムを送信しようと試みるが、宛先 (終点) アドレスが指定されていない、そしてソケットが接続されていないとき。

[ ENOBUFS]

システムが内部のデータ構造のためのメモリを使い果たすとき。

[ EADDRNOTAVAIL]

ネットワークインタフェースが存在しないネットワークアドレスでソケットを作成する試みをするとき。

[ EACCES]

特権のないプロセスによって生の (raw) IP ソケットを作成する試みをするとき。

次の IP 特有のエラーは、 IP オプションを設定するか、または取得するとき生じるかもしれません:

[ EINVAL]

未知のソケットオプション名が与えられました。

[ EINVAL]

IP オプションフィールドは、不適切に形成されています。オプションフィールドが最小値より短いか、または提供されたオプションバッファがより長いということです。

IP_HDRINCL オプションセットがある“生のソケット”を通して IP データグラムの送信を試みるとき、次のエラーが生じるかもしれません:

[ EINVAL]

ユーザによって供給された ip_len フィールドは、ソケットに書き込まれたデータグラムの長さと等しくありませんでした。

関連項目

歴史

バグ