Rechercher une page de manuel
connect
Langue: ru
Version: 1998-10-03 (fedora - 25/11/07)
Section: 2 (Appels système)
Sommaire
НАЗВАНИЕ
connect - инициирует соединение на сокетеОБЗОР
#include <sys/types.h>#include <sys/socket.h>
int connect(int sockfd, const struct sockaddr *serv_addr, socklen_t addrlen);
ОПИСАНИЕ
Файловый дескриптор sockfd должен ссылаться на сокет. Если сокет имеет тип SOCK_DGRAM, значит, адрес serv_addr является адресом по умолчанию, куда посылаются датаграммы, и единственным адресом, откуда они принимаются. Если сокет имеет тип SOCK_STREAM или SOCK_SEQPACKET, то данный системный вызов попытается установить соединение с другим сокетом. Другой сокет задан параметром serv_addr, являющийся адресом длиной addrelen в пространстве коммуникации сокета. Каждое пространство коммуникации интерпретирует параметр serv_addr по-своему.Обычно сокеты с протоколами, основанными на соединении, могут устанавливать соединение только один раз; сокеты с протоколами без соединения могут использовать connect многократно, чтобы изменить адрес назначения. Сокеты без поддержки соединения могут прекратить связь с другим сокетом, установив член sa_family структуры sockaddr в AF_UNSPEC.
ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ
Если соединение или привязка прошла успешно, возвращается нуль. При ошибке возвращается -1, а errno устанавливается должным образом.ОШИБКИ
Ниже следуют только общие ошибки сокетов. Могут также появляться коды ошибок, существующие в конкретном домене.- EBADF
- Файловый дескриптор не является правильными индексом в таблице дескрипторов.
- EFAULT
- Адрес структуры сокета находится за пределами адресного пространства пользователя.
- ENOTSOCK
- Файловый дескриптор не связан с сокетом.
- EISCONN
- Соединение на сокете уже произошло.
- ECONNREFUSED
- С той стороны никто не слушает.
- ETIMEDOUT
- Произошел тайм-аут во время ожидания соединения. Сервер, возможно, очень занят и не может принимать новые соединения. Заметьте, что для IP-сокетов тайм-аут может быть очень длинным, если на сервере разрешено использование syncookies.
- ENETUNREACH
- Сеть недоступна.
- EADDRINUSE
- Локальный адрес уже используется.
- EINPROGRESS
- Сокет является неблокирующим, а соединение не может быть установлено прямо сейчас. Можно использовать select(2) или poll(2), чтобы закончить соединение, установив ожидание возможности записи в сокет. После того, как select сообщит о такой возможности, используйте getsockopt(2), чтобы прочитать флаг SO_ERROR на уровне SOL_SOCKET, чтобы определить, успешно ли завершился connect (в этом случае SO_ERROR равен нулю) или неуспешно, тогда SO_ERROR равен одному из обычных кодов ошибок, перечисленных здесь, и объясняет причину неудачи).
- EALREADY
- Сокет является неблокирующим, а предыдущая попытка установить соединение еще не завершилась.
- EAGAIN
- Не осталось свободных локальных портов, или же недостаточно места в кэше маршрутизации. Для домена PF_INET смотри описание системной переменной net.ipv4.ip_local_port_range в ip(7), где описано, как увеличить количество локальных портов.
- EAFNOSUPPORT
- Адрес имеет некорректную семью адресов в поле sa_family.
- EACCES, EPERM
- Пользователь попытался соединиться с широковещательным адресом, не установив широковещательный флаг на сокете или же запрос на соединение завершился неуспешно из-за локального правила на файерволле.
СООТВЕТСТВИЕ СТАНДАРТАМ
SVr4, 4.4BSD (функция connect впервые появилась в BSD 4.2). SVr4 документирует дополнительные общие коды ошибок EADDRNOTAVAIL, EINVAL, EAFNOSUPPORT, EALREADY, EINTR, EPROTOTYPE, и ENOSR. Там также документируется множество дополнительных кодов ошибок, не описанных здесь.ЗАМЕЧАНИЕ
Третий аргумент connect в действительности имеет тип int (а в BSD 4.*, libc4 и libc5 это так и есть). Определенное недопонимание привело к появлению socklen_t. Черновик стандарта еще не принят, но glibc2 уже следует ему и в ней присутствует socklen_t. Смотри также accept(2).ОШИБКИ
Прекращение соединения на сокете с помощью вызова connect с адресом AF_UNSPEC еще не реализовано.СМОТРИ ТАКЖЕ
accept(2), bind(2), listen(2), socket(2), getsockname(2)ПЕРЕВОД
Copyright (C) Alexey Mahotkin <alexm@hsys.msk.ru> 1999Contenus ©2006-2024 Benjamin Poulain
Design ©2006-2024 Maxime Vantorre