opensolaris man page for sasl_verifyfile_t

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)