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

NOTE: If the arguments are insufficient for the format, the behavior can
be unexpected.
Return
Returns one of the following values:
0
If the message is logged.
1
If the message is queued.
-1
If the message is not logged or queued.
Asynchronous Event and I/O APIs
The HP-UX AAA Server maintains a global list of file descriptors and calls system
functions, to monitor file descriptors for inbound messages. Programmers writing a
socket based AATV, or any file descriptor-based AATV, can use the APIs discussed in
this section, to register or unregister the socket (or file descriptor) with the HP-UX AAA
Server and schedule an event. This set of APIs can also be used in a scenario where
user profiles are stored in a repository that the HP-UX AAA Server software does not
recognize. You can write your action to communicate with the data store or an
intermediary application through a socket.
int sdk_pollfd_register()
int sdk_pollfd_register (int fd, callback_f callback)
Usage
Registers a file descriptor with the HP-UX AAA Server and supplies a callback function
to the HP-UX AAA Server. The socket descriptor and associated callback function are
added to the global list of file descriptors monitored by the server for inbound messages.
The callback function is called when data is received on the file descriptor.
Input
fd The file descriptor that must be registered.
callback The callback function that is called when data is received by the file
descriptor. The callback function takes the file descriptor as the argument
and returns an event code.
Return
Returns one of the following values:
• SDK_SUCCESS if the operation succeeds.
• SDK_INVALID_ARG if the arguments are invalid.
• SDK_FAILURE if the operation fails.
int sdk_pollfd_unregister()
int sdk_pollfd_unregister (int fd)
Usage
440 Header Files, Data Structures, and APIs in the HP-UX AAA Server SDK