Symantec logo

vxfs_vol_clearflags

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.

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_deencapsulate(3), vxfs_vol_encapsulate(3), vxfs_vol_encapsulate_bias(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)