SASL_CHECKAPOP(3SASL) Simple Authentication Security Layer Library Functions
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
responseRETURN 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(7) 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(7) Meyers, J. and Rose, M.
RFC 1939, Post Office Protocol - Version 3.
Network Working Group. May 1996.
October 14, 2003 SASL_CHECKAPOP(3SASL)
