Home > Veritas Storage Foundation™ File System Manual Pages

VXFS_VOL_REMOVE (3)
Library Functions

Table of contents

NAME

vxfs_vol_remove - remove a volume from 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_remove(int fd, char *volname);

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_ckpt(3), .. vxfs_ap_enforce_file(3), vxfs_ap_enforce_fs(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)

Last updated: 01 April 2006
Copyright ©2009 Symantec Corporation
All rights reserved.