ACCEPT

名前

書式

#include <sys/types.h>          /* 「注意」参照 */
#include <sys/socket.h>

int accept(int sockfd, struct sockaddr *addr, socklen_t *addrlen);

#define _GNU_SOURCE             /* feature_test_macros(7) 参照 */
#include <sys/socket.h>

int accept4(int sockfd, struct sockaddr *addr,
            socklen_t *addrlen, int flags);

説明

引き数 sockfd は、 socket(2) によって生成され、 bind(2) によってローカルアドレスにバインドされ、 listen(2) を経て接続を待っているソケットである。

addr 引き数は sockaddr 構造体へのポインターである。 この構造体には接続相手のソケットのアドレスが入っている。 addr 引き数で返されるアドレスの正確なフォーマットは、 ソケットのアドレス種別によって変わる (socket(2) およびそれぞれのプロトコルの man ページを参照)。 addr が NULL の場合、 addr には何も入らない。この場合、 addrlen は使用されず、この引き数は NULL にしておくべきである。

addrlen 引き数は入出力両用の引き数である。呼び出し時には、呼び出し元が addr が指す構造体のサイズ (バイト単位) で初期化しておかなければならない。 返ってくる時には、接続相手のアドレスの実際の大きさが格納される。

渡されたバッファーが小さ過ぎた場合は、返されるアドレスの末尾が切り詰められる。 この場合には、 addrlen には、呼び出し時に指定された値よりも大きな値が格納される。

キューに保留となっている接続要求がなく、 かつソケットが非停止になっていないときは、 accept() は接続が発生するまで呼び出し元を停止 (block) する。 ソケットが非停止になっていて、 待ち状態の接続要求がキューに無いときは、 accept() はエラー EAGAIN か EWOULDBLOCK で失敗する。

ソケットへの接続到着を知るには、 select(2), poll(2), epoll(7) のいずれかを用いればよい。 新しい接続要求が来るとソケットは読み込み可能になるので、 そうしたら accept() を呼んでその接続に対するソケットを取得すればよい。 あるいはソケットに設定を行い、何らかのアクションがあったときに SIGIO を配送 (deliver) させるようにすることもできる。詳細は socket(7) を参照のこと。

flags が 0 の場合、 accept4() は accept() と同じである。 flags に以下の値をビット毎の論理和 (OR) で指定することで、 異なる動作をさせることができる。

SOCK_NONBLOCK

新しいファイルディスクリプターで参照される オープンファイル記述 (open file description) (open(2) を参照) の O_NONBLOCK ファイルステータスフラグをセットする。 このフラグを使うことで、 O_NONBLOCK をセットするために fcntl(2) を追加で呼び出す必要がなくなる。

SOCK_CLOEXEC

新しいファイルディスクリプターに対して close-on-exec (FD_CLOEXEC) フラグをセットする。 このフラグが役に立つ理由については、 open(2) の O_CLOEXEC フラグの説明を参照のこと。

返り値

エラー処理

エラー

EAGAIN または EWOULDBLOCK

ソケットが非停止になっていて、かつ受付け対象の接続が存在しない。 POSIX.1-2001 と POSIX.1-2008 は、この場合にどちらのエラーを返すことも認めており、 これら 2 つの定数が同じ値を持つことも求めていない。 したがって、移植性が必要なアプリケーションでは、両方の可能性を 確認すべきである。

EBADF

sockfd がオープンファイルディスクリプターではない。

ECONNABORTED

接続が中止された。

EFAULT

addr 引き数がユーザーアドレス空間の書き込み可能領域にない。

EINTR

有効な接続が到着する前に捕捉されたシグナルによって システムコールが中断された。 signal(7) 参照。

EINVAL

ソケットが接続待ち状態ではない。もしくは、 addrlen が不正である (例えば、負の場合など)。

EINVAL

(accept4()) flags に不正な値が指定されている。

EMFILE

1 プロセスがオープンできるファイルディスクリプター数の上限に達した。

ENFILE

オープンされたファイルの総数がシステム全体の上限に達した。

ENOBUFS, ENOMEM

メモリーが足りない。 多くの場合は、システムメモリーが足りないわけではなく、 ソケットバッファーの大きさによるメモリー割り当ての制限である。

ENOTSOCK

ファイルディスクリプター sockfd がソケットを参照していない。

EOPNOTSUPP

参照しているソケットの型が SOCK_STREAM でない。

EPROTO

プロトコルエラー。

上記に加えて、Linux の accept() は以下のエラーで失敗する:

EPERM

ファイアウォールのルールにより接続が禁止された。

この他に、新しいソケットに対するネットワークエラーが返されることもある。 これらはそれぞれのプロトコルで定義されている。 いろいろな Linux カーネルでは、 以下に示すようなエラーを返すこともある。 ENOSR, ESOCKTNOSUPPORT, EPROTONOSUPPORT, ETIMEDOUT. ERESTARTSYS がトレースの最中に現れることもある。  

バージョン

準拠

accept4() は非標準の Linux による拡張である。

Linux では、 accept() が返す新しいソケットは listen を行っているソケットの ファイル状態フラグ (O_NONBLOCK や O_ASYNC など) を継承「しない」。 この動作は標準的な BSD ソケットの実装とは異なっている。 移植性を考慮したプログラムではファイル状態フラグが継承されるかどうかは 前提にせず、常に accept() が返したソケットに対して全ての必要なフラグを明示的に設定するように すべきである。  

注意

SIGIO が届けられた後や、 select(2), poll(2), epoll(7) が読み込み可能イベントを返した後に、必ずしも待機中の接続があるとは 限らない。 なぜならその接続は、 accept() が呼ばれる前に、非同期的なネットワークエラーや 他のスレッドから呼ばれた (別の) accept によって 削除されているかもしれないからである。 この場合、その accept() 呼び出しは停止 (block) し、次の接続の到着を待ちつづける。 accept() に停止を行わせないようにするには、引き数に渡すソケット sockfd に O_NONBLOCK フラグをセットしておく必要がある (socket(7) を見よ)。

明示的な接続確認 (confirmation) を必要とするようなプロトコル (DECNet など) では、 accept() は単に次の接続要求をキューから取り出すだけであり、 接続確認は行わないことに注意せよ。 接続確認は、新しいファイルディスクリプターに対する 通常の読み取り/書き込みによってなされ、接続拒否 (rejection) は新しいソケットを クローズすることによってなされる。 現在のところ、Linux 上でこれらのセマンティクスを持つのは DECNet だけである。  

socklen_t 型

例

関連項目

この文書について

Index

名前

書式

説明

返り値

エラー処理

エラー

バージョン

準拠

注意

socklen_t 型

例

関連項目

この文書について