release/man7/socket.7

   1 .\" t
   2 .\" This man page is Copyright (C) 1999 Andi Kleen <ak@muc.de>.
   3 .\" and copyright (c) 1999 Matthew Wilcox.
   4 .\"
   5 .\" %%%LICENSE_START(VERBATIM_ONE_PARA)
   6 .\" Permission is granted to distribute possibly modified copies
   7 .\" of this page provided the header is included verbatim,
   8 .\" and in case of nontrivial modification author and date
   9 .\" of the modification is added to the header.
  10 .\" %%%LICENSE_END
  11 .\"
  12 .\" 2002-10-30, Michael Kerrisk, <mtk.manpages@gmail.com>
  13 .\"     Added description of SO_ACCEPTCONN
  14 .\" 2004-05-20, aeb, added SO_RCVTIMEO/SO_SNDTIMEO text.
  15 .\" Modified, 27 May 2004, Michael Kerrisk <mtk.manpages@gmail.com>
  16 .\"     Added notes on capability requirements
  17 .\"     A few small grammar fixes
  18 .\" 2010-06-13 Jan Engelhardt <jengelh@medozas.de>
  19 .\"     Documented SO_DOMAIN and SO_PROTOCOL.
  20 .\" FIXME
  21 .\" The following are not yet documented:
  22 .\"     SO_PEERNAME (2.4?)
  23 .\"             get only
  24 .\"             Seems to do something similar to getpeernam(), but then
  25 .\"             why is it necessary / how does it differ?
  26 .\"     SO_TIMESTAMPNS (2.6.22)
  27 .\"             Documentation/networking/timestamping.txt
  28 .\"             commit 92f37fd2ee805aa77925c1e64fd56088b46094fc
  29 .\"             Author: Eric Dumazet <dada1@cosmosbay.com>
  30 .\"     SO_TIMESTAMPING (2.6.30)
  31 .\"             Documentation/networking/timestamping.txt
  32 .\"             commit cb9eff097831007afb30d64373f29d99825d0068
  33 .\"             Author: Patrick Ohly <patrick.ohly@intel.com>
  34 .\"     SO_RXQ_OVFL (2.6.33)
  35 .\"             commit 3b885787ea4112eaa80945999ea0901bf742707f
  36 .\"             Author: Neil Horman <nhorman@tuxdriver.com>
  37 .\"     SO_WIFI_STATUS (3.3)
  38 .\"             commit 6e3e939f3b1bf8534b32ad09ff199d88800835a0
  39 .\"             Author: Johannes Berg <johannes.berg@intel.com>
  40 .\"             Also: SCM_WIFI_STATUS
  41 .\"     SO_PEEK_OFF (3.4)
  42 .\"             commit ef64a54f6e558155b4f149bb10666b9e914b6c54
  43 .\"             Author: Pavel Emelyanov <xemul@parallels.com>
  44 .\"     SO_NOFCS (3.4)
  45 .\"             commit 3bdc0eba0b8b47797f4a76e377dd8360f317450f
  46 .\"             Author: Ben Greear <greearb@candelatech.com>
  47 .\"
  48 .\"*******************************************************************
  49 .\"
  50 .\" This file was generated with po4a. Translate the source file.
  51 .\"
  52 .\"*******************************************************************
  53 .TH SOCKET 7 2013\-03\-15 Linux "Linux Programmer's Manual"
  54 .SH 名前
  55 socket \- Linux のソケットインターフェース
  56 .SH 書式
  57 \fB#include <sys/socket.h>\fP
  58 .sp
  59 \fIsockfd\fP\fB = socket(int \fP\fIsocket_family\fP\fB, int \fP\fIsocket_type\fP\fB, int
  60 \fP\fIprotocol\fP\fB);\fP
  61 .SH 説明
  62 このマニュアルページは Linux ネットワークのソケット層に対する ユーザインターフェースを記述するものである。 BSD
  63 互換ソケットは、ユーザプロセスとカーネル内部の ネットワークプロトコルスタック群との間に、 統一的なインターフェースを提供するものである。
  64 プロトコルモジュールは \fIプロトコルファミリー (protocol familiy)\fP (例： \fBAF_INET\fP, \fBAF_IPX\fP,
  65 \fBAF_PACKET\fP)  と \fIソケットタイプ (socket types)\fP (例： \fBSOCK_STREAM\fP,
  66 \fBSOCK_DGRAM\fP)  に分類できる。 これらに関するより詳しい情報は \fBsocket\fP(2)  を参照のこと。
  67 .SS ソケット層の関数群
  68 これらの関数はユーザプロセスがパケットを送受信したり、その他のソケット操作を 行ったりするために用いられる。詳細はそれぞれのマニュアルページを
  69 見てほしい。
  70
  71 \fBsocket\fP(2)  はソケットを生成する。 \fBconnect\fP(2)  はソケットをリモートのソケットアドレスに接続する。
  72 \fBbind\fP(2)  はソケットをローカルのソケットアドレスにバインドする。 \fBlisten\fP(2)
  73 はソケットに新しい接続が来たら受信するように伝え、 \fBaccept\fP(2)  は外部からやってきた接続に対して新しいソケットを得るために用いられる。
  74 \fBsocketpair\fP(2)  は互いに接続された二つの名前無しソケット (anonymous socket) を返す (\fBAF_UNIX\fP
  75 のような、いくつかのローカルなファミリーでしか実装されていない)。
  76 .PP
  77 \fBsend\fP(2), \fBsendto\fP(2), \fBsendmsg\fP(2)  はソケットを通してデータを送信し、 \fBrecv\fP(2)
  78 \fBrecvfrom\fP(2), \fBrecvmsg\fP(2)  はソケットからデータを受信する。 \fBpoll\fP(2)  と \fBselect\fP(2)
  79 はデータの到着を待ったり、データ送信の準備ができるまで待ったりする。 さらに、 \fBwrite\fP(2), \fBwritev\fP(2),
  80 \fBsendfile\fP(2), \fBread\fP(2), \fBreadv\fP(2)  のような標準的な I/O 操作もデータの読み書きに用いることができる。
  81 .PP
  82 \fBgetsockbyname\fP(2)  はローカルのソケットアドレスを返し、 \fBgetpeername\fP(2)
  83 はリモートのソケットアドレスを返す。 \fBgetsockopt\fP(2)  と \fBsetsockopt\fP(2)
  84 はソケット層のオプションやプロトコルオプションの取得・設定に用いられる。 他のいくつかのオプションの取得・設定には \fBioctl\fP(2)
  85 を使うことができる。
  86 .PP
  87 \fBclose\fP(2)  はソケットをクローズする。 \fBshutdown\fP(2)  は全二重なソケット接続を部分的にクローズする。
  88 .PP
  89 シーク動作や、 0 以外の位置に対する \fBpread\fP(2)  や \fBpwrite\fP(2)  はソケットではサポートされていない。
  90 .PP
  91 非ブロッキングな I/O をソケットで行うことは可能で、 \fBfcntl\fP(2)  を使ってソケットのファイルディスクリプタに
  92 \fBO_NONBLOCK\fP フラグをセットすれば良い。 こうするとブロックされる操作は、 (通常)  \fBEAGAIN\fP エラーで戻ることになる
  93 (後で処理が再試行されることが期待されている)。 \fBconnect\fP(2)  では \fBEINPROGRESS\fP エラーが返される。
  94 この場合、ユーザはさまざまなイベントを \fBpoll\fP(2)  や \fBselect\fP(2)  を使って待つことができる。
  95 .TS
  96 tab(:) allbox;
  97 c s s
  98 l l l.
  99 I/O イベント
 100 イベント:poll フラグ:内容
 101 Read:POLLIN:T{
 102 新しいデータが到着した。
 103 T}
 104 Read:POLLIN:T{
 105 (接続志向のソケットで)
 106 接続の設定が終了した。
 107 T}
 108 Read:POLLHUP:T{
 109 接続先で切断要求が生成された。
 110 T}
 111 Read:POLLHUP:T{
 112 接続が壊れた (接続志向のプロトコルのみ)。
 113 この場合、ソケットに書き込みが行われると
 114 \fBSIGPIPE\fP
 115 も送信される。
 116 T}
 117 Write:POLLOUT:T{
 118 ソケットには新しいデータを書き込むのに充分なバッファ領域がある。
 119 T}
 120 Read/Write:T{
 121 POLLIN|
 122 .br
 123 POLLOUT
 124 T}:T{
 125 外部向けの
 126 \fBconnect\fP(2)
 127 が終了した。
 128 T}
 129 Read/Write:POLLERR:非同期的 (asynchronous) なエラーが起こった。
 130 Read/Write:POLLHUP:接続先が片方向を切断した。
 131 Exception:POLLPRI:T{
 132 緊急データ (urgent data) が到着した。この場合は
 133 \fBSIGURG\fP
 134 が送信される。
 135 T}
 136 .\" FIXME . The following is not true currently:
 137 .\" It is no I/O event when the connection
 138 .\" is broken from the local end using
 139 .\" .BR shutdown (2)
 140 .\" or
 141 .\" .BR close (2).
 142 .TE
 143 .PP
 144 \fBpoll\fP(2)  や \fBselect\fP(2)  を使う代わりに、カーネルからアプリケーションに イベントを通知させるのに \fBSIGIO\fP
 145 シグナルを使う方法もある。 この方法を使うには、 \fBfcntl\fP(2)  を用いてソケットのファイルディスクリプタに \fBO_ASYNC\fP
 146 フラグをセットし、 \fBSIGIO\fP に対する有効なシグナルハンドラを \fBsigaction\fP(2)  によって設定しておく必要がある。 後述の
 147 \fIシグナル\fP に関する議論も参考にすること。
 148 .SS "Socket address structures"
 149 Each socket domain has its own format for socket addresses, with a
 150 domain\-specific address structure.  Each of these structures begins with an
 151 integer "family" field (typed as \fIsa_family_t\fP)  that indicates the type of
 152 the address structure.  This allows the various system calls (e.g.,
 153 \fBconnect\fP(2), \fBbind\fP(2), \fBaccept\fP(2), \fBgetsockname\fP(2),
 154 \fBgetpeername\fP(2)), which are generic to all socket domains, to determine
 155 the domain of a particular socket address.
 156
 157 To allow any type of socket address to be passed to interfaces in the
 158 sockets API, the type \fIstruct sockaddr\fP is defined.  The purpose of this
 159 type is purely to allow casting of domain\-specific socket address types to a
 160 "generic" type, so as to avoid compiler warnings about type mismatches in
 161 calls to the sockets API.
 162
 163 In addition, the sockets API provides the data type \fIstruct
 164 sockaddr_storage\fP.  This type is suitable to accommodate all supported
 165 domain\-specific socket address structures; it is large enough and is aligned
 166 properly.  (In particular, it is large enough to hold IPv6 socket
 167 addresses.)  The structure includes the following field, which can be used
 168 to identify the type of socket address actually stored in the structure:
 169
 170 .in +4n
 171 .nf
 172     sa_family_t ss_family;
 173 .fi
 174 .in
 175
 176 The \fIsockaddr_storage\fP structure is useful in programs that must handle
 177 socket addresses in a generic way (e.g., programs that must deal with both
 178 IPv4 and IPv6 socket addresses).
 179 .SS ソケットオプション
 180 .\" FIXME
 181 .\" In the list below, the text used to describe argument types
 182 .\" for each socket option should be more consistent
 183 .\"
 184 .\" SO_ACCEPTCONN is in POSIX.1-2001, and its origin is explained in
 185 .\" W R Stevens, UNPv1
 186 これらのソケットオプションは、 \fBsetsockopt\fP(2)  を用いれば設定でき、 \fBgetsockopt\fP(2)  を用いれば取得できる。
 187 但し、どのソケットの場合も ソケットレベルには \fBSOL_SOCKET\fP を指定すること。
 188 .TP
 189 \fBSO_ACCEPTCONN\fP
 190 このソケットが \fBlisten\fP(2)  によって接続待ち受け状態に設定されているかどうかを示す値を返す。 値 0 は listen
 191 状態のソケットでないことを、 値 1 は listen 状態のソケットであることを示す。このソケットオプションは読み込み専用である。
 192 .TP
 193 \fBSO_BINDTODEVICE\fP
 194 このソケットを、引き数で渡したインターフェース名で指定される
 195 (\(lqeth0\(rq のような) 特定のデバイスにバインドする。
 196 名前が空文字列だったり、オプションの長さ (optlen) が 0 の場合には、
 197 ソケットのバインドが削除される。渡すオプションは、インターフェース名が
 198 入ったヌル文字で終端された可変長の文字列である。
 199 文字列の最大のサイズは \fBIFNAMSIX\fP である。
 200 ソケットがインターフェースにバインドされると、その特定のインターフェース
 201 から受信されたパケットだけを処理する。
 202 このオプションはいくつかのソケットタイプ、
 203 特に \fBAF_INET\fP に対してのみ動作する点に注意すること。
 204 パケットソケットではサポートされていない (通常の \fBbind\fP(2) を使うこと)。
 205
 206 Before Linux 3.8, this socket option could be set, but could not retrieved
 207 with \fBgetsockopt\fP(2).  Since Linux 3.8, it is readable.  The \fIoptlen\fP
 208 argument should contain the buffer size available to receive the device name
 209 and is recommended to be \fBIFNAMSZ\fP bytes.  The real device name length is
 210 reported back in the \fIoptlen\fP argument.
 211 .TP
 212 \fBSO_BROADCAST\fP
 213 ブロードキャストフラグを設定・取得する。有効になっていると、データグラ
 214 ムソケットはブロードキャストアドレスにパケットを送信できるようになる。
 215 ストリーム指向のソケットには何の効果もない。
 216 .TP
 217 \fBSO_BSDCOMPAT\fP
 218 BSD のバグに対して互換性を取るための機能を有効にする。 この機能は Linux 2.0 と 2.2 の UDP
 219 プロトコルモジュールで使用されている。 有効になっていると、 UDP ソケットで受信された ICMP エラーは ユーザプログラムに渡されない。
 220 これ以降のバージョンのカーネルでは、このオプションのサポートは 段階的に廃止されてきた。 Linux 2.4 ではこのオプションは黙って無視され、
 221 Linux 2.6 ではプログラムがこのオプションを使用すると (printk() を使って)  カーネルの警告メッセージが出力される。 Linux
 222 2.0 では、このオプションを指定すると、 raw ソケットにおいても BSD のバグ (ランダムヘッダ変更、 ブロードキャストフラグのスキップ)
 223 に対する互換機能が有効になっていた。 しかし、こちらは Linux 2.2 で削除された。
 224 .TP
 225 \fBSO_DEBUG\fP
 226 ソケットのデバッグ機能を有効にする。 \fBCAP_NET_ADMIN\fP 権限を持つプロセスか、実効ユーザ ID が 0 のプロセスでしか 利用できない。
 227 .TP
 228 \fBSO_DOMAIN\fP (Linux 2.6.32 以降)
 229 ソケットドメインを整数で取得する。 \fBAF_INET6\fP のような値が返される。
 230 詳細は \fBsocket\fP(2) を参照。このソケットオプションは読み込み専用である。
 231 .TP
 232 \fBSO_ERROR\fP
 233 保留になっていたソケットエラーを取得してクリアする。
 234 このソケットオプションは読み込み専用である。整数値をとる。
 235 .TP
 236 \fBSO_DONTROUTE\fP
 237 ゲートウェイを経由せず、直接接続されているホストに送信する。 \fBsend\fP(2)  操作で \fBMSG_DONTROUTE\fP
 238 フラグをセットした場合も同じ効果が得られる。 ブール整数のフラグを取る。
 239 .TP
 240 \fBSO_KEEPALIVE\fP
 241 接続志向のソケットに対する keep\-alive メッセージの送信を有効にする。 ブール値の整数フラグをとる。
 242 .TP
 243 \fBSO_LINGER\fP
 244 \fBSO_LINGER\fP オプションを取得・設定する。引き数には \fIlinger\fP 構造体を取る。
 245 .sp
 246 .in +4n
 247 .nf
 248 struct linger {
 249     int l_onoff;    /* linger active */
 250     int l_linger;   /* how many seconds to linger for */
 251 };
 252 .fi
 253 .in
 254 .IP
 255 有効になっていると、 \fBclose\fP(2)  や \fBshutdown\fP(2)
 256 は、そのソケットにキューイングされたメッセージがすべて送信完了するか、 linger (居残り) タイムアウトになるまで返らない。無効になっていると、
 257 これらのコールはただちに戻り、クローズ動作はバックグラウンドで行われる。 ソケットのクローズを \fBexit\fP(2)
 258 の一部として行った場合には、残っているソケットの クローズ動作は必ずバックグラウンドに送られる。
 259 .TP
 260 \fBSO_MARK\fP (Linux 2.6.25 以降)
 261 .\" commit 4a19ec5800fc3bb64e2d87c4d9fdd9e636086fe0
 262 .\" and    914a9ab386a288d0f22252fc268ecbc048cdcbd5
 263 Set the mark for each packet sent through this socket (similar to the
 264 netfilter MARK target but socket\-based).  Changing the mark can be used for
 265 mark\-based routing without netfilter or for packet filtering.  Setting this
 266 option requires the \fBCAP_NET_ADMIN\fP capability.
 267 .TP
 268 \fBSO_OOBINLINE\fP
 269 .\" don't document it because it can do too much harm.
 270 .\".B SO_NO_CHECK
 271 このオプションを有効にすると、帯域外データ (out\-of\-band data) は 受信データストリーム中に置かれる。有効にしなければ、
 272 帯域外データは受信時に \fBMSG_OOB\fP フラグがセットされている場合に限って渡される。
 273 .TP
 274 \fBSO_PASSCRED\fP
 275 .\" FIXME Document SO_PASSSEC, added in 2.6.18; there is some info
 276 .\" in the 2.6.18 ChangeLog
 277 \fBSCM_CREDENTIALS\fP 制御メッセージの受信を有効/無効にする。詳細は \fBunix\fP(7)  を参照のこと。
 278 .TP
 279 \fBSO_PEERCRED\fP
 280 Return the credentials of the foreign process connected to this socket.
 281 This is only possible for connected \fBAF_UNIX\fP stream sockets and \fBAF_UNIX\fP
 282 stream and datagram socket pairs created using \fBsocketpair\fP(2); see
 283 \fBunix\fP(7).  The returned credentials are those that were in effect at the
 284 time of the call to \fBconnect\fP(2)  or \fBsocketpair\fP(2).  The argument is a
 285 \fIucred\fP structure; define the \fBGNU_SOURCE\fP feature test macro to obtain
 286 the definition of that structure from \fI<sys/socket.h>\fP.  This
 287 socket option is read\-only.
 288 .TP
 289 \fBSO_PRIORITY\fP
 290 プロトコルで定義された優先度を、このソケットから 送信される全てのパケットにセットする。 Linux はネットワークキュー内部の
 291 整列にこの値を用いる。高い優先度を持っているパケットは先に処理される。 ただしそのデバイスのキュー処理のやり方に依存する。 \fBip\fP(7)
 292 では、外向けパケットの IP type\-of\-service (TOS) フィールドにもこの値が設定される。 0 から 6 以外の優先度をセットするには
 293 \fBCAP_NET_ADMIN\fP ケーパビリティが必要である。
 294 .TP
 295 \fBSO_PROTOCOL\fP (Linux 2.6.32 以降)
 296 ソケットのプロトコルを整数で取得する。 \fBIPPROTO_SCTP\fP のような値が返される。
 297 詳細は \fBsocket\fP(2) を参照。このソケットオプションは読み込み専用である。
 298 .TP
 299 \fBSO_RCVBUF\fP
 300 .\" Most (all?) other implementations do not do this -- MTK, Dec 05
 301 .\" The following thread on LMKL is quite informative:
 302 .\" getsockopt/setsockopt with SO_RCVBUF and SO_SNDBUF "non-standard" behaviour
 303 .\" 17 July 2012
 304 .\" http://thread.gmane.org/gmane.linux.kernel/1328935
 305 ソケットの受信バッファの最大サイズを設定・取得する (バイト単位)。 \fBsetsockopt\fP(2)  を使って値が設定されたときに
 306 (管理オーバヘッド用の領域を確保するために)  カーネルはこの値を 2倍し、 \fBgetsockopt\fP(2)  はこの 2倍された値を返す。
 307 デフォルトの値は \fI/proc/sys/net/core/rmem_default\fP ファイルで設定され、許容される最大の値は
 308 \fI/proc/sys/net/core/rmem_max\fP ファイルで設定される。 このオプションの最小値は (2倍した値で) 256 である。
 309 .TP
 310 \fBSO_RCVBUFFORCE\fP (Linux 2.6.14 以降)
 311 このソケットオプションを使うと、特権プロセス (\fBCAP_NET_ADMIN\fP を持つプロセス) は \fBSO_RCVBUF\fP
 312 と同じことを実行できる。 ただし、上限 \fIrmem_max\fP を上書きすることができる。
 313 .TP
 314 \fBSO_RCVLOWAT\fP と \fBSO_SNDLOWAT\fP
 315 .\" See http://marc.theaimsgroup.com/?l=linux-kernel&m=111049368106984&w=2
 316 .\" Tested on kernel 2.6.14 -- mtk, 30 Nov 05
 317 バッファ中に溜めることのできるデータの最小値を指定する。 このサイズを越えると、ソケット層はそのデータをプロトコルに渡し
 318 (\fBSO_SNDLOWAT\fP)、 受信時にはユーザに渡す (\fBSO_RCVLOWAT\fP)。 これら二つの値は 1 に初期化される。
 319 \fBSO_SNDLOWAT\fP は Linux では変更できない (\fBsetsockopt\fP(2)  は \fBENOPROTOOPT\fP
 320 エラーで失敗する)。 \fBSO_RCVLOWAT\fP は Linux 2.4 以降でのみ変更可能である。 現状、Linux ではシステムコール
 321 \fBselect\fP(2)  と \fBpoll\fP(2)  は \fBSO_RCVLOWAT\fP の設定を考慮に入れずに動作し、
 322 データが1バイト利用可能になっただけでも、 ソケットは読み出し可能とのマークをつける。 一方、それに続けて行うソケットからの read は
 323 \fBSO_RCVLOWAT\fP バイトのデータが利用可能になるまで停止してしまう。
 324 .TP
 325 \fBSO_RCVTIMEO\fP と \fBSO_SNDTIMEO\fP
 326 .\" Not implemented in 2.0.
 327 .\" Implemented in 2.1.11 for getsockopt: always return a zero struct.
 328 .\" Implemented in 2.3.41 for setsockopt, and actually used.
 329 .\" in fact to EAGAIN
 330 送信・受信のタイムアウトを指定する。これを越えるとエラーを報告する。 引き数は \fIstruct timeval\fP である。
 331 入出力関数がタイムアウト時間の間ブロックされ、かつデータの送信または 受信が行われていた場合は、転送されたデータ量が関数の返り値となる。
 332 何もデータが転送されずにタイムアウトに達した場合は、 \-1 を返し、 \fIerrno\fP に \fBEAGAIN\fP か \fBEWOULDBLOCK\fP か
 333 \fBEINPROGRESS\fP (\fBconnect\fP(2) の場合) が設定され、 あたかもソケットに非ブロッキングが指定されたように見える。
 334 タイムアウト値に (デフォルト値である) 0 に設定すると、 操作は決してタイムアウトしなくなる。 タイムアウトが影響を及ぼすのは、 ソケット I/O
 335 を実行するシステムコールだけ (例えば \fBread\fP(2), \fBrecvmsg\fP(2), \fBsend\fP(2), \fBsendmsg\fP(2))
 336 である。 \fBselect\fP(2), \fBpoll\fP(2), \fBepoll_wait\fP(2)  などにはタイムアウトは影響を及ぼさない。
 337 .TP
 338 \fBSO_REUSEADDR\fP
 339 \fBbind\fP(2)  コールに与えられたアドレスが正しいかを判断するルールで、 ローカルアドレスの再利用を可能にする。 つまり \fBAF_INET\fP
 340 ソケットなら、そのアドレスにバインドされたアクティブな listen 状態のソケットが存在しない限り、バインドが行える。 listen
 341 状態のソケットがアドレス \fBINADDR_ANY\fP で特定のポートにバインドされている場合には、
 342 このポートに対しては、どんなローカルアドレスでもバインドできない。 引き数はブール整数のフラグである。
 343 .TP
 344 \fBSO_SNDBUF\fP
 345 .\" Most (all?) other implementations do not do this -- MTK, Dec 05
 346 .\" See also the comment to SO_RCVBUF (17 Jul 2012 LKML mail)
 347 ソケットの送信バッファの最大サイズを設定・取得する (バイト単位)。 \fBsetsockopt\fP(2)  を使って値が設定されたときに
 348 (管理オーバヘッド用の領域を確保するために)  カーネルはこの値を 2倍し、 \fBgetsockopt\fP(2)  はこの 2倍された値を返す。
 349 デフォルトの値は \fI/proc/sys/net/core/wmem_default\fP ファイルで設定され、許容される最大の値は
 350 \fI/proc/sys/net/core/wmem_max\fP ファイルで設定される。 このオプションの最小値は (2倍した値で) 2048 である。
 351 .TP
 352 \fBSO_SNDBUFFORCE\fP (Linux 2.6.14 以降)
 353 このソケットオプションを使うと、特権プロセス (\fBCAP_NET_ADMIN\fP を持つプロセス) は \fBSO_SNDBUF\fP
 354 と同じことを実行できる。 ただし、上限 \fIwmem_max\fP を上書きすることができる。
 355 .TP
 356 \fBSO_TIMESTAMP\fP
 357 \fBSO_TIMESTAMP\fP 制御メッセージの受信を有効/無効にする。 タイムスタンプ制御メッセージはレベル \fBSOL_SOCKET\fP で送信され、
 358 \fIcmsg_data\fP フィールドはこのシステムコールでユーザに渡した 最後のパケットの受信時刻を示す \fIstruct timeval\fP である。
 359 制御メッセージの詳細については \fBcmsg\fP(3)  を参照。
 360 .TP
 361 \fBSO_TYPE\fP
 362 ソケットのタイプを整数で取得する (例: \fBSOCK_STREAM\fP)。
 363 このソケットオプションは読み出し専用である。
 364 .SS シグナル
 365 (ローカルもしくはリモート側で) 切断された 接続指向 (connection\-oriented) のソケットに対して
 366 書き込みを行うと、その書き込みを行ったプロセスに \fBSIGPIPE\fP が送られ、 \fBEPIPE\fP が返される。 write 呼び出しに
 367 \fBMSG_NOSIGNAL\fP フラグを指定していた場合はシグナルは送られない。
 368 .PP
 369 \fBFIOSETOWN\fP \fBfcntl\fP(2)  や \fBSIOCSPGRP\fP \fBioctl\fP(2)
 370 をプロセスまたはプロセスグループに指定しておくと、 I/O イベントが起きたときに \fBSIGIO\fP が送られる。 \fBpoll\fP(2)  や
 371 \fBselect\fP(2)  をシグナルハンドラ内で用いれば、どのソケットでイベントが起こったかを 知ることができる。 (Linux 2.2 における)
 372 別の方法としては、 \fBF_SETSIG\fP \fBfcntl\fP(2)  を用いてリアルタイムシグナルを設定するやり方もある。
 373 リアルタイムシグナルのハンドラは、 \fIsiginfo_t\fP の \fIsi_fd\fP フィールドにファイルディスクリプタが入った状態で呼び出される。
 374 詳細は \fBfcntl\fP(2)  を参照のこと。
 375 .PP
 376 .\" .SS Ancillary messages
 377 状況によっては (例えば複数のプロセスが一つのソケットにアクセスしているなど)、 \fBSIGIO\fP
 378 の原因となった状態は、プロセスがそのシグナルへの対応を行ったときには 消えてしまっているかもしれない。
 379 この場合は、プロセスは再び待つようにすべきである。 Linux は同じシグナルを後で再送するからである。
 380 .SS "/proc インタフェース"
 381 core のソケットのネットワーキングパラメータには、 \fI/proc/sys/net/core/\fP ディレクトリ内のファイルを通してアクセスできる。
 382 .TP
 383 \fIrmem_default\fP
 384 ソケットの受信バッファサイズのデフォルト値 (バイト単位)。
 385 .TP
 386 \fIrmem_max\fP
 387 \fBSO_RCVBUF\fP ソケットオプションを用いてユーザが設定できる ソケットの受信バッファサイズの最大値 (バイト単位)。
 388 .TP
 389 \fIwmem_default\fP
 390 ソケットの送信バッファサイズのデフォルト値 (バイト単位)。
 391 .TP
 392 \fIwmem_max\fP
 393 \fBSO_SNDBUF\fP ソケットオプションを用いてユーザが設定できる ソケットの送信バッファサイズの最大値 (バイト単位)。
 394 .TP
 395 \fImessage_cost\fP と \fImessage_burst\fP
 396 トークン・バケット・フィルターを設定する。 これは外部のネットワークイベントによって引き起こされた 負荷限界の警告メッセージに用いられる。
 397 .TP
 398 \fInetdev_max_backlog\fP
 399 グローバルな入力キューにおける最大のパケット数。
 400 .TP
 401 \fIoptmem_max\fP
 402 .\" netdev_fastroute is not documented because it is experimental
 403 ソケットあたりの、補助データ (ancillary data) とユーザ制御データ (iovecs のようなもの) との和の最大長。
 404 .SS ioctl
 405 以下に示す操作には \fBioctl\fP(2)  を用いてアクセスできる。
 406
 407 .in +4n
 408 .nf
 409 \fIerror\fP\fB = ioctl(\fP\fIip_socket\fP\fB, \fP\fIioctl_type\fP\fB, \fP\fI&value_result\fP\fB);\fP
 410 .fi
 411 .in
 412 .TP
 413 \fBSIOCGSTAMP\fP
 414 .\"
 415 最後にユーザに渡されたパケットの受信タイムスタンプを \fIstruct timeval\fP に入れて返す。 これは round trip
 416 時間を正確に測りたいときに便利である。 \fIstruct timeval\fP の説明は \fBsetitimer\fP(2)  を見てほしい。 この ioctl
 417 は、ソケットオプション \fBSO_TIMESTAMP\fP がソケットにセットされていない場合にのみ使用すべきである。 さもなければ、この ioctl は
 418 \fBSO_TIMESTAMP\fP がセットされていなかった間に受信した最後のパケットの時刻を返すか、 そのようなパケットを受信していない場合には失敗する
 419 (つまり、 \fBioctl\fP(2)  は \-1 を返し、 \fIerrno\fP に \fBENOENT\fP をセットする)。
 420 .TP
 421 \fBSIOCSPGRP\fP
 422 非同期 I/O 操作の終了時や緊急データの受信時に \fBSIGIO\fP や \fBSIGURG\fP シグナル群を送るプロセスやプロセスグループを設定する。
 423 引き数は \fIpid_t\fP へのポインタである。 引き数が正だと、そのプロセスにシグナルが送られる。負だと、 引き数の絶対値を ID
 424 に持つプロセスグループにシグナルが送られる。 シグナル受信先には、自分自身のプロセス / 自分の所属するプロセスグループ しか指定できない。但し、
 425 \fBCAP_KILL\fP ケーパビリティを持っている場合、及び実効ユーザ ID が 0 のプロセスの場合は この限りではない。
 426 .TP
 427 \fBFIOASYNC\fP
 428 \fBO_ASYNC\fP フラグを変更し、ソケットの非同期 (asynchronous) I/O モードを 有効/無効にする。非同期 I/O モードでは、
 429 新しい I/O イベントが起きたときに、 \fBSIGIO\fP シグナルや \fBF_SETSIG\fP で設定されたシグナル・セットが発行される。
 430 .IP
 431 .\"
 432 引き数はブール整数のフラグである。 (この操作は \fBfcntl\fP(2)  を使って \fBO_ASYNC\fP フラグをセットするのと同じ意味である。)
 433 .TP
 434 \fBSIOCGPGRP\fP
 435 \fBSIGIO\fP や \fBSIGURG\fP を受信したカレントプロセス・プロセスグループを取得する。 ない場合は 0 が返る。
 436 .PP
 437 有効な \fBfcntl\fP(2)  操作:
 438 .TP
 439 \fBFIOGETOWN\fP
 440 \fBSIOCGPGRP\fP \fBioctl\fP(2)  と同じ。
 441 .TP
 442 \fBFIOSETOWN\fP
 443 \fBSIOCSPGRP\fP \fBioctl\fP(2)  と同じ。
 444 .SH バージョン
 445 \fBSO_BINDTODEVICE\fP は Linux 2.0.30 で導入された。 \fBSO_PASSCRED\fP は Linux 2.2 で登場した。
 446 \fI/proc\fP インタフェースは Linux 2.2 で導入された。 \fBSO_RCVTIMEO\fP と \fBSO_SNDTIMEO\fP は Linux
 447 2.3.41 以降でサポートされている。 それ以前は、タイムアウトはプロトコル固有の固定の設定値で、 読み書きをすることはできなかった。
 448 .SH 注意
 449 Linux は、送受信バッファの半分を内部のカーネル構造体で用いると仮定している。 したがって、対応する \fI/proc\fP
 450 ファイルはネットワーク回線上での大きさの 2 倍になる。
 451
 452 Linux では、 \fBSO_REUSEADDR\fP オプションでポートの再利用が許可されるのは、 そのポートに対して \fBbind\fP(2)
 453 を前に実行したプログラムとそのポートを再利用 しようとするプログラムの両方で \fBSO_REUSEADDR\fP がセットされた場合のみである。 この動作は
 454 (FreeBSD などの) いくつかの実装とは異なる。これらでは、 後でポートを再利用しようとするプログラムで \fBSO_REUSEADDR\fP
 455 オプションをセットするだけでよい。 たいていはこの違いは見えない。なぜなら、例えばサーバプログラムは
 456 常にこのオプションをセットするように設計されるからである。
 457 .SH バグ
 458 .\" FIXME Document SO_ATTACH_FILTER and SO_DETACH_FILTER
 459 .\" .SH AUTHORS
 460 .\" This man page was written by Andi Kleen.
 461 \fBCONFIG_FILTER\fP ソケットオプションである \fBSO_ATTACH_FILTER\fP と \fBSO_DETACH_FILTER\fP
 462 について記載されていない。これらは libpcap ライブラリを通して 用いる方が良い。
 463 .SH 関連項目
 464 \fBgetsockopt\fP(2), \fBconnect\fP(2), \fBsetsockopt\fP(2), \fBsocket\fP(2),
 465 \fBcapabilities\fP(7), \fBddp\fP(7), \fBip\fP(7), \fBpacket\fP(7), \fBtcp\fP(7), \fBudp\fP(7),
 466 \fBunix\fP(7)
 467 .SH この文書について
 468 この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.50 の一部
 469 である。プロジェクトの説明とバグ報告に関する情報は
 470 http://www.kernel.org/doc/man\-pages/ に書かれている。