OSDN Git Service

Update release for LDP 3.67
[linuxjm/LDP_man-pages.git] / release / man7 / socket.7
index 200ee24..5761f92 100644 (file)
@@ -21,7 +21,7 @@
 .\" The following are not yet documented:
 .\"    SO_PEERNAME (2.4?)
 .\"            get only
-.\"            Seems to do something similar to getpeernam(), but then
+.\"            Seems to do something similar to getpeername(), but then
 .\"            why is it necessary / how does it differ?
 .\"    SO_TIMESTAMPNS (2.6.22)
 .\"            Documentation/networking/timestamping.txt
@@ -31,9 +31,6 @@
 .\"            Documentation/networking/timestamping.txt
 .\"            commit cb9eff097831007afb30d64373f29d99825d0068
 .\"            Author: Patrick Ohly <patrick.ohly@intel.com>
-.\"    SO_RXQ_OVFL (2.6.33)
-.\"            commit 3b885787ea4112eaa80945999ea0901bf742707f
-.\"            Author: Neil Horman <nhorman@tuxdriver.com>
 .\"    SO_WIFI_STATUS (3.3)
 .\"            commit 6e3e939f3b1bf8534b32ad09ff199d88800835a0
 .\"            Author: Johannes Berg <johannes.berg@intel.com>
 .\"    SO_NOFCS (3.4)
 .\"            commit 3bdc0eba0b8b47797f4a76e377dd8360f317450f
 .\"            Author: Ben Greear <greearb@candelatech.com>
+.\"    SO_GET_FILTER (3.8)
+.\"            commit a8fc92778080c845eaadc369a0ecf5699a03bef0
+.\"            Author: Pavel Emelyanov <xemul@parallels.com>
+.\"    SO_REUSEPORT (3.9)
+.\"            commit c617f398edd4db2b8567a28e899a88f8f574798d
+.\"            https://lwn.net/Articles/542629/
+.\"    SO_LOCK_FILTER (3.9)
+.\"            commit d59577b6ffd313d0ab3be39cb1ab47e29bdc9182
+.\"            Author: Vincent Bernat <bernat@luffy.cx>
+.\"    SO_SELECT_ERR_QUEUE (3.10)
+.\"             commit 7d4c04fc170087119727119074e72445f2bb192b
+.\"            Author: Keller, Jacob E <jacob.e.keller@intel.com>
+.\"     SO_MAX_PACING_RATE (3.13)
+.\"             commit 62748f32d501f5d3712a7c372bbb92abc7c62bc7
 .\"
 .\"*******************************************************************
 .\"
 .\" This file was generated with po4a. Translate the source file.
 .\"
 .\"*******************************************************************
-.TH SOCKET 7 2013\-06\-21 Linux "Linux Programmer's Manual"
+.\"
+.\" Japanese Version Copyright (c) 1999 NAKANO Takeo all rights reserved.
+.\" Translated 1999-12-06, NAKANO Takeo <nakano@apm.seikei.ac.jp>
+.\" Updated 2003-01-20, Akihiro Motoki <amotoki@dd.iij4u.or.jp>
+.\" Updated 2005-02-23, Akihiro MOTOKI
+.\" Updated 2005-10-05, Akihiro MOTOKI
+.\" Updated 2005-12-05, Akihiro MOTOKI, Catch up to LDP man-pages 2.16
+.\" Updated 2005-12-26, Akihiro MOTOKI, Catch up to LDP man-pages 2.18
+.\" Updated 2006-04-15, Akihiro MOTOKI, Catch up to LDP man-pages 2.29
+.\" Updated 2007-01-05, Akihiro MOTOKI, Catch up to LDP man-pages 2.43
+.\" Updated 2013-05-01, Akihiro MOTOKI <amotoki@gmail.com>
+.\" Updated 2013-05-06, Akihiro MOTOKI <amotoki@gmail.com>
+.\" Updated 2013-07-24, Akihiro MOTOKI <amotoki@gmail.com>
+.\"
+.TH SOCKET 7 2014\-02\-21 Linux "Linux Programmer's Manual"
 .SH 名前
 socket \- Linux のソケットインターフェース
 .SH 書式
@@ -304,8 +329,9 @@ recv(fd, buf, 2, MSG_PEEK);  // Peeks "ee"; offset set to 8
 このソケットに接続してきた外部プロセスの信任状 (credential) を返す。このソケットオプションが利用できるのは、接続された
 \fBAF_UNIX\fP ストリームソケット間、および \fBsocketpair\fP(2) を使って作成された \fBAF_UNIX\fP
 のストリームソケットとデータグラムソケットのペアだけである。 \fBunix\fP(7)  を参照のこと。 \fBconnect\fP(2) や
-\fBsocketpair\fP(2) が呼ばれた時に有効であった信任状が返される。引き数は \fIucred\fP
-構造体である。このソケットオプションは読み込み専用である。
+\fBsocketpair\fP(2) が呼ばれた時に有効であった信任状が返される。 引き数は \fIucred\fP 構造体である。この構造体の定義を
+\fI<sys/socket.h>\fP を得るには、 機能検査マクロ \fB_GNU_SOURCE\fP を定義すること。
+このソケットオプションは読み込み専用である。
 .TP 
 \fBSO_PRIORITY\fP
 プロトコルで定義された優先度を、このソケットから 送信される全てのパケットにセットする。 Linux はネットワークキュー内部の
@@ -362,6 +388,11 @@ recv(fd, buf, 2, MSG_PEEK);  // Peeks "ee"; offset set to 8
 状態のソケットがアドレス \fBINADDR_ANY\fP で特定のポートにバインドされている場合には、
 このポートに対しては、どんなローカルアドレスでもバインドできない。 引き数はブール整数のフラグである。
 .TP 
+\fBSO_RXQ_OVFL\fP (Linux 2.6.33 以降)
+.\" commit 3b885787ea4112eaa80945999ea0901bf742707f
+最後の受信パケットとこの受信パケットの間にそのソケットで捨てられた (ドロップされた) パケット数を示す、unsigned 32
+ビット値の補助メッセージ (cmsg) を受信した skb に付与することを指示する。
+.TP 
 \fBSO_SNDBUF\fP
 .\" Most (all?) other implementations do not do this -- MTK, Dec 05
 .\" See also the comment to SO_RCVBUF (17 Jul 2012 LKML mail)
@@ -382,6 +413,20 @@ recv(fd, buf, 2, MSG_PEEK);  // Peeks "ee"; offset set to 8
 \fBSO_TYPE\fP
 ソケットのタイプを整数で取得する (例: \fBSOCK_STREAM\fP)。
 このソケットオプションは読み出し専用である。
+.TP 
+\fBSO_BUSY_POLL\fP (Linux 3.11 以降)
+データがなかった際にブロッキング受信での busy polling のおおよその時間をマイクロ秒単位で設定する。 この値を増やすには
+\fBCAP_NET_ADMIN\fP ケーパビリティが必要である。 このオプションのデフォルト値は
+\fI/proc/sys/net/core/busy_read\fP で制御できる。
+
+\fI/proc/sys/net/core/busy_poll\fP の値により、 \fBSO_BUSY_POLL\fP がセットされたソケットに対して
+\fBselect\fP(2) や \fBpoll\fP(2) を行い、報告すべきイベントがない場合に、 \fBselect\fP(2) や \fBpoll\fP(2) が
+busy polling をどのくらいの時間行うかが決まる。
+
+どちらの場合も、busy polling は、そのソケットが最後にデータを受信したネットワークデバイスがこのオプションに対応している場合のみ行われる。
+
+busy polling により遅延が改善されるはアプリケーションもあるが、 busy polling は CPU
+使用率と電力使用量をともに増加させることになるので、使用する際は注意して行うこと。
 .SS シグナル
 (ローカルもしくはリモート側で) 切断された 接続指向 (connection\-oriented) のソケットに対して
 書き込みを行うと、その書き込みを行ったプロセスに \fBSIGPIPE\fP が送られ、 \fBEPIPE\fP が返される。 write 呼び出しに
@@ -482,10 +527,10 @@ Linux では、 \fBSO_REUSEADDR\fP オプションでポートの再利用が許
 \fBCONFIG_FILTER\fP ソケットオプションである \fBSO_ATTACH_FILTER\fP と \fBSO_DETACH_FILTER\fP
 について記載されていない。これらは libpcap ライブラリを通して 用いる方が良い。
 .SH 関連項目
-\fBgetsockopt\fP(2), \fBconnect\fP(2), \fBsetsockopt\fP(2), \fBsocket\fP(2),
+\fBconnect\fP(2), \fBgetsockopt\fP(2), \fBsetsockopt\fP(2), \fBsocket\fP(2),
 \fBcapabilities\fP(7), \fBddp\fP(7), \fBip\fP(7), \fBpacket\fP(7), \fBtcp\fP(7), \fBudp\fP(7),
 \fBunix\fP(7)
 .SH この文書について
-この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.52 の一部
+この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.67 の一部
 である。プロジェクトの説明とバグ報告に関する情報は
 http://www.kernel.org/doc/man\-pages/ に書かれている。