sasl_setprop(3SASL)			      Simple Authentication Security Layer Library Functions			       sasl_setprop(3SASL)

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

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Availability		     |SUNWlibsasl		   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |Evolving			   |
       +-----------------------------+-----------------------------+
       |MT-Level		     |MT-Safe			   |
       +-----------------------------+-----------------------------+

SEE ALSO

       sasl_errors(3SASL), attributes(5)

SunOS 5.11							    14 Oct 2003 					       sasl_setprop(3SASL)