sasl_checkapop(3SASL) Simple Authentication Security Layer Library Functions sasl_checkapop(3SASL)
NAME
sasl_checkapop - check an APOP challenge or response
SYNOPSIS
cc [ flag ... ] file ... -lsasl [ library ... ]
#include <sasl/sasl.h>
int sasl_checkapop(sasl_conn_t *conn, const char *challenge, unsigned challen, const char *response, unsigned resplen);
DESCRIPTION
The sasl_checkapop() interface checks an APOP challenge or response. APOP is an option POP3 authentication command that uses a shared
secret password. See RFC 1939.
If sasl_checkapop() is called with a NULL challenge, sasl_checkapop() will check to see if the APOP mechanism is enabled.
PARAMETERS
conn The sasl_conn_t for which the request is being made
challenge The challenge sent to the client
challen The length of challenge
response The client response
resplens The length of response
RETURN VALUES
sasl_checkapop() returns an integer that corresponds to a SASL error code.
ERRORS
SASL_OK Indicates that the authentication is complete
All other error codes indicate an error situation that must be handled, or the authentication session should be quit. See
sasl_errors(3SASL) for information on SASL error codes.
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
+-----------------------------+-----------------------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+-----------------------------+-----------------------------+
|Interface Stability |SUNWlibsasl |
+-----------------------------+-----------------------------+
|Interface Stability |Obsolete |
+-----------------------------+-----------------------------+
|MT-Level |Safe |
+-----------------------------+-----------------------------+
SEE ALSO
sasl_errors(3SASL), attributes(5)
Meyers, J. and Rose, M. RFC 1939, Post Office Protocol - Version 3. Network Working Group. May 1996.
SunOS 5.10 14 Oct 2003 sasl_checkapop(3SASL)