socket - 約束事その他の説明 - Linux コマンド集 一覧表

socket - Linux のソケットインターフェース

#include <sys/socket.h>
mysocket = socket(int socket_family , int socket_type , int protocol );

このマニュアルページは Linux ネットワークのソケット層に対する ユーザインターフェースを記述するものである。 BSD 互換ソケットは、ユーザプロセスとカーネル内部の ネットワークプロトコルスタック群との間に、 統一的なインターフェースを提供するものである。 プロトコルモジュールは "プロトコルファミリー (protocol familiy)" (例： PF_INET , PF_IPX , PF_PACKET )と "ソケットタイプ (socket types)" (例： SOCK_STREAM , SOCK_DGRAM )に分類できる。 これらに関するより詳しい情報は   socket (2) を参照のこと。

これらの関数はユーザプロセスがパケットを送受信したり、その他のソケット操作を 行ったりするために用いられる。詳細はそれぞれのマニュアルページを 見てほしい。
  socket (2) はソケットを生成する。   connect (2) はソケットをリモートのソケットアドレスに接続する。   bind (2) はソケットをローカルのソケットアドレスにバインドする。   listen (2) はソケットに新しい接続が来たら受信するように伝え、   accept (2) は外部からやってきた接続に対して新しいソケットを得るために用いられる。   socketpair (2) は互いに接続された二つの名前無しソケット (anonymous socket) を返す ( PF_UNIX のような、いくつかのローカルなファミリーでしか実装されていない)。

  send (2),  sendto (2), sendmsg (2)はソケットを通してデータを送信し、   recv (2)  recvfrom (2), recvmsg (2)はソケットからデータを受信する。   poll (2) と   select (2) はデータの到着を待ったり、データ送信の準備ができるまで待ったりする。 さらに、   write (2),  writev (2),  sendfile (2),   read (2),  readv (2) のような標準的な I/O 操作もデータの読み書きに用いることができる。

getsockbyname (2)はローカルのソケットアドレスを返し、   getpeername (2) はリモートのソケットアドレスを返す。   getsockopt (2) と setsockopt (2)はソケット層のオプションやプロトコルオプションの取得・設定に用いられる。 他のいくつかのオプションの取得・設定には   ioctl (2) を使うことができる。

  close (2) はソケットをクローズする。   shutdown (2) は全二重なソケット接続を部分的にクローズする。

シーク動作や、 0 以外の位置に対する   pread (2) や pwrite (2)はソケットではサポートされていない。

非ブロッキングな I/O をソケットで行うことは可能で、   fcntl (2) を使ってソケットのファイルディスクリプタに O_NONBLOCK フラグをセットすれば良い。 こうするとブロックされる操作は、 (通常) EAGAIN エラーで戻ることになる (後で処理が再試行されることが期待されている)。   connect (2) では EINPROGRESS エラーが返される。 この場合、ユーザはさまざまなイベントを   poll (2) や   select (2) を使って待つことができる。

.TS tab(:) allbox; c s s l l l. I/O イベント イベント:poll フラグ:内容 Read:POLLIN:T{ 新しいデータが到着した。 T} Read:POLLIN:T{ (接続志向のソケットで) 接続の設定が終了した。 T} Read:POLLHUP:T{ 接続先で切断要求が生成された。 T} Read:POLLHUP:T{ 接続が壊れた (接続志向のプロトコルのみ)。 この場合、ソケットに書き込みが行われると SIGPIPE も送信される。 T} Write:POLLOUT:T{ ソケットには新しいデータを書き込むのに 充分なバッファ領域がある。 T} Read/Write:T{ POLLIN|
POLLOUT T}:T{ 外部向けの   connect (2) が終了した。 T} Read/Write:POLLERR:T{ 非同期的 (asynchronous) なエラーが起こった。 T} Read/Write:POLLHUP:接続先が片方向を切断した。 Exception:POLLPRI:T{ 緊急データ (urgent data) が到着した。 この場合は SIGURG が送信される。 T}

poll ()や select ()を使う代わりに、カーネルからアプリケーションに イベントを通知させるのに SIGIO シグナルを使う方法もある。 この方法を使うには、   fcntl (2) を用いてソケットのファイルディスクリプタに FASYNC フラグをセットし、 SIGIO に対する有効なシグナルハンドラを   sigaction (2) によって設定しておく必要がある。 後述の シグナル に関する議論も参考にすること。

これらのソケットオプションは、 setsockopt (2)を用いれば設定でき、   getsockopt (2) を用いれば取得できる。 但し、どのソケットの場合も ソケットレベルには SOL_SOCKET を指定すること。

SO_ACCEPTCONN

このソケットが   listen (2) によって接続待ち受け状態に設定されているかどうかを示す値を返す。 値 0 は listen 状態のソケットでないことを、 値 1 は listen 状態のソケットであることを示す。 getsockopt ()からのみ読み出し可能である。

SO_BSDCOMPAT

BSD のバグに対して互換性を取るための機能を有効にする。 この機能は Linux 2.0 と 2.2 の UDP プロトコルモジュールで使用されている。 有効になっていると、 UDP ソケットで受信された ICMP エラーは ユーザプログラムに渡されない。 これ以降のバージョンのカーネルでは、このオプションのサポートは 段階的に廃止されてきた。 Linux 2.4 ではこのオプションは黙って無視され、 Linux 2.6 ではプログラムがこのオプションを使用すると (printk() を使って) カーネルの警告メッセージが出力される。 Linux 2.0 では、このオプションを指定すると、 raw ソケットにおいても BSD のバグ (ランダムヘッダ変更、 ブロードキャストフラグのスキップ) に対する互換機能が有効になっていた。 しかし、こちらは Linux 2.2 で削除された。

SO_BINDTODEVICE

このソケットを、引き数で渡したインターフェース名で指定される (\(lqeth0\(rq のような) 特定のデバイスにバインドする。 名前が空文字列だったり、オプションの長さ (optlen) が 0 の場合には、 ソケットのバインドが削除される。渡すオプションは、インターフェース名が 入ったヌル文字で終端された可変長の文字列である。 文字列の最大のサイズは IFNAMSIX である。 ソケットがインターフェースにバインドされると、 その特定のインターフェースから受信されたパケットだけを処理する。 このオプションはいくつかのソケットタイプ、特に AF_INET に対してのみ動作する点に注意すること。 パケットソケットではサポートされていない (通常の bind (8)を使うこと)。

SO_BROADCAST

ブロードキャストフラグを設定・取得する。有効になっていると、 データグラムソケットはブロードキャストアドレスに送られたパケットを受信したり、 ブロードキャストアドレスにパケットを送信したりできるようになる。 ストリーム指向のソケットには何の効果もない。

SO_DEBUG

ソケットのデバッグ機能を有効にする。 CAP_NET_ADMIN 権限を持つプロセスか、実効ユーザ ID が 0 のプロセスでしか 利用できない。

SO_ERROR

保留になっていたソケットエラーを取得してクリアする。 getsockopt ()でのみ用いることができる。 整数値をとる。

SO_DONTROUTE

ゲートウェイを経由せず、直接接続されているホストに送信する。   send (2) 操作で MSG_DONTROUTE フラグをセットした場合も同じ効果が得られる。 ブール整数のフラグを取る。

SO_KEEPALIVE

接続志向のソケットに対する keep-alive メッセージの送信を有効にする。 ブール値の整数フラグをとる。

SO_LINGER

SO_LINGER オプションを取得・設定する。引き数には linger 構造体を取る。

struct linger {
    int l_onoff;    /* linger active */
    int l_linger;   /* how many seconds to linger for */
};

有効になっていると、   close (2) や   shutdown (2) は、そのソケットにキューキングされたメッセージがすべて送信完了するか、 linger (居残り) タイムアウトになるまで返らない。無効になっていると、 これらのコールはただちに戻り、クローズ動作はバックグラウンドで行われる。 ソケットのクローズを   exit (2) の一部として行った場合には、残っているソケットの クローズ動作は必ずバックグラウンドに送られる。

SO_OOBINLINE

このオプションを有効にすると、帯域外データ (out-of-band data) は 受信データストリーム中に置かれる。有効にしなければ、 帯域外データは受信時に MSG_OOB フラグがセットされている場合に限って渡される。

SO_PASSCRED

SCM_CREDENTIALS 制御メッセージの受信を有効/無効にする。詳細は   unix (7) を参照のこと。

SO_PEERCRED

このソケットに接続してきた外部プロセスの信任状 (credential) を返す。 このソケットオプションが利用できるのは、 接続された PF_UNIX ストリームソケット間、および   socketpair (2) を使って作成された PF_UNIX のストリームソケットとデータグラムソケットのペアだけである。   unix (7) を参照のこと。   connect (2) や   socketpair (2) が呼ばれた時に有効であった信任状が返される。 引き数は ucred 構造体である。 getsockopt ()でのみ用いることができる。

SO_PRIORITY

プロトコルで定義された優先度を、このソケットから 送信される全てのパケットにセットする。 Linux はネットワークキュー内部の 整列にこの値を用いる。高い優先度を持っているパケットは先に処理される。 ただしそのデバイスのキュー処理のやり方に依存する。   ip (7) では、外向けパケットの IP type-of-service (TOS) フィールドにもこの値が設定される。 0 から 6 以外の優先度をセットするには CAP_NET_ADMIN ケーパビリティが必要である。

SO_RCVLOWAT と SO_SNDLOWAT

バッファ中に溜めることのできるデータの最小値を指定する。 このサイズを越えると、ソケット層はそのデータをプロトコルに渡し ( SO_SNDLOWAT )、受信時にはユーザに渡す ( SO_RCVLOWAT )。これら二つの値は 1 に初期化される。 SO_SNDLOWAT は Linux では変更できない ( setsockopt は ENOPROTOOPT エラーで失敗する)。 SO_RCVLOWAT は Linux 2.4 以降でのみ変更可能である。 現状、Linux ではシステムコール   select (2) と   poll (2) は SO_RCVLOWAT の設定を考慮に入れずに動作し、 データが1バイト利用可能になっただけでも、 ソケットは読み出し可能とのマークをつける。 一方、それに続けて行うソケットからの read は SO_RCVLOWAT バイトのデータが利用可能になるまで停止してしまう。

SO_RCVTIMEO と SO_SNDTIMEO

送信・受信のタイムアウトを指定する。これを越えるとエラーを報告する。 引き数は "struct timeval" である。 入出力関数がタイムアウト時間の間ブロックされ、かつデータの送信または 受信が行われていた場合は、転送されたデータ量が関数の返り値となる。 何もデータが転送されずにタイムアウトに達した場合は、 -1 を返し、 errno に EAGAIN か EWOULDBLOCK を設定され、 あたかもソケットに非ブロッキングが指定されたように見える。 タイムアウト値に (デフォルト値である) 0 に設定すると、 操作は決してタイムアウトしなくなる。

SO_RCVBUF

ソケットの受信バッファの最大サイズを設定・取得する (バイト単位)。 setsockopt ()を使って値が設定されたときに (管理オーバヘッド用の領域を確保するために) カーネルはこの値を 2倍し、 getsockopt ()はこの 2倍された値を返す。 デフォルトの値は rmem_default sysctl で設定され、許容される最大の値は rmem_max sysctl で設定される。 このオプションの最小値は (2倍した値で) 256 である。

SO_RCVBUFFORCE (Linux 2.6.14 以降)

このソケットオプションを使うと、特権プロセス ( CAP_NET_ADMIN を持つプロセス) は SO_RCVBUF と同じことを実行できる。 ただし、上限 rmem_max を上書きすることができる。

SO_REUSEADDR

  bind (2) コールに与えられたアドレスが正しいかを判断するルールで、 ローカルアドレスの再利用を可能にする。 つまり PF_INET ソケットなら、そのアドレスにバインドされたアクティブな listen 状態のソケットが存在しない限り、バインドが行える。 listen 状態のソケットがアドレス INADDR_ANY で特定のポートにバインドされている場合には、 このポートに対しては、どんなローカルアドレスでもバインドできない。

SO_SNDBUF

ソケットの送信バッファの最大サイズを設定・取得する (バイト単位)。 setsockopt ()を使って値が設定されたときに (管理オーバヘッド用の領域を確保するために) カーネルはこの値を 2倍し、 getsockopt ()はこの 2倍された値を返す。 デフォルトの値は wmem_default sysctl で設定され、許容される最大の値は wmem_max sysctl で設定される。 このオプションの最小値は (2倍した値で) 2048 である。

SO_SNDBUFFORCE (Linux 2.6.14 以降)

このソケットオプションを使うと、特権プロセス ( CAP_NET_ADMIN を持つプロセス) は SO_SNDBUF と同じことを実行できる。 ただし、上限 wmem_max を上書きすることができる。

SO_TIMESTAMP

SO_TIMESTAMP 制御メッセージの受信を有効/無効にする。 タイムスタンプ制御メッセージはレベル SOL_SOCKET で送信され、 cmsg_data フィールドはこのシステムコールでユーザに渡した 最後のパケットの受信時刻を示す "struct timeval" である。 制御メッセージの詳細については   cmsg (3) を参照。

SO_TYPE

ソケットのタイプを整数で取得する (例: SOCK_STREAM )。 getsockopt ()からのみ読み出し可能である。

(ローカルもしくはリモート側で) 切断された 接続指向 (connection-oriented) のソケットに対して 書き込みを行うと、その書き込みを行ったプロセスに SIGPIPE が送られ、 EPIPE が返される。 write 呼び出しに MSG_NOSIGNAL フラグを指定していた場合はシグナルは送られない。

FIOSETOWN fcntl ()や SIOCSPGRP ioctl ()をプロセスまたはプロセスグループに指定しておくと、 I/O イベントが起きたときに SIGIO が送られる。   poll (2) や   select (2) をシグナルハンドラ内で用いれば、どのソケットでイベントが起こったかを 知ることができる。 (Linux 2.2 における) 別の方法としては、 F_SETSIG fcntl ()を用いてリアルタイムシグナルを設定するやり方もある。 リアルタイムシグナルのハンドラは、 siginfo_t の si_fd フィールドにファイルディスクリプタが入った状態で呼び出される。 詳細は   fcntl (2) を参照のこと。

状況によっては (例えば複数のプロセスが一つのソケットにアクセスしているなど)、 SIGIO の原因となった状態は、プロセスがそのシグナルへの対応を行ったときには 消えてしまっているかもしれない。 この場合は、プロセスは再び待つようにすべきである。 Linux は同じシグナルを後で再送するからである。

core ソケットのネットワーキング sysctl にアクセスするには、 /proc/sys/net/core/* ファイルを通して行うか、   sysctl (2) のインターフェースを用いる。

rmem_default

ソケットの受信バッファサイズのデフォルト値 (バイト単位)。

rmem_max

SO_RCVBUF ソケットオプションを用いてユーザが設定できる ソケットの受信バッファサイズの最大値 (バイト単位)。

wmem_default

ソケットの送信バッファサイズのデフォルト値 (バイト単位)。

wmem_max

SO_SNDBUF ソケットオプションを用いてユーザが設定できる ソケットの送信バッファサイズの最大値 (バイト単位)。

message_cost と message_burst

トークン・バケット・フィルターを設定する。 これは外部のネットワークイベントによって引き起こされた 負荷限界の警告メッセージに用いられる。

netdev_max_backlog

グローバルな入力キューにおける最大のパケット数。

optmem_max

ソケットあたりの、補助データ (ancillary data) とユーザ制御データ (iovecs のようなもの) との和の最大長。

以下に示す操作には   ioctl (2) を用いてアクセスできる。

error = ioctl(ip_socket, ioctl_type, &value_result);

SIOCGSTAMP

最後にユーザに渡されたパケットの受信タイムスタンプを struct timeval に入れて返す。 これは round trip 時間を正確に測りたいときに便利である。 struct timeval の説明は setitimer (2)を見てほしい。 この ioctl は、ソケットオプション SO_TIMESTAMP がソケットにセットされていない場合にのみ使用すべきである。 さもなければ、この ioctl は SO_TIMESTAMP がセットされていなかった間に受信した最後のパケットの時刻を返すか、 そのようなパケットを受信していない場合には失敗する (つまり、 ioctl ()は -1 を返し、 errno に ENOENT をセットする)。

SIOCSPGRP

非同期 I/O 操作の終了時や緊急データの受信時に SIGIO や SIGURG シグナル群を送るプロセスやプロセスグループを設定する。 引き数は pid_t へのポインタである。 引き数が正だと、そのプロセスにシグナルが送られる。負だと、 引き数の絶対値を ID に持つプロセスグループにシグナルが送られる。 シグナル受信先には、自分自身のプロセス / 自分の所属するプロセスグループ しか指定できない。但し、 CAP_KILL ケーパビリティを持っている場合、及び実効ユーザ ID が 0 のプロセスの場合は この限りではない。

FIOASYNC

O_ASYNC フラグを変更し、ソケットの非同期 (asynchronous) I/O モードを 有効/無効にする。非同期 I/O モードでは、 新しい I/O イベントが起きたときに、 SIGIO シグナルや F_SETSIG で設定されたシグナル・セットが発行される。
引き数はブール整数のフラグである。

SIOCGPGRP

SIGIO や SIGURG を受信したカレントプロセス・プロセスグループを取得する。 ない場合は 0 が返る。

有効な fcntl ()操作:

FIOGETOWN

SIOCGPGRP ioctl ()と同じ。

FIOSETOWN

SIOCSPGRP ioctl ()と同じ。

Linux は、送受信バッファの半分を内部のカーネル構造体で用いると仮定している。 したがって sysctl はネットの回線上での大きさの 2 倍になる。
Linux では、SO_REUSEADDR オプションでポートの再利用が許可されるのは、 そのポートに対して bind ()を前に実行したプログラムとそのポートを再利用 しようとするプログラムの両方で SO_REUSEADDR がセットされた場合のみである。 この動作は (FreeBSD などの) いくつかの実装とは異なる。これらでは、 後でポートを再利用しようとするプログラムで SO_REUSEADDR オプションを セットするだけでよい。 たいていはこの違いは見えない。なぜなら、例えばサーバプログラムは 常にこのオプションをセットするように設計されるからである。

CONFIG_FILTER ソケットオプションである SO_ATTACH_FILTER と SO_DETACH_FILTER について記載されていない。これらは libpcap ライブラリを通して 用いる方が良い。

SO_BINDTODEVICE は Linux 2.0.30 で導入された。 SO_PASSCRED は Linux 2.2 で登場した。 sysctl も Linux 2.2 で登場した。 SO_RCVTIMEO と SO_SNDTIMEO は Linux 2.3.41 以降でサポートされている。 それ以前は、タイムアウトはプロトコル固有の固定の設定値で、 読み書きをすることはできなかった。

  getsockopt (2),  setsockopt (2),  socket (2),   capabilities (7),   ddp (7),   ip (7),   packet (7)