Discards a resource set definition from the system resource set registry.
Standard C library (libc.a)
The rs_discardname subroutine discards from the system global repository the definition of the resource set. The resource set is identified by the namespace and rsname parameters. The specified resource set is removed from the registry, and can no longer be shared with other applications.
In order to be able to discard a name from the global repository, the calling process must have root authority or CAP_NUMA_ATTACH capability, and an effective user ID equal to that of the rsname parameter's creator. CAP_NUMA_ATTACH allows non-root users to create or remove an exclusive rset.
The rs_discardname subroutine is used to remove an exclusive rset. When an exclusive rset is removed, the state of CPUs in that rset is modified so that those CPUs can run any work on the system. Root authority is required to remove an exclusive rset. See Exclusive use processor resource sets in AIX® Version 7.1 Operating system and device management and the rmrset command for more information.
Item | Description |
---|---|
namespace | Points to a null terminated string corresponding to the name space within which rsname should be found. |
rsname | Points to a null terminated string corresponding to the name of a registered resource set to be discarded. |
If successful, a value of 0 is returned. Otherwise, a value of -1 is returned, and the errno global variable is set to indicate the error.
The rs_discardname subroutine is unsuccessful if one or more of the following are true:
Item | Description |
---|---|
EINVAL | One of the following is true:
|
EPERM | One of the following is true:
|
EFAULT | Invalid address, and/or exceptions outside errno range. |