iofunc_unblock_default()

Default unblock handler

Synopsis:

#include <sys/iofunc.h>

int iofunc_unblock_default( resmgr_context_t * ctp,
                            io_pulse_t * msg,
                            iofunc_ocb_t * ocb );

Library:

libc

Description:

The iofunc_unblock_default() function calls iofunc_unblock().

The iofunc_unblock_default() function implements the functionality required when the client requests to be unblocked (e.g. a signal or timeout). This function can be placed directly into the io_funcs table passed to resmgr_attach(), at the unblock position.

The unblock message is synthesized by the resource manager shared library when a client wishes to unblock from its MsgSendv() to the resource manager. The iofunc_unblock_default() function takes care of freeing up any locks that the client may have placed on the resource.

Returns:

_RESMGR_DEFAULT

No client connection was found.

_RESMGR_NOREPLY

A client connection has been unblocked.

Examples:

If you're calling iofunc_lock_default() then your unblock handler should call iofunc_unblock_default():

if((status = iofunc_unblock_default(...)) != _RESMGR_DEFAULT) {
return status;
}

/* Do your own thing to look for a client to unblock */

Classification:

QNX 6

See also:

iofunc_chmod_default(), iofunc_chown_default(), iofunc_close_dup_default(), iofunc_close_ocb_default(), iofunc_devctl_default(), iofunc_lock_default(), iofunc_lseek_default(), iofunc_mmap_default(), iofunc_open_default(), iofunc_pathconf_default(), iofunc_stat_default(), iofunc_time_update(), iofunc_utime_default(), resmgr_attach()