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(7) for descriptions of the following attributes:

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Interface Stability	Evolving
MT-Level	MT-Safe