openfam::fam::fam_destroy_region
Destroy an existing region in FAM.
Synopsis
void fam_destroy_region(Fam_Region_Descriptor *descriptor);
Description
This destroys a region in FAM, and asynchronously frees space allocated to the region.
Input Arguments
| Name | Description |
|---|---|
| descriptor | Descriptor of the region to be destroyed. |
Return Values
None. Throws Fam_Exception on error.
Fam Error Numbers
| Error | Description |
|---|---|
| FAM_ERR_NOPERM | Caller does not have access rights |
| FAM_ERR_NOTFOUND | Region name is not present in FAM |
| FAM_ERR_RPC | Communication error from grpc layer. |
| FAM_ERR_RPC_CLIENT_NOTFOUND | RPC service not available. |
| FAM_ERR_METADATA | Metadata service error. |
| FAM_ERR_MEMORY | Memory service error. |
| FAM_ERR_RESOURCE | Resource not available. |
Notes
If a region is destroyed, all data items in it are also destroyed. If descriptors to the region or the contained data items are subsequently used, the behavior of the library is implementation dependent. Note that this call will trigger a delayed free operation, to perform memset operation to zero deallocated memory space from this region.