resmgr_handler()

QNX SDP8.0C Library ReferenceAPIDeveloper

Handle resource manager messages

Synopsis:

#include <sys/iofunc.h>
#include <sys/dispatch.h>

int resmgr_handler( resmgr_context_t * ctp );

Arguments:

ctp
A pointer to a resmgr_context_t structure that the resource-manager library uses to pass context information between functions.

Library:

libc

Use the -l c option to qcc to link against this library. This library is usually included automatically.

Description:

The resmgr_handler() function handles the message received in ctp. This function can handle different I/O messages through the resource manager framework.

Note:
The resmgr_handler() function is a special case of dispatch_handler(). You should use it only when writing a simple resource manager (i.e., where there's no need to attach pulses or messages).

Returns:

This function always returns 0 (success).

Examples:

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

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

Classification:

QNX OS

Safety:
Cancellation pointYes
Signal handlerNo
ThreadYes

Caveats:

If you attach messages or pulses to dpp by calling message_attach(), pulse_attach(), or select_attach(), those events aren't dispatched by resmgr_handler(). Instead, you should call dispatch_handler().

Page updated: