sasl_setprop(3sasl) [opensolaris man page]

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)

Check Out this Related Man Page

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

NAME

       sasl_decode - decode data received

SYNOPSIS

       cc [ flag ... ] file ... -lsasl	 [ library ... ]
       #include <sasl/sasl.h>

       int sasl_decode(sasl_conn_t *conn, const char *input, unsigned inputlen, const char **output, unsigned *outputlen);

DESCRIPTION

       Use the sasl_decode() interface to decode data received. After authentication, call this function on all data received. The data is decoded
       from encrypted or signed form to plain data. If no security lay is negotiated, the output is identical to the input.

       Do not give sasl_decode() more data than the negotiated maxbufsize. See sasl_getprop(3SASL).

       sasl_decode() can complete successfully although the value of outputlen is zero. If  this  is  the  case,  wait	for  more  data  and  call
       sasl_decode() again.

PARAMETERS

       conn		       The SASL connection context.

       input		       Data received.

       inputlen 	       The length of input

       output		       The decoded data. output must be allocated or freed by the library.

       outputlen	       The length of output.

RETURN VALUES

       sasl_decode() returns an integer that corresponds to a SASL error code.

ERRORS

       SASL_OK	       The call to sasl_decode() 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		     |Safe			   |
       +-----------------------------+-----------------------------+

SEE ALSO

       sasl_errors(3SASL), sasl_getprop(3SASL), attributes(5)

SunOS 5.10							    28 Aug 2003 						sasl_decode(3SASL)

Linux and UNIX Man Pages

sasl_setprop(3sasl) [opensolaris man page]

Check Out this Related Man Page