名称

getpeername − コネクトしている peer の名前を取り出す

形式

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

解説

getpeername は、 ソケット s にコネクトされている peer の名前を 返します。 namelen パラメタは、 name によって指し示される大きさを 示すように初期設定する必要があります。 リターン時、 これには、 返された名前の実際のサイズ(バイト数)が収められます。 与えられたバッファが少なすぎると、 名前は切り捨てられます。

診断

コールが成功した場合には 0 が返され、 失敗した場合には −1 が返されます。

エラー

次の場合でない限り、 コールは成功します。

[EBADF] 引数 s が有効なディスクリプタではない。

[ENOTSOCK] 引数 s は、 ソケットではなく、 ファイルである。

[ENOTCONN] そのソケットはコネクトされていない。

[ENOBUFS] 必要なシステムのリソースが使用可能でない。

[EFAULT] name パラメタが、 プロセスのアドレススペースの有効な部分にはないメモリを 指し示している。

関連事項

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

NEWS-OSRelease 4.1C