Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

sasl_getsecret_t(3sasl) [opensolaris man page]

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

NAME

       sasl_getsecret_t - the SASL callback function for secrets (passwords)

SYNOPSIS

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

       int sasl_getsecret_t(sasl_conn_t *conn, void *context,
	    int id, sasl_secret_t **psecret);

DESCRIPTION

       Use   the   sasl_getsecret_t()	function   to	retrieve   the	 secret   from	 the  application.  Allocate  a  sasl_secret_t	to  length
       sizeof(sasl_secret_t)+<length of secret>. sasl_secret_t has two fields of len which contain the length of secret in bytes and the data con-
       tained in secret. The secret string does not need to be null-terminated.

PARAMETERS

       conn	  The connection context

       context	  The context from the callback structure

       id	  The callback ID

       psecret	  To  cancel,  set  the  value	of psecret to NULL. Otherwise, set the value to the password structure. The structure must persist
		  until the next call to sasl_getsecret_t() in the same connection. Middleware erases password data when it is done with it.

RETURN VALUES

       Like other SASL callback functions, sasl_getsecret_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_getsecret_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_getsecret_t(3SASL)

Check Out this Related Man Page

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

NAME

       sasl_verifyfile_t - the SASL file verification callback function

SYNOPSIS

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

       typedef enum {
	      SASL_VRFY_PLUGIN,       /* a DLL/shared library plugin */
	      SASL_VRFY_CONF,	      /* a configuration file */
	      SASL_VRFY_PASSWD,       /* a password storage file */
	      SASL_VRFY_OTHER	      /* some other file type */
       } sasl_verify_tyep_t

       int sasl_verifyfile_t(void *context, const char *file,
	    sasl_verifyfile_t type);

DESCRIPTION

       Use  the  sasl_verifyfile_t()  callback	function check whether a given file can be used by the SASL library. Applications use sasl_verify-
       file_t() to check the environment to ensure that plugins or configuration files cannot be written to.

PARAMETERS

       context	  The context from the callback record

       file	  The full path of the file to verify

       type	  The type of the file

RETURN VALUES

       Like other SASL callback functions, sasl_verifyfile_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_verifyfile_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_verifyfile_t(3SASL)
Man Page