test veritas logo


vxfs_fiostats_dump(3)

NAME

vxfs_fiostats_dump - return file and file range I/O statistics

SYNOPSIS

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

#include <sys/types.h>

#include <vxfsutil.h>

int vxfs_fiostats_dump(int fd, int reset, struct vx_fileiostats *filebufp, struct vx_rangeiostats *rangebufp, uint32_t *nfilerange);

AVAILABILITY

VRTSvxfs

DESCRIPTION

The vxfs_fiostats_dump() function fills file statistics described by the vx_fileiostats structure into the *filebufp array, and fills file range statistics described by the vx_rangeiostats structure into the *rangebufp array. Both *filebufp and *rangebufp are user-allocated. Upon entry, *nfilerange contains the number of structures in the array pointed to by *rangebufp. On return, *nfilerange is updated with the number of structures that were filled in. If the error E2BIG is returned, *nfilerange will contain the minimum number of structures necessary for the call to succeed.

RETURN VALUES

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

ERRORS

E2BIG The amount of file range statistics to return is too large to fit in the specified array.
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_set(3)


VxFS 7.4.1 vxfs_fiostats_dump(3)