manページ  — SOCKETPAIR

socketpair – 接続されたソケットのペアの作成

ライブラリ 書式 解説 戻り値 エラー 関連項目 バグ 歴史

Standard C Library (libc, -lc)

#include <sys/types.h>

#include <sys/socket.h>

int
socketpair(int d, int type, int protocol, int *sv);

socketpair() システムコールは、任意に指定された protocol を使用し、指定された type の、名前を持たない、接続されたソケットのペアを、指定されたドメイン d に作成します。 このとき、ペアは指定できません。 新しいソケットの参照に使用された記述子は、 sv, Ns, [0] と sv, Ns, [1] に戻されます。 2 つのソケットは区別できません。

The socketpair function returns the value 0 if successful; otherwise the value -1 is returned and the global variable errno is set to indicate the error.

以下のような場合、処理を失敗します:

[EMFILE]
	プロセスで使用されている記述子が多すぎます。
[EAFNOSUPPORT]
	指定されたアドレスファミリが、この機械でサポートされていません。
[EPROTONOSUPPORT]
	指定したプロトコルが、この機械でサポートされていません。
[EOPNOTSUPP]
	指定したプロトコルでの、ソケットペアの作成がサポートされていません。
[EFAULT]
	アドレス sv が、プロセスアドレス空間の有効な部分を指定していません。

この呼び出しは、現在のところ Unix ドメインのみで実装されています。

socketpair() システムコールは BSD 4.2 で登場しました。