resmgr_open

Associate an OCB with an open request

Synopsis:

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

int resmgr_open_bind(
       resmgr_context_t* ctp,
       void* ocb,
       const resmgr_io_funcs_t* iofuncs );

Arguments:

ctp: A pointer to a resmgr_context_t structure that the resource-manager library uses to pass context information between functions.
ocb: A pointer to the Open Control Block that you want to bind to the open request. An OCB is usually a structure of type iofunc_ocb_t.
iofuncs: A pointer to the resmgr_io_funcs_t structure that defines the I/O functions for the resource manager.

Library:

libc

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

Description:

The resmgr_open_bind() function is the lowest-level call in the resource manager library used for handling open messages. It associates the Open Control Block (OCB) with a process identified by the id and info members of ctp.

Note: You must use this function as part of the handling of an _IO_OPEN message. In practice, you don't call this function directly; you typically use either iofunc_open_default() or iofunc_ocb_attach(). (The iofunc_open_default() function calls iofunc_ocb_attach(), which in turn calls resmgr_open_bind()).

An internal data structure is allocated that maintains the number of links to the OCB. On a file descriptor dup(), the link count is incremented and on a close() it's decremented. When the count reaches zero, the close_ocb() callout specified in io_funcs is called.

The OCB is a structure that contains at least the members as defined by the typedef iofunc_ocb_t. This typedef defines a common OCB structure that can then be used by the POSIX layer helper functions (all functions beginning with the name iofunc_*). You can extend it if you need to store additional information; see the "Extending the POSIX-Layer Data Structures" chapter of Writing a Resource Manager.

The attr argument to the open() callout is also typically saved in the OCB. The iofunc_ocb_t structure has a member called attr where you must store the value of the attr argument. This lets the POSIX helper functions access information about the current open session (as stored in the OCB) as well as information about the device itself (as stored in the attributes structure, ocb->attr).

For a detailed discussion, including several examples, see Writing a Resource Manager.

Returns:

0: Success.
-1: An error occurred (errno is set).

Errors:

EINVAL: The id and/or info members of ctp aren't valid.
ENOMEM: Insufficient memory to allocate an internal data structure.

Classification:

QNX Neutrino

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