sasl_setprop - Cyrus SASL documentation

NAME  SYNOPSIS  DESCRIPTION  RETURN VALUE  SEE ALSO  AUTHOR  COPYRIGHT 

---

NAME

sasl_setprop − Cyrus SASL documentation

SYNOPSIS

#include <sasl/sasl.h>

int sasl_setprop(sasl_conn_t *conn,
int propnum,
const void * pvalue)

DESCRIPTION

int sasl_setprop(sasl_conn_t *conn,
int propnum,
const void * pvalue)

sasl_setprop sets the value of a SASL property. For example an application should tell the SASL library about any external negotiated security layer (i.e. TLS).
Parameters

	•		conn â is the SASL connection context
	•		propnum â is the identifier for the property requested
	•		pvalue â

contains a pointer to the data. It is the applications job to make sure this type is correct. This is an easy way to crash a program.

	•		SASL_AUTH_EXTERNAL â external authentication ID (const char *)
	•		SASL_SSF_EXTERNAL â external SSF active ââ (sasl_ssf_t)
	•		SASL_DEFUSERREALM â user realm (const char *)
	•		SASL_SEC_PROPS â sasl_security_properties_t (may be freed after call)
	•

SASL_IPLOCALPORT â string describing the local ip and
port in the form

âa.b.c.d;pâ, or âe:f:g:h:i:j:k:l;portâ

•

SASL_IPREMOTEPORT â string describing the remote ip
and port in the form

âa.b.c.d;pâ, or âe:f:g:h:i:j:k:l;portâ

RETURN VALUE

SASL callback functions should return SASL return codes. See sasl.h for a complete list. SASL_OK indicates success.

Other return codes indicate errors and should be handled.

SEE ALSO

RFC 4422,:saslman:sasl(3), sasl_errors(3)

AUTHOR

The Cyrus Team

COPYRIGHT

1993-2016, The Cyrus Team

---