sasl_setpropSimple)Authentication Security Layer Library Fusasl_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 applica‐
tion 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 │
├─────────────────────────────┼─────────────────────────────┤
│Availability │SUNWlibsasl │
├─────────────────────────────┼─────────────────────────────┤
│Interface Stability │Evolving │
├─────────────────────────────┼─────────────────────────────┤
│MT-Level │MT-Safe │
└─────────────────────────────┴─────────────────────────────┘
SEE ALSOsasl_errors(3SASL), attributes(5)SunOS 5.10 14 Oct 2003 sasl_setprop(3SASL)