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)

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

NAME

       sasl_authorize_t - the SASL authorization callback

SYNOPSIS

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

       int  sasl_authorize_t(sasl_conn_t  *conn,  const  char *requested_user, unsigned alen, const char* auth_identity, unsigned rlen, const char
       *def_realm, unsigned urlen, struct propctx *propctx);

DESCRIPTION

       sasl_authorize_t() is a typedef function prototype that defines the interface associated with the SASL_CB_PROXY_POLICY callback.

       Use the sasl_authorize_t() interface to check whether the authorized user auth_identity can act as the user  requested_user.  For  example,
       the  user root may want to authenticate with root's credentials but as the user tmartin, with all of tmartin's rights, not root's. A server
       application should be very careful when it determines which users may proxy as other users.

PARAMETERS

       conn	       The SASL connection context.

       requested_user  The identity or username to authorize. requested_user is null-terminated.

       rlen	       The length of requested_user.

       auth_identity   The identity associated with the secret. auth_identity is null-terminated.

       alen	       The length of auth_identity.

       default_realm   The default user realm as passed to sasl_server_new(3SASL).

       ulren	       The length of the default realm

       propctx	       Auxiliary properties

RETURN VALUES

       Like other SASL callback functions, sasl_authorize_t() returns an integer that corresponds to a SASL error code. See <sasl.h>  for  a  com-
       plete list of SASL error codes.

ERRORS

       SASL_OK	       The call to sasl_authorize_t() 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), sasl_server_new(3SASL), attributes(5)

SunOS 5.10							    27 Oct 2003 					   sasl_authorize_t(3SASL)