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

pmm_node_unlink()

Unlink the node

Synopsis:

#include <sys/pmm.h>

int pmm_node_unlink(pmm_node_t *node);

Library:

libc

Description:

This call unlinks the node specified by node.

If the policy provides a unlink() function, it is called to determine whether the policy allows that node to be unlinked. If the unlink() function refuses to allow the unlink operation, this call returns an error code (typically EBUSY) that was returned by the unlink() function.

The default unlink() policy is to allow the unlink to occur.

If the unlink is allowed, this call returns 0:

• if there are no client references, the node is removed from the name space and it will be deleted. The policy specific destroy() function is called to free any policy specific data.
• if there are client references, the node is simply removed from the namespace. It will be deleted when the last client reference is removed.
• if node is a non-empty directory, any nodes below it are also (recursively) unlinked.

  If any of these nodes have no client references, they are deleted. Otherwise, they are deleted when the last client reference is removed.

Returns:

Classification:

QNX Neutrino

See also: