Symantec logo

vxfs_ap_alloc2

NAME

vxfs_ap_alloc2 - allocate an fsap_info2 structure

SYNOPSIS

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

#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)