DL_Authenticate man page on DigitalUNIX

Man page or keyword search:  
man Server   12896 pages
apropos Keyword Search (all sections)
Output format
DigitalUNIX logo
[printable version]

DL_Authenticate(3)					    DL_Authenticate(3)

NAME
       DL_Authenticate,	 CSSM_DL_Authenticate - Provide authentication creden‐
       tials (CDSA)

SYNOPSIS
       # include <cdsa/cssm.h>

       API: CSSM_RETURN CSSMAPI CSSM_DL_Authenticate (CSSM_DL_DB_HANDLE	 DLDB‐
       Handle,	CSSM_DB_ACCESS_TYPE  AccessRequest,  const CSSM_ACCESS_CREDEN‐
       TIALS   *AccessCred)   SPI:   CSSM_RETURN    CSSMDLI    DL_Authenticate
       (CSSM_DL_DB_HANDLE DLDBHandle, CSSM_DB_ACCESS_TYPE AccessRequest, const
       CSSM_ACCESS_CREDENTIALS *AccessCred)

LIBRARY
       Common Security Services Manager library (libcssm.so)

PARAMETERS
       The handle pair that describes the add-in data storage  library	module
       used  to	 perform  this	function and the data store to which access is
       being requested. If the	form  of  authentication  being	 requested  is
       authentication  to the DL module in general, then the data store handle
       must be NULL.  An indicator of the requested access mode for  the  data
       store  or  DL  module  in general.  A pointer to the set of one or more
       credentials being presented for authentication by the caller. The  cre‐
       dentials	 can apply to the DL module in general or to a particular data
       store managed by this service module. The credentials required for cre‐
       ating  new data stores is defined by the DL and recorded in a record in
       the MDS Primary DL relation. The required set of credentials to	access
       a  particular  data  store  is  defined by the DbInfo record containing
       meta-data for the specified data store.

	      The credentials structure can contain multiple types of  creden‐
	      tials,  as required for multi-factor authentication. The creden‐
	      tial data can be an immediate value, such as a passphrase,  PIN,
	      certificate,  or	template  of user-specific data, or the caller
	      can specify a callback function the DL can use to obtain one  or
	      more credentials.

DESCRIPTION
       This  function  allows the caller to provide authentication credentials
       to the DL module at a time other than data  store  creation,  deletion,
       open,  import,  and export. AccessRequest defines the type of access to
       be associated with the caller. If the authentication credential applies
       to access and use of a DL module in general, then the data store handle
       specified in the DLDBHandle must be NULL. When the  authorization  cre‐
       dential	is to apply to a specific data store, the handle for that data
       store must be specified in the DLDBHandle pair.

RETURN VALUE
       A CSSM_RETURN value indicating success or specifying a particular error
       condition. The value CSSM_OK indicates success. All other values repre‐
       sent an error condition.

ERRORS
       Errors  are  described	in   the   CDSA	  technical   standard.	   See
       CDSA_intro(3).		CSSMERR_DL_INVALID_ACCESS_REQUEST	  CSS‐
       MERR_DL_INVALID_DB_HANDLE

SEE ALSO
       Books

       Intel CDSA Application Developer's Guide (see CDSA_intro(3))

       Reference Pages

							    DL_Authenticate(3)
[top]

List of man pages available for DigitalUNIX

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net