*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->Tru64 Unix man pages -> CSSM_GetKeyAcl (3)              



NAME    [Toc]    [Back]

       CSSM_GetKeyAcl - Get ACL entries by key (CDSA)

SYNOPSIS    [Toc]    [Back]

       # include <cdsa/cssm.h>

       CSPHandle, const CSSM_KEY *Key, const CSSM_STRING  *SelectionTag,
 uint32 *NumberOfAclInfos, CSSM_ACL_ENTRY_INFO_PTR

LIBRARY    [Toc]    [Back]

       Common Security Services Manager library (libcssm.so)

PARAMETERS    [Toc]    [Back]

       The module handle that identifies the  cryptographic  service
 provider to perform this operation.  A pointer to the
       target key whose associated ACL entries  are  scanned  and
       returned.   A  CSSM_STRING value matching the user-defined
       tag value associated with one or more ACL entries for  the
       target  Key.  To retrieve a description of all ACL entries
       for the target Key, this parameter must be NULL.  The number
  of  entries  in  the  AclInfos array. If no ACL entry
       descriptions are returned, this value is zero.   An  array
       of  CSSM_ACL_ENTRY_INFO structures. The unique handle contained
 in this structure can be used  during  the  current
       attach session to reference specific ACL entries for editing.
 The structure is allocated by  the  service  provider
       and  must  be released by the caller when the structure is
       no  longer  needed.  If  no  ACL  entry  descriptions  are
       returned, this value is NULL.

DESCRIPTION    [Toc]    [Back]

       This  function  returns  a description of zero or more ACL
       entries managed by the CSP and associated with the  target
       key.   The   optional  input  SelectionTag  restricts  the
       returned descriptions to those ACL entries with a matching
       EntryTag  value.  If a SelectionTag value is specified and
       no matches are found, zero descriptions are  returned.  If
       no  SelectionTag  is  specified,  a description of all ACL
       entries associated with the key is returned by this  function.

       Each AclInfo structure contains: Public contents of an ACL
       entry ACL EntryHandle, which is a unique value defined and
       managed by the service provider

       The public ACL entry information returned by this function
       includes: A CSSM_LIST  structure  containing  one  element
       identifying  the  type of subject stored in the ACL entry.
       A CSSM_BOOL value indicating whether the subject can delegate
  the permissions recorded in the authorization array.
       A CSSM_AUTHORIZATIONGROUP structure defining  the  set  of
       operations for which permission is granted to the subject.
       A CSSM_ACL_VALIDITY_PERIOD structure containing  two  elements,
  the start time and the stop time for which the ACL
       entry is valid.  A CSSM_STRING containing  a  user-defined
       value associated with the ACL entry.

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

       None specific to this call.

SEE ALSO    [Toc]    [Back]


       Intel   CDSA   Application    Developer's    Guide    (see

       Reference Pages    [Toc]    [Back]

       Functions: CSSM_ChangeKeyAcl(3)

[ Back ]
 Similar pages
Name OS Title
CSSM_CSP_GetLoginAcl Tru64 Get description of CSP ACL entries (CDSA)
man IRIX print entries from the on-line reference manuals; find manual entries by keyword
bptojdb Tru64 Converts bootptab entries into permanent, static IP entries for JOIN databases.
list_object HP-UX Lists the specifies object entries (including clearinghouse object entries)
DXmSvnSelectAll Tru64 Selects all entries.
nlist Tru64 gets entries from name list
DXmSvnHighlightAll Tru64 Highlights all entries.
nlist IRIX get entries from name list
getdents Linux get directory entries
getallpppoutmodem IRIX get all PPP outgoing modem entries
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service