vxfs_ap_define

NAME

vxfs_ap_define - define a new allocation policy

SYNOPSIS

AVAILABILITY

VRTSvxfs

DESCRIPTION

vxfs_ap_define() defines an allocation policy with the specified name, flags, order, and volume names. If the policy name is already defined, the definition is overwritten with the new values. The specified volume names must all exist as component volumes in the file system. The file descriptor fd specifies any file in the file system where the policy will be defined. The flags argument is currently unused.

EXAMPLES

Possible values for ap_flags are:

FSAP_ANYUSER

The policy can be assigned by non-privileged users. By default, only privileged users can assign policies.

Possible values for ap_order are:

FSAP_ORDER_ASGIVEN

Allocations are done from the volume in the order in which they are given in the allocation policy.

FSAP_ORDER_LEASTFULL

Allocations are done from the volume specified in the allocation policy that has the most free blocks.

FSAP_ORDER_ROUNDROBIN

Allocations are done from a volume that is selected in a round-robin fashion from those specified in the allocation policy.

RETURN VALUES

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

ERRORS

EEXIST

The specified policy name is reserved.

EINVAL

The specified number of volumes exceeds the maximum number of volumes.

EIO

An I/O error occurred during the operation.

EINVAL

The specified list of volumes contains a duplicate entry.

ENOENT

One or more of the specified volumes does not exist in the file system.

ENOSPC

There was not enough space to store the policy definition.

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

An I/O error occurred during the operation.

EPERM

The effective user ID of the calling process does not have appropriate priviledges to perform this operation.

EROFS

The specified file system is mounted read-only.

SEE ALSO

vxfs_ap_assign_ckpt (3), vxfs_ap_assign_file (3), vxfs_ap_assign_fs (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_encapsulate (3), vxfs_vol_enumerate (3), vxfs_vol_remove (3), vxfs_vol_resize (3), vxfs_vol_stat (3)