Previous  |  Next  >  
Product: File System Manual Pages for Storage Foundation   
Manual: Library Functions (3)   

vxfs_ap_query

NAME

vxfs_ap_query - return information about a specific allocation policy

SYNOPSIS


cc -I /opt/VRTS/include -L /opt/VRTS/lib
-l vxfsutil -ldld

#include <sys/types.h>
#include <vxfsutil.h>
int vxfs_ap_query(int fd, struct fsap_info *fsap);

AVAILABILITY

VRTSvxfs

DESCRIPTION

vxfs_ap_query() fills the fsap_info structure with the information for the policy specified by name fsap->ap_name. The file descriptor fd specifies the mount point or any file in the file system.

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_query() returns zero on success, non-zero on failure.

ERRORS

EFAULT

One or more of the specified pointer arguments points to an illegal address.

ENOENT

The specified policy does not exist.

SEE ALSO

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_file (3), vxfs_ap_enumerate (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)
 ^ Return to Top Previous  |  Next  >  
Product: File System Manual Pages for Storage Foundation  
Manual: Library Functions (3)  
VERITAS Software Corporation
www.veritas.com