test veritas logo



vxfs_vol_setflags - set specified 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_setflags(int fd, uint64_t flags, int nvols, char **vollist);




The vxfs_vol_setflags() function sets flags on volumes specified in vollist in a multi-volume file system. The file descriptor fd must be the mount point of the file system. The names of the target volumes are specified in the vollist argument, which is an array of volume names. The size of the vollist array is specified by the nvols argument. The flags argument specifies the flags to be set on the target volumes. The only valid value of the flags argument is VX_VOLFLAG_DATAONLY.

The vxfs_vol_setflags() function might fail if a conflict is detected with an allocation policy or if there is not enough space in the file system to move the extents in accordance with the allocation policies present in the file system. Even if vxfs_vol_setflags() fails, the function might have moved some of the extents.


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


EFAULT One or more of the specified pointer arguments points to an illegal address.
EAGAIN One of the volumes is part of a conflicting allocation policy.
EFBIG The calling function issued a request with a file offset off past the EOF mark.
EINVAL The specified flags are invalid.
ENFILE The maximum number of files are open on the system.
ENOENT The specified volume does not exist.
ENOSPC There was not enough space to create the structural files to represent the new volume.
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_queryflags(3), vxfs_vol_remove(3), vxfs_vol_resize(3), vxfs_vol_stat(3)

VxFS 7.4 vxfs_vol_setflags(3)