getpeername
Section: System Calls (2)
Updated: 2025-10-29
Index
JM Home Page
roff page
名前
getpeername - 接続している相手ソケットの名前を取得する
ライブラリ
標準 C ライブラリ (libc,~-lc)
書式
#include <sys/socket.h>
int getpeername(int sockfd, struct sockaddr *restrict addr,
socklen_t *restrict addrlen);
説明
getpeername() は、ソケット(socket) sockfd に接続している相手のアドレスを、 addr
が指すバッファーに格納して返す。 addrlen 引数は、 addr が指している領域のサイズに初期化しておかなければならない。
関数が返る時には、 addrlen には実際に返された名前のサイズが (バイト単位で) 格納される。
提供されたバッファーが小さすぎた場合には、名前は切り詰められる。
渡されたバッファーが小さ過ぎた場合は、返されるアドレスの末尾が切り詰められる。 この場合には、 addrlen
には、呼び出し時に指定された値よりも大きな値が格納される。
返り値
On success, zero is returned. On error, -1 is returned, and errno is set
to indicate the error.
エラー
- EBADF
-
引数 sockfd が有効なファイルディスクリプターでない。
- EFAULT
-
addr 引数の指しているメモリーが有効なプロセスのアドレス空間の 一部でない。
- EINVAL
-
addrlen が不正である (例えば、負で場合など)。
- ENOBUFS
-
この操作を行なうのに十分な資源がシステムに存在しない。
- ENOTCONN
-
ソケットが接続していない。
- ENOTSOCK
-
ファイルディスクリプター sockfd がソケットを参照していない。
標準規格
POSIX.1-2024.
歴史
POSIX.1-2001, SVr4, 4.4BSD (4.2BSD で初めて登場した)。
注意
ストリームソケットでは、 いったん connect(2) が実行されると、 どのソケットも getpeername()
を使って相手ソケットのアドレスを取得できる。 一方、データグラムソケットはコネクションレスである (接続がない)。 データグラムソケットに対する
connect(2) の呼び出しは、 write(2) や recv(2)
で送信される出力データグラムの相手アドレスを設定するだけである。
connect(2) の呼び出し元は、 getpeername()
を使って、それ以前にそのソケットに設定された相手アドレスを取得することができる。 しかし、相手ソケットはこの情報を知らないので、 相手ソケットで
getpeername() を呼び出しても、 役に立つ情報は得られない (相手側でも connect(2) が呼び出されている場合を除く)。
なお、データグラムの受信側では recvfrom(2) を使って送信元アドレスを 取得できることも覚えておいてほしい。
関連項目
accept(2), bind(2), getsockname(2), ip(7), socket(7),
unix(7)
Index
- 名前
-
- ライブラリ
-
- 書式
-
- 説明
-
- 返り値
-
- エラー
-
- 標準規格
-
- 歴史
-
- 注意
-
- 関連項目
-
This document was created by
man2html,
using the manual pages.