GETPEERNAME

名前

書式

int getpeername(int sockfd, struct sockaddr *addr, socklen_t *addrlen);  

説明

渡されたバッファーが小さ過ぎた場合は、返されるアドレスの末尾が切り詰められる。 この場合には、 addrlen には、呼び出し時に指定された値よりも大きな値が格納される。  

返り値

エラー

EBADF

引数 sockfd が有効なファイルディスクリプターでない。

EFAULT

addr 引数の指しているメモリーが有効なプロセスのアドレス空間の 一部でない。

EINVAL

addrlen が不正である (例えば、負で場合など)。

ENOBUFS

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

ENOTCONN

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

ENOTSOCK

ファイルディスクリプター sockfd がソケットを参照していない。

準拠

注意

ストリームソケットでは、 いったん connect(2) が実行されると、 どのソケットも getpeername() を使って相手ソケットのアドレスを取得できる。 一方、データグラムソケットはコネクションレスである (接続がない)。 データグラムソケットに対する connect(2) の呼び出しは、 write(2) や recv(2) で送信される出力データグラムの相手アドレスを設定するだけである。 connect(2) の呼び出し元は、 getpeername() を使って、それ以前にそのソケットに設定された相手アドレスを取得することができる。 しかし、相手ソケットはこの情報を知らないので、 相手ソケットで getpeername() を呼び出しても、 役に立つ情報は得られない (相手側でも connect(2) が呼び出されている場合を除く)。 なお、データグラムの受信側では recvfrom(2) を使って送信元アドレスを 取得できることも覚えておいてほしい。  

関連項目

この文書について

関連キーワード

Linux マニュアル 一覧

[man1] [man2] [man3] [man4] [man5] [man6] [man7] [man8]
[a] [b] [c] [d] [e] [f] [g] [h] [i] [j] [k] [l] [m] [n] [o] [p] [q] [r] [s] [t] [u] [v] [w] [x] [y] [z]

Index

名前

書式

説明

返り値

エラー

準拠

注意

関連項目

この文書について