Home > Veritas Storage Foundation™ File System Manual Pages
VXFS_VOL_QUERYFLAGS (3) |
|
Library Functions |
Table of contents
vxfs_vol_queryflags - queries flags on volumes in a multi-volume
file system
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);
VRTSvxfs
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.
vxfs_vol_queryflags()
returns zero on success,
non-zero on failure.
-
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.
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)
Last updated: 7 May 2007
Copyright ©2009 Symantec Corporation
All rights reserved.