test veritas logo


vxfs_vol_queryflags(3)

NAME

vxfs_vol_queryflags - queries flags on volumes in 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_queryflags(int fd, int getall, int *countp, struct fsvol_queryinfo *qinfop);

AVAILABILITY

VRTSvxfs

DESCRIPTION

The vxfs_vol_queryflags() function returns volume flags information for the volumes specified in the *qinfop argument. If the getall argument is zero, information is returned for volumes specified in the *qinfop argument. The *countp argument must contain the number of volumes specified in the array pointed to by the *qinfop argument.

The file descriptor fd must be the mount point of the file system.

If the getall argument is non-zero, information is returned for all component volumes in a multi-volume file system. Upon entry, *countp must contain the number of structures in the array pointed to by *qinfop. On return, *countp is updated with the number of records that were filled. If the error E2BIG is returned, *countp contains the minimum number of records necessary for the call to succeed.

The contents of the structure pointed to by *qinfop are as follows:


struct fsvol_queryinfo { uint64_t vol_flags; char vol_name[FSVOL_NAMESZ]; }

The fields of *qinfop are as follows:
vol_flags Returns flags that are currently set on the volume.
vol_name Contains the name of the component volume.

RETURN VALUES

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

ERRORS

E2BIG The amount of data to return is too large to fit in the specified array.
EFAULT One or more of the specified pointer arguments points to an illegal address.
EINVAL The number of structures specified is incorrect.
ENOENT The specified volume does not exist.
ENOSYS There is no license installed to allow this operation.
ENOTSUP This operation is not supported by the disk layout version of the specified file system. Use vxupgrade(1m) to enable this operation.
EPERM The calling process does not have correct access privileges.
ENXIO There is no such device or address.
EROFS The specified file system is mounted read-only.

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_clearflags(3), vxfs_vol_deencapsulate(3), vxfs_vol_encapsulate(3), vxfs_vol_enumerate(3), vxfs_vol_remove(3), vxfs_vol_resize(3), vxfs_vol_setflags(3), vxfs_vol_stat(3)


VxFS 7.4 vxfs_vol_queryflags(3)