CSSM_GenerateAlgorithmParams man page on DigitalUNIX

Man page or keyword search:  
man Server   12896 pages
apropos Keyword Search (all sections)
Output format
DigitalUNIX logo
[printable version]

GenerateAlgorithmParams(3)			    GenerateAlgorithmParams(3)

NAME
       GenerateAlgorithmParams,	 CSSM_GenerateAlgorithmParams, CSP_GenerateAl‐
       gorithmParams - Generate algorithm parameters (CDSA)

SYNOPSIS
       # include <cdsa/cssm.h>

       API: CSSM_RETURN CSSMAPI	 CSSM_GenerateAlgorithmParams  (CSSM_CC_HANDLE
       CCHandle, uint32 ParamBits, CSSM_DATA_PTR Param) SPI: CSSM_RETURN CSSM‐
       CSPI    CSP_GenerateAlgorithmParams     (CSSM_CSP_HANDLE	    CSPHandle,
       CSSM_CC_HANDLE CCHandle, const CSSM_CONTEXT *Context, uint32 ParamBits,
       CSSM_DATA_PTR  Param,  uint32   *NumberOfUpdatedAttributes,   CSSM_CON‐
       TEXT_ATTRIBUTE_PTR *UpdatedAttributes)

LIBRARY
       Common Security Services Manager library (libcssm.so)

API PARAMETERS
       The  handle  that describes the context of this cryptographic operation
       used to link to the CSP-managed information.  Used to generate  parame‐
       ters  for  the  algorithm  (for example, Diffie-Hellman).  Pointer to a
       CSSM_DATA structure used to provide information to the parameter gener‐
       ation  process, or to receive information resulting from the generation
       process that is not required as a  parameter  to	 the  algorithm.   For
       instance, phase 2 of the KEA algorithm requires a private random value,
       rA, and a public version, Ra, to be generated. The private  value,  rA,
       is  added  to  the context and the public value, Ra, is returned to the
       caller. In some cases, when both input and output is required,  a  data
       structure  is  passed  to the algorithm. In this situation, Param->Data
       references the structure and Param->Length is set to the length of  the
       structure.

SPI PARAMETERS
       The  handle  that  describes  the add-in cryptographic service provider
       module used to perform up calls to CSSM for the memory  functions  man‐
       aged  by	 CSSM.	 Pointer  to CSSM_CONTEXT structure that describes the
       attributes with this context. Modifying this structure has no effect on
       the internal structure maintained by the CSSM. It is only a copy of the
       actual data. Changes to the context attributes must be  returned	 using
       the  UpdatedAttributes  return  parameter.   The	 number	 of  CSSM_CON‐
       TEXT_ATTRIBUTE structures contained in the UpdatedAttributes array.  If
       this  value is zero, UpdatedAttributes should be set to NULL.  An array
       of attributes that will be added to  the	 context  should  be  returned
       using  this  parameter.	Memory	for the attribute structures should be
       allocated using the CSSM_UPCALLS	 callbacks  provided  to  the  service
       provider module when CSSM_SPI_ModuleAttach() is called.

DESCRIPTION
       This function generates algorithm parameters for the specified context.
       These parameters include Diffie-Hellman key  agreement  parameters  and
       DSA  key	 generation parameters. In most cases the algorithm parameters
       will be added directly to the cryptographic context  (by	 returning  an
       array  of  CSSM_CONTEXT_ATTRIBUTE  structures),	but  an	 algorithm may
       return some data to the caller via the Param parameter.	The  generated
       parameters   are	  added	 to  the  context  as  an  attribute  of  type
       CSSM_ATTRIBUTE_ALG_PARAMS.  Other attributes returned are added to  the
       context, or replace existing values in the context.

NOTES FOR API
       The output is returned to the caller either by filling the caller-spec‐
       ified buffer or by using the application's declared  memory  allocation
       functions  to  allocate	buffer space. To specify a specific, pre-allo‐
       cated output buffer, the caller must provide an array of	 one  or  more
       CSSM_DATA structures each, containing a Length field value greater than
       zero and a non-NULL data pointer field value. To specify automatic out‐
       put  buffer  allocation by the CSP, the caller must provide an array of
       one or more CSSM_DATA structures, each containing a Length field	 value
       equal  to  zero and a NULL data pointer field value. The application is
       always responsible for deallocating the memory when  it	is  no	longer
       needed.

NOTES FOR SPI
       The  output is returned to the caller as specified in Buffer Management
       for Cryptographic Services.

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).

       None specific to this call.

SEE ALSO
       Books

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

       Reference Pages

						    GenerateAlgorithmParams(3)
[top]

List of man pages available for DigitalUNIX

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net