sasl_setprop(3SASL) Simple Authentication Security Layer Library Functions sasl_setprop(3SASL)
NAME
sasl_setprop - set a SASL property
SYNOPSIS
cc [ flag ... ] file ... -lsasl [ library ... ]
#include <sasl/sasl.h>
int sasl_setprop(sasl_conn_t *conn, int propnum, const void *pvalue);
DESCRIPTION
Use the sasl_setprop() interface to set the value of a SASL property. For example, an application can use sasl_setprop() to tell the SASL
liabrary about any external negotiated security layer like TLS.
sasl_setprop() uses the following flags.
SASL_AUTH_EXTERNAL External authentication ID that is a pointer of type const char
SASL_SSF_EXTERNAL External SSF active of type sasl_ssf_t
SASL_DEFUSERREALM User realm that is a pointer of type const char
SASL_SEC_PROPS sasl_security_properties_t, that can be freed after the call
SASL_IPLOCALPORT A string that describes the local ip and port in the form a.b.c.d:p or [e:f:g:h:i:j:k:l]:port or one of the older
forms, a.b.c.d;p or e:f:g:j:i:j:k:l;port
SASL_IPREMOTEPORT A string that describes the remote ip and port in the form a.b.c.d:p or [e:f:g:h:i:j:k:l]:port or one of the older
forms, a.b.c.d;p or e:f:g:j:i:j:k:l;port
PARAMETERS
conn The SASL connection context
propnum The identifier for the property requested
pvalue Contains a pointer to the data. The application must ensure that the data type is correct, or the application can crash.
RETURN VALUES
sasl_setprop() returns an integer that corresponds to a SASL error code.
ERRORS
SASL_OK The call to sasl_setprop() was successful.
See sasl_errors(3SASL) for information on SASL error codes.
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
+-----------------------------+-----------------------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+-----------------------------+-----------------------------+
|Availability |SUNWlibsasl |
+-----------------------------+-----------------------------+
|Interface Stability |Evolving |
+-----------------------------+-----------------------------+
|MT-Level |MT-Safe |
+-----------------------------+-----------------------------+
SEE ALSO
sasl_errors(3SASL), attributes(5)
SunOS 5.10 14 Oct 2003 sasl_setprop(3SASL)