Museum

Home

Lab Overview

Retrotechnology Articles

Online Manuals

⇒ sec_psm_verify_data(3sec) — DCE 3.1

Media Vault

Software Library

Restoration Projects

Artifacts Sought

sec_psm_verify_data(3sec)  —  Subroutines

NAME

sec_psm_verify_data —  Verify signed data. This routine is not available in the DCE binary code.  It is provided in DCE source for use by vendors. 

Synopsis

error_status_t sec_psm_verify_data(
sec_psm_handle_t psm_handle,
sec_pk_domain_t ∗signer_domain_id,
void ∗signer_name,
unsigned32 ∗kvno,
sec_pk_algorithm_id_t ∗signature_alg_id,
sec_pk_usage_flags_t key_usage,
sec_pk_gen_data_t ∗data,
sec_pk_signed_t ∗signature,
error_status_t ∗status);

Parameters

Input

psm_handle
A pointer to an opaque handle to personal security context data. Use sec_psm_open()  to obtain the handle. 

signer_domain_id
A pointer to the application domain of the principal that signed the data.

signer_name
A pointer to the name of the principal that signed the data.

kvnoThe version of the key being used. 

signature_alg_id
The ASN.1 DER-encoded object ID of the signature algorithm, such as MD5WithRSAEncryption. 

key_usageA sec_pk_usage_flags_t that contains the usage flag for the public key. 

dataA pointer to the data to be verified. 

signatureA pointer to the signature to be verified. 

Output

statusA pointer to the completion status.  On successful completion, the routine returns error_status_ok.  Otherwise, it returns an error. 

Description

The sec_psm_sign_data() routine verifies input data, usually the data signature of input data. 

Files

/usr/include/dce/sec_pk_base.idl
The idl file from which dce/sec_pk_base.h was derived. 

Errors

The following describes a partial list of errors that might be returned.  Refer to the OSF DCE Problem Determination Guide for complete descriptions of all error messages. 

error_status_ok

sec_psm_not_init

sec_psm_invalid_handle

sec_psm_unsupported_algorithm_id

sec_pk_e_domain_unsupported

sec_rgy_object_not_found

sec_rgy_not_authorized

sec_attr_unauthorized

Related Information

Functions: sec_psm_sign_data(3sec). 

Typewritten Software • bear@typewritten.org • Edmonds, WA 98026