名 前
getsockname − ソ ケ ッ ト の 名 前 を 取 得 す る
書 式
#include <sys/socket.h>
int getsockname(int sockfd, struct sockaddr *addr, socklen_t *addrlen);
説 明
getsockname() は 、 ソ ケ ッ ト sockfd に 結 び 付 け ら れ て い る 現 在 の ア ド レ ス を 、 addr が 指 す バ ッ フ ァ ー に 格 納 し て 返 す 。 addrlen 引 き 数 は 、 addr が 指 し て い る 領 域 の サ イ ズ (バ イ ト 単 位 ) に 初 期 化 し て お か な け れ ば な ら な い 。 関 数 が 返 る 時 に は 、 addrlen に は ソ ケ ッ ト ア ド レ ス の 実 際 の サ イ ズ (バ イ ト 単 位 ) が 格 納 さ れ る 。 渡 さ れ た バ ッ フ ァ ー が 小 さ 過 ぎ た 場 合 は 、 返 さ れ る ア ド レ ス の 末 尾 が 切 り 詰 め ら れ る 。 こ の 場 合 に は 、 addrlen に は 、 呼 び 出 し 時 に 指 定 さ れ た 値 よ り も 大 き な 値 が 格 納 さ れ る 。
返 り 値
成 功 し た 場 合 に は ゼ ロ が 返 さ れ る 。 エ ラ ー 時 に は −1 が 返 さ れ 、 errno が 適 切 に 設 定 さ れ る 。
エ ラ ー
|
EBADF 引 き 数 |
sockfd は 有 効 な デ ィ ス ク リ プ タ ー で な い 。 | ||
|
EFAULT 引 き 数 |
addr の 指 し て い る メ モ リ ー が プ ロ セ ス の ア ド レ ス 空 間 の 有 効 な |
部 分 で は な い 。
|
EINVAL |
addrlen が 不 正 で あ る (例 え ば 、 負 で 場 合 な ど )。 |
ENOBUFS 処
理 を す る だ け
の 十 分 な リ ソ
ー ス が シ ス テ
ム に 無 い 。
ENOTSOCK 引 き 数 sockfd
が ソ ケ ッ ト で
は な く フ ァ イ
ル で あ る 。
準 拠
SVr4, 4.4BSD (getsockname() 関 数 は 4.2BSD で 追 加 さ れ た ), POSIX.1−2001.
注 意
getsockname() の 三 番 目 の 引 き 数 は (4.x BSD や libc4, libc5 と 同 様 に ) 実 際 に は int * で あ る 。 glibc で も 使 わ れ て い る 現 在 の socklen_t に 関 し て 、 POSIX に は 少 し 混 乱 が あ る 。 詳 し く は accept(2) を 参 照 の こ と 。
関 連 項 目
bind(2), socket(2), getifaddrs(3), ip(7), socket(7), unix(7)
こ の 文 書 に つ い て
こ の man ペ ー ジ は Linux man−pages プ ロ ジ ェ ク ト の リ リ ー ス 3.79 の 一 部 で あ る 。 プ ロ ジ ェ ク ト の 説 明 と バ グ 報 告 に 関 す る 情 報 は http://www.kernel.org/doc/man−pages/ に 書 か れ て い る 。