socketpair

Section: System Calls (2)
Updated: 2025-10-29
Index JM Home Page roff page
 

名前

socketpair - 接続されたソケットのペアを作成する  

ライブラリ

標準 C ライブラリ (libc,~-lc)  

書式

#include <sys/socket.h>

int socketpair(int domain, int type, int protocol, int sv[2]);
 

説明

socketpair() は、指定されたドメイン domain に指定された種類 type で名前のないソケットの接続されたペアを作成する。 protocol が指定されると、このプロトコルを用いる。 これらの引数の詳細は socket(2) を参照のこと。

The file descriptors used in referencing the new sockets are returned in sv[0] and sv[1]. The two sockets are indistinguishable.  

返り値

On success, zero is returned. On error, -1 is returned, errno is set to indicate the error, and sv is left unchanged

On Linux (and other systems), socketpair() does not modify sv on failure. A requirement standardizing this behavior was added in POSIX.1-2008 TC2.  

エラー

EAFNOSUPPORT
このマシンでは指定されたアドレスファミリーがサポートされていない。
EFAULT
アドレス sv がこのプロセスで使えるアドレス空間を指定していない。
EMFILE
1プロセスがオープンできるファイルディスクリプター数の上限に達した。
ENFILE
オープンされたファイルの総数がシステム全体の上限に達していた。
EOPNOTSUPP
指定されたプロトコルではソケットのペアの作成がサポートされていない。
EPROTONOSUPPORT
このマシンでは指定されたプロトコルがサポートされていない。
 

バージョン

On Linux, the only supported domains for this call are AF_UNIX (or synonymously, AF_LOCAL) and AF_TIPC (since Linux 4.12).  

標準規格

POSIX.1-2024.  

歴史

POSIX.1-2001, 4.2BSD.

It is generally portable to/from non-BSD systems supporting clones of the BSD socket layer (including System V variants).

SOCK_CLOEXEC
SOCK_NONBLOCK
POSIX.1-2024; Linux 2.6.27. (See socket(2).)
 

関連項目

pipe(2), read(2), socket(2), write(2), socket(7), unix(7)


 

Index

名前
ライブラリ
書式
説明
返り値
エラー
バージョン
標準規格
歴史
関連項目

This document was created by man2html, using the manual pages.