CONNECT
Section: System Calls (2)
索引
jman
BSD mandoc
索引
名称
connect
- ソケット上で接続を開始する
索引
ライブラリ
Lb libc
索引
書式
In sys/types.h
In sys/socket.h
Ft int
Fn connect int s const struct sockaddr *name socklen_t namelen
索引
解説
Fa s
引数はソケットです。
このタイプが
SOCK_DGRAM
の場合、この呼び出しはソケットが結び付けられる
通信相手を指定します。
このアドレスは送信データグラムの送信先であり、
受信データグラムの送信元となる唯一のアドレスです。
ソケットのタイプが
SOCK_STREAM
の場合、この呼び出しは通信相手のソケットに接続を確立
しようとします。
通信相手のソケットは
Fa name
で指定されます。
Fa name
はソケット通信空間内のアドレスです。
各通信空間は
Fa name
引数を独自の方法で解釈します。
一般に、ストリームソケットが正常に
Fn connect
できるのは 1 回だけです。
データグラムソケットは
Fn connect
を複数回使用してその結び付けを変更できます。
データグラムソケットは、NULL アドレスのような無効なアドレスに
接続することによって結び付けを解除できます。
索引
戻り値
Rv -std connect
索引
エラー
Fn connect
システムコールは次の場合に失敗します:
- Bq Er EBADF
-
Fa s
引数が有効な記述子でありません。
- Bq Er ENOTSOCK
-
Fa s
引数がソケットではなくファイルの記述子です。
- Bq Er EADDRNOTAVAIL
-
指定のアドレスがこのマシンでは利用できません。
- Bq Er EAFNOSUPPORT
-
指定のアドレスファミリ内のアドレスがこのソケットでは使用できません。
- Bq Er EISCONN
-
ソケットは既に接続されています。
- Bq Er ETIMEDOUT
-
接続を確立することなく、タイムアウトしました。
- Bq Er ECONNREFUSED
-
接続が強制的に拒絶されました。
- Bq Er ENETUNREACH
-
このホストからそのネットワークに到達できません。
- Bq Er EHOSTUNREACH
-
このホストからそのリモートホストに到達できません。
- Bq Er EADDRINUSE
-
アドレスが既に使用中です。
- Bq Er EFAULT
-
Fa name
引数はプロセスアドレス空間の外側の領域を指定しています。
- Bq Er EINPROGRESS
-
非ブロッキングのソケットで、接続がすぐには確立できませんでした。
ソケットへの書込みを
select(2)
で待つことによって、接続完了を待つことができます。
- Bq Er EINTR
-
接続の試みは、シグナルの配信により割り込まれました。
その接続は
Er EINPROGRESS
の場合と同じようにバックグラウンドで確立されます。
- Bq Er EALREADY
-
前の接続の試みが未だ完了していません。
- Bq Er EACCES
-
ブロードキャストの機能を提供していないソケットを通して、
( INADDR_BROADCAST
定数または
INADDR_NONE
戻り値を通して獲得した) ブロードキャストアドレスに接続しようとしています。
以降のエラーは、UNIX ドメインの接続名に固有です。
これらのエラーは、UNIX IPC ドメインの将来の
バージョンには適用されない可能性があります。
- Bq Er ENOTDIR
-
パスの構成要素中にディレクトリ以外のものが含まれています。
- Bq Er ENAMETOOLONG
-
パス名の構成要素が 255 文字を越えているか、
またはパス名全体が 1023 文字を越えています。
- Bq Er ENOENT
-
指定のソケットが存在しません。
- Bq Er EACCES
-
指定されたパスには、検索が許可されていないディレクトリが含まれています。
- Bq Er EACCES
-
指定のソケットへの書込みアクセスが拒絶されています。
- Bq Er ELOOP
-
パス名を変換するときに検出されたシンボリックリンクが多すぎます。
索引
関連項目
accept(2),
getpeername(2),
getsockname(2),
select(2),
socket(2)
索引
歴史
Fn connect
システムコールは
BSD 4.2
で登場しました。
索引
Index
- 名称
-
- ライブラリ
-
- 書式
-
- 解説
-
- 戻り値
-
- エラー
-
- 関連項目
-
- 歴史
-
Time: 07:06:25 GMT, January 12, 2009