vxfs_ap_remove (3)

NAME

vxfs_ap_remove - delete a specified allocation policy

SYNOPSIS

For 32-bit applications:

cc -I /opt/VRTS/include -L /opt/VRTS/lib

-l vxfsutil -ldl

For 64-bit applications:

cc -I /opt/VRTS/include -L /opt/VRTS/lib/64

-l vxfsutil -ldld

For both applications:

#include <sys/types.h>

#include <vxfsutil.h>

int vxfs_ap_remove(int fd, char *name);

AVAILABILITY

VRTSvxfs

DESCRIPTION

vxfs_ap_remove() deletes the policy specified by the name argument. The file descriptor fd specifies any file in the file system where the policy will be removed.

To use this function, specify -l vxfsutil while linking. Specify the /opt/VRTSfssdk/5.0/lib directory for 32-bit executables, or the /opt/VRTSfssdk/5.0/lib/64 directory for 64-bit executables.

If the LIBVXFSUTIL_DLL_PATH environment variable is defined, it should be set to the name of the vxfsutil.so file, such as ~/mylib/vxfsutil.so. If undefined, this variable is assumed to point to the 32-bit and 64-bit vxfsutil.so files, /opt/VRTSvxfs/lib/vxfsutil.so and /opt/VRTSvxfs/lib/64/vxfsutil.so, respectively.

NOTES

This API can only be executed through root. This API supports file system versions 6.0 and above.

RETURN VALUES

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

ERRORS

EFAULT One or more of the specified pointer arguments points to an illegal address.
EINVAL The specified number of volumes exceeds the maximum number of volumes.
EIO An I/O error occurred during the operation.
ENFILE The maximum number of files are open on the system.
ENOENT The specified policy does not exist.
ENOMEM Memory could not be allocated to support the API.
ENOSPC There was not enough space to create the structural files to represent the new volume.
ENOSYS There is no license installed to allow this 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 There is no such device or address.
EPERM The effective user ID of the calling process does not have appropriate privileges to perform this operation.
EROFS The specified file system is mounted read-only.
VX_ENOINODE The file system is out of inodes.
VX_ETOOMANYVOLS Too many volumes were specified for the volume set.

SEE ALSO

vxfs_ap_assign_ckpt(3), vxfs_ap_assign_file(3), vxfs_ap_assign_fs(3), vxfs_ap_define(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)


VxFS 5.1 SP1 vxfs_ap_remove (3)