Provided by: manpages-zh_1.6.3.3-2_all
NAME 名称
bind - 将一个名字和一个套接字绑定到一起(赋一个名字给一个套接字)
SYNOPSIS 概述
#include <sys/types.h> #include <sys/socket.h> int bind(int sockfd, struct sockaddr *my_addr, socklen_t addrlen);
DESCRIPTION 描述
bind 为套接字 sockfd 指定本地地址 my_addr. my_addr 的长度为 addrlen (字节).传统的叫法是给一个套接字分配一个名字. 当使用 socket(2), 函数创建一个套接字时,它存在于一个地址空间(地址族), 但还没有给它分配一个名字 一般来说在使用 SOCK_STREAM 套接字建立连接之前总要使用 bind 为其分配一个本地地址.参见 accept(2)).
NOTES 注意
这条规则用于给每个地址族绑定不同的名称.更多细节请参 考手册页第7册(man7). 对于 AF_INET 参见 ip(7), 对于 AF_UNIX 参见 unix(7), 对于 AF_APPLETALK 参见 ddp(7), 对于 AF_PACKET 参见 packet(7), 对于r AF_X25 参见 x25(7) 对于 AF_NETLINK 参见 netlink(7).
RETURN VALUE 返回值
函数执行成功返回0,否则返回-1, 并设置错误代码.
ERRORS 错误
EBADF sockfd 不是一个合法套接字描述符. EINVAL 套接字已经绑定到一个地址.这一条在以后会有所改变: 具体参见 linux/unix/sock.c EACCES 地址受保护,用户不是系统管理员. ENOTSOCK 参数是文件描述符,不是一个套接字. 下列错误适用于UNIX域 (AF_UNIX) 套接字. EINVAL 地址长度 addrlen 错误,或者套接字不在 AF_UNIX 族. EROFS 套接字节点位于只读文件系统. EFAULT my_addr 指向用户无权访问的地址空间. ENAMETOOLONG my_addr 长度超范围. ENOENT 文件不存在. ENOMEM 内核存储空间不足. ENOTDIR 指定路径不是一个目录. EACCES 指定路径拒绝访问. ELOOP 在解析 my_addr 时发现过多符号连接.
BUGS 勘误
透明代理选项没有描述.
CONFORMING TO 一致性
SVr4,4.4BSD(函数 bind 首次出现于BSD 4.2)SVr4文档增加了 EADDRNOTAVAIL, EADDRINUSE, 和 ENOSR 一般性错误, 还增加了 EIO, EISDIR 和 EROFS Unix域错误.
NOTE
函数 bind 的第三个参数实际上是int类型(BSD 4.*和libc4以及libc5都是这么做的). 不知为什么有的POSIX系统目前仍在使用socklen_t. 目前尚无统一标准,不过glibc2两者都使用.参见 accept(2).
SEE ALSO 参见
accept(2), connect(2), listen(2), socket(2), getsockname(2), ip(7), socket(7)
跋
本页面中文版由中文 man 手册页计划提供。 中文 man 手册页计划:https://github.com/man-pages-zh/manpages-zh