DragonFly On-Line Manual Pages

SASL_SETPROP(3) 		  Cyrus SASL		       SASL_SETPROP(3)

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

		     o conn a is the SASL connection context

		     o propnum a is the identifier for the property requested

		     o pvalue a

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

		       o SASL_AUTH_EXTERNAL   a   external  authentication  ID
			 (const char *)

		       o SASL_SSF_EXTERNAL   a	  external   SSF   active   aa
			 (sasl_ssf_t)

		       o SASL_DEFUSERREALM a user realm (const char *)

		       o SASL_SEC_PROPS   a    sasl_security_properties_t (may
			 be freed after call)

		       o

			 SASL_IPLOCALPORT ^ string describing the local ip and
			 port in the form
				aa.b.c.d;pa, or ae:f:g:h:i:j:k:l;porta

		       o

			 SASL_IPREMOTEPORT  ^  string describing the remote ip
			 and port in the form
				aa.b.c.d;pa, or ae:f:g:h:i:j:k:l;porta

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

2.1.27			       November 08, 2018	       SASL_SETPROP(3)