resmgr_block()

Заблокировать в ожидании сообщения

Прототип:

#include <sys/iofunc.h>
#include <sys/dispatch.h>
resmgr_context_t * resmgr_block( resmgr_context_t *ctp );

Аргументы:

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

Библиотека:

libc

Описание:

Функция resmgr_block() ожидает сообщения (созданного при помощи вызова resmgr_context_alloc()) для контекста ctp.


Note: Данная функция является частным случаем dispatch_block(), ее следует использовать только при написании простого менеджера ресурсов. Если требуется прикрепить импульсы или другие сообщения, необходимо использовать dispatch_block().

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

Тот же указатель, что и ctp.

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

Коды ошибок:

EFAULT
Произошла ошибка при попытке ядра получить доступ к предоставленным буферам. Поскольку ОС обращается к буферам отправителя только при вызове MsgReceivev(), у отправителя может произойти сбой, если его буферы недействительны. Если ошибка происходит при доступе к буферам отправителя (и только), они получат EFAULT, а MsgReceivev() не разблокируется.
EINTR
Вызов был прерван сигналом.
ETIMEDOUT
Тайм-аут ядра (установленный с помощью dispatch_timeout()) разблокировал вызов.

Примеры:

#include <sys/dispatch.h>
#include <stdio.h>
#include <stdlib.h>
int main( int argc, char **argv )
{
dispatch_t *dpp;
resmgr_context_t *ctp;
if ( (dpp = dispatch_create()) == NULL )
{
fprintf( stderr, "%s: Unable to allocate dispatch handle.\n", argv[0] );
return (EXIT_FAILURE);
}
...
ctp = resmgr_context_alloc( dpp );
while ( 1 )
{
if ( ( ctp = resmgr_block( ctp )) == NULL )
{
fprintf( stderr, "block error\n" );
return (EXIT_FAILURE);
}
resmgr_handler( ctp );
}
}

Примеры использования интерфейса диспетчеризации см. в dispatch_create(), message_attach(), resmgr_attach(), и thread_pool_create().

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

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

Точка остановки потока
Да
Обработчик прерываний
Нет
Обработчик сигналов
Нет
В потоке
Да

Предостережения:

Следует использовать resmgr_block() только в простейших менеджерах ресурсов, и когда не используются message_attach(), pulse_attach(), или select_attach().

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

dispatch_block(), MsgReceivev(), resmgr_attach(), resmgr_context_alloc(), resmgr_context_t, resmgr_handler()




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