TP_TupleGroupToCertGroup(3)TP_TupleGroupToCertGroup(3)NAME
TP_TupleGroupToCertGroup, CSSM_TP_TupleGroupToCertGroup - Create a set
of certificate templates (CDSA)
SYNOPSIS
# 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_Tuple‐
GroupToCertGroup (CSSM_TP_HANDLE TPHandle, CSSM_CL_HANDLE CLHandle,
const CSSM_TUPLEGROUP *TupleGroup, CSSM_CERTGROUP_PTR *CertTemplates)
LIBRARY
Common Security Services Manager library (libcssm.so)
DESCRIPTION
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 authoriza‐
tions 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
The handle that describes the trust policy service module used to per‐
form 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
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_TP_INVALID_CL_HANDLE CSSMERR_TP_INVALID_TUPLE‐
GROUP_POINTER CSSMERR_TP_INVALID_TUPLEGROUP CSSMERR_TP_INVALID_TUPLE
SEE ALSO
Books
Intel CDSA Application Developer's Guide (see CDSA_intro(3))
Reference Pages
For the CSSM API: CSSM_TP_CertGroupToTupleGroup(3), CSSM_AC_AuthCom‐
pute(3)
For the TP SPI: TP_CertGroupToTupleGroup(3), AC_AuthCompute(3)TP_TupleGroupToCertGroup(3)