Symantec logo

vxfs_vol_stat

NAME

vxfs_vol_stat - return free space information about a component volume within a multi-volume file system

SYNOPSIS

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

#include <sys/types.h>

#include <vxfsutil.h>

int vxfs_vol_stat(int fd, char *volname, struct fsdev_info *infop);

AVAILABILITY

VRTSvxfs

DESCRIPTION

vxfs_vol_stat() returns information on the specified volume of a multi-volume file system. Information is returned on the total number of bytes available to VxFS in the component volume with volume volname. vxfs_vol_stat() also returns the number of bytes not yet allocated to files.

The file descriptor fd must specify any file in the file system.

The infop structure returns information about the volume specified by volname. The fields of infop are:

dev_size

Returns the total size, in bytes, of the volume.

dev_free

Returns the amount of available space, in bytes, on the volume.

struct fsdev_info {

int dev_id;

uint64_t dev_size;

uint64_t dev_free;

uint64_t dev_avail;

char dev_name[FSDEV_NAMESZ];

};

RETURN VALUES

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

ERRORS

EFAULT

One or more of the specified pointer arguments points to an illegal address.

ENOENT

The specified volume name does not exist.

ENOTSUP

This operation is not supported by the disk layout version of the specified file system. Use vxupgrade(1m) to enable this operation.

SEE ALSO

vxfs_ap_assign_ckpt(3), vxfs_ap_assign_file(3), vxfs_ap_assign_fs(3), vxfs_ap_define(3), vxfs_ap_remove(3), vxfs_ap_enforce_file(3), vxfs_ap_enumerate(3), vxfs_ap_query(3), vxfs_ap_query_ckpt(3), vxfs_ap_query_file(3), vxfs_ap_query_fs(3), vxfs_vol_add(3), vxfs_vol_deencapsulate(3), vxfs_vol_encapsulate(3), vxfs_vol_enumerate(3), vxfs_vol_remove(3), vxfs_vol_resize(3)