pulse_attach()

Задать функцию-обработчик импульса для менеджера ресурсов

Прототип:

#include <sys/iofunc.h>
#include <sys/dispatch.h>
int pulse_attach( dispatch_t *dpp,
int flags,
int code,
int (*func)( message_context_t *ctp,
int code,
unsigned flags,
void *handle ),
void *handle );

Аргументы:

dpp
Дескриптор диспетчера, возвращенного функцией dispatch_create().
flags
В настоящий момент доступны следующие флаги, определенные в <sys/dispatch.h>:
MSG_FLAG_ALLOC_PULSE
использовать новый код пульса (выделенный системой), который отличается от любого уже использованного в данном процессе кода, уже присоединенного через аргумент pulse_attach() или выделенного системой. Выделенный код пульса будет в пределах диапазона _PULSE_CODE_MINAVAIL и _PULSE_CODE_MAXAVAIL.
code
Код пульса, который необходимо присоединить для обработки в функции func.
func
Указатель на функцию-обработчик, которая будет вызываться в ответ на поступление пульса с кодом, указанным в code. См. Handler function.
handle
Аргумент функции-обработчика func.

Библиотека:

libc

Описание:

Функция pulse_attach() присоединяет пульс с кодом code к обработчику func. Можно использоваться данный обработчиктакже и в message_attach(). Посредством контроля ctp->rcvid, в обработчике func можно определить что получено – пульс или сообщение.

Если менеджер ресурсов получит пульс с кодом code, будет вызван func. За всю последующую обработку пульса ctp->msg.pulse отвечает исключительно обработчик. Указатель handle передается ему в качестве аргумента. Обработчик должен вернуть 0; остальные значения зарезервированы.

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

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

Если передан флаг MSG_FLAG_ALLOC_PULSE, функция возвращает код выделенного системой пульса; в противном случае, возвращается code.

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

Коды ошибок:

EAGAIN
Выделение кода пульса code невозможно.
EINVAL
Код пульса code вне допустимого диапазона или уже используется.
ENOMEM
Недостаточно памяти для создания внутренних структур.

Примеры:

#include <sys/dispatch.h>
#include <time.h>
#include <stdio.h>
#include <stdlib.h>
int my_func( ... )
{
...
}
int main( int argc, char **argv )
{
dispatch_t *dpp;
int flag = 0, code, mycode;
if ( ( dpp = dispatch_create() ) == NULL )
{
fprintf( stderr, "%s: Unable to allocate dispatch handle.\n",argv[0] );
return (EXIT_FAILURE);
}
...
mycode = ...;
if ( (code = pulse_attach( dpp, flag, mycode, &my_func, NULL )) == -1 )
{
fprintf( stderr, "Failed to attach code %d.\n", mycode );
return (1);
}
/* else successfully attached a pulse code */
...
}

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

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

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

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

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

message_context_t, message_attach(), pulse_detach()




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