NAME    [Toc]    [Back]

       CSSM_CSP_Login - Log user in to the CSP (CDSA)

SYNOPSIS    [Toc]    [Back]

       # include <cdsa/cssm.h>

       CSSM_RETURN    CSSMAPI   CSSM_CSP_Login   (CSSM_CSP_HANDLE
       CSPHandle,  const   CSSM_ACCESS_CREDENTIALS   *AccessCred,
       const CSSM_DATA *LoginName, const void *Reserved)

LIBRARY    [Toc]    [Back]

       Common Security Services Manager library (libcssm.so)

PARAMETERS    [Toc]    [Back]

       Handle  of  the CSP to log in to.  A pointer to the set of
       one or more credentials required to log in to the token or
       cryptographic  service provider. The credentials structure
       can contain an immediate value for the credential, such as
       a  passphrase or PIN, or the caller can specify a callback
       function the CSP can use to obtain  one  or  more  credentials.
  A name or ID of the caller. The value is used with
       the provided AccessCred to authenticate and authorize  the
       caller  for login with the CSP. The CSP can require that a
       name value be provided. If a name value is  not  provided,
       the  CSP  can assume a default name under which to perform
       the authentication and authorization check, or  the  login
       request  can fail.  This field is reserved for future use.
       The value NULL should always be given. (May  be  used  for
       multiple user support in the future.)

DESCRIPTION    [Toc]    [Back]

       Logs  the  user in to the CSP, allowing for multiple login
       types.

RETURN VALUE    [Toc]    [Back]

       A CSSM_RETURN value indicating  success  or  specifying  a
       particular  error  condition.  The value CSSM_OK indicates
       success. All other values represent an error condition.

ERRORS    [Toc]    [Back]

       Errors are described in the CDSA technical standard.   See
       CDSA_intro(3).      CSSMERR_CSP_INVALID_LOGIN_NAME    CSSMERR_CSP_ALREADY_LOGGED_IN

SEE ALSO    [Toc]    [Back]

       Books

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

       Reference Pages    [Toc]    [Back]

       Functions:  CSSM_CSP_GetLoginAcl(3),  CSSM_CSP_ChangeLoginAcl(3), CSSM_CSP_Logout(3)



                                                CSSM_CSP_Login(3)