bind

Section: System Calls (2)
Updated: 2026-02-08
Index JM Home Page roff page
 

名前

bind - ソケットに名前をつける  

ライブラリ

標準 C ライブラリ (libc,~-lc)  

書式

#include <sys/socket.h>

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

説明

When a socket is created with socket(2), it exists in a name space (address family) but has no address assigned to it. bind() assigns the address specified by addr to the socket referred to by the file descriptor sockfd. addrlen specifies the size, in bytes, of the address structure pointed to by addr. Traditionally, this operation is called "assigning a name to a socket".

SOCK_STREAM ソケットが接続を受け付けられるようにするには (accept(2) を参照)、通常その前に bind() を使用してローカルアドレスを割り当てる必要がある。

名前付けのルールはアドレスファミリーごとに異なっている。詳細な情報は 第 7 章の各マニュアルを参照すること。 AF_INET は ip(7) を、 AF_INET6 は ipv6(7) を、 AF_UNIX は unix(7) を、 AF_APPLETALK は ddp(7) を、 AF_PACKET は packet(7) を、 AF_X25 は x25(7) を、 AF_NETLINK は netlink(7) を参照。

addr 引数に実際にどのような構造体が渡されるかは、 アドレスファミリーに依存する。 sockaddr 構造体は以下のような感じで定義されている:

struct sockaddr {
    sa_family_t sa_family;
    char        sa_data[14];
}

この構造体は、 addr に渡される構造体へのポインターをキャストし、 コンパイラの警告メッセージを抑えるためだけに存在する。 下記の「例」を参照。  

返り値

On success, zero is returned. On error, -1 is returned, and errno is set to indicate the error.  

エラー

EACCES
そのアドレスは保護されていて、かつユーザーがスーパーユーザーではない。
EADDRINUSE
指定されたアドレスが既に使用中である。
EADDRINUSE
(インターネットドメインソケットの場合) ソケットアドレス構造体でポート番号に 0 が指定されたが、 一時ポート (ephemeral port) を割り当てようとした際に、 一時ポートとして使用する範囲のすべてのポート番号が使用中であった。 ip(7) の /proc/sys/net/ipv4/ip_local_port_range の説明を参照。
EBADF
sockfd が有効なファイルディスクリプターでない。
EINVAL
ソケットがすでにアドレスに結びつけ (bind) られている。
EINVAL
addrlen が間違っているか、 addr がこのソケットのドメインで有効なアドレスではない。
ENOTSOCK
ファイルディスクリプター sockfd がソケットを参照していない。
EADDRNOTAVAIL
存在しないインターフェースが要求されたか、要求されたアドレスが ローカルではなかった。

以下のエラーは UNIXドメイン (AF_UNIX) のソケット特有である:

EACCES
パス名の構成要素に検索許可 (search permission) がない (path_resolution(7) も参照すること)。
EFAULT
addr がユーザーのアクセス可能なアドレス空間の外を指している。
ELOOP
addr を解決する際に遭遇したシンボリックリンクが多過ぎる。
ENAMETOOLONG
addr が長過ぎる。
ENOENT
A component in the directory prefix of the socket pathname does not exist.
ENOMEM
カーネルに、利用可能なメモリーが十分にない。
ENOTDIR
パス名の構成要素がディレクトリではない。
EROFS
ソケット inode が読み込み専用のファイルシステム上にある。

下位のプロトコルモジュールから他のエラーが生成されるかもしれない。  

バージョン

Portable programs must ensure that addr.sun_path is a null-terminated string for AF_UNIX sockets.  

標準規格

POSIX.1-2024.  

歴史

POSIX.1-2001, SVr4, 4.2BSD.  

バグ

透過的プロキシ (transparent proxy) オプションについて記述していない。  

例

インターネットドメインソケットでの bind() の利用例が getaddrinfo(3) に記載されている。

以下の例は、UNIX ドメイン (AF_UNIX) でストリームソケットを bind する方法を示したものである。

#include <err.h>
#include <stdlib.h>
#include <string.h>
#include <sys/socket.h>
#include <sys/un.h>
#include <unistd.h>

#define MY_SOCK_PATH "/somepath"
#define LISTEN_BACKLOG 50

int
main(void)
{
    int                 sfd, cfd;
    socklen_t           peer_addr_size;
    struct sockaddr_un  my_addr, peer_addr;

    sfd = socket(AF_UNIX, SOCK_STREAM, 0);
    if (sfd == -1)
        err(EXIT_FAILURE, "socket");

    memset(&my_addr, 0, sizeof(my_addr));
    my_addr.sun_family = AF_UNIX;
    strncpy(my_addr.sun_path, MY_SOCK_PATH,
            sizeof(my_addr.sun_path) - 1);

    if (bind(sfd, (struct sockaddr *) &my_addr,
             sizeof(my_addr)) == -1)
        err(EXIT_FAILURE, "bind");

    if (listen(sfd, LISTEN_BACKLOG) == -1)
        err(EXIT_FAILURE, "listen");

    /* Now we can accept incoming connections one
       at a time using accept(2).  */

    peer_addr_size = sizeof(peer_addr);
    cfd = accept(sfd, (struct sockaddr *) &peer_addr,
                 &peer_addr_size);
    if (cfd == -1)
        err(EXIT_FAILURE, "accept");

    /* Code to deal with incoming connection(s)...  */

    if (close(sfd) == -1)
        err(EXIT_FAILURE, "close");

    if (unlink(MY_SOCK_PATH) == -1)
        err(EXIT_FAILURE, "unlink");
}
 

関連項目

accept(2), connect(2), getsockname(2), listen(2), socket(2), getaddrinfo(3), getifaddrs(3), ip(7), ipv6(7), path_resolution(7), socket(7), unix(7)


 

Index

名前
ライブラリ
書式
説明
返り値
エラー
バージョン
標準規格
歴史
バグ
例
関連項目

This document was created by man2html, using the manual pages.