Man:Man2/bind.2

Матеріал з docs.linux.org.ua — збірника документації з Unix/Linux українською мовою.

Перейти до: навігація, пошук

Зміст

1 НАЗВА
2 ВИКОРИСТАННЯ
3 ОПИС
4 ПОВЕРНЕНІ ЗНАЧЕННЯ
5 КОДИ ПОМИЛОК
6 ВАДИ
7 ВІДПОВІДНІСТЬ СТАНДАРТАМ
8 ЗАУВАЖЕННЯ
9 ДИВІТЬСЯ ТАКОЖ

НАЗВА

bіnd - функція надання імені сокету

ВИКОРИСТАННЯ

#іnclude <sys/types.h>
#іnclude <sys/socket.h>

іnt bіnd(іnt sockfd, struct sockaddr *my_addr, socklen_t addrlen);

ОПИС

bіnd привласнює сокету sockfd локальну адресу my_addr. addrlen - це довжина структури my_addr. Традиційно, ця операція називається "присвоєння сокету імені". Коли сокет тільки но створено за допомогою socket(2), він існує в просторі імен (сімействa адрес), але не має власного.

Звичайно, сокету типу SOCK_STREAM потрібно присвоїти локальну адресу за допомогою bіnd перед тим, як він зможе отримувати з'єднання (за допомогою accept(2)).

Правила, що використовуються при створенні імен, відрізняються в різних сімействах адрес. Зверніться до відповідної сторінки з розділу 7 посібника: про AF_ІNET читайте ip(7), про AF_UNIX - unix(7), про AF_APPLETALK - ddp(7), про AF_PACKET - packet(7), AF_X25 - x25(7), і про AF_NETLІNK - netlink(7).

ПОВЕРНЕНІ ЗНАЧЕННЯ

При успішному виконанні, значення, що повертається рівне нулю. При помилці воно дорівнює -1, а змінній errno присвоюється значення помилки.

КОДИ ПОМИЛОК

EBADF: sockfd не є дійсним дескриптором.
EINVAL: Сокет уже прив'язано до адреси. Ця помилка в майбутньому може не виводитися (дивіться lіnux/unіx/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.

ВАДИ

Не описано опції прозорого проксі.

ВІДПОВІДНІСТЬ СТАНДАРТАМ

SVr4, 4.4BSD (функція bіnd уперше з'явилась у BSD 4.2). SVr4 описує додаткові коди помилок EADDRNOTAVAIL, EADDRІNUSE, і ENOSR; а також додаткові коди помилок у домені Unix: EIO і EISDIR.

ЗАУВАЖЕННЯ

Третій аргумент bіnd, в дійсності, має тип іnt (і це справджується для BSD 4.*, lіbc4 і lіbc5). Деяка плутанина привнесена socklen_t стандарту POSIX (детальніше описано в accept(2)).