rsrcdbmgr_destroy()

Updated: April 19, 2023

Destroy a system resource

Synopsis:

#include <sys/rsrcdbmgr.h>
#include <sys/rsrcdbmsg.h>

int rsrcdbmgr_destroy( rsrc_alloc_t *item,
                       int count );

Arguments:

item
An array of rsrc_alloc_t structures that describe the resources that you want to destroy. For more information about this structure, see the documentation for rsrcdbmgr_create().
count
The number of entries in the array.

Library:

libc

Use the -l c option to qcc to link against this library. This library is usually included automatically.

Description:

The rsrcdbmgr_destroy() function removes count system resources that are defined in the array item.

Note: In order to successfully use the rsrcdbmgr_*() functions to modify the resource database, your process must have the PROCMGR_AID_RSRCDBMGR ability enabled. For more information, see procmgr_ability().

Returns:

EOK
Success.
-1
An error occurred; errno is set.

Errors:

EINTR
The call was interrupted by a signal.
EINVAL
Invalid argument, or the resource is in use.
ENOMEM
Insufficient memory to allocate internal data structures.
EPERM
The calling process doesn't have the required permission; see procmgr_ability().

Examples:

See the example in rsrcdbmgr_create().

Classification:

QNX Neutrino

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