Veritas™ File System 5.0.1 Programmer's Reference Guide

Possible value for flag is:
■ VXFS_TS_RECLAIM_AGGRESSIVE — Perform an additional
data and metadata reorganization to maximize free space
reclamation. This operation might trigger additional space
allocation from the underlying Thin Storage, which is
released at the end of the operation. This operation can
fragment existing large allocations.
Aggressive reclamation is performed only if VxVM reports
the volume as thinrclm. In case of multi−volume file
systems, only the volumes that VxVM reports as thinrclm
are considered.
If the volindex argument has a value of −1, then the full
file system is covered. The offset and length arguments are
ignored. If you specify a value for the volindex argument,
then the full volume is covered if both the offset argument
and length argument have a value of 0. If you specify a
value for the offset argument and length argument,
vxfs_ts_reclaim() does not perform aggressive
reclamation, but performs the default the default
reclamation instead, regardless if you specified a value for
the volindex argument.
flag
VxFS may align the offset and length internally for correctness.
Note: Thin Reclamation is a slow process and may take several hours to complete,
depending on the file system size. Thin Reclamation is not guaranteed to reclaim
100% of the free space.
vxfs_ts_reclaim return values
The return values from the API are as follows:
Successful reclamation.0
A non-root user called the API.EPERM
The mount point does not exist.ENOENT
The mount point is not the root of the file system.EBADF
The device for the mount point cannot be accessed.EPIPE
The mount point is not the root of a VxFS file system, the
specified volume is not thinrclm−capable, or none of the
volumes in the volume set are thinrclm−capable.
ENOTSUP
87Thin Reclamation
Thin Reclamation application programming interface