.\"
.TH GETSOCKOPT 2 2008-12-03 "Linux" "Linux Programmer's Manual"
.\"O .SH NAME
-.SH ̾Á°
+.SH 名前
.\"O getsockopt, setsockopt \- get and set options on sockets
-getsockopt, setsockopt \- ¥½¥±¥Ã¥È¤Î¥ª¥×¥·¥ç¥ó¤ÎÀßÄê¤È¼èÆÀ¤ò¹Ô¤Ê¤¦
+getsockopt, setsockopt \- ソケットのオプションの設定と取得を行なう
.\"O .SH SYNOPSIS
-.SH ½ñ¼°
+.SH 書式
.nf
.\"O .BR "#include <sys/types.h>" " /* See NOTES */"
-.BR "#include <sys/types.h>" " /* ¡ÖÃí°Õ¡×»²¾È */"
+.BR "#include <sys/types.h>" " /* 「注意」参照 */"
.br
.B #include <sys/socket.h>
.sp
.BI " const void *" optval ", socklen_t " optlen );
.fi
.\"O .SH DESCRIPTION
-.SH ÀâÌÀ
+.SH 説明
.\"O .BR getsockopt ()
.\"O and
.\"O .BR setsockopt ()
.\"O protocol levels; they are always present at the uppermost
.\"O socket level.
.BR getsockopt ()
-¤È
+と
.BR setsockopt ()
-¤Ï¡¢¥Õ¥¡¥¤¥ë¥Ç¥£¥¹¥¯¥ê¥×¥¿
+ã\81¯ã\80\81ã\83\95ã\82¡ã\82¤ã\83«ã\83\87ã\82£ã\82¹ã\82¯ã\83ªã\83\97ã\82¿
.I socket
-¤Ç»²¾È¤µ¤ì¤ë¥½¥±¥Ã¥È¤Ë´ØÏ¢¤¹¤ë¥ª¥×¥·¥ç¥ó¤ÎÁàºî¤ò¹Ô¤¦¡£
-¥ª¥×¥·¥ç¥ó¤ÏÊ£¿ô¤Î¥×¥í¥È¥³¥ëÁØ(level)¤Ë¸ºß¤¹¤ë¤«¤â¤·¤ì¤Ê¤¤¤¬¡¢
-¤³¤ì¤é¤Ï¾ï¤ËºÇ¾å°Ì¤Î¥½¥±¥Ã¥ÈÁؤؤÈÀßÄꤵ¤ì¤ë¡£
+で参照されるソケットに関連するオプションの操作を行う。
+オプションは複数のプロトコル層(level)に存在するかもしれないが、
+これらは常に最上位のソケット層へと設定される。
.\"O When manipulating socket options, the level at which the
.\"O option resides and the name of the option must be specified.
.\"O .BR TCP ;
.\"O see
.\"O .BR getprotoent (3).
-¥½¥±¥Ã¥È¡¦¥ª¥×¥·¥ç¥ó¤òÁàºî¤¹¤ëºÝ¤Ë¤Ï¡¢¥ª¥×¥·¥ç¥ó¤ÎÁØ (level) ¤È
-¥ª¥×¥·¥ç¥ó¤Î̾Á°¤ò»ØÄꤷ¤Ê¤±¤ì¤Ð¤Ê¤é¤Ê¤¤¡£
-¥½¥±¥Ã¥È API Áؤǥª¥×¥·¥ç¥ó¤òÁàºî¤¹¤ë°Ù¤Ë¤Ï¡¢
+ソケット・オプションを操作する際には、オプションの層 (level) と
+オプションの名前を指定しなければならない。
+ソケット API 層でオプションを操作する為には、
.I level
-¤ò
+を
.B SOL_SOCKET
-¤Ë»ØÄꤹ¤ë¡£
-¾¤ÎÁ´¤Æ¤ÎÁؤǥª¥×¥·¥ç¥ó¤òÁàºî¤¹¤ë°Ù¤Ë¤Ï¡¢Í¿¤¨¤é¤ì¤¿¥ª¥×¥·¥ç¥ó¤Î
-À©¸æ¼çÂΤȤʤë¥×¥í¥È¥³¥ë¤Î¥×¥í¥È¥³¥ëÈÖ¹æ¤ò»ØÄꤹ¤ë¡£Î㤨¤Ð¡¢
-¥ª¥×¥·¥ç¥ó¤¬
+に指定する。
+他の全ての層でオプションを操作する為には、与えられたオプションの
+制御主体となるプロトコルのプロトコル番号を指定する。例えば、
+オプションが
.B TCP
-¥×¥í¥È¥³¥ë¤Ç²ò¼á¤µ¤ì¤ë¤Ù¤¤³¤È¤ò»Ø¼¨¤¹¤ë¤Ë¤Ï¡¢
+プロトコルで解釈されるべきことを指示するには、
.I level
-¤Ë
+に
.B TCP
-¤Î¥×¥í¥È¥³¥ëÈÖ¹æ¤ò»ØÄꤷ¤Ê¤±¤ì¤Ð¤Ê¤é¤Ê¤¤¡£
+のプロトコル番号を指定しなければならない。
.BR getprotoent (3)
-¤ò»²¾È¤¹¤ë¤³¤È¡£
+を参照すること。
.\"O The arguments
.\"O .I optval
.\"O are used to access option values for
.\"O .BR setsockopt ().
.I optval
-¤È
+と
.I optlen
-°ú¤¿ô¤Ï
+引き数は
.BR setsockopt ()
-¤Î¥ª¥×¥·¥ç¥ó¤ÎÃͤ˥¢¥¯¥»¥¹¤¹¤ë¤¿¤á¤ËÍѤ¤¤é¤ì¤ë¡£
+のオプションの値にアクセスするために用いられる。
.\"O For
.\"O .BR getsockopt ()
.\"O they identify a buffer in which the value for the
.\"O requested option(s) are to be returned.
.BR getsockopt ()
-¤Ç¤ÏÍ׵ᤷ¤¿¥ª¥×¥·¥ç¥ó¤ÎÃͤòÊÖ¤¹¤¿¤á¤Î¥Ð¥Ã¥Õ¥¡¡¼¤ò»ØÄꤹ¤ë¡£
+では要求したオプションの値を返すためのバッファーを指定する。
.\"O For
.\"O .BR getsockopt (),
.\"O .I optlen
.\"O .I optval
.\"O may be NULL.
.BR getsockopt ()
-¤Ç¤Ï
+では
.I optlen
-¤ÏÃͤȷë²ÌξÍѤΰú¤¿ô¤Ç¡¢ºÇ½é¤Ë
+は値と結果両用の引き数で、最初に
.I optval
-¤Î»Ø¤·¤Æ¤¤¤ë¥Ð¥Ã¥Õ¥¡¡¼¤Î¥µ¥¤¥º¤òÍ¿¤¨¡¢¼ÂºÝ¤ËÊÖ¤µ¤ì¤ëÃͤΥµ¥¤¥º¤Ë
-½ñ¤´¹¤¨¤é¤ì¤ë¡£¤â¤·¥ª¥×¥·¥ç¥óÃͤòÍ¿¤¨¤º¡¢ÊÖ¤µ¤ì¤â¤·¤Ê¤¤¾ì¹ç¤Ë¤Ï
+の指しているバッファーのサイズを与え、実際に返される値のサイズに
+書き換えられる。もしオプション値を与えず、返されもしない場合には
.I optval
-¤Ï NULL ¤Ç¤âÎɤ¤¡£
+は NULL でも良い。
.\"O .I Optname
.\"O and any specified options are passed uninterpreted to the appropriate
.\"O other protocol levels vary in format and name; consult the appropriate
.\"O entries in section 4 of the manual.
.I optname
-¤ª¤è¤Ó»ØÄꤵ¤ì¤¿¥ª¥×¥·¥ç¥ó¤Ï²ò¼á¤µ¤ì¤º¤Ë¡¢Å¬Àڤʥץí¥È¥³¥ë¡¦¥â¥¸¥å¡¼¥ë¤Ë
-ÅϤµ¤ì¤Æ²ò¼á¤µ¤ì¤ë¡£¥¤¥ó¥¯¥ë¡¼¥É¡¦¥Õ¥¡¥¤¥ë
+および指定されたオプションは解釈されずに、適切なプロトコル・モジュールに
+渡されて解釈される。インクルード・ファイル
.I <sys/socket.h>
-¤Ë¤Ï¸å½Ò¤Î¥½¥±¥Ã¥ÈÁؤΥª¥×¥·¥ç¥ó¤ÎÄêµÁ¤¬´Þ¤Þ¤ì¤Æ¤¤¤ë¡£
-¾¤Î¥×¥í¥È¥³¥ëÁؤǤÏ̾Á°¤ä·Á¼°¤Ï°Û¤Ê¤ë¡£
-¥Þ¥Ë¥å¥¢¥ë¤Î¥»¥¯¥·¥ç¥ó 4 ¤ÎŬÀڤʥ¨¥ó¥È¥ê¤ò»²¾È¤¹¤ë¤³¤È¡£
+には後述のソケット層のオプションの定義が含まれている。
+他のプロトコル層では名前や形式は異なる。
+マニュアルのセクション 4 の適切なエントリを参照すること。
.\"O Most socket-level options utilize an
.\"O .I int
.\"O .BR setsockopt (),
.\"O the argument should be nonzero to enable a boolean option, or zero if the
.\"O option is to be disabled.
-¤Û¤È¤ó¤É¤Î¥½¥±¥Ã¥ÈÁؤΥª¥×¥·¥ç¥ó¤Ï
+ほとんどのソケット層のオプションは
.I optval
-¤Ë
+に
.I int
-°ú¤¿ô¤òÍøÍѤ¹¤ë¡£
+引き数を利用する。
.BR setsockopt ()
-¤Ç¡¢ÆóÃÍ(boolean)¥ª¥×¥·¥ç¥ó¤ò͸ú(enable)¤Ë¤¹¤ë¤Ë¤Ï¥¼¥í°Ê³°¤ò»ØÄꤷ¡¢
-̵¸ú(disable)¤Ë¤¹¤ë¤Ë¤Ï¥¼¥í¤ò»ØÄꤹ¤ë¡£
+で、二値(boolean)オプションを有効(enable)にするにはゼロ以外を指定し、
+無効(disable)にするにはゼロを指定する。
.PP
.\"O For a description of the available socket options see
.\"O .BR socket (7)
.\"O and the appropriate protocol man pages.
-ÍøÍѲÄǽ¤Ê¥½¥±¥Ã¥È¥ª¥×¥·¥ç¥ó¤ÎÀâÌÀ¤Ë´Ø¤·¤Æ¤Ï¡¢
+利用可能なソケットオプションの説明に関しては、
.BR socket (7)
-¤ÈŬÀڤʥץí¥È¥³¥ë¤Î man ¥Ú¡¼¥¸¤ò»²¾È¤Î¤³¤È¡£
+と適切なプロトコルの man ページを参照のこと。
.\"O .SH "RETURN VALUE"
-.SH ÊÖ¤êÃÍ
+.SH 返り値
.\"O On success, zero is returned.
.\"O On error, \-1 is returned, and
.\"O .I errno
.\"O is set appropriately.
-À®¸ù¤·¤¿¾ì¹ç¤Ë¤Ï¥¼¥í¤òÊÖ¤¹¡£¥¨¥é¡¼»þ¤Ë¤Ï \-1 ¤¬ÊÖ¤µ¤ì¡¢
+成功した場合にはゼロを返す。エラー時には \-1 が返され、
.I errno
-¤¬Å¬ÀÚ¤ËÀßÄꤵ¤ì¤ë¡£
+が適切に設定される。
.\"O .SH ERRORS
-.SH ¥¨¥é¡¼
+.SH ã\82¨ã\83©ã\83¼
.TP 10
.B EBADF
.\"O The argument
.\"O .I sockfd
.\"O is not a valid descriptor.
-°ú¤¿ô
+引き数
.I sockfd
-¤¬Í¸ú¤Ê¥Ç¥£¥¹¥¯¥ê¥×¥¿¤Ç¤Ê¤¤¡£
+が有効なディスクリプタでない。
.TP
.B EFAULT
.\"O The address pointed to by
.\"O .I optlen
.\"O is not in a valid part of the process address space.
.I optval
-¤Ç»ØÄꤵ¤ì¤¿¥¢¥É¥ì¥¹¤¬¥×¥í¥»¥¹¤Î¥¢¥É¥ì¥¹¶õ´Ö¤Î͸ú¤ÊÉôʬ¤Ç¤Ï¤Ê¤¤¡£
+で指定されたアドレスがプロセスのアドレス空間の有効な部分ではない。
.BR getsockopt ()
-¤Î¾ì¹ç¡¢
+の場合、
.I optlen
-¤¬¥×¥í¥»¥¹¤Î¥¢¥É¥ì¥¹¶õ´Ö¤Î͸ú¤ÊÉôʬ¤Ç¤Ê¤¤¾ì¹ç¤Ë¤â¤³¤Î¥¨¥é¡¼¤¬ÊÖ¤µ¤ì¤ë¡£
+がプロセスのアドレス空間の有効な部分でない場合にもこのエラーが返される。
.TP
.B EINVAL
.\"O .I optlen
.\"O invalid in
.\"O .BR setsockopt ().
.BR setsockopt ()
-¤Ç
+で
.I option
-¤¬ÉÔÀµ¤Ç¤¢¤ë¡£
+が不正である。
.\"O In some cases this error can also occur for an invalid value in
.\"O .IR optval
.\"O (e.g., for the
.\"O option described in
.\"O .BR ip (7)).
.I optval
-¤Ë̵¸ú¤ÊÃͤ¬»ØÄꤵ¤ì¤¿¾ì¹ç¤Ë¤â¡¢¤³¤Î¥¨¥é¡¼¤¬È¯À¸¤¹¤ë²ÄǽÀ¤¬¤¢¤ë
-(Î㤨¤Ð¡¢
+に無効な値が指定された場合にも、このエラーが発生する可能性がある
+(例えば、
.BR ip (7)
-¤ËÀâÌÀ¤¬¤¢¤ë
+に説明がある
.B IP_ADD_MEMBERSHIP
-¥ª¥×¥·¥ç¥ó¤Ê¤É)¡£
+オプションなど)。
.TP
.B ENOPROTOOPT
.\"O The option is unknown at the level indicated.
-»ØÄꤵ¤ì¤¿ÁØ(level)¤Ë¤Ï¤³¤Î¥ª¥×¥·¥ç¥ó¤Ï¸ºß¤·¤Ê¤¤¡£
+指定された層(level)にはこのオプションは存在しない。
.TP
.B ENOTSOCK
.\"O The argument
.\"O .I sockfd
.\"O is a file, not a socket.
-°ú¤¿ô
+引き数
.I sockfd
-¤Ï¥Õ¥¡¥¤¥ë¤Ç¤¢¤ê¡¢¥½¥±¥Ã¥È¤Ç¤Ê¤¤¡£
+はファイルであり、ソケットでない。
.\"O .SH "CONFORMING TO"
-.SH ½àµò
+.SH 準拠
.\"O SVr4, 4.4BSD (these system calls first appeared in 4.2BSD),
.\"O POSIX.1-2001.
.\"O .\" SVr4 documents additional ENOMEM and ENOSR error codes, but does
.\"O .\" not document the
.\"O .\" .BR SO_SNDLOWAT ", " SO_RCVLOWAT ", " SO_SNDTIMEO ", " SO_RCVTIMEO
.\"O .\" options
-SVr4, 4.4BSD (¤³¤ì¤é¤Î¥·¥¹¥Æ¥à¡¦¥³¡¼¥ë¤Ï 4.2BSD ¤ÇºÇ½é¤Ë¸½¤ì¤¿),
+SVr4, 4.4BSD (これらのシステム・コールは 4.2BSD で最初に現れた),
POSIX.1-2001.
-.\" SVr4 ¤Ë¤Ï¾¤Ë ENOMEM ¤È ENOSR ¥¨¥é¡¼¡¦¥³¡¼¥É¤Ë¤Ä¤¤¤Æ¤âµ½Ò¤µ¤ì¤Æ¤¤¤ë¡£
-.\" ¤·¤«¤·¡¢
+.\" SVr4 には他に ENOMEM と ENOSR エラー・コードについても記述されている。
+.\" しかし、
.\" .BR SO_SNDLOWAT ", " SO_RCVLOWAT ", " SO_SNDTIMEO ", " SO_RCVTIMEO
-.\" ¥ª¥×¥·¥ç¥ó¤Ë´Ø¤¹¤ëµ½Ò¤Ï¤Ê¤¤¡£
+.\" オプションに関する記述はない。
.\"O .SH NOTES
-.SH Ãí°Õ
+.SH 注意
.\"O POSIX.1-2001 does not require the inclusion of
.\"O .IR <sys/types.h> ,
.\"O and this header file is not required on Linux.
.\"O However, some historical (BSD) implementations required this header
.\"O file, and portable applications are probably wise to include it.
-POSIX.1-2001 ¤Ç¤Ï
+POSIX.1-2001 では
.I <sys/types.h>
-¤Î¥¤¥ó¥¯¥ë¡¼¥É¤Ïɬ¿Ü¤È¤µ¤ì¤Æ¤ª¤é¤º¡¢
-Linux ¤Ç¤Ï¤³¤Î¥Ø¥Ã¥À¥Õ¥¡¥¤¥ë¤ÏɬÍפǤϤʤ¤¡£
-¤·¤«¤·¡¢Îò»ËŪ¤Ë¤Ï¡¢¤¤¤¯¤Ä¤«¤Î¼ÂÁõ (BSD ·Ï) ¤Ç¤³¤Î¥Ø¥Ã¥À¥Õ¥¡¥¤¥ë¤¬
-ɬÍפǤ¢¤ê¡¢°Ü¿¢À¤¬É¬Íפʥ¢¥×¥ê¥±¡¼¥·¥ç¥ó¤Ç¤Ï¤³¤Î¥Õ¥¡¥¤¥ë¤ò
-¥¤¥ó¥¯¥ë¡¼¥É¤¹¤ë¤Î¤¬¸ÌÀ¤Ç¤¢¤í¤¦¡£
+のインクルードは必須とされておらず、
+Linux ではこのヘッダファイルは必要ではない。
+しかし、歴史的には、いくつかの実装 (BSD 系) でこのヘッダファイルが
+必要であり、移植性が必要なアプリケーションではこのファイルを
+インクルードするのが賢明であろう。
.\"O The
.\"O .I optlen
.\"O .I "int [*]"
.\"O (and this is what 4.x BSD and libc4 and libc5 have).
.BR getsockopt ()
-¤È
+と
.BR setsockopt ()
-¤Î
+の
.I optlen
-°ú¤¿ô¤Ï¼ÂºÝ¤Ï
+引き数は実際は
.I int [*]
-¤Ç¤¢¤ë (¤½¤·¤Æ 4.x BSD ¤È libc4 ¤È libc5 ¤Ï¤½¤¦¤Ê¤Ã¤Æ¤¤¤ë)¡£
+である (そして 4.x BSD と libc4 と libc5 はそうなっている)。
.\"O Some POSIX confusion resulted in the present
.\"O .IR socklen_t ,
.\"O also used by glibc.
.\"O See also
-POSIX ¤Ç¤Ïäþ;¶ÊÀÞ¤ò·Ð¤Æ¸½ºß¤Î
+POSIX では紆余曲折を経て現在の
.I socklen_t
-¤Ë¤Ê¤Ã¤Æ¤ª¤ê¡¢
-glibc ¤Ç¤â
+になっており、
+glibc でも
.I socklen_t
-¤ò»È¤Ã¤Æ¤¤¤ë¡£
+を使っている。
.BR accept (2)
-¤â»²¾È¤Î¤³¤È¡£
+も参照のこと。
.\"O .SH BUGS
-.SH ¥Ð¥°
+.SH ã\83\90ã\82°
.\"O Several of the socket options should be handled at lower levels of the
.\"O system.
-¥½¥±¥Ã¥È¤Î¥ª¥×¥·¥ç¥ó¤Î¤¤¤¯¤Ä¤«¤Ï¥·¥¹¥Æ¥à¤Î¤è¤êÄ㤤ÁؤÇ
-½èÍý¤µ¤ì¤ë¤Ù¤¤Ç¤¢¤ë¡£
+ソケットのオプションのいくつかはシステムのより低い層で
+処理されるべきである。
.\"O .SH "SEE ALSO"
-.SH ´ØÏ¢¹àÌÜ
+.SH 関連項目
.BR ioctl (2),
.BR socket (2),
.BR getprotoent (3),
OSDN Git Service
