setsockopt()

struct  linger
{
        int     l_onoff;                /* option on/off */
        int     l_linger;               /* linger time */
};

オプション

説明

TCP_NODELAY

ソケットを介して送信されたすべてのデータについて、Nagle アルゴリズム (RFC 896) の使用を切り替えます。 このオプションは AF_IUCV ソケットではサポートされていません。 ほとんどの環境のもとでは、アプリケーションからデータが提示されたときに、TCP はデータを送信します。

ただし、未解決のデータに対して肯定応答がまだ受信されていないときは、 未解決のデータがすべて肯定応答されるまで、TCP は アプリケーションからの追加データの伝送を据え置きます。 Nagle アルゴリズムは、追加データを受け入れるために受信側のウィンドウが十分に開いている場合であっても、 この据え置きを実行します。 例えば、マウス・イベントというストリームを送るが応答を受け取らない対話式アプリケーションの場合、 伝送の据え置きの結果として大きな遅延が生じます。 このようなタイプのアプリケーションの場合は、Nagle アルゴリズムを使用不可にして応答時間を改善することができます。

注:

1. Nagle アルゴリズムが使用可能になっているとき、TCP は、 前のデータの肯定応答が受信されるまで、小さいパケットのデータを送るために待機します。
2. Nagle アルゴリズムが使用不可になっているとき、TCP は、 前のデータの肯定応答が受信される前でも、小さいパケットのデータを送ります。

キーワード

説明

SO_RCVBUF

OPTVAL に TCP/IP 受信バッファーのデータ部分のサイズをセットしま す。 受信バッファーのデータ部分のサイズは、各プロトコルごとに決まっています。 要求されたサイズが許容サイズを超える場合は、次のようになります。

• TCP プロトコルを使用している場合は、-1 という戻り値と ENOBUFS の errno が設定されます。 受信バッファーのサイズは変更されません。

  TCP プロトコルの最大値については、「z/OS Communications Server: IP 構成解説書」の TCPCONFIG TCPRCVBUFRSIZE および TCPMAXRCVBUFSIZE パラメーターを参照してください。

• UDP または RAW プロトコルを使用している場合は、ゼロの戻り値が戻され、 バッファー・サイズが 65535 にセットされます。

SO_SNDBUF

OPTVAL に TCP/IP 送信バッファーのデータ部分のサイズをセットします。 送信バッファーのデータ部分のサイズは、各プロトコルごとに決まっています。 要求されたサイズが許容サイズを超える場合は、次のようになります。

• TCP プロトコルを使用している場合は、-1 という戻り値と ENOBUFS の errno が設定されます。 TCP 接続の送信バッファー・サイズは最大サイズに設定されます。 送信バッファー・サイズの値は、GETSOCKOPT を SO_SNDBUF に対して実行することによって取得できます。

  TCP プロトコルの最大値については、「z/OS Communications Server: IP 構成解説書」の TCPCONFIG TCPSENDBUFRSIZE パラメーターを 参照してください。

• UDP または RAW プロトコルを使用している場合は、ゼロの戻り値が戻され、 バッファー・サイズが 65535 にセットされます。

SO_BROADCAST

メッセージをブロードキャストする機能を切り替えます。 デフォルト値は disabled です。このオプションを使用可能にすると、宛先で指定された インターフェースがパケットのブロードキャストをサポートしている場合は、アプリケーション が s を使用してブロードキャスト・メッセージを送信できるようになります。ストリーム・ソケットの場合は、このオプションに意味はありません。

SO_KEEPALIVE

ストリーム・ソケット用の TCP キープアライブ・メカニズムを切り替えます。デフォルト値は disabled です。キープアライブ・メカニズムは活動化されると、 それ以外のときはアイドル状態にある接続にパケットを定期的に送信します。リモート TCP が このパケットに対してまたはこのパケットが再送された際に応答しない場合は、 その接続は終了してエラー ETIMEDOUT が発行されます。

SO_LINGER

データがある場合、クローズを延長します。 デフォルト値は disabled です。close() が呼び出されたときにこのオプションが使用可能になっており、かつ未送信の データがある場合には、呼び出しアプリケーションは close() 呼び出しの間、その データが伝送されるまでまたはその接続がタイムアウトになるまでブロックされます。この オプションが使用不可である場合は、close() 呼び出しは呼び出し側をブロックすることなく 制御を戻し、TCP/IP アドレス・スペースはデータの送信を試みるためにそのまま待ちます。通常、データ転送は正常に行われますが、それが保証されているわけではありません。なぜなら、データ送信試行時に TCP/IP アドレス・スペースが待ち状態になっている時間は非常に限られているからです。このオプションは、ストリーム・ソケットの場合のみ意味をもちます。

SO_OOBINLINE

アウト・オブ・バンド・データの受信のトグルを行います。デフォルト値は disabled です。このオプションを使用可能にすると、アウト・オブ・バンド・データは 受信された順に通常のデータ入力キューに入れられるため、recv()、recvfrom()、およ び recvmsg() の呼び出し時に MSG_OOB フラグを指定しなくても、これらの関数で アウト・オブ・バンド・データを使用することができます。 このオプションを使用不可にすると、アウト・オブ・バンド・データは受信された順に 優先順位付きデータ入力キューに入れられるため、アウト・オブ・バンド・データ を recv()、recvfrom()、および recvmsg() で使用することができるのは、その 呼び出し時に MSG_OOB フラグを指定した場合のみとなります。このオプションは、ストリーム・ソケットの場合のみ意味をもちます。

SO_REUSEADDR

ローカル・アドレスの再利用を切り替えます。 デフォルトでは、使用不可 (disabled) です。 これは、bind() 呼び出しで使用される通常アルゴリズムを更新します。

通常 bind() 呼び出しのアルゴリズムでは、各 IP アドレスとポートの 組み合わせを一度だけバインドできます。 アドレスとポートが既にバインドされている場合は、 後続の bind() は失敗し、エラー EADDRINUSE を戻します。

'SO_REUSEADDR' オプションが活動状態になると、 以下の状態がサポートされます。

• サーバーは、すべての呼び出しが異なるローカル IP アドレスを使用している限り、同じ ポートを複数回 bind() できます。ワイルドカード・アドレスの INADDR_ANY は、各ポート ごとに一度だけ使用されます。
• クライアント接続がアクティブのサーバーは、再始動可能であり、クライアント接続のすべてを クローズしなくても、そのポートにバインドできます。
• データグラム・ソケットの場合、マルチキャストがサポートされているので、bind() 呼び出しを 同じクラス D アドレスおよびポート番号に対して行うことができます。

オプション

説明

IP_MULTICAST_TTL

発信用のマルチキャスト・データグラムの IP 存続時間を設定します。 デフォルト値は 1 (ローカル・サブネットについてのみマルチキャストが使用できる) です。

IP_MULTICAST_LOOP

発信用のマルチキャスト・データグラムのループバックを使用可能あるいは使用不可にします。 デフォルトでは有効になっています。

IP_MULTICAST_IF

ソケット・アプリケーションから アウトバウンド・マルチキャスト・データグラムを送信するためのインターフェースをセットします。

注: マルチキャスト・データグラムを同時に複数のインターフェースで送信することはできません。

IP_ADD_MEMBERSHIP

特定のインターフェースでマルチキャスト・グループに参加します。 このオプションでは 1 つのインターフェースを指定してください。 マルチキャスト・データグラムを受け取る必要があるアプリケーションのみ、マルチキャスト・グループに参加する必要があります。

IP_DROP_MEMBERSHIP

マルチキャスト・グループから離脱します。

Errno

説明

EBADF

s パラメーターは、有効なソケット記述子ではありません。

EFAULT

パラメーター optval および optlen を使用すると、その結果として、呼び出し側のアドレス・スペースの外側のストレージへのアクセスが試みられる可能性があります。

ENOBUFS

使用可能なバッファー・スペースがありません。

ENOPROTOOPT

optname パラメーターが認識されないか、または level パラメーターが SOL_SOCKET ではありません。