НАЗВАНИЕ
bind − привязать имя к сокету
ОБЗОР
#include
<sys/types.h>
#include <sys/socket.h>
int bind(int sockfd, struct sockaddr *my_addr, socklen_t addrlen);
ОПИСАНИЕ
bind привязывает к сокету sockfd локальный адрес my_addr длиной addrlen. Традиционно, эта операция называется “присваивание сокету имени.” Когда сокет только что создан с помощью socket(2), он существует в пространстве имён (семействе адресов), но не имеет назначенного имени.
Обычно сокету типа SOCK_STREAM требуется назначить локальный адрес с помощью bind, перед тем, как он сможет принимать соединения (см. accept(2)).
Правила, используемые при привязке имён, разные в разных семействах адресов. Обратитесь к соответствующему руководству в секции 7 за дальнейшей информацией. Для AF_INET смотри ip(7), для AF_UNIX смотри unix(7), для AF_APPLETALK смотри ddp(7), для AF_PACKET смотри packet(7), для AF_X25 смотри x25(7), а для AF_NETLINK смотри netlink(7).
ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ
В случае успеха возвращается ноль. При ошибке возвращается −1, а errno устанавливается должным образом.
ОШИБКИ
|
EBADF |
sockfd не является правильным дескриптором. | ||
|
EINVAL |
Сокет уже привязан к какому-то адресу. Эта ошибка в будущем может не выдаваться, смотри linux/unix/sock.c, где описаны детали. | ||
|
EACCES |
Адрес защищен, или пользователь не является суперпользователем. |
ENOTSOCK
Аргумент системного вызова является дескриптором файла, а не сокета.
Нижеследующие ошибки специфичны для сокетов домена UNIX (AF_UNIX):
|
EINVAL |
Параметр addrlen неверен, или сокет не был найден в семействе адресов AF_UNIX. | ||
|
EROFS |
Попытка создания inode сокета на файловой системе "только для чтения". | ||
|
EFAULT |
my_addr указывает за пределы доступного адресного пространства. |
ENAMETOOLONG
my_addr слишком длинно.
|
ENOENT |
Файл не существует. | ||
|
ENOMEM |
Ядру не хватило памяти. | ||
|
ENOTDIR |
Компонент пути, использованный как каталог, в действительности таковым не является. | ||
|
EACCES |
Не разрешен поиск в одном из компонентов пути. | ||
|
ELOOP |
my_addr является зацикленной символической ссылкой, то есть при подстановке возникает ссылка на неё саму. |
ОШИБКИ
Не описываются ключи, связанные с работой прозрачных прокси.
СООТВЕТСТВИЕ СТАНДАРТАМ
SVr4, 4.4BSD (функция bind впервые появилась в BSD 4.2). SVr4 документирует дополнительные коды ошибок EADDRNOTAVAIL, EADDRINUSE, и ENOSR, и дополнительные коды ошибок домена Unix: EIO и EISDIR
ЗАМЕЧАНИЕ
Третий аргумент вызова bind в действительности имеет тип int (это именно так в BSD 4.*, libc4 и libc5). При разработке стандарта POSIX случилось некоторое недопонимание, и появился тип socklen_t. Смотри также accept(2).
СМОТРИ ТАКЖЕ
accept(2), connect(2), listen(2), socket(2), getsockname(2), ip(7), socket(7)
ПЕРЕВОД
Copyright (C) Alexey Mahotkin <alexm [AT] hsys.ru> 1999