Home > Veritas Storage Foundation™ File System Manual Pages

VXFS_AP_QUERY (3)

Library Functions

Table of contents


NAME

vxfs_ap_query - return information about a specific 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_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_ckpt(3), .. vxfs_ap_enforce_file(3), vxfs_ap_enforce_fs(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)

Last updated: 01 April 2006
Copyright ©2009 Symantec Corporation
All rights reserved.