NAME    [Toc]    [Back]

       TP_TupleGroupToCertGroup,  CSSM_TP_TupleGroupToCertGroup -
       Create a set of certificate templates (CDSA)

SYNOPSIS    [Toc]    [Back]

       # include <cdsa/cssm.h>

       API:  CSSM_RETURN  CSSMAPI   CSSM_TP_TupleGroupToCertGroup
       (CSSM_TP_HANDLE  TPHandle, CSSM_CL_HANDLE  CLHandle, const
       CSSM_TUPLEGROUP *TupleGroup, CSSM_CERTGROUP_PTR  *CertTemplates)
  SPI: CSSM_RETURN CSSMTPI TP_TupleGroupToCertGroup
       (CSSM_TP_HANDLE TPHandle, CSSM_CL_HANDLE  CLHandle,  const
       CSSM_TUPLEGROUP  *TupleGroup, CSSM_CERTGROUP_PTR *CertTemplates)

LIBRARY    [Toc]    [Back]

       Common Security Services Manager library (libcssm.so)

DESCRIPTION    [Toc]    [Back]

       This function creates a set of certificate templates based
       on  a  set  of  input tuples. The tuples describe a set of
       authorizations for one or more subjects. The trust  policy
       service  provider maps these authorizations to appropriate
       template values for one or more certificates of  the  type
       managed by the Trust Policy module. The resulting certificate
 templates can be  input  to  a  certificate  creation
       function,  such  as  CSSM_CL_CertSign(),  (CSSM  API),  or
       CL_CertSign(), (TP SPI). The signed  certificates  created
       by   these   functions  should  carry  the  authorizations
       described in the input tuples.

PARAMETERS    [Toc]    [Back]

       The handle that describes the trust policy service  module
       used  to perform this function.  The handle that describes
       the certificate library module that can be used to  assist
       in the creation of field values. If no certificate library
       module is specified, the TP module uses an assumed CL module,
  if  required.   A  pointer  to a group of CSSM_TUPLE
       describing authorizations for one  or  more  subjects.   A
       pointer  to  a  structure  containing references to one or
       more certificate templates resulting from the  translation
       process.  Storage  for  the structure and certificate templates
 is allocated by the service provider  and  must  be
       deallocated by the application.

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_TP_INVALID_CL_HANDLE      CSSMERR_TP_INVALID_TUPLEGROUP_POINTER
                    CSSMERR_TP_INVALID_TUPLEGROUP
 CSSMERR_TP_INVALID_TUPLE

SEE ALSO    [Toc]    [Back]

       Books

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

       Reference Pages    [Toc]    [Back]

       For   the   CSSM   API:  CSSM_TP_CertGroupToTupleGroup(3),
       CSSM_AC_AuthCompute(3)

       For the TP SPI:  TP_CertGroupToTupleGroup(3),  AC_AuthCompute(3)



                                      TP_TupleGroupToCertGroup(3)