Home > Veritas Storage Foundation™ File System Manual Pages

VXFS_VOL_CLEARFLAGS (3)

Library Functions

NAME
SYNOPSIS
AVAILABILITY
DESCRIPTION
RETURN VALUES
ERRORS
SEE ALSO

NAME

vxfs_vol_clearflags - clear specified 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_clearflags(int fd, uint64_t flags, int nvols, char \(**\(**vollist);

AVAILABILITY

VRTSvxfs

DESCRIPTION

The vxfs_vol_clearflags() function clears the specified 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 cleared on the target volumes. The only valid value of the flags argument is VX_VOLFLAG_DATAONLY.

The vxfs_vol_clearflags() 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_clearflags() fails, the function might have moved some of the extents.

RETURN VALUES

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

ERRORS

EFAULT: One or more of the specified pointer arguments points to an illegal address.
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_deencapsulate(3), vxfs_vol_encapsulate(3), vxfs_vol_enumerate(3), vxfs_vol_queryflags(3), vxfs_vol_remove(3), vxfs_vol_resize(3), vxfs_vol_setflags(3), vxfs_vol_stat(3)