ИМЯ¶

send, sendto, sendmsg - отправляет сообщения в сокет

LIBRARY¶

Standard C library (libc, -lc)

СИНТАКСИС¶

#include <sys/socket.h>

ssize_t send(int sockfd, const void buf[.len], size_t len, int flags);
ssize_t sendto(int sockfd, const void buf[.len], size_t len, int flags,
               const struct sockaddr *dest_addr, socklen_t addrlen);
ssize_t sendmsg(int sockfd, const struct msghdr *msg, int flags);

ОПИСАНИЕ¶

Системные вызовы send(), sendto() и sendmsg() используются для пересылки сообщений в другой сокет.

Вызов send() можно использовать, только если сокет находится в состоянии соединения (то есть известен получатель). Вызов send() отличается от write(2) только наличием аргумента flags. Если значение flags равно нулю, то вызов send() эквивалентен write(2). Также, вызов

send(sockfd, buf, len, flags);

эквивалентен

sendto(sockfd, buf, len, flags, NULL, 0);

Аргумент sockfd представляет файловый дескриптор сокета отправления.

Если sendto() используется с сокетом в режиме с установлением соединения (SOCK_STREAM, SOCK_SEQPACKET), то аргументы dest_addr и addrlen игнорируются (и может быть возвращена ошибка EISCONN, если их значения не равны NULL и 0) и возвращается ошибка ENOTCONN, если соединение через сокет не установлено. Иначе в dest_addr задаётся адрес назначения и его размер в addrlen. Для sendmsg() адрес назначения указывается в msg.msg_name, а его размер в msg.msg_namelen.

У send() и sendto() сообщение находится в buf, а его длина в len. У sendmsg() сообщение указывается в элементах массива msg.msg_iov. Вызов sendmsg() также позволяет отправлять вспомогательные данные (так называемую управляющую информацию).

Если сообщение слишком длинно для передачи за раз через используемый нижележащий протокол, то возвращается ошибка EMSGSIZE и сообщение не передаётся.

Неудачная отправка с помощью send() никак не отмечается. При обнаружении локальных ошибок возвращается значение -1.

Когда сообщение не помещается в буфер отправки сокета, выполнение блокируется в send(), если сокет не находится в неблокирующем режиме. Если сокет находится в неблокирующем режиме, то возвращается ошибка EAGAIN или EWOULDBLOCK. Для выяснения, возможна ли отправка данных, можно использовать вызов select(2).

struct msghdr {


    void         *msg_name;       /* необязательный адрес */


    socklen_t     msg_namelen;    /* размер адреса */


    struct iovec *msg_iov;        /* массив приёма/передачи */


    size_t        msg_iovlen;     /* # количество элементов в msg_iov */


    void         *msg_control;    /* вспомогательные данные,


                                     смотрите ниже */


    size_t        msg_controllen; /* размер буфера вспомогательных


                                     данных */


    int           msg_flags;      /* флаги (не используется) */
};

ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ¶

On success, these calls return the number of bytes sent. On error, -1 is returned, and errno is set to indicate the error.

ОШИБКИ¶

Здесь представлено несколько стандартных ошибок, возвращаемых с уровня сокетов. Могут также появиться другие ошибки, возвращаемые из соответствующих модулей протоколов; их описание находится в соответствующих справочных страницах.

EACCES

(для доменных сокетов UNIX, которые идентифицируются по имени пути) Нет прав на запись в файл сокета назначения или в одном из каталогов пути запрещён поиск (см. также path_resolution(7)).

(для сокетов UDP) Попытка отправки по сетевому/широковещательному адресу, как будто это был однозначный (unicast) адрес.

EAGAIN или EWOULDBLOCK

Сокет помечен как неблокирующий, но запрошенная операция привела бы к блокировке. POSIX.1-2001 допускает в этих случаях возврат ошибки и не требует, чтобы эти константы имели одинаковое значение, поэтому переносимое приложение должно проверять обе возможности.

EAGAIN

(доменные датаграммные сокеты Интернета) Сокет, указанный sockfd, ранее не был привязан к адресу и при попытке привязать его к эфемеридному порту, было определено, что все номера в диапазоне эфемеридных портов уже используются. Смотрите обсуждение /proc/sys/net/ipv4/ip_local_port_range в ip(7).

EALREADY

Сейчас выполняется другая операция Fast Open.

EBADF

Значение sockfd не является правильным открытым файловым дескриптором.

ECONNRESET

Соединение сброшено другой стороной.

EDESTADDRREQ

Сокет в режиме без установления соединения и адрес второй стороны не задан.

EFAULT

В аргументе указано неверное значение адреса пользовательского пространства.

EINTR

Получен сигнал до начала передачи данных; смотрите signal(7).

EINVAL

Передан неверный аргумент.

EISCONN

Сокет в режиме с установлением соединения уже выполнил подключение, но указан получатель (теперь или возвращается эта ошибка, или игнорируется указание получателя).

EMSGSIZE

Для типа сокета требуется, чтобы сообщение было отослано за время одной операции (атомарно), а размер сообщения не позволяет этого.

ENOBUFS

Исходящая очередь сетевого интерфейса заполнена. Обычно это означает, что интерфейс прекратил отправку, но это может быть также вызвано временной перегрузкой сети. Обычно, в Linux этого не происходит. Пакеты просто отбрасываются, когда очередь устройства переполняется.

ENOMEM

Больше нет доступной памяти.

ENOTCONN

Сокет не подключён и назначение не задано.

ENOTSOCK

Файловый дескриптор sockfd указывает не на каталог.

EOPNOTSUPP

Один из битов в аргументе flags не может устанавливаться для этого типа сокета.

EPIPE

Локальный сокет, ориентированный на соединение, был закрыт. В этом случае процесс также получит сигнал SIGPIPE, если не установлен флаг MSG_NOSIGNAL.

ВЕРСИИ¶

According to POSIX.1-2001, the msg_controllen field of the msghdr structure should be typed as socklen_t, and the msg_iovlen field should be typed as int, but glibc currently types both as size_t.

СТАНДАРТЫ¶

POSIX.1-2008.

MSG_CONFIRM is a Linux extension.

ИСТОРИЯ¶

4.4BSD, SVr4, POSIX.1-2001. (first appeared in 4.2BSD).

POSIX.1-2001 describes only the MSG_OOB and MSG_EOR flags. POSIX.1-2008 adds a specification of MSG_NOSIGNAL.

ПРИМЕЧАНИЯ¶

В sendmmsg(2) можно найти информацию о специальном системном вызове Linux, который можно использовать для передачи нескольких дейтаграмм за один вызов.

ОШИБКИ¶

Linux может вернуть EPIPE вместо ENOTCONN.

ПРИМЕРЫ¶

Пример использования sendto() показан в getaddrinfo(3).

СМОТРИТЕ ТАКЖЕ¶

fcntl(2), getsockopt(2), recv(2), select(2), sendfile(2), sendmmsg(2), shutdown(2), socket(2), write(2), cmsg(3), ip(7), ipv6(7), socket(7), tcp(7), udp(7), unix(7)

ПЕРЕВОД¶

Русский перевод этой страницы руководства разработал Alexander Golubev <fatzer2@gmail.com>, Azamat Hackimov <azamat.hackimov@gmail.com>, Hotellook, Nikita <zxcvbnm3230@mail.ru>, Spiros Georgaras <sng@hellug.gr>, Vladislav <ivladislavefimov@gmail.com>, Yuri Kozlov <yuray@komyakino.ru> и Иван Павлов <pavia00@gmail.com>

Этот перевод является свободной программной документацией; он распространяется на условиях общедоступной лицензии GNU (GNU General Public License - GPL, https://www.gnu.org/licenses/gpl-3.0.html версии 3 или более поздней) в отношении авторского права, но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ.

Если вы обнаружите какие-либо ошибки в переводе этой страницы руководства, пожалуйста, сообщите об этом разработчику по его адресу электронной почты или по адресу списка рассылки русских переводчиков.