qnx_name_detach()

remove the registration of the given name

Synopsis:

#include <sys/name.h>
int qnx_name_detach( nid_t nid, int name_id );

Description:

The qnx_name_detach() function removes the name identified by name_id from the node specified by nid. If nid is zero, the local node is used.

The name_id parameter must be the value that was returned by the qnx_name_attach() function. In addition, the same nid must be specified as that on the call to qnx_name_attach().

Once the name has been detached, client processes fail when they attempt to locate the name using the qnx_name_locate() function. When a process dies, all its names are detached by the system.

Returns:

0

Success

-1

An error occurred. errno is set to indicate the error.

Errors:

EINVAL

The name doesn't exist, or, if it does, you don't own it.

Examples:

See qnx_name_attach().

Classification:

QNX

See also:

errno, qnx_name_attach(), qnx_name_locate(), qnx_name_locators(), qnx_name_query()