.\" Modified 1999 by Andi Kleen <ak@muc.de>.
.\" Removed most stuff because it is in socket.7 now.
.\"
-.\" Japanese Version Copyright (c) 1996 Akira Yoshiyama
-.\" all rights reserved.
-.\" Translated Sat Jul 6 00:43:37 JST 1996
-.\" by Akira Yoshiyama <yosshy@jedi.seg.kobe-u.ac.jp>
-.\" Modified Fri Nov 7 22:45:27 JST 1997
-.\" by HANATAKA Shinya <hanataka@abyss.rim.or.jp>
-.\" Updated Sun Oct 12 JST 2003 by Kentaro Shirakata <argrath@ub32.org>
+.\"*******************************************************************
.\"
-.TH GETSOCKOPT 2 2008-12-03 "Linux" "Linux Programmer's Manual"
+.\" This file was generated with po4a. Translate the source file.
+.\"
+.\"*******************************************************************
+.TH GETSOCKOPT 2 2008\-12\-03 Linux "Linux Programmer's Manual"
.SH 名前
getsockopt, setsockopt \- ソケットのオプションの設定と取得を行なう
.SH 書式
.nf
-.BR "#include <sys/types.h>" " /* 「注意」参照 */"
+\fB#include <sys/types.h>\fP /* 「注意」参照 */
.br
-.B #include <sys/socket.h>
+\fB#include <sys/socket.h>\fP
.sp
-.BI "int getsockopt(int " sockfd ", int " level ", int " optname ,
-.BI " void *" optval ", socklen_t *" optlen );
-.BI "int setsockopt(int " sockfd ", int " level ", int " optname ,
-.BI " const void *" optval ", socklen_t " optlen );
+\fBint getsockopt(int \fP\fIsockfd\fP\fB, int \fP\fIlevel\fP\fB, int \fP\fIoptname\fP\fB,\fP
+\fB void *\fP\fIoptval\fP\fB, socklen_t *\fP\fIoptlen\fP\fB);\fP
+\fBint setsockopt(int \fP\fIsockfd\fP\fB, int \fP\fIlevel\fP\fB, int \fP\fIoptname\fP\fB,\fP
+\fB const void *\fP\fIoptval\fP\fB, socklen_t \fP\fIoptlen\fP\fB);\fP
.fi
.SH 説明
-.BR getsockopt ()
-と
-.BR setsockopt ()
-は、ファイルディスクリプタ
-.I socket
-で参照されるソケットに関連するオプションの操作を行う。
-オプションは複数のプロトコル層(level)に存在するかもしれないが、
+\fBgetsockopt\fP() と \fBsetsockopt\fP() は、ファイルディスクリプタ \fIsocket\fP
+で参照されるソケットに関連するオプションの操作を行う。 オプションは複数のプロトコル層(level)に存在するかもしれないが、
これらは常に最上位のソケット層へと設定される。
-ソケット・オプションを操作する際には、オプションの層 (level) と
-オプションの名前を指定しなければならない。
-ソケット API 層でオプションを操作する為には、
-.I level
-を
-.B SOL_SOCKET
-に指定する。
-他の全ての層でオプションを操作する為には、与えられたオプションの
-制御主体となるプロトコルのプロトコル番号を指定する。例えば、
-オプションが
-.B TCP
-プロトコルで解釈されるべきことを指示するには、
-.I level
-に
-.B TCP
-のプロトコル番号を指定しなければならない。
-.BR getprotoent (3)
-を参照すること。
+ソケット・オプションを操作する際には、オプションの層 (level) と オプションの名前を指定しなければならない。 ソケット API
+層でオプションを操作する為には、 \fIlevel\fP を \fBSOL_SOCKET\fP に指定する。
+他の全ての層でオプションを操作する為には、与えられたオプションの 制御主体となるプロトコルのプロトコル番号を指定する。例えば、 オプションが
+\fBTCP\fP プロトコルで解釈されるべきことを指示するには、 \fIlevel\fP に \fBTCP\fP のプロトコル番号を指定しなければならない。
+\fBgetprotoent\fP(3) を参照すること。
-.I optval
-と
-.I optlen
-引き数は
-.BR setsockopt ()
-のオプションの値にアクセスするために用いられる。
-.BR getsockopt ()
-では要求したオプションの値を返すためのバッファーを指定する。
-.BR getsockopt ()
-では
-.I optlen
-は値と結果両用の引き数で、最初に
-.I optval
-の指しているバッファーのサイズを与え、実際に返される値のサイズに
-書き換えられる。もしオプション値を与えず、返されもしない場合には
-.I optval
-は NULL でも良い。
+\fIoptval\fP と \fIoptlen\fP 引き数は \fBsetsockopt\fP() のオプションの値にアクセスするために用いられる。
+\fBgetsockopt\fP() では要求したオプションの値を返すためのバッファーを指定する。 \fBgetsockopt\fP() では
+\fIoptlen\fP は値と結果両用の引き数で、最初に \fIoptval\fP の指しているバッファーのサイズを与え、実際に返される値のサイズに
+書き換えられる。もしオプション値を与えず、返されもしない場合には \fIoptval\fP は NULL でも良い。
-.I optname
-および指定されたオプションは解釈されずに、適切なプロトコル・モジュールに
-渡されて解釈される。インクルード・ファイル
-.I <sys/socket.h>
-には後述のソケット層のオプションの定義が含まれている。
-他のプロトコル層では名前や形式は異なる。
+\fIoptname\fP および指定されたオプションは解釈されずに、適切なプロトコル・モジュールに 渡されて解釈される。インクルード・ファイル
+\fI<sys/socket.h>\fP には後述のソケット層のオプションの定義が含まれている。 他のプロトコル層では名前や形式は異なる。
マニュアルのセクション 4 の適切なエントリを参照すること。
-ほとんどのソケット層のオプションは
-.I optval
-に
-.I int
-引き数を利用する。
-.BR setsockopt ()
-で、二値(boolean)オプションを有効(enable)にするにはゼロ以外を指定し、
-無効(disable)にするにはゼロを指定する。
+ほとんどのソケット層のオプションは \fIoptval\fP に \fIint\fP 引き数を利用する。 \fBsetsockopt\fP()
+で、二値(boolean)オプションを有効(enable)にするにはゼロ以外を指定し、 無効(disable)にするにはゼロを指定する。
.PP
-利用可能なソケットオプションの説明に関しては、
-.BR socket (7)
-と適切なプロトコルの man ページを参照のこと。
+利用可能なソケットオプションの説明に関しては、 \fBsocket\fP(7) と適切なプロトコルの man ページを参照のこと。
.SH 返り値
-成功した場合にはゼロを返す。エラー時には \-1 が返され、
-.I errno
-が適切に設定される。
+成功した場合にはゼロが返される。エラー時には \-1 が返され、 \fIerrno\fP が適切に設定される。
.SH エラー
-.TP 10
-.B EBADF
-引き数
-.I sockfd
-が有効なディスクリプタでない。
-.TP
-.B EFAULT
-.I optval
-で指定されたアドレスがプロセスのアドレス空間の有効な部分ではない。
-.BR getsockopt ()
-の場合、
-.I optlen
+.TP 10
+\fBEBADF\fP
+引き数 \fIsockfd\fP は有効なディスクリプターでない。
+.TP
+\fBEFAULT\fP
+\fIoptval\fP で指定されたアドレスがプロセスのアドレス空間の有効な部分ではない。 \fBgetsockopt\fP() の場合、 \fIoptlen\fP
がプロセスのアドレス空間の有効な部分でない場合にもこのエラーが返される。
-.TP
-.B EINVAL
-.BR setsockopt ()
-で
-.I option
-が不正である。
-.I optval
-に無効な値が指定された場合にも、このエラーが発生する可能性がある
-(例えば、
-.BR ip (7)
-に説明がある
-.B IP_ADD_MEMBERSHIP
+.TP
+\fBEINVAL\fP
+\fBsetsockopt\fP() で \fIoption\fP が不正である。 \fIoptval\fP
+に無効な値が指定された場合にも、このエラーが発生する可能性がある (例えば、 \fBip\fP(7) に説明がある \fBIP_ADD_MEMBERSHIP\fP
オプションなど)。
-.TP
-.B ENOPROTOOPT
+.TP
+\fBENOPROTOOPT\fP
指定された層(level)にはこのオプションは存在しない。
-.TP
-.B ENOTSOCK
-引き数
-.I sockfd
-はファイルであり、ソケットでない。
+.TP
+\fBENOTSOCK\fP
+引き数 \fIsockfd\fP がソケットではなくファイルである。
.SH 準拠
-SVr4, 4.4BSD (これらのシステム・コールは 4.2BSD で最初に現れた),
-POSIX.1-2001.
-.\" SVr4 には他に ENOMEM と ENOSR エラー・コードについても記述されている。
-.\" しかし、
+.\" SVr4 documents additional ENOMEM and ENOSR error codes, but does
+.\" not document the
.\" .BR SO_SNDLOWAT ", " SO_RCVLOWAT ", " SO_SNDTIMEO ", " SO_RCVTIMEO
-.\" オプションに関する記述はない。
+.\" options
+SVr4, 4.4BSD (これらのシステム・コールは 4.2BSD で最初に現れた), POSIX.1\-2001.
.SH 注意
-POSIX.1-2001 では
-.I <sys/types.h>
-のインクルードは必須とされておらず、
-Linux ではこのヘッダファイルは必要ではない。
-しかし、歴史的には、いくつかの実装 (BSD 系) でこのヘッダファイルが
-必要であり、移植性が必要なアプリケーションではこのファイルを
-インクルードするのが賢明であろう。
+POSIX.1\-2001 では \fI<sys/types.h>\fP のインクルードは必須とされておらず、 Linux
+ではこのヘッダファイルは必要ではない。 しかし、歴史的には、いくつかの実装 (BSD 系) でこのヘッダファイルが
+必要であり、移植性が必要なアプリケーションではこのファイルを インクルードするのが賢明であろう。
-.BR getsockopt ()
-と
-.BR setsockopt ()
-の
-.I optlen
-引き数は実際は
-.I int [*]
-である (そして 4.x BSD と libc4 と libc5 はそうなっている)。
-POSIX では紆余曲折を経て現在の
-.I socklen_t
-になっており、
-glibc でも
-.I socklen_t
-を使っている。
-.BR accept (2)
-も参照のこと。
+\fBgetsockopt\fP() と \fBsetsockopt\fP() の \fIoptlen\fP 引き数は実際は \fIint [*]\fP である (そして
+4.x BSD と libc4 と libc5 はそうなっている)。 POSIX では紆余曲折を経て現在の \fIsocklen_t\fP になっており、
+glibc でも \fIsocklen_t\fP を使っている。 \fBaccept\fP(2) も参照のこと。
.SH バグ
-ソケットのオプションのいくつかはシステムのより低い層で
-処理されるべきである。
+ソケットのオプションのいくつかはシステムのより低い層で 処理されるべきである。
.SH 関連項目
-.BR ioctl (2),
-.BR socket (2),
-.BR getprotoent (3),
-.BR protocols (5),
-.BR socket (7),
-.BR tcp (7),
-.BR unix (7)
+\fBioctl\fP(2), \fBsocket\fP(2), \fBgetprotoent\fP(3), \fBprotocols\fP(5), \fBsocket\fP(7),
+\fBtcp\fP(7), \fBunix\fP(7)
OSDN Git Service
