name_detach()
QNX SDP8.0C Library ReferenceAPIDeveloper
Remove a name from the namespace and destroy the channel
Synopsis:
#include <sys/iofunc.h>
#include <sys/dispatch.h>
int name_detach( name_attach_t * attach,
unsigned flags );
Arguments:
- attach
- A pointer to the name_attach_t structure returned by a successful call to name_attach().
- flags
- Flags that affect the function's behavior:
- NAME_FLAG_DETACH_SAVEDPP — don't destroy the dispatch handle.
Library:
libc
Use the -l c option to qcc to link against this library. This library is usually included automatically.
Description:
The name_detach() function removes the name from the namespace and destroys the channel created by name_attach(). If you set NAME_FLAG_DETACH_SAVEDPP in flags, the dispatch pointer contained in the name_attach_t structure isn't destroyed; it's up to you to destroy it by calling dispatch_destroy(). The default is to destroy the dispatch pointer.
Returns:
Zero on success, or -1 if an error occurs (errno is set).
Errors:
- EINVAL
- The mount ID (mntid) was never attached with name_attach().
Examples:
See name_attach() and resmgr_detach().
Classification:
| Safety: | |
|---|---|
| Cancellation point | Yes |
| Signal handler | No |
| Thread | Yes |
Page updated: