test veritas logo


vxfs_fiostats_set(3)

NAME

vxfs_fiostats_set - turn on and off file range I/O statistics, and resets statistics counters

SYNOPSIS

cc -I /opt/VRTS/include -L /opt/VRTS/lib

#include <sys/types.h>

#include <vxfsutil.h>

int vxfs_fiostats_set(int fd, int action, uint64_t offset, uint64_t length, uint32_t nfilerange);

AVAILABILITY

VRTSvxfs

DESCRIPTION

The vxfs_fiostats_set() function turns on file range I/O statistics when action is set to VX_FIOSTATS_ON. offset and length specify range of the file to collect statistics. nfilerange specifies the number of file range units within the range. The vxfs_fiostats_set() function turns off file range I/O statistics when action is set to VX_FIOSTATS_OFF, and resets statistics counters to 0 when action is set to VX_FIOSTATS_RESET.

RETURN VALUES

vxfs_fiostats_set() returns zero on success, non-zero on failure.

ERRORS

EINVAL Value for action is invalid or nrange is 0.
ENOMEM There was not enough memory to maintain file range statistics for the file.
EPERM The effective user ID of the calling process does not have the appropriate privileges to perform this operation.
ENOTSUP The fiostats_enable tunable for the file system is disabled.

SEE ALSO

vxfs_fiostats_getconfig(3), vxfs_fiostats_dump(3)


VxFS 7.4.1 vxfs_fiostats_set(3)