[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_property_add()

Add a new property to a node

Synopsis:

#include <sys/pmm.h>

int pmm_property_add(pmm_node_t *node, pm_property_t id, 
                                  void *data, int size);

Library:

libc

Description:

This calls adds a new property to a node:

node
Pointer to the node.
id
Property identifier.
Note: Currently only user-defined properties above PM_PROPERTY_USER are supported.

data
Pointer to the initial data that represents the property value.
size
Size in bytes of the data.

If successful, this function call allocates internal storage to hold a copy of data and returns 0.

If the policy specifies properety_add() function, it is called to inform the policy of the new property and its initial value.

If an error occurs, the errno is set to one of the following:

Returns:

ENOMEM
Insufficient memory to allocate required data structures.
EEXIT
Property with the same identifier as id already exists.

Classification:

QNX Neutrino

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

See also:


[Previous] [Contents] [Next]