sasl_seterror(3sasl) [opensolaris man page]

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

NAME

       sasl_seterror - set the error string

SYNOPSIS

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

       void sasl_seterror(sasl_conn_t *conn, unsigned flags,
	    const char *fmt, ...);

DESCRIPTION

       The  sasl_seterror()  interface sets the error string that will be returned by sasl_errdetail(3SASL). Use syslog(3C) style formatting, that
       is, use printf()--style with %m as the most recent errno error.

       The sasl_seterror() interface is primarily used by server callback functions and internal plug-ins, for example, with the  sasl_authorize_t
       callback.  The  sasl_seterror()	interface  triggers a call to the SASL logging callback, if any, with a level of SASL_LOG_FAIL, unless the
       SASL_NOLOG flag is set.

       Make the message string sensitive to the current language setting. If there is no SASL_CB_LANGUAGE callback, message  strings  must  be	i-
       default. Otherwise, UTF-8 is used. Use of RFC 2482 for mixed-language text is encouraged.

       If the value of conn is NULL, the sasl_seterror() interface fails.

PARAMETERS

       conn	The sasl_conn_t for which the call to sasl_seterror() applies.

       flags	If set to SASL_NOLOG, the call to sasl_seterror() is not logged.

       fmt	A syslog(3C) style format string.

RETURN VALUES

       sasl_seterror() has no return values.

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_errdetail(3SASL), syslog(3C), attributes(5)

       Whistler, K. and Adams, G. RFC 2482, Language Tagging in Unicode Plain Text. Network Working Group. January 1999.

SunOS 5.11							    14 Oct 2003 					      sasl_seterror(3SASL)

Check Out this Related Man Page

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

NAME

       sasl_auxprop_request - request auxialliary properties from SASL

SYNOPSIS

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

       int sasl_auxprop_request(sasl_conn_t *conn, const char **propnames);

DESCRIPTION

       The  sasl_auxprop_request()  interface  requests that the SASL library obtain properties form any auxialiary property plugins that might be
       installed, for example, the user's home directory from an LDAP server. The lookup occurs just after username canonicalization is  complete.
       Therefore, the request should be made before the call to sasl_server_start(3SASL), but after the call to sasl_server_new(3SASL).

PARAMETERS

       conn	    The sasl_conn_t for which the request is being made

       propnames    A  null-terminated	array  of  property  names  to request. This array must persist until a call to sasl_dispose(3SASL) on the
		    sasl_conn_t.

ERRORS

       sasl_auxprop_request() returns SASL_OK upon success. See sasl_errors(3SASL) for a discussion of other 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_dispose(3SASL), sasl_errors(3SASL), sasl_server_new(3SASL), sasl_server_start(3SASL), attributes(5)

SunOS 5.11							    22 Aug 2003 				       sasl_auxprop_request(3SASL)

Linux and UNIX Man Pages

sasl_seterror(3sasl) [opensolaris man page]

Check Out this Related Man Page