名称

getpeername — 接続されたピア (通信相手) の名前を取得する

ライブラリ

Standard C Library (libc, -lc)

書式

#include < sys/types.h>
#include < sys/socket.h>

int
getpeername( int s, struct sockaddr * restrict name, socklen_t * restrict namelen);

解説

getpeername() システムコールは、ソケット s に接続されたピア (通信相手) の名前を返します。 namelen 引数は、 name によって指される空間の総量を示すために初期化されるべきです。返り時に、それには、返された (バイト単位の) 名前の実際のサイズを含んでいます。名前は、提供されるバッファが小さすぎるなら、切り詰められます。

戻り値

The getpeername() function returns the value 0 if successful; otherwise the value -1 is returned and the global variable errno is set to indicate the error.

エラー

呼び出しは、次の場合でなければ、成功します:

[ EBADF]

引数 s が有効な記述子ではありません。

[ ECONNRESET]

接続が、ピア (通信相手) によってリセットされました。

[ EINVAL]

namelen 引数の値が有効ではありません。

[ ENOTSOCK]

引数 s がソケットではなくファイルです。

[ ENOTCONN]

ソケットが接続されていません。

[ ENOBUFS]

十分なリソースが操作を実行するためにシステムで利用可能でありません。

[ EFAULT]

name 引数がプロセスのアドレス空間の有効な部分ではないメモリを指しています。

関連項目

accept(2), bind(2), getsockname(2), socket(2)

歴史

getpeername() システムコールは、 4.2BSD で登場しました。