vxfs_vol_remove

NAME

vxfs_vol_remove - remove a volume from a multi-volume file system

SYNOPSIS

AVAILABILITY

VRTSvxfs

DESCRIPTION

vxfs_vol_remove() removes the component volume with the specified volume volname from the file system. The file descriptor fd can specify any file in the file system.

CLUSTER FILE SYSTEM ISSUES

For a cluster mounted file system, you must call vxfs_vol_remove() from the primary node of the cluster, and the primary must be mounted with read and write access. vxfs_vol_remove() fails if called from one of the secondary mounts. You can use the fsclustadm showprimary mount_point command to determine which cluster node is the primary before you call vxfs_vol_remove().

NOTES

In the current implementation, the specified volume must be empty before it can be removed.

RETURN VALUES

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

ERRORS

ENOSPC

There was insufficient space to perform the operation.

EPERM

The calling process does not have correct access privileges.

ENXIO

An I/O error occurred during the operation.

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_enumerate (3), vxfs_vol_resize (3), vxfs_vol_stat (3)