Home > Veritas Storage Foundation™ File System Manual Pages

VXFS_FIOSTATS_SET (3)

Library Functions

Table of contents


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

#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)

Last updated: 7 May 2007
Copyright ©2009 Symantec Corporation
All rights reserved.