HP-UX AAA Server A.08.02 Administrator's Guide

D Header Files, Data Structures, and APIs in the HP-UX AAA
Server SDK
This appendix discusses the header files, data structures, and APIs that the HP-UX AAA Server SDK
includes. This chapter addresses the following topics:
• “Header Files and Data Structures in the SDK.”
• “APIs in the HP-UX AAA Server SDK” (page 429)
Header Files and Data Structures in the SDK
This section lists the header files and the predefined data structures that the SDK includes.
The HP-UX AAA Server SDK includes the sdk.h header file. This file contains definitions of all the
data structures and APIs that are included in the SDK.
You must use the aatv_info_v2_t data structure to register the AATV with the HP-UX AAA
Server. The aatv_info_v2_t data structure includes the following fields:
char name[MAX_NAME_LENGTH + 1]; /*AATV Name */
aatvInit_v2_t init; /* AATV init function */
aatvTimer_v2_t timer; /* AATV Timer function */
aatvAction_v2_t act_func; /* AATV action function */
aatvCleanup_v2_t cleanup; /* AATV clean up function */
The following additional data structures are used to represent the HP-UX AAA Server attribute-value
and HP-UX AAA Server request:
• typedef void sdk_avp_t;
• typedef void sdk_authreq_t;
NOTE: These data structures are documented here for your reference. Customers are not expected
to modify the data structures. APIs are provided to modify or read the data elements in the data
structure.
APIs in the HP-UX AAA Server SDK
You can use the following API types to create AATVs:
• A-V pair APIs — These APIs can be used to modify, add, delete, or display attribute values.
• Authreq APIs — These APIs provide an interface to modify the HP-UX AAA Server request by
adding or deleting A-V pairs in radius queues, and retrieving information about the request.
• Logging APIs — These APIs are used for logging messages in the log file.
• 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.
Header Files and Data Structures in the SDK 429