名前

       connect - ソケットの接続を行う

書式

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

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

説明

       connect()  システムコールは、ファイルディスクリプター sockfd が参照しているソケットを addr
       で指定されたアドレスに接続する。 addrlen 引数は addr  の大きさを示す。  addr  のアドレスの
       フォーマットはソケット  sockfd のアドレス空間により異なる。 さらなる詳細は socket(2)  を参
       照のこと。

       ソケット 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.)

返り値

       接続または対応づけに成功するとゼロを返す。 失敗すると -1 を返し、 errno に適切な値を設定す
       る。

エラー

       以下は一般的なソケットについてのエラーである。他にドメイン特有のエラー  が発生する可能性が
       ある。

       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 がサーバーで有効に
              なっている場合、 タイムアウトが非常に長くなる場合があるので注意すること。

準拠

       accept(): POSIX.1-2001, POSIX.1-2008, SVr4, 4.4BSD, (connect()  は 4.2BSD で初めて実装され
       た).

注意

       POSIX.1 では <sys/types.h> のインクルードは必須とされておらず、 Linux ではこのヘッダーファ
       イルは必要ではない。  しかし、歴史的には、いくつかの実装 (BSD 系) でこのヘッダーファイルが
       必要であり、移植性が必要なアプリケーションではこのファイルを  インクルードするのが賢明であ
       ろう。

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

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

例

       connect()  の利用例が getaddrinfo(3)  に記載されている。

関連項目

       accept(2), bind(2), getsockname(2), listen(2), socket(2), path_resolution(7), selinux(8)

この文書について

       この man ページは Linux man-pages プロジェクトのリリース 5.10 の一部である。プロジェクトの
       説明とバグ報告に関する情報は https://www.kernel.org/doc/man-pages/ に書かれている。