[Previous] [Contents] [Next]

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

pmm_node_lookup()

Look up a node by name

Synopsis:

#include <sys/pmm.h>

void * pmm_node_lookup(pmm_node_t *parent, 
                        const char *name);

Library:

libc

Description:

This call is used to look up a node by name:

parent
Pointer to the node at which the name resolution begins.

If it is NULL, the name resolution begins at the root of the namespace.

name
Name to be resolved. This can contain multiple '/'-separated components.

If successful, this returns the policy specific data assocaietd with the node when it isinitially created.

If the name resolution fails, it returns NULL, and errno is set one of the following:

Returns:

ENOENT
Final component of name does not exist.
ENOTDIR
one of the intermediate components in name is not a directory
EACCES
one of the intermediate directory components in name does not have search permission.
ENOMEM
Insufficient memory to allocate required resources.

Classification:

QNX Neutrino

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

See also:


[Previous] [Contents] [Next]