Thin Reclamation application programming interface
You can use Thin Reclamation with the following API:
uint vxfs_ts_reclaim(char *mountpoint, uint64_t offset,
uint64_t length, int32_t volindex, uint64_t unit_size,
uint64_t *bytes_reclaimed, uint32_t flag)
This is a non-reentrant API. This API cannot be called when an instance of the fsadm command or a reorg of the file system is running.
|
mountpoint
|
The pathname of the VxFS file system that is mounted on a Veritas Volume Manager (VxVM) volume.
|
|
offset
|
The offset in bytes in the volume from which to start reclamation.
|
|
length
|
The length in bytes from offset, up to which to reclaim free storage.
|
|
volindex
|
The index of the volume in a volume set. When volindex has a value of -1, all the volumes in the file system ignore offset and length. On a non-multi-volume file system, volindex should be zero.
|
|
unit_size
|
The size in multiples by which the file system issues reclaim requests to VxVM. Each Thin Provisioning array supports reclamation by a factor of some unit size.
|
|
bytes_reclaimed
|
Returns the number of bytes that the file system attempted to reclaim. The value does not give an indication of the number of bytes actually reclaimed. |
|
flag
|
Currently unused. |
VxFS may align the offset and length internally for correctness.
Note: |
Thin Reclamation is a slow process and may take over an hour to complete. |
