Symantec logo

vxfs_vol_queryflags

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

cc -I /opt/VRTS/include -L /opt/VRTS/lib/sparcv9
-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)