---

   recvmmsg - получает несколько сообщений из сокета

---

---

ОБЗОР

#define _GNU_SOURCE /* Смотрите feature_test_macros(7) */
#include <sys/socket.h>
int recvmmsg(int sockfd, struct mmsghdr *msgvec, unsigned int vlen,
unsigned int flags, struct timespec *timeout);

---

ОПИСАНИЕ

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

Аргумент msgvec является указателем на массив структур mmsghdr. Размер этого массива указывается в vlen.

Структура mmsghdr определена в <sys/socket.h> следующим образом:

struct mmsghdr {
    struct msghdr msg_hdr;  /* Заголовок сообщения */
    unsigned int  msg_len;  /* Количество полученных байт
                               для заголовка */
};

Поле msg_hdr представляет собой структуру msghdr, которая описана в recvmsg(2). В поле msg_len содержится количество байт возвращаемого сообщения в записи. Это поле имеет такое же значение, что и возвращаемое значение одиночного вызова recvmsg(2) в заголовке.

Аргумент flags содержит объединённые с помощью OR флаги. Флаги те же, что и у recvmsg(2), но со следующим дополнением:

MSG_WAITFORONE (начиная с Linux 2.6.34) Включить MSG_DONTWAIT после получения первого сообщения.

Аргумент timeout указывает на struct timespec (смотрите clock_gettime(2)), задающую время ожидания (в секундах и наносекундах) операции приёма (но смотрите ДЕФЕКТЫ!; (этот интервал будет округлён до точности системных часов, и из-за задержек планировщика ядра интервал блокировки может быть немного больше). Если timeout равно NULL, то операция блокируется на неопределённое время.

Блокирование вызова recvmmsg() происходит до тех пор, пока не будет получено vlen сообщений или не истечёт интервал блокировки. Неблокирующий вызов читает все доступные сообщения (максимальное количество указано в vlen) и сразу завершает работу.

При выходе из recvmmsg() последующие элементы msgvec обновляются информацией о каждом полученном сообщении: в msg_len содержится размер принятого сообщения; подполя msg_hdr обновляются согласно описанию в recvmsg(2). Возвращаемое значение вызова означает количество обновлённых элементов msgvec.

---

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

---

ОШИБКИ

EINVAL Значение timeout неверно.

ВЕРСИИ

---

СООТВЕТСТВИЕ СТАНДАРТАМ

---

ПРИМЕР

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

Следующий отрывок периодически генерирует датаграммы UDP с произвольным номером внутри:

$ while true; do echo $RANDOM > /dev/udp/127.0.0.1/1234; 
sleep 0.25; done

Эти датаграммы читаются примером приложения, который выдаёт:

$ ./a.out
5 сообщений получено
1 11782
2 11345
3 304
4 13514
5 28421

Исходный код программы

#define _GNU_SOURCE
#include <netinet/ip.h>
#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include <sys/socket.h>
int
main(void)
{
#define VLEN 10
#define BUFSIZE 200
#define TIMEOUT 1
    int sockfd, retval, i;
    struct sockaddr_in sa;
    struct mmsghdr msgs[VLEN];
    struct iovec iovecs[VLEN];
    char bufs[VLEN][BUFSIZE+1];
    struct timespec timeout;
    sockfd = socket(AF_INET, SOCK_DGRAM, 0);
    if (sockfd == -1) {
        perror("socket()");
        exit(EXIT_FAILURE);
    }
    sa.sin_family = AF_INET;
    sa.sin_addr.s_addr = htonl(INADDR_LOOPBACK);
    sa.sin_port = htons(1234);
    if (bind(sockfd, (struct sockaddr *) &sa, sizeof(sa)) == -1) {
        perror("bind()");
        exit(EXIT_FAILURE);
    }
    memset(msgs, 0, sizeof(msgs));
    for (i = 0; i < VLEN; i++) {
        iovecs[i].iov_base         = bufs[i];
        iovecs[i].iov_len          = BUFSIZE;
        msgs[i].msg_hdr.msg_iov    = &iovecs[i];
        msgs[i].msg_hdr.msg_iovlen = 1;
    }
    timeout.tv_sec = TIMEOUT;
    timeout.tv_nsec = 0;
    retval = recvmmsg(sockfd, msgs, VLEN, 0, &timeout);
    if (retval == -1) {
        perror("recvmmsg()");
        exit(EXIT_FAILURE);
    }
    printf("%d сообщений получено\n", retval);
    for (i = 0; i < retval; i++) {
        bufs[i][msgs[i].msg_len] = 0;
        printf("%d %s", i+1, bufs[i]);
    }
    exit(EXIT_SUCCESS);
}

ДЕФЕКТЫ