Home > Veritas Storage Foundation™ File System Manual Pages
VXFS_VOL_ENCAPSULATE_BIAS (3) |
|
Library Functions |
Table of contents
vxfs_vol_encapsulate_bias - encapsulate a volume within a multi-volume file system
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);
VRTSvxfs
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.
vxfs_vol_encapsulate_bias()
returns zero on success,
non-zero on failure.
-
EEXIST
-
The specified policy name is reserved.
-
EFAULT
-
One or more of the specified pointer arguments points to an illegal address.
-
EFBIG
-
The calling function issued a request with a file offset
off
past the EOF mark.
-
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.
-
ENOTSUP
-
This operation is not supported by the disk layout version of the
specified file system.
Use
vxupgrade(1M)
to enable this operation.
-
ENXIO
-
An I/O error occurred during the operation.
-
EPERM
-
The calling process does not have correct access privileges.
-
EROFS
-
The specified file system is mounted read-only.
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_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)
Last updated: 7 May 2007
Copyright ©2009 Symantec Corporation
All rights reserved.