rsrcdbmgr_detach()

Updated: April 19, 2023

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().

Examples:

See the examples in rsrcdbmgr_attach().

Classification:

QNX Neutrino

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