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().
Classification:
QNX Neutrino
Safety: |
|
Cancellation point |
Yes |
Interrupt handler |
No |
Signal handler |
Yes |
Thread |
Yes |