resmgr_msgreadv()

Прочитать сообщение клиента

Прототип:

#include <sys/resmgr.h>
                                       
int resmgr_msgreadv( resmgr_context_t *ctp,
                     iov_t *iov,
                     int rparts,
                     int offset );

Аргументы:

ctp

Указатель на структуру resmgr_context_t, которую библиотека менеджера ресурсов использует для передачи контекстной информации между функциями. Данная функция извлекает rcvid из этой структуры.

iov

Массив из объектов iov_t, где функция может хранить данные.

rparts

Количество элементов массива iov.

offset

Смещение в сообщении отправки потока, которое указывает, откуда необходимо начать чтение данных.

Библиотека:

libc

Описание:

Функция resmgr_msgreadv() является удобная заменой MsgReadv(), которую следует использовать при написании менеджера ресурсов.

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

Возвращаемое значение:

То же, что и у MsgReadv(): количество считанных байт.

Если возникла ошибка функция возвращает -1, код ошибки записывается в errno.

Коды ошибок:

EFAULT

Произошла ошибка в адресном пространстве сервера при попытке доступа к буферам сообщений вызывающей стороны.

ESRCH

Поток ctp-> rcvid не существует или его соединение прервано.

ESRVRFAULT

Произошла ошибка при попытке ядра получить доступ к предоставленным буферам.

Классификация:

ЗОСРВ «Нейтрино»

Безопасность использования

Точка остановки потока

Нет

Обработчик прерываний

Нет

Обработчик сигналов

Да

В потоке

Да

Тематические ссылки:

iov_t, MsgReadv(), resmgr_context_t, resmgr_msgread(), resmgr_msgwrite(), resmgr_msgwritev()

Предыдущий раздел: Описание API системной библиотеки