Home > Veritas Storage Foundation™ File System Manual Pages

VXFS_VOL_DEENCAPSULATE (3)

Library Functions

NAME
SYNOPSIS
AVAILABILITY
DESCRIPTION
RETURN VALUES
ERRORS
SEE ALSO

NAME

vxfs_vol_deencapsulate - deencapsulate 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_deencapsulate(char *fname);

AVAILABILITY

VRTSvxfs

DESCRIPTION

vxfs_vol_deencapsulate() is the reverse of the vxfs_vol_encapsulate() operation. vxfs_vol_deencapsulate() takes a volume which was encapsulated in a file, restores the original contents to the volume, and removes the volume from the file system. The vxfs_vol_deencapsulate() operation can succeed only if the organization of the file and volume are unchanged from the state that encapsulation produced. If the size of the file is changed (for example, by vxfs_vol_resize()), or if the contents of the file are moved (for example, by fsadm -e, vxfs_ap_enforce_file(), vxfs_ap_enforce_ckpt(), or vxfs_ap_enforce_fs()), the amount of the volume being used by the file system is changed, so the encapsulation cannot be reversed and the deencapsulate operation will fail with an ENOTSUP error.

If the operation succeeds, the file fname is removed.

RETURN VALUES

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

ERRORS

ENOENT: The specified path name does not exist.
ENOSPC: There was insufficient space to complete the operation, possibly because a Storage Checkpoint was created since encapsulation.
ENOTSUP: Deencapsulation cannot be performed because of a configuration change.

fsadm_vxfs(1M), 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_encapsulate(3), vxfs_vol_encapsulate_bias(3), vxfs_vol_enumerate(3), vxfs_vol_remove(3), vxfs_vol_resize(3), vxfs_vol_stat(3)