bind() - ソケットへの名前の結合

X/Open

#define _XOPEN_SOURCE_EXTENDED 1
#include <sys/socket.h>

int bind(int socket, const struct sockaddr *address, socklen_t address_len);

バークレー・ソケット

#define _OE_SOCKETS
#include <sys/types.h>
#include <sys/socket.h>

int bind(int socket, struct sockaddr *address, int address_len);

bind() 関数は、固有のローカル名を socket 記述子のソケットに結合します。socket() 呼び出しの後で、記述子には、関連付けられた名前がありません。記述子は、socket() が呼び出されたときに指定された特定のアドレス・ファミリーに所属します。名前の正確な形式は、アドレス・ファミリーに依存します。

パラメーター

説明

socket

直前の socket() 呼び出しで戻されたソケット記述子。

address

socket に結合される名前が入っている sockaddr 構造体を指すポインター。

address_len

address のサイズ (バイト単位)。

ソケット記述子 socket が AF_INET ドメインで作成された 場合、名前バッファーの形式は、組み込みファイル の netinet/in.h に定義されているよう に、sockaddr_in であると想定されます。

struct in_addr
{
        ip_addr_t s_addr;
};

 struct sockaddr_in {
     unsigned char  sin_len;
     unsigned char  sin_family;
     unsigned short sin_port;
     struct in_addr sin_addr;
     unsigned char  sin_zero[8];

};

AF_INET6 ドメインで作成されたソケット記述子 ソケット記述子 socket が AF_INET6 ドメインで作成された 場合、名前バッファーの形式は、組み込みファイル の netinet/in.h に定義されているよう に、sockaddr_in6 であると想定されます。構造体は、以下のように定義されます。

struct sockaddr_in6 {
   uint8_t          sin6_len;
   sa_family_t      sin6_family;
   in_port_t        sin6_port;
   uint32_t         sin6_flowinfo;
   struct in6_addr  sin6_addr;
   uint32_t         sin6_scope_id;
};

ソケット記述子 socket が AF_UNIX ドメインで作成された場合は、名前バッファーの形式は、組み込みファイルの un.h に定義されている sockaddr_un であると想定されます。

 struct sockaddr_un {
    unsigned char  sun_len;
    unsigned char  sun_family;
             char  sun_path[108];        /* pathname */
};

sun_path フィールドには、NULL 終了のパス名が 含まれ、sun_len フィールドには、パス名の長さが含まれます。

正常に実行されなかった場合、bind() は、-1 を戻して、errno を次のいずれかの値に設定します。

エラー・コード

説明

EACCES

許可が拒否されました。

EADDRINUSE

アドレスは既に使用中である。詳細は、getsockopt() - ソケットに関連したオプションの取得で説明して いる SO_REUSEADDR オプション、および setsockopt() - ソケットに関連したオプションの設定で説明して いる SO_REUSEADDR オプションを参照します。

EADDRNOTAVAIL

指定されたアドレスがこのホストでは無効である。例えば、IP アドレスが有効な ネットワーク・インターフェースを指定していません。

EAFNOSUPPORT

アドレス・ファミリーはサポートされていません (それは AF_UNIX、AF_INET、または AF_INET6 ではありません)。

EBADF

socket パラメーターが無効ソケット記述子です。

EINVAL

次の 3 つの状態のいずれかが当てはまる可能性があります。

• ソケットが既にアドレスに結合済みです。例えば、既に 接続済みのソケットに名前を結合しようとしています。
• ソケットがシャットダウンされました。
• bind() 呼び出しで正しくないパラメーターが渡されました。

渡されたパラメーター値を調べて、それらの値が上記で説明されているとおりに指定されていることを確認してください。

EIO

ネットワークまたはトランスポートで障害が発生しました。

ENOBUFS

bind() は、ストレージが不十分なためにバッファーを取得することができません。

ENOTSOCK

記述子はファイル用であり、ソケット用ではありません。

EOPNOTSUPP

指定されたソケットのソケット・タイプが アドレスへの結合をサポートしません。

EPERM

ユーザーは、指定されたポートへの結合を 許可されていません。

以下は、AF_UNIX 専用です。

エラー・コード

説明

EACCES

パス接頭部のコンポーネントが検索許可を拒否します。あるいは、要求された名前が、書き込み許可を拒否するモードで ディレクトリーへの書き込みを要求します。

EDESTADDRREQ

address 引数が NULL ポインターです。

EIO

入出力エラーが発生しました。

ELOOP

address のパス名の変換中に検出された シンボリック・リンクが多すぎます。

ENAMETOOLONG

パス名のコンポーネントが NAME_MAX 文字を超えたか、あるいはパス名全体が PATH_MAX 文字を超えました。

ENOENT

パス名のコンポーネントに既存のファイル名が指定されていないか、またはパス名が空ストリングです。

ENOTDIR

address のパス名のパス接頭部のコンポーネントが ディレクトリーではありません。

EROFS

名前が読み取り専用ファイル・システム上にあります。

以下の例で、AF_INET ドメインでインターフェースに結合している bind() 呼び出しを示します。 IP アドレスとポートは、ネットワーク・バイト順 でなければなりません。ポートをネットワーク・バイト順にする には、htons() ユーティリティー・ルーチンを 呼び出して、ホスト・バイト順からネットワーク・バイト順 に短整数を変換します。address フィールドは、別のユーティリティー・ ルーチン inet_addr() を使用して設定します。このルーチン は、インターフェースの小数点付き 10 進数アドレスを表す文字ストリングを 受け取って、2 進の IP アドレス表記をネットワーク・バイト順 に戻します。

int rc;
int s;
struct sockaddr_in myname;
/* Bind to a specific interface in the Internet domain */
/* make sure the sin_zero field is cleared */
memset(&myname, 0, sizeof(myname));
myname.sin_family = AF_INET;
myname.sin_addr.s_addr = inet_addr("129.5.24.1"); 
/* specific interface */
myname.sin_port = htons(1024);
⋮
rc = bind(s, (struct sockaddr *) &myname, 
sizeof(myname));
/* Bind to all network interfaces in the Internet domain */
/* make sure the sin_zero field is cleared */
memset(&myname, 0, sizeof(myname));
myname.sin_family = AF_INET;
myname.sin_addr.s_addr = INADDR_ANY; /* specific interface */
myname.sin_port = htons(1024);
⋮
rc = bind(s, (struct sockaddr *) &myname, 
sizeof(myname));
/* Bind to a specific interface in the Internet domain.
   Let the system choose a port                        */
/* make sure the sin_zero field is cleared */
memset(&myname, 0, sizeof(myname));
myname.sin_family = AF_INET;
myname.sin_addr.s_addr = inet_addr("129.5.24.1"); 
/* specific interface */
myname.sin_port = 0;
⋮
rc = bind(s, (struct sockaddr *) &myname, 
sizeof(myname));

以下の例で、AF_UNIX ドメインでインターフェースに結合している bind() 呼び出しを示します。

/* Bind to a name in the UNIX domain */
struct sockaddr_un myname;
char socket_name[]="/tmp/socket.for._";
⋮
memset(&myname, 0, sizeof(myname));
myname.sun_family = AF_UNIX;
strcpy(myname.sun_path,socket_name);
myname.sun_len = sizeof(myname.sun_path);
⋮
rc = bind(s, (struct sockaddr *) &myname, SUN_LEN(&myname));