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.

---

Данная функция является частным случаем 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 системной библиотеки