HP-UX AAA Server A.08.01 administrator's guide (T1428-90072, May 2010)

Table Of Contents
Asynchronous APIs — These APIs enable you to write AATVs that are required
for making asynchronous calls to external servers.
Secondary APIs — These additional APIs enable you to further customize the
HP-UX AAA Server.
The following sections describe these APIs in detail.
A-V Pair APIs
This section discusses the A-V pair APIs.
sdk_avp_t *sdk_avp_allocate()
Allocates an A-V pair, initializes all fields as 0, and returns a pointer to it.
Return
Returns a pointer to the allocated A-V pair, or NULL if the A-V pair is not allocated.
void sdk_avp_free()
void sdk_avp_free (sdk_avp_t *avp)
Usage
Frees the memory and any allocated string storage associated with an A-V pair. The
string storage must not be shared with other objects.
Input
avp A pointer to the A-V pair that must be freed.
int sdk_get_avp_info()
int sdk_get_avp_info (sdk_avp_t *avp, uint32_t *vendid, uint32_t
*attrid, uint32_t *attrlen, void ** attrval, u_char *tag)
Usage
Obtains information from an A-V pair.
Input
avp A pointer to an A-V pair.
vendid The address of an unsigned integer variable to store the vendor ID of the
A-V pair. This value is NULL if the vendor ID is not applicable.
attrid The address of an unsigned integer to store the attribute ID of the A-V
pair.
attrlen The address of an unsigned integer to store the length of the A-V pair
attribute.
attrval The address of a pointer intended to point to the attribute value.
tag The address of an unsigned character variable to store the tag for the tagged
attribute. This value is NULL if the tag is not applicable.
Output
vendid The input variable that stores the vendor ID of the A-V pair.
580 Header Files, Data Structures, and APIs in the HP-UX AAA Server SDK