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

Table 77 Pre-defined Mapping Functions (continued)
DescriptionMapping FunctionMapping Type
Retrieves the session ID from the RADIUS request’s CLASS
attribute-value pair or generates a session ID if the CLASS
attribute-value pair does not exist.
get_sidSource
Initiates the release of the input IP address via DHCP (IPv4
only). Can be used only if session management with DHCP is
enabled in the FSM.
AAAFreeIPTarget
Returns ACK irrespective of the input. Typically used with the
DBR source mapping to force the continuation of mapping
execution even if a previous SQL statement failed.
ACKonAllTarget
Returns ACK if the function’s input data is zero. Else, it returns
NAK. Typically used with the DBR source mapping to return
ACK when DBResultCode or DBMatchRow are zero.
ACKonZeroTarget
Returns RETRIEVE_SUCCESS is the function’s input data is
zero. Else, it returns NAK. Typically used with the DBR source
RetrieveOnZeroTarget
mapping to return RETRIEVE_SUCCESS for user retrieval
actions.
Returns NAK if the function’s input data is zero. Typically used
with the DBR source mapping to return NAK when
DBResultCode or DBMatchRow are zero.
NAKOnZeroTarget
A failure of a mapping function results in the termination of the SQL action.
The following input mapping example for OCI uses the pre-defined mapping function get_sid
as a source to set a session ID.
input
FUNC(get_sid) DBP(sessid, 254, CHAR)
The following output mapping example for OCI uses the pre-defined mapping function AAAFreeIP
as a target to initiate the freeing of the input IP address via DHCP:
output
DBP(ipaddr, 11, INT) FUNC(AAAFreeIP)
Conversion Functions
A conversion function is executed between the source and target mapping and can be used to
convert or modify data.
You can identify a conversion function in the conversion_function variable for each mapping
entry. conversion_function is the name of the function to execute. It can either be a pre-defined
function included in the AAA Server, or a user-defined function. See “Advanced SQL Mapping
Configuration” (page 269) for more information on user-defined conversion functions.
Table 78 lists the pre-defined conversion functions:
Table 78 Pre-defined Conversion Functions
DescriptionConversion Function
Converts the binary IP address to an ASCII string.AAAIPtoString
Converts the binary IPv6 address to an ASCII string as specified in DFC 2373.AAAIPv6toString
Converts the ASCII string to a binary IP address.AAAStringtoIP
Converts the ASCII string to a binary IPv6 address as specified in RFC 2373.AAAStringtoIPv6
Converts a RADIUS IPv6 Prefix attribute type to an ASCII string containing the
prefix/length format as specified by RFC 2373.
AAAIPv6PrefixtoString
Implementing SQL Access 263