名称

getsockname − ソケット名を取り出す

形式

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

解説

getsockname は、 指定されたソケットの現在の名前 ( name ) を 返します。 namelen パラメタは、 name によって指し示されるエリアの大きさを 示すように初期設定する必要があります。 リターン時、 namelen には、 返された名前の実際のサイズ (バイト数) が収められます。

診断

コールが成功すると 0 が返され、 失敗すると −1 が返されます。

エラー

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

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

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

[ENOBUFS] このオペレーションを 遂行するに足るリソースがシステムで使用可能ではない。

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

関連事項

bind(2), socket(2)

バグ

UNIX ドメイン内でソケットに割り当てられている名前はアクセス不能です。 これを指定した場合、 getsockname は、長さがゼロの名前を返します。

NEWS-OSRelease 4.2.1R