.\" Copyright (c) 1983, 1991 The Regents of the University of California.
.\" All rights reserved.
.\"
+.\" %%%LICENSE_START(BSD_4_CLAUSE_UCB)
.\" Redistribution and use in source and binary forms, with or without
.\" modification, are permitted provided that the following conditions
.\" are met:
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
+.\" %%%LICENSE_END
.\"
.\" @(#)getsockname.2 6.4 (Berkeley) 3/10/91
.\"
.\" Modified Tue Oct 22 00:22:35 EDT 1996 by Eric S. Raymond <esr@thyrsus.com>
.\" Modified Sun Mar 28 21:26:46 1999 by Andries Brouwer <aeb@cwi.nl>
.\"
+.\"*******************************************************************
+.\"
+.\" This file was generated with po4a. Translate the source file.
+.\"
+.\"*******************************************************************
+.\"
.\" Japanese Version Copyright (c) 1997 SUTO, Mitsuaki
.\" all rights reserved.
.\" Translated Thu Jun 26 20:36:49 JST 1997
.\" Updated & Modified Sat Feb 5 17:23:11 JST 2005
.\" by Yuichi SATO <ysato444@yahoo.co.jp>
.\"
-.TH GETSOCKNAME 2 2008-12-03 "Linux" "Linux Programmer's Manual"
-.\"O .SH NAME
-.SH ̾Á°
-.\"O getsockname \- get socket name
-getsockname \- ¥½¥±¥Ã¥È¤Î̾Á°¤ò¼èÆÀ¤¹¤ë
-.\"O .SH SYNOPSIS
-.SH ½ñ¼°
+.TH GETSOCKNAME 2 2008\-12\-03 Linux "Linux Programmer's Manual"
+.SH 名前
+getsockname \- ソケットの名前を取得する
+.SH 書式
.nf
-.B #include <sys/socket.h>
+\fB#include <sys/socket.h>\fP
.sp
-.BI "int getsockname(int " sockfd ", struct sockaddr *" addr \
-", socklen_t *" addrlen );
+\fBint getsockname(int \fP\fIsockfd\fP\fB, struct sockaddr *\fP\fIaddr\fP\fB, socklen_t *\fP\fIaddrlen\fP\fB);\fP
.fi
-.\"O .SH DESCRIPTION
-.SH ÀâÌÀ
-.\"O .BR getsockname ()
-.\"O returns the current address to which the socket
-.\"O .I sockfd
-.\"O is bound, in the buffer pointed to by
-.\"O .IR addr .
-.\"O The
-.\"O .I addrlen
-.\"O argument should be initialized to indicate
-.\"O the amount of space (in bytes) pointed to by
-.\"O .IR addr .
-.BR getsockname ()
-¤Ï¡¢¥½¥±¥Ã¥È
-.I sockfd
-¤Ë·ë¤ÓÉÕ¤±¤é¤ì¤Æ¤¤¤ë¸½ºß¤Î¥¢¥É¥ì¥¹¤ò¡¢
-.I addr
-¤¬»Ø¤¹¥Ð¥Ã¥Õ¥¡¤Ë³ÊǼ¤·¤ÆÊÖ¤¹¡£
-.I addrlen
-°ú¤¿ô¤Ï¡¢
-.I addr
-¤¬»Ø¤·¤Æ¤¤¤ëÎΰè¤Î¥µ¥¤¥º (¥Ð¥¤¥Èñ°Ì) ¤Ë½é´ü²½¤·¤Æ¤ª¤«¤Ê¤±¤ì¤Ð¤Ê¤é¤Ê¤¤¡£
-.\"O On return it contains the actual size of the socket address.
-.\"O returned (in bytes).
-´Ø¿ô¤¬ÊÖ¤ë»þ¤Ë¤Ï¡¢
-.I addrlen
-¤Ë¤Ï¥½¥±¥Ã¥È¥¢¥É¥ì¥¹¤Î¼ÂºÝ¤Î¥µ¥¤¥º (¥Ð¥¤¥Èñ°Ì) ¤¬³ÊǼ¤µ¤ì¤ë¡£
+.SH 説明
+\fBgetsockname\fP() は、ソケット \fIsockfd\fP に結び付けられている現在のアドレスを、 \fIaddr\fP
+が指すバッファに格納して返す。 \fIaddrlen\fP 引き数は、 \fIaddr\fP が指している領域のサイズ (バイト単位)
+に初期化しておかなければならない。 関数が返る時には、 \fIaddrlen\fP にはソケットアドレスの実際のサイズ (バイト単位) が格納される。
-.\"O The returned address is truncated if the buffer provided is too small;
-.\"O in this case,
-.\"O .I addrlen
-.\"O will return a value greater than was supplied to the call.
-ÅϤµ¤ì¤¿¥Ð¥Ã¥Õ¥¡¤¬¾®¤µ²á¤®¤¿¾ì¹ç¤Ï¡¢ÊÖ¤µ¤ì¤ë¥¢¥É¥ì¥¹¤ÎËöÈø¤¬ÀÚ¤êµÍ¤á¤é¤ì¤ë¡£
-¤³¤Î¾ì¹ç¤Ë¤Ï¡¢
-.I addrlen
-¤Ë¤Ï¡¢¸Æ¤Ó½Ð¤·»þ¤Ë»ØÄꤵ¤ì¤¿Ãͤè¤ê¤âÂ礤ÊÃͤ¬³ÊǼ¤µ¤ì¤ë¡£
-.\"O .SH "RETURN VALUE"
-.SH ÊÖ¤êÃÍ
-.\"O On success, zero is returned.
-.\"O On error, \-1 is returned, and
-.\"O .I errno
-.\"O is set appropriately.
-À®¸ù¤·¤¿¾ì¹ç 0 ¤òÊÖ¤¹¡£¼ºÇÔ¤·¤¿¾ì¹ç \-1 ¤òÊÖ¤·¡¢
-.I errno
-¤ò¥¨¥é¡¼¤ÎÆâÍƤ˽¾¤Ã¤ÆÀßÄꤹ¤ë¡£
-.\"O .SH ERRORS
-.SH ¥¨¥é¡¼
-.TP
-.B EBADF
-.\"O The argument
-.\"O .I sockfd
-.\"O is not a valid descriptor.
-°ú¤¿ô
-.I sockfd
-¤¬Í¸ú¤Ê¥Ç¥£¥¹¥¯¥ê¥×¥¿ (descriptor) ¤Ç¤Ï¤Ê¤¤¡£
-.TP
-.B EFAULT
-.\"O The
-.\"O .I addr
-.\"O argument points to memory not in a valid part of the
-.\"O process address space.
-°ú¤¿ô
-.I addr
-¤Î»Ø¤·¤Æ¤¤¤ë¥á¥â¥ê¤¬¥×¥í¥»¥¹¤Î¥¢¥É¥ì¥¹¶õ´Ö¤Î͸ú¤ÊÉôʬ¤Ç¤Ï¤Ê¤¤¡£
-.TP
-.B EINVAL
-.\"O .I addrlen
-.\"O is invalid (e.g., is negative).
-.I addrlen
-¤¬ÉÔÀµ¤Ç¤¢¤ë (Î㤨¤Ð¡¢Éé¤Ç¾ì¹ç¤Ê¤É)¡£
-.TP
-.B ENOBUFS
-.\"O Insufficient resources were available in the system
-.\"O to perform the operation.
-½èÍý¤ò¤¹¤ë¤À¤±¤Î½½Ê¬¤Ê¥ê¥½¡¼¥¹¤¬¥·¥¹¥Æ¥à¤Ë̵¤¤¡£
-.TP
-.B ENOTSOCK
-.\"O The argument
-.\"O .I sockfd
-.\"O is a file, not a socket.
-°ú¤¿ô
-.I sockfd
-¤¬¥½¥±¥Ã¥È¤Ç¤Ï¤Ê¤¯¥Õ¥¡¥¤¥ë¤Ç¤¢¤ë¡£
-.\"O .SH "CONFORMING TO"
-.SH ½àµò
-.\"O SVr4, 4.4BSD (the
-.\"O .BR getsockname ()
-.\"O function call appeared in 4.2BSD), POSIX.1-2001.
-.\"O .\" SVr4 documents additional ENOMEM
-.\"O .\" and ENOSR error codes.
-SVr4, 4.4BSD
-.RB ( getsockname ()
-´Ø¿ô¤Ï 4.2BSD ¤ÇÄɲ䵤줿), POSIX.1-2001.
-.\" SVr4 ¤Ë¤Ï¾¤Ë ENOMEM ¤È ENOSR ¤Î¥¨¥é¡¼¥³¡¼¥É¤Ë¤Ä¤¤¤Æ¤Îµ½Ò¤¬¤¢¤ë¡£
-.\"O .SH NOTES
-.SH Ãí°Õ
-.\"O The third argument of
-.\"O .BR getsockname ()
-.\"O is in reality an \fIint *\fP
-.\"O (and this is what 4.x BSD and libc4 and libc5 have).
-.\"O Some POSIX confusion resulted in the present \fIsocklen_t\fP,
-.\"O also used by glibc.
-.BR getsockname ()
-¤Î»°ÈÖÌܤΰú¤¿ô¤Ï (4.x BSD ¤ä libc4, libc5 ¤ÈƱÍͤË) ¼ÂºÝ¤Ë¤Ï \fIint *\fP
-¤Ç¤¢¤ë¡£ glibc ¤Ç¤â»È¤ï¤ì¤Æ¤¤¤ë¸½ºß¤Î \fIsocklen_t\fP ¤Ë´Ø¤·¤Æ¡¢
-POSIX ¤Ë¤Ï¾¯¤·º®Í𤬤¢¤ë¡£
-.\"O See also
-.\"O .BR accept (2).
-¾Ü¤·¤¯¤Ï
-.BR accept (2)
-¤ò»²¾È¤Î¤³¤È¡£
-.\"O .SH "SEE ALSO"
-.SH ´ØÏ¢¹àÌÜ
-.BR bind (2),
-.BR socket (2),
-.BR getifaddrs (3),
-.BR ip (7),
-.BR socket (7),
-.BR unix (7)
+渡されたバッファが小さ過ぎた場合は、返されるアドレスの末尾が切り詰められる。
+この場合には、 \fIaddrlen\fP には、呼び出し時に指定された値よりも大きな値が格納される。
+.SH 返り値
+成功した場合にはゼロが返される。エラー時には \-1 が返され、 \fIerrno\fP が適切に設定される。
+.SH エラー
+.TP
+\fBEBADF\fP
+引き数 \fIsockfd\fP は有効なディスクリプターでない。
+.TP
+\fBEFAULT\fP
+引き数 \fIaddr\fP の指しているメモリがプロセスのアドレス空間の有効な部分ではない。
+.TP
+\fBEINVAL\fP
+\fIaddrlen\fP が不正である (例えば、負で場合など)。
+.TP
+\fBENOBUFS\fP
+処理をするだけの十分なリソースがシステムに無い。
+.TP
+\fBENOTSOCK\fP
+引き数 \fIsockfd\fP がソケットではなくファイルである。
+.SH 準拠
+.\" SVr4 documents additional ENOMEM
+.\" and ENOSR error codes.
+SVr4, 4.4BSD (\fBgetsockname\fP() 関数は 4.2BSD で追加された), POSIX.1\-2001.
+.SH 注意
+\fBgetsockname\fP() の三番目の引き数は (4.x BSD や libc4, libc5 と同様に) 実際には \fIint\ *\fP
+である。 glibc でも使われている現在の \fIsocklen_t\fP に関して、 POSIX には少し混乱がある。 詳しくは \fBaccept\fP(2)
+を参照のこと。
+.SH 関連項目
+\fBbind\fP(2), \fBsocket\fP(2), \fBgetifaddrs\fP(3), \fBip\fP(7), \fBsocket\fP(7),
+\fBunix\fP(7)
+.SH この文書について
+この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.76 の一部
+である。プロジェクトの説明とバグ報告に関する情報は
+http://www.kernel.org/doc/man\-pages/ に書かれている。
OSDN Git Service
