dispatch_timeout()

Установить тайм-аут

Прототип:

#include <sys/iofunc.h>
#include <sys/dispatch.h>
                                       
int dispatch_timeout( dispatch_t *dpp,
                      struct timespec *reltime );

Аргументы:

dpp

Дескриптор структуры диспетчера, созданной dispatch_create().

reltime

Указатель на struct timespec, определяющую относительное время таймаута.

Библиотека:

libc

Описание:

Функция dispatch_timeout() устанавливает таймаут, использующийся во время блокировки с помощью dispatch_block().

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

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

0

Успешное завершение.

-1

Возникла ошибка.

Примеры:

#include <sys/dispatch.h>
#include <time.h>
#include <stdio.h>
#include <stdlib.h>
    
int main( int argc, char **argv )
{
    dispatch_t      *dpp;
    struct timespec time_out;
    int             timedout;
        
    time_out.tv_sec  = 1;
    time_out.tv_nsec = 2;
                                       
    if ( ( dpp = dispatch_create() ) == NULL )
    {
        fprintf( stderr, "%s: Unable to allocate dispatch handle.\n", argv[0] );
        return (EXIT_FAILURE);
    }
    ...
                                   
    if ( (timedout = dispatch_timeout( dpp, &time_out )) == -1 )
    {
        fprintf( stderr, "Couldn't set timeout" );
        return (EXIT_FAILURE);
    }
    /* else successful timeout set */
    ...
                                   
    return (EXIT_SUCCESS);
}

Другие примеры, использующие интерфейс диспетчера см. на страницах dispatch_create(), message_attach(), resmgr_attach() или thread_pool_create().

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

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

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

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

Нет

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

Нет

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

Нет

В потоке

Да

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

dispatch_block(), dispatch_create(), dispatch_create_channel(), dispatch_handler(), dispatch_unblock() struct timespec

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