.\" 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>
.\"
-.\" Japanese Version Copyright (c) 1997 SUTO, Mitsuaki
-.\" all rights reserved.
-.\" Translated Thu Jun 26 20:36:49 JST 1997
-.\" by SUTO, Mitsuaki <suto@av.crl.sony.co.jp>
-.\" Modified Sat Apr 3 14:56:26 JST 1999
-.\" by HANATAKA Shinya <hanataka@abyss.rim.or.jp>
-.\" 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"
+.\" This file was generated with po4a. Translate the source file.
+.\"
+.\"*******************************************************************
+.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
.SH 説明
-.BR getsockname ()
-は、ソケット
-.I sockfd
-に結び付けられている現在のアドレスを、
-.I addr
-が指すバッファに格納して返す。
-.I addrlen
-引き数は、
-.I addr
-が指している領域のサイズ (バイト単位) に初期化しておかなければならない。
-関数が返る時には、
-.I addrlen
-にはソケットアドレスの実際のサイズ (バイト単位) が格納される。
+\fBgetsockname\fP() は、ソケット \fIsockfd\fP に結び付けられている現在のアドレスを、 \fIaddr\fP
+が指すバッファに格納して返す。 \fIaddrlen\fP 引き数は、 \fIaddr\fP が指している領域のサイズ (バイト単位)
+に初期化しておかなければならない。 関数が返る時には、 \fIaddrlen\fP にはソケットアドレスの実際のサイズ (バイト単位) が格納される。
渡されたバッファが小さ過ぎた場合は、返されるアドレスの末尾が切り詰められる。
-この場合には、
-.I addrlen
-には、呼び出し時に指定された値よりも大きな値が格納される。
+この場合には、 \fIaddrlen\fP には、呼び出し時に指定された値よりも大きな値が格納される。
.SH 返り値
-成功した場合 0 を返す。失敗した場合 \-1 を返し、
-.I errno
-をエラーの内容に従って設定する。
+成功した場合にはゼロが返される。エラー時には \-1 が返され、 \fIerrno\fP が適切に設定される。
.SH エラー
-.TP
-.B EBADF
-引き数
-.I sockfd
-が有効なディスクリプタ (descriptor) ではない。
-.TP
-.B EFAULT
-引き数
-.I addr
-の指しているメモリがプロセスのアドレス空間の有効な部分ではない。
-.TP
-.B EINVAL
-.I addrlen
-が不正である (例えば、負で場合など)。
-.TP
-.B ENOBUFS
+.TP
+\fBEBADF\fP
+引き数 \fIsockfd\fP は有効なディスクリプターでない。
+.TP
+\fBEFAULT\fP
+引き数 \fIaddr\fP の指しているメモリがプロセスのアドレス空間の有効な部分ではない。
+.TP
+\fBEINVAL\fP
+\fIaddrlen\fP が不正である (例えば、負で場合など)。
+.TP
+\fBENOBUFS\fP
処理をするだけの十分なリソースがシステムに無い。
-.TP
-.B ENOTSOCK
-引き数
-.I sockfd
-がソケットではなくファイルである。
+.TP
+\fBENOTSOCK\fP
+引き数 \fIsockfd\fP がソケットではなくファイルである。
.SH 準拠
-SVr4, 4.4BSD
-.RB ( getsockname ()
-関数は 4.2BSD で追加された), POSIX.1-2001.
-.\" SVr4 には他に ENOMEM と ENOSR のエラーコードについての記述がある。
+.\" SVr4 documents additional ENOMEM
+.\" and ENOSR error codes.
+SVr4, 4.4BSD (\fBgetsockname\fP() 関数は 4.2BSD で追加された), POSIX.1\-2001.
.SH 注意
-.BR getsockname ()
-の三番目の引き数は (4.x BSD や libc4, libc5 と同様に) 実際には \fIint *\fP
-である。 glibc でも使われている現在の \fIsocklen_t\fP に関して、
-POSIX には少し混乱がある。
-詳しくは
-.BR accept (2)
+\fBgetsockname\fP() の三番目の引き数は (4.x BSD や libc4, libc5 と同様に) 実際には \fIint *\fP である。
+glibc でも使われている現在の \fIsocklen_t\fP に関して、 POSIX には少し混乱がある。 詳しくは \fBaccept\fP(2)
を参照のこと。
.SH 関連項目
-.BR bind (2),
-.BR socket (2),
-.BR getifaddrs (3),
-.BR ip (7),
-.BR socket (7),
-.BR unix (7)
+\fBbind\fP(2), \fBsocket\fP(2), \fBgetifaddrs\fP(3), \fBip\fP(7), \fBsocket\fP(7),
+\fBunix\fP(7)
OSDN Git Service
