CSSM_DL_DbOpen man page on Tru64

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

DL_DbOpen(3)							  DL_DbOpen(3)

NAME
       DL_DbOpen, CSSM_DL_DbOpen - Open a data store (CDSA)

SYNOPSIS
       # include <cdsa/cssm.h>

       API: CSSM_RETURN CSSMAPI CSSM_DL_DbOpen (CSSM_DL_HANDLE DLHandle, const
       char *DbName, const CSSM_NET_ADDRESS  *DbLocation,  CSSM_DB_ACCESS_TYPE
       AccessRequest,  const  CSSM_ACCESS_CREDENTIALS  *AccessCred, const void
       *OpenParameters, CSSM_DB_HANDLE	*DbHandle)  SPI:  CSSM_RETURN  CSSMDLI
       DL_DbOpen   (CSSM_DL_HANDLE   DLHandle,	 const	 char  *DbName,	 const
       CSSM_NET_ADDRESS *DbLocation, CSSM_DB_ACCESS_TYPE AccessRequest,	 const
       CSSM_ACCESS_CREDENTIALS	 *AccessCred,	const	void  *OpenParameters,
       CSSM_DB_HANDLE *DbHandle)

LIBRARY
       Common Security Services Manager library (libcssm.so)

PARAMETERS
       The handle that describes the add-in data storage library module to  be
       used  to perform this function.	A pointer to the string containing the
       logical name of the  data  store.   A  pointer  to  a  network  address
       directly	 or indirectly identifying the location of the storage service
       process. If the input is NULL, the module can determine a storage  ser‐
       vice  process  and  its location based on the DbName (for existing data
       stores) or can assume a default storage service	process	 location.  If
       the  DbName  does not distinguish the storage service process, the ser‐
       vice cannot be performed and the operation fails.  An indicator of  the
       requested  access  mode	for the data store, such as read-only or read-
       write.  A pointer to the set of one or more credentials being presented
       for  authentication  by	the  caller. These credentials are required to
       obtain access to the specified data store.  The	credentials  structure
       can contain multiple types of credentials, as required for multi-factor
       authentication. The credential 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. The required set of credentials to access a par‐
       ticular data store is defined by the DbInfo record containing meta-data
       for the specified data store. If credentials are not required to access
       the specified data store, then this field can be NULL.  A pointer to  a
       module-specific set of parameters required to open the data store.  The
       handle  to  the	opened	data  store.  The  value  will	 be   set   to
       CSSM_INVALID_HANDLE if the function fails.

DESCRIPTION
       This  function  opens  the  data	 store with the specified logical name
       under the specified access mode. If user authentication credentials are
       required,  they	must be provided. Also, additional open parameters may
       be required to open a given data store, and are supplied in the OpenPa‐
       rameters.

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_DB_LOCKED  CSSMERR_DL_INVALID_ACCESS_REQUEST
       CSSMERR_DL_INVALID_DB_LOCATION	   CSSMERR_DL_INVALID_DB_NAME	  CSS‐
       MERR_DL_DATASTORE_DOESNOT_EXIST CSSMERR_DL_INVALID_PARSING_MODULE  CSS‐
       MERR_DL_INVALID_OPEN_PARAMETERS

SEE ALSO
       Books

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

       Reference Pages

       Functions for the CSSM API:

       CSSM_DL_DbClose(3)

       Functions for the DL SPI:

       DL_DbClose(3)

								  DL_DbOpen(3)
[top]
                             _         _         _ 
                            | |       | |       | |     
                            | |       | |       | |     
                         __ | | __ __ | | __ __ | | __  
                         \ \| |/ / \ \| |/ / \ \| |/ /  
                          \ \ / /   \ \ / /   \ \ / /   
                           \   /     \   /     \   /    
                            \_/       \_/       \_/ 
More information is available in HTML format for server Tru64

List of man pages available for Tru64

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