vxfs_vol_encapsulate

NAME

vxfs_vol_encapsulate - encapsulate a volume within a multi-volume file system

SYNOPSIS

AVAILABILITY

VRTSvxfs

DESCRIPTION

vxfs_vol_encapsulate() adds the volume specified by volname to the file system, making the existing data in the volume available in the file fname. The size of the resulting file is size bytes, which does not have to be the full size of the volume. Any space in the volume past the portion being encapsulated can be added to the file system as free space by a subsequent vxfs_vol_resize() operation.

RETURN VALUES

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

ERRORS

EINVAL

The specified size is not a multiple of the file system block size.

ENOENT

The specified volume does not exist.

ENOSPC

There was insufficient space to complete the operation.

ENXIO

An I/O error occurred during the operation.

EPERM

The calling process does not have correct access privileges.

EEXIST

The specified file name already exists.

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