Home > Veritas Storage Foundation™ File System Manual Pages
VXFS_AP_QUERY (3) |
|
Library Functions |
Table of contents
vxfs_ap_query - return information about a specific allocation policy
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);
VRTSvxfs
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.
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 value for
ap_flags
is:
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.
To use this function,
specify
-l vxfsutil
while linking.
This API supports file
system versions 6.0 and above.
vxfs_ap_query()
returns zero on success,
non-zero on failure.
-
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.
-
ENOENT
-
The specified policy does not exist.
-
ENOMEM
-
Memory could not be allocated to support the API.
-
ENOTSUP
-
This operation is not supported by the disk layout version of the
specified file system.
Use
vxupgrade(1M)
to enable this operation.
-
ERANGE
-
The result was too large.
-
VX_ETOOMANYVOLS
-
Too many volumes were specified for the volume set.
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_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: 7 May 2007
Copyright ©2009 Symantec Corporation
All rights reserved.