« SORT Documents < Previous  | TOC | Index | Next  >

vxfs_fiostats_dump

NAME

vxfs_fiostats_dump - return file and sub-file I/O statistics

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_dump(int fd, int reset, struct vx_fileiostats *filebufp, struct vx_rangeiostats *rangebufp, uint32_t *nsubfile);

AVAILABILITY

VRTSvxfs

DESCRIPTION

The vxfs_fiostats_dump() function fills file statistics described by the vx_fileiostats structure into the *filebufp array, and fills sub-file statistics described by the vx_rangeiostats structure into the *rangebufp array. Both *filebufp and *rangebufp are user-allocated. Upon entry, *nsubfile contains the number of structures in the array pointed to by *rangebufp. On return, *nsubfile is updated with the number of structures that were filled in. If the error E2BIG is returned, *nsubfile 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 sub-file 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.

SEE ALSO

vxfs_fiostats_getconfig(3), vxfs_fiostats_set(3)