bind() - Unix、Linux 系統呼叫

名稱

bind - 將名稱繫結到套接字

語法

#include <sys/types.h>
#include <sys/socket.h>
int bind(int sockfd, const struct sockaddr *my_addr ", socklen_t " addrlen );

描述

bind() 為套接字 sockfd 提供本地地址 my_addr。my_addr 長度為 addrlen 位元組。傳統上，這被稱為\(“為套接字分配名稱”。\(”當使用 socket(2) 建立套接字時，它存在於名稱空間（地址族）中，但沒有分配名稱。

通常需要在 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)。

為 my_addr 引數傳遞的實際結構將取決於地址族。sockaddr 結構定義如下：


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

此結構的唯一目的是強制轉換 my_addr 中傳遞的結構指標，以避免編譯器警告。以下示例顯示了在 Unix（AF_UNIX）域中繫結套接字時如何執行此操作

#include <sys/socket.h>
#include <sys/un.h>
#include <stdlib.h>
#include <stdlio.h>

#define MY_SOCK_PATH "/somepath"

int
main(int argc, char *argv[])
{
    int sfd;
    struct sockaddr_un addr;
   
    sfd = socket(AF_UNIX, SOCK_STREAM, 0);        
    if (sfd == -1) {
        perror("socket");
        exit(EXIT_FAILURE);
    }
    memset(&addr, 0, sizeof(struct sockaddr_un)); 
                        /* Clear structure */
    addr.sun_family = AF_UNIX;                    
    strncpy(addr.sun_path, MY_SOCK_PATH,
            sizeof(addr.sun_path) - 1);
    if (bind(sfd, (struct sockaddr *) &addr,
            sizeof(struct sockaddr_un)) == -1) {
        perror("bind");
        exit(EXIT_FAILURE);
    }
    ...
}

返回值

成功時，返回 0。失敗時，返回 -1，並適當地設定 errno。

錯誤

錯誤程式碼	描述
EACCES	地址受保護，並且使用者不是超級使用者。
EADDRINUSE	給定的地址已在使用。
EBADF	sockfd 不是有效的描述符。
EINVAL	套接字已繫結到地址。
ENOTSOCK	sockfd 是檔案的描述符，而不是套接字。
以下錯誤特定於 UNIX 域（AF_UNIX）套接字
EACCES	路徑字首的某個元件上的搜尋許可權被拒絕。（另請參閱 path_resolution(2)。）
EADDRNOTAVAIL	請求了不存在的介面，或者請求的地址不是本地的。
EFAULT	my_addr 指向使用者可訪問地址空間之外。
EINVAL	addrlen 錯誤，或者套接字不在 AF_UNIX 族中。
ELOOP	在解析 my_addr 時遇到太多符號連結。
ENAMETOOLONG	my_addr 太長。
ENOENT	檔案不存在。
ENOMEM	核心記憶體不足。
ENOTDIR	路徑字首的某個元件不是目錄。
EROFS	套接字 inode 將駐留在只讀檔案系統上。

錯誤

未描述透明代理選項。

符合標準

SVr4、4.4BSD（bind() 函式首次出現在 4.2BSD 中）。

注意

bind() 的第三個引數實際上是 int（這是 4.x BSD 和 libc4 和 libc5 所具有的）。一些 POSIX 混淆導致了當前的 socklen_t，glibc 也使用它。另請參閱 accept(2)。

另請參閱

列印頁面