Home > Veritas Storage Foundation™ File System Manual Pages

VXFS_AP_DEFINE (3)

Library Functions

NAME
SYNOPSIS
AVAILABILITY
DESCRIPTION
EXAMPLES
RETURN VALUES
ERRORS
SEE ALSO

NAME

vxfs_ap_define - define a new allocation policy

SYNOPSIS

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

-l vxfsutil -ldl

#include <sys/types.h>

#include <vxfsutil.h>

int vxfs_ap_define(int fd, struct fsap_info *fsap, uint32_t flags);

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


struct fsap_info {
        char            ap_name[FSAP_NAMESZ];
        uint32_t        ap_flags;
        uint32_t        ap_order;
        uint32_t        ap_ndevs;
        char            ap_devs[FSAP_MAXDEVS][FSDEV_NAMESZ];
};

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.

VXFS_AP_DEFINE (3)

Table of contents