test veritas logo


vxfs_ap_alloc2(3)

NAME

vxfs_ap_alloc2 - allocate an fsap_info2 structure

SYNOPSIS

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

-l vxfsutil -ldl

#include <sys/types.h>

#include <vxfsutil.h>

struct fsap_info2 * vxfs_ap_alloc2(uint32_t ncomp, uint32_t flags);

AVAILABILITY

VRTSvxfs

DESCRIPTION

vxfs_ap_alloc2() allocates an fsap_info2 structure large enough to contain ncomp components, where components are either volumes if flags is 0, or subpolicies if flags has FSAP_SUBPOLICIES set.

To use this function, specify -l vxfsutil while linking.

The fsap_info2 structure is freed by calling vxfs_ap_free2().


struct fsap_info2 { char ap_name[FSAP_NAMESZ]; uint32_t ap_flags; uint32_t ap_order; uint64_t ap_chunk; uint32_t ap_ncomp; uint32_t ap_pad; union { char apc_vols[1][FSVOL_NAMEZ]; char apc_subp[1][FSAP_NAMEZ]; } ap_comp; }; #define ap_vols ap_comp.apc_vols #define ap_subp ap_comp.apc_subp

Possible values for flags are:
FSAP_ANYUSER
  The policy can be assigned by non-privileged users. By default, only privileged users can assign policies.
FSAP_SUBPOLICIES
  The policy definition will contain the names of other allocation policies in its component list. Without this flag, the component list will contain volume names. A policy can refer to either subpolicies or volumes, but not to both.

NOTES

This function is supported only on Version 6 and later disk layouts. This API supports file system versions 6.0 and above.

RETURN VALUES

vxfs_ap_alloc2() returns a pointer to the newly allocated fsap_info2 structure, or NULL on failure.

SEE ALSO

vxfs_ap_assign_ckpt(3), vxfs_ap_assign_file(3), vxfs_ap_assign_fs(3), vxfs_ap_define(3), vxfs_ap_define2(3), vxfs_ap_enforce_file(3), vxfs_ap_enforce_file2(3), vxfs_ap_enumerate(3), vxfs_ap_enumerate2(3), vxfs_ap_free2(3), vxfs_ap_query(3), vxfs_ap_query2(3), vxfs_ap_query_ckpt(3), vxfs_ap_query_file(3), vxfs_ap_query_fs(3), vxfs_ap_remove(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)


VxFS 8.0 vxfs_ap_alloc2(3)