UNIX: разработка сетевых приложений

Часть 158 из 399 Информация о книге

#include &lt;sys/socket.h&gt;
ssize_t recvmsg(int <i>sockfd</i>, struct msghdr *<i>msg</i>, int <i>flags</i>);
ssize_t sendmsg(int <i>sockfd</i>, struct msghdr *<i>msg</i>, int <i>flags</i>);
<i>Обе функции возвращают: количество прочитанных или записанных байтов в случае успешного выполнения, -1 в случае ошибки</i>
Большинство аргументов обеих функций скрыто в структуре 
msghdr
:
struct msghdr {
 void         *msg_name;     /* адрес протокола */
 socklen_t    msg_namelen;   /* размер адреса протокола */
 struct iovec *msg_iov;      /* массив буферов */
 size_t       msg_iovlen;    /* количество элементов в массиве msg_iov */
 void         *msg_control;  /* вспомогательные данные: должны быть
                                выровнены для структуры cmsghdr */
 socklen_t    msg_controllen; /* размер вспомогательных данных */
 int          msg_flags;      /* флаги, возвращенные функцией recvmsg() */
};
 ПРИМЕЧАНИЕ
 Показанная нами структура msghdr восходит к 4.3BSD Reno и определяется POSIX. Некоторые системы (например, Solaris 2.5) используют более раннюю структуру msghdr, которая появилась в 4.2BSD. У более ранней структуры нет элемента msg_flags, а элементы msg_control и msg_controllen называются msg_accrights и msg_accrightslen. В этой системе поддерживается только одна форма вспомогательных данных — передача дескрипторов файлов (так называемые права доступа). При появлении протоколов OSI в 4.3BSD Reno были добавлены новые формы вспомогательных данных, вследствие чего были обобщены имена элементов структуры.
 
Элементы 
msg_name
 и msg_namelen
 используются, когда сокет не является присоединенным (например, неприсоединенный сокет UDP). Они аналогичны пятому и шестому аргументам функций recvfrom
 и sendto
: msg_name
 указывает на структуру адреса сокета, в которой вызывающий процесс хранит адрес протокола получателя для функции sendmsg
 или функция recvmsg
 хранит адрес протокола отправителя. Если нет необходимости задавать адрес протокола (например, сокет TCP или присоединенный сокет UDP), элемент msg
_name должен быть пустым указателем. Элемент msg_namelen
 является аргументом типа «значение» для функции sendmsg
, но для функции recvmsg
 это аргумент типа «значение-результат».
Элементы 
msg_iov
 и msg_iovlen
 задают массив буферов ввода и вывода (массив структур iovec
), аналогичный второму и третьему аргументам функций readv
 и writev
.
Элементы 
msg_control
 и msg_controllen
 задают расположение и размер необязательных вспомогательных данных. Элемент msg_controllen
 — это аргумент типа «значение-результат» функции recvmsg
. Вспомогательные данные мы рассматриваем в разделе 14.6.
  Работая с функциями 
recvmsg
 и sendmsg
, следует учитывать различие между двумя флаговыми переменными: это аргумент flags
, который передается по значению, и элемент msg_flags
 структуры msghdr
, который передается по ссылке (поскольку функции передается адрес этой структуры).
■ Элемент 
msg_flags
 используется только функцией recvmsg
. Когда вызывается функция recvmsg
, аргумент flags
 копируется в элемент msg_flags
 [128, с. 502], и это значение используется ядром для управления приемом данных. Затем это значение обновляется в зависимости от результата функции recvmsg
.
■ Элемент 
msg_flags
 игнорируется функцией sendmsg
, поскольку эта функция использует аргумент flags
 для управления выводом данных. Это значит, что если мы хотим установить флаг MSG_DONTWAIT
 при вызове функции sendmsg
, то мы должны присвоить это значение аргументу flags
, а присваивание значения MSG_DONTWAIT
 элементу msg_flags
 не имеет никакого эффекта.
В табл. 14.2 показано, какие флаги проверяются ядром для функций ввода и вывода и какие элементы 
msg_flags
 может возвращать функция recvmsg
. Для элемента sendmsg.msg_flags
 нет колонки, потому что, как мы отмечали, он не используется.
Таблица 14.2. Флаги для различных функций ввода-вывода
  Флаг  Проверяются функциями send flags sendto flags sendmsg flags  Проверяются функциями recv flags recvfrom flags recvmsg flags  Возвращаются функцией recvmsg msg_flags  
  MSG_DONTROUTE  •    
  MSG_DONTWAIT  •  •   
  MSG_PEEK   •   
  MSG_WAITALL   •   
  MSG_EOR  •    
  MSG_OOB  •  •  •  
  MSG_BCAST    •  
  MSG_MCAST    •  
  MSG_TRUNC    •  
  MSG_CTRUNC    •
Флаг	Проверяются функциями send flags sendto flags sendmsg flags	Проверяются функциями recv flags recvfrom flags recvmsg flags	Возвращаются функцией recvmsg msg_flags
MSG_DONTROUTE	•
MSG_DONTWAIT	•	•
MSG_PEEK		•
MSG_WAITALL		•
MSG_EOR	•
MSG_OOB	•	•	•
MSG_BCAST			•
MSG_MCAST			•
MSG_TRUNC			•
MSG_CTRUNC			•
Перейти к странице:
Предыдущая страница
Следующая страница