Return a system resource to the resource database
Synopsis:
#include <sys/rsrcdbmgr.h>
#include <sys/rsrcdbmsg.h>
int rsrcdbmgr_detach( rsrc_request_t *list,
int count );
Arguments:
- list
- An array of
rsrc_request_t
structures that describe the resources that you want to return.
For information about this structure, see the documentation for
rsrcdbmgr_attach().
- 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_detach() function returns
count resources in list
to the database of available system resources.
You must return the resource
with the same start,
end, and flags (type) that were
issued for the resource when it was allocated with
rsrcdbmgr_attach().
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 by a process, isn't found in the database, or
can't be returned to the system.
- 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 |