OSDN Git Service

(split) LDP: Update release (3.64)
[linuxjm/LDP_man-pages.git] / release / man7 / socket.7
index adcf9b7..f9a4881 100644 (file)
@@ -81,13 +81,11 @@ socket \- Linux のソケットインターフェース
 \fIsockfd\fP\fB = socket(int \fP\fIsocket_family\fP\fB, int \fP\fIsocket_type\fP\fB, int
 \fP\fIprotocol\fP\fB);\fP
 .SH 説明
-This manual page describes the Linux networking socket layer user
-interface.  The BSD compatible sockets are the uniform interface between the
-user process and the network protocol stacks in the kernel.  The protocol
-modules are grouped into \fIprotocol families\fP such as \fBAF_INET\fP, \fBAF_IPX\fP,
-and \fBAF_PACKET\fP, and \fIsocket types\fP such as \fBSOCK_STREAM\fP or
-\fBSOCK_DGRAM\fP.  See \fBsocket\fP(2)  for more information on families and
-types.
+このマニュアルページは Linux ネットワークのソケット層に対する ユーザインターフェースを記述するものである。 BSD
+互換ソケットは、ユーザプロセスとカーネル内部の ネットワークプロトコルスタック群との間に、 統一的なインターフェースを提供するものである。
+プロトコルモジュールは \fIプロトコルファミリー (protocol familiy)\fP (例: \fBAF_INET\fP, \fBAF_IPX\fP,
+\fBAF_PACKET\fP)  と \fIソケットタイプ (socket types)\fP (例: \fBSOCK_STREAM\fP,
+\fBSOCK_DGRAM\fP)  に分類できる。 これらに関するより詳しい情報は \fBsocket\fP(2)  を参照のこと。
 .SS ソケット層の関数群
 これらの関数はユーザプロセスがパケットを送受信したり、その他のソケット操作を 行ったりするために用いられる。詳細はそれぞれのマニュアルページを
 見てほしい。
@@ -289,13 +287,12 @@ struct linger {
 .TP 
 \fBSO_PEEK_OFF\fP (Linux 3.4 以降)
 .\" commit ef64a54f6e558155b4f149bb10666b9e914b6c54
-This option, which is currently supported only for \fBunix\fP(7)  sockets, sets
-the value of the "peek offset" for the \fBrecv\fP(2)  system call when used
-with \fBMSG_PEEK\fP flag.
+\fBMSG_PEEK\fP フラグと一緒に使用された場合 \fBrecv\fP(2) システムコールの "peek offset"
+にこのオプションの値が設定される。現在のところ、このオプションは \fBunix\fP(7) ソケットでのみサポートされている。
 
-When this option is set to a negative value (it is set to \-1 for all new
-sockets), traditional behavior is provided: \fBrecv\fP(2)  with the \fBMSG_PEEK\fP
-flag will peek data from the front of the queue.
+このオプションが負の値に設定された場合、従来の動作となる。 つまり \fBMSG_PEEK\fP フラグが指定された \fBrecv\fP(2)
+は、キューの先頭のデータに対して peek 処理を行う (データを読み出すが、キューからデータの削除を行わない)。
+新規のソケットではこのオプションの値は必ず \-1 に設定される。
 
 このオプションに 0 以上の値が設定されると、 そのソケットのキュー上のオプション値で指定されたバイトオフセットにあるデータが次の peek
 処理で返される。 同時に、 "peek offset" がキューから peek 処理されたバイト数だけ加算される。したがって、次の peek
@@ -332,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 はネットワークキュー内部の
@@ -537,6 +535,6 @@ Linux では、 \fBSO_REUSEADDR\fP オプションでポートの再利用が許
 \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.63 の一部
+この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.64 の一部
 である。プロジェクトの説明とバグ報告に関する情報は
 http://www.kernel.org/doc/man\-pages/ に書かれている。