Caution: This version of this document is no longer maintained. For the latest documentation, see http://www.qnx.com/developers/docs.

iofunc_notify_remove()

Remove notification entries from list

Synopsis:

#include <sys/iofunc.h>

void iofunc_notify_remove( resmgr_context_t * ctp,
                           iofunc_notify_t * nop );

Arguments:

ctp
NULL, or a pointer to a resmgr_context_t structure for the client whose entries you want to remove.
nop
An array of three iofunc_notify_t structures that represent (in order), the input, output, and out-of-band notification lists whose entries you want to remove; for information about this structure, see the documentation for iofunc_notify().

Library:

libc

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

Description:

The iofunc_notify_remove() function removes all of the entries associated with the current client from the notification list passed in nop. The client information is obtained from the ctp.

If the ctp pointer is NULL, then all of the notify entries will be removed. A resource manager generally calls this function, with NULL as the ctp in the close_ocb callout, to clean up all handles associated with this connection. If the handles are shared between several connections, then the ctp should be provided to clean up after each client.

Examples:

See Writing a Resource Manager.

Classification:

QNX Neutrino

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

See also:

iofunc_notify(), iofunc_notify_trigger()

Handling ionotify() and select() in the Handling Other Messages chapter of Writing a Resource Manager

Resource Managers chapter of Getting Started with QNX Neutrino