Home > Veritas Storage Foundation™ File System Manual Pages

VXFS_VOL_ENCAPSULATE_BIAS (3)

Library Functions

NAME
SYNOPSIS
AVAILABILITY
DESCRIPTION
RETURN VALUES
ERRORS
SEE ALSO

NAME

vxfs_vol_encapsulate_bias - encapsulate a volume within 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_encapsulate_bias(char *fname, char *volname, uint64_t size, uint64_t bias);

AVAILABILITY

VRTSvxfs

DESCRIPTION

vxfs_vol_encapsulate_bias() adds the volume specified by volname to the file system, making the existing data starting at byte offset bias in the volume available in the file fname. The size of the resulting file is size - bias bytes. size does not have to be the full size of the volume. bias must be smaller than size and must be a multiple of the file system block size in bytes. 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_bias() returns zero on success, non-zero on failure.

ERRORS

EINVAL: The specified bias 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.

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