Index for Section 3

Alphabetical listing for T

Bottom of page

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_TupleGroupToCertGroup
       (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 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
  TPHandle (input)
	  The handle that describes the trust policy service module used to
	  perform this function.

  CLHandle (input/optional)
	  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.

  TupleGroup (input)
	  A pointer to a group of CSSM_TUPLE describing authorizations for
	  one or more subjects.

  CertTemplates (output)
	  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 represent
  an error condition.

ERRORS
  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
  Books

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

  Reference Pages

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

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

Index for Section 3

Alphabetical listing for T

Top of page