Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

sasl_getsimple_t(3sasl) [sunos man page]

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

NAME

       sasl_getsimple_t - the SASL callback function for username, authname and realm

SYNOPSIS

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

       int sasl_getsimple_t(void *context, int id, const char **result, unsigned *len);

DESCRIPTION

       Use  the  sasl_getsimple_t() callback function to retrieve simple data from the application such as the authentication name, the authoriza-
       tion name, and the realm. The id parameter indicates which value is requested.

PARAMETERS

       context	       The context from the callback structure.

       id	       The callback ID. Possible values for id include:

		       SASL_CB_USER	       Client user identity for login.

		       SASL_CB_AUTHNAME        Client authentication name.

		       SASL_CB_LANGUAGE        Comma-separated list of languages pursuant to RFC 1766.

		       SASL_CB_CNONCE	       The client-nonce. This value is used primarily for testing.

       result	       To cancel user, set the value of result with a null-terminated string. If the value of result is NULL,  then  the  user	is
		       cancelled.

       len	       The length of result.

RETURN VALUES

       Like  other  SASL  callback functions, sasl_getsimple_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_getsimple_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), attributes(5)

       Alvestrand, H. RFC 1766, Tags for the Identification of Languages. Network Working Group. November 1995.

SunOS 5.10							    27 Oct 2003 					   sasl_getsimple_t(3SASL)

Check Out this Related Man Page

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

NAME

       sasl_getrealm_t - the realm acquisition callback function

SYNOPSIS

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

       int sasl_getrealm_t(void *context, int id, const char **availrealms,
	    const char **result);

DESCRIPTION

       Use the sasl_getrealm_t() functionwhen there is an interaction with SASL_CB_GETREALM as the type.

       If a mechanism would use this callback, but it is not present, then the first realm listed is automatically selected. A mechanism can still
       force the existence of a getrealm callback by SASL_CB_GETREALM to its required_prompts list.

PARAMETERS

       context	      The context from the callback record

       id	      The callback ID (SASL_CB_GETREALM)

       availrealms    A string list of the vailable realms. availrealms is a null-terminated sting that can be empty.

       result	      The chosen realm. result is a null-terminated string.

RETURN VALUES

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

ERRORS

       SASL_OK	  The call to sasl_getrealm_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), attributes(5)

SunOS 5.11							    27 Oct 2003 					    sasl_getrealm_t(3SASL)
Man Page