Symantec logo

vxfs_fiostats_set

NAME

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

SYNOPSIS

cc -I /opt/VRTS/include -L /opt/VRTS/lib
-l vxfsutil -ldl

cc -I /opt/VRTS/include -L /opt/VRTS/lib/sparcv9
-l vxfsutil -ldl

#include <sys/types.h>

#include <vxfsutil.h>

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

AVAILABILITY

VRTSvxfs

DESCRIPTION

The vxfs_fiostats_set() function turns on sub-file I/O statistics when action is set to VX_FIOSTATS_ON. offset and length specify range of the file to collect statistics. nsubfile specifies the number of sub-file units within the range. The vxfs_fiostats_set() function turns off sub-file 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 sub-file statistics for the file.

EPERM

The effective user ID of the calling process does not have the appropriate privileges to perform this operation.

SEE ALSO

vxfs_fiostats_getconfig(3), vxfs_fiostats_dump(3)