名称

sctp_getpaddrs, sctp_getladdrs — 呼び出し側のアドレスのリストを返す

ライブラリ

Standard C Library (libc, -lc)

書式

#include < sys/types.h>
#include < sys/socket.h>
#include < netinet/sctp.h>

int
sctp_getpaddrs( int s, sctp_assoc_t asocid, struct sockaddr **addrs);

int
sctp_getladdrs( int s, sctp_assoc_t asocid, struct sockaddr **addrs);

解説

sctp_getpaddrs() 関数は、ピア (相手側) アドレスのリストを取得するために使用されます。 sctp_getladdrs() 関数は、ローカルのアドレスのリストを取得するために使用されます。関心の関連付けは asocid 引数によって識別されます。成功すれば、引数 addrs に返されたソケットアドレスの新たに割り付けられた配列にアドレスが返されます。

呼び出し側が終了した後に、関数 sctp_freepaddrs() または sctp_freeladdrs() は、これらの呼び出しによって割り付けられたメモリを解放するために使用されるべきです。

戻り値

呼び出しは、失敗すれば -1 を返し、成功すれば addrs に返されたアドレスの数のカウントを返します。

エラー

関数は、次のエラーを返すかもしれません:

[ EINVAL]

リストされたアドレスが不正なファミリを持っているか、またはアドレスが提供されませんでした。

[ ENOMEM]

呼び出しは、ソケットアドレスを保持するためにメモリを割り付けることができません。

[ EBADF]

引数 s が、有効な記述子ではありません。

[ ENOTSOCK]

引数 s が、ソケットではありません。

関連項目

getsockopt(2), sctp_freeladdrs(3), sctp_freepaddrs(3), sctp(4)