GETPEERNAME(2)

名前
getpeername - 接続している相手の名前を取得する

書式
#include <sys/socket.h>

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

説明
getpeername はソケット(socket) s に接続している相手の名前を返す。 namelen パラメーターは name で指定された領域のサイズに初期化されなければならない。 返された時にはそれには実際に返された名前のサイズが(バイト単位で) 格納されている。 提供されたバッファーが小さすぎる場合には名前は切り詰められる。

返り値
成功した場合はゼロが返される。エラーの場合は -1 が返され、 errno を適切に設定する。

エラー

EBADF
    引き数 s が有効なディスクリプターでない。

ENOTSOCK
    引き数 s がソケットでなくてファイルである。

ENOTCONN
    ソケットが接続していない。

ENOBUFS
    システムにこの操作を行なうのに十分な資源が存在しない。

EFAULT
    name パラメーターの指しているメモリが有効なプロセスのアドレス空間の 一部でない。

準拠
SVr4, 4.4BSD ( getpeername 関数は BSD 4.2 で現われた).

関連項目
accept(2), bind(2), getsockname(2)