pkc_crypto_sign(3sec)

Synopsis

#include <dce/pkc_base.h>

#include <dce/pkc_crypto_reg.h>

pkc_crypto_sign(

gss_OID algorithm,

sec_pk_gen_data_t data,

sec_pk_data_t private_key,

sec_pk_data_t *signature);

Parameters

Input

algorithm
An OID identifying the cryptographic algorithm to be used in signing the data.

data
The data to be signed.

private_key
The private key (i.e., private member of a public-private key pair) to be used to sign the data.

Output

signature
The signature generated by the algorithm on the data passed.

Description

pkc_crypto_sign(3sec) searches the list of registered algorithms for an implementation of the specified algorithm. If found, the implementation is opened, if necessary, and its (sign)( ) function invoked to sign the data. The signature is returned to the caller.

Using this routine, an application can get data signed in one simple call. The alternative is to lookup the desired cryptographic module by calling pkc_crypto_lookup_algorithm(3sec) then explicitly call the module's (sign)( ) routine.

Return Values

pkc_s_success
Operation successfully completed.

Errors

Refer to the OSF DCE Problem Determination Guide for complete descriptions of all error messages.

Related Information

Functions:
pkc_crypto_generate_keypair(3sec)
pkc_crypto_get_registered_algorithms(3sec)
pkc_crypto_lookup_algorithm(3sec)
pkc_crypto_register_signature_alg(3sec)
pkc_crypto_verify_signature(3sec)