SASL_SETPROP(3SASL)SASL_SETPROP(3SASL)NAMEsasl_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 VALUESsasl_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 │
├────────────────────┼─────────────────┤
│Interface Stability │ Evolving │
├────────────────────┼─────────────────┤
│MT-Level │ MT-Safe │
└────────────────────┴─────────────────┘
SEE ALSOsasl_errors(3SASL), attributes(5)
Oct 14, 2003 SASL_SETPROP(3SASL)