CONNECT

名前

書式

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

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

説明

ソケット sockfd が SOCK_DGRAM 型であれば、 addr は、デフォルトのデータグラムの送信先のアドレスであり、 データグラムを受信する唯一のアドレスを示すに過ぎない。 ソケットが SOCK_STREAM 型もしくは SOCK_SEQPACKET 型であれば、このシステムコールは addr で指定されたアドレスに結び付けられたソケットに対する接続の 作成を試みる。

Some protocol sockets (e.g., UNIX domain stream sockets) may successfully connect() only once.

Some protocol sockets (e.g., datagram sockets in the UNIX and Internet domains) may use connect() multiple times to change their association.

Some protocol sockets (e.g., TCP sockets as well as datagram sockets in the UNIX and Internet domains) may dissolve the association by connecting to an address with the sa_family member of sockaddr set to AF_UNSPEC; thereafter, the socket can be connected to another address. (AF_UNSPEC is supported on Linux since kernel 2.2.)  

返り値

エラー

EACCES

UNIX ドメインソケットはパス名で識別される。 ソケットファイルへの書き込み許可がなかったか、パス名へ 到達するまでのディレクトリのいずれかに対する検索許可がなかった。 (path_resolution(7) も参照のこと)

EACCES, EPERM

ソケットのブロードキャストフラグが有効になっていないのに ユーザーがブロードキャストへ接続を試みた。または、ローカルのファイアウォールの 規則により接続の要求が失敗した。

EACCES can also be returned if an SELinux policy denied a connection (for example, if there is a policy saying that an HTTP proxy can only connect to ports associated with HTTP servers, and the proxy tries to connect to a different port). dd

EADDRINUSE

ローカルアドレスが既に使用されている。

EADDRNOTAVAIL

(インターネットドメインソケットの場合) sockfd が参照するソケットがそれ以前にアドレスにバインドされておらず、 そのソケットに一時ポートをバインドしようとした際に、 一時ポートとして使用する範囲のポート番号がすべて使用中であった。 ip(7) の /proc/sys/net/ipv4/ip_local_port_range の議論を参照のこと。

EAFNOSUPPORT

渡されたアドレスの sa_family フィールドが正しいアドレスファミリーではない。

EAGAIN

For nonblocking UNIX domain sockets, the socket is nonblocking, and the connection cannot be completed immediately. For other socket families, there are insufficient entries in the routing cache.

EALREADY

ソケットが非停止 (nonblocking) に設定されており、 前の接続が完了していない。

EBADF

sockfd が有効なオープンされたファイルディスクリプターでない。

ECONNREFUSED

A connect() on a stream socket found no one listening on the remote address.

EFAULT

ソケット構造体のアドレスがユーザーのアドレス空間外にある。

EINPROGRESS

The socket is nonblocking and the connection cannot be completed immediately. (UNIX domain sockets failed with EAGAIN instead.) It is possible to select(2) or poll(2) for completion by selecting the socket for writing. After select(2) indicates writability, use getsockopt(2) to read the SO_ERROR option at level SOL_SOCKET to determine whether connect() completed successfully (SO_ERROR is zero) or unsuccessfully (SO_ERROR is one of the usual error codes listed here, explaining the reason for the failure).

EINTR

捕捉されたシグナルによりシステムコールが中断された。 signal(7) 参照。

EISCONN

ソケットは既に接続 (connect) されている。

ENETUNREACH

到達できないネットワークである。

ENOTSOCK

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

EPROTOTYPE

ソケットタイプが要求された通信プロトコルではサポートされていない。 このエラーは、 例えば UNIX ドメインデータグラムソケットをストリームソケットに接続しようとした場合などに起こり得る。

ETIMEDOUT

接続を試みている途中で時間切れ (timeout) になった。サーバーが混雑していて 新たな接続を受け入れられないのかもしれない。 IP ソケットでは、 syncookie がサーバーで有効になっている場合、 タイムアウトが非常に長くなる場合があるので注意すること。

準拠

注意

For background on the socklen_t type, see accept(2).

connect() が失敗した場合、そのソケットの状態は不定だと考えること。 移植性を考慮したアプリケーションでは、そのソケットをクローズし、再接続用に新しいソケットを作成すべきである。  

例

関連項目

この文書について

Index

名前

書式

説明

返り値

エラー

準拠

注意

例

関連項目

この文書について