Home > Veritas Storage Foundation™ File System Manual Pages

VXFS_AP_ALLOC2 (3)

Library Functions

NAME
SYNOPSIS
AVAILABILITY
DESCRIPTION
NOTES
RETURN VALUES
SEE ALSO

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.

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)