Default handler for _IO_CLOSE messages
Synopsis:
#include <sys/iofunc.h>
int iofunc_close_dup_default(
resmgr_context_t *ctp,
io_close_t *msg,
iofunc_ocb_t *ocb );
Arguments:
- ctp
- A pointer to a
resmgr_context_t
structure that the resource-manager library uses to pass context information
between functions.
- msg
- A pointer to the
io_close_t
structure that contains the message that the resource manager received.
For more information, see the documentation for
iofunc_close_dup().
- ocb
- A pointer to the
iofunc_ocb_t
structure for the Open Control Block that was created when the
client opened the resource.
Library:
libc
Use the -l c option to
qcc
to link against this library.
This library is usually included automatically.
Description:
The iofunc_close_dup_default() function implements default actions
for the _IO_CLOSE message.
This function simply calls
iofunc_close_dup() to do the actual work.
You can place iofunc_close_dup_default() directly into the
resmgr_io_funcs_t
table passed as the io_funcs argument to
resmgr_attach(),
at the close_dup position, or you can call
iofunc_func_init()
to initialize all of the functions to their default values.
Note:
If your resource manager uses
iofunc_lock_default(),
you
must use both
iofunc_close_dup_default() and
iofunc_unblock_default()
in their respective handlers, as they provide
necessary ancillary functionality for managing file locks.
This is because file locks are owned by the process, and aren't
inherited by the child process.
Returns:
- EOK
- Successful completion.
Classification:
QNX Neutrino
Safety: |
|
Cancellation point |
No |
Interrupt handler |
No |
Signal handler |
Yes |
Thread |
Yes |