sctp_opt_info サブルーチン

オンライン編集

目的

SCTP スタックとの間で情報を受け渡します。

ライブラリー

標準 C ライブラリー (libc.a)

構文

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

int sctp_opt_info(sd, id, opt, *arg_size, *size);
int sd;
sctp_assoc_t id;
int opt;
void *arg_size;
size_t *size;

説明

アプリケーションは、 SCT_OPT_INFO サブルーチンを使用して、スタックからさまざまな SCTP ソケット・オプションに関する情報を取得します。 複数の関連を持つソケットの場合、関連 ID を指定して、ソケットの特定の関連に操作を適用することができます。 SCTP 関連はマルチホームをサポートするため、この操作を使用して、 Sockaddr_storage 構造体を使用する特定のピア・アドレスを指定することができます。 この場合、操作の結果はその特定のピア・アドレスにのみ適用されます。

実行の特性

SCT_OPT_INFO サブルーチンは、基本オペレーティング・システム (BOS) ランタイムの一部です。

パラメーター

項目 説明
sd ソケット システム・コールから戻される UDP スタイルのソケット記述子を指定します。
id 照会する関連の ID を指定します。
OPT 取得するソケット・オプションを指定します。
引数サイズ 呼び出し元によって提供されるオプション固有の構造体バッファーを指定します。
size 返されるオプションのサイズを指定します。

戻り値

正常終了すると、 SCT_OPT_INFO サブルーチンは 0 を戻します。

sctp_opt_infoサブルーチンが失敗した場合、サブルーチン・ハンドラは呼び出し元のプログラ ムに値-11を返し、errnoに適切なエラー・コードを設定する。

エラー・コード

以下のいずれかのエラーが発生すると、 SCT_OPT_INFO サブルーチンは失敗します。

項目 説明
EFAULT ユーザーがデータにアクセスするための十分な権限を持っていないか、または ユーザー・アドレス パラメーターに指定されたアドレスが無効であることを示します。
EIO データの参照中に永続入出力エラーが発生したことを示します。
ENOMEM 必要なページング操作のためのメモリーが不足していることを示します。
ENOSPC ファイル・システムまたはページング・スペースが不十分であることを示します。
ENOBUFS 呼び出しを完了するための十分なリソースがシステムにありませんでした。
ENOPROTOOPT プロトコルが使用できません 。
ENOTSOCK ユーザーが非ソケットでソケット操作を行おうとしたことを示します。