Home > Veritas Storage Foundation™ File System Manual Pages

VXFS_VOL_STAT (3)

Library Functions

NAME
SYNOPSIS
AVAILABILITY
DESCRIPTION
RETURN VALUES
ERRORS
SEE ALSO

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.