dispatch_timeout()

Set a timeout

Synopsis:

#include <sys/dispatch.h>

int dispatch_timeout( dispatch_t *dpp,
                      struct timespec *reltime );

Library:

libc

Description:

The function dispatch_timeout() sets a timeout that's used when blocking with dispatch_block().

Returns:

0: Success.
-1: An error occurred.

Examples:

#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;
}

For examples using the dispatch interface, see dispatch_create(), message_attach(), resmgr_attach(), and thread_pool_create().

Classification:

QNX 6

Safety:
Cancellation point	No
Interrupt handler	No
Signal handler	No
Thread	Yes