NAME
OBJ_add_sigid,
OBJ_sigid_free,
OBJ_find_sigid_algs,
OBJ_find_sigid_by_algs —
signature algorithm mappings
SYNOPSIS
#include
<openssl/objects.h>
int
OBJ_add_sigid(int signature,
int digest, int encryption);
void
OBJ_sigid_free(void);
int
OBJ_find_sigid_algs(int
signature, int *pdigest, int
*pencryption);
int
OBJ_find_sigid_by_algs(int
*psignature, int digest, int
encryption);
DESCRIPTION
OBJ_add_sigid()
defines the signature algorithm to use the specified
digest and encryption
algorithms. Making sure that this does not conflict with earlier invocations
of OBJ_add_sigid() is the responsibility of the
caller. Definitions made with OBJ_add_sigid() take
precedence over definitions built into the library.
OBJ_sigid_free()
deletes all definitions made with
OBJ_add_sigid().
OBJ_find_sigid_algs()
looks up the signature algorithm. If it is found, the
associated digest algorithm is stored in *pdigest
unless pdigest is a NULL
pointer, and the associated encryption algorithm is stored in
*pencryption unless pencryption
is a NULL pointer.
OBJ_find_sigid_by_algs()
looks up the pair (digest,
encryption). If it is found, the associated signature
algorithm is stored in *psignature unless
psignature is a NULL
pointer.
RETURN VALUES
OBJ_add_sigid() returns 1 on success or 0
if memory allocation fails.
OBJ_find_sigid_algs() returns 1 if a
definition of the signature algorithm is found or 0 if
a definition of the signature algorithm is neither
built into the library nor provided with
OBJ_add_sigid().
OBJ_find_sigid_by_algs() returns 1 if a
signature algorithm using the specified digest and
encryption algorithms is defined or 0 if the
definition of such an algorithm is neither built into the library nor
provided with OBJ_add_sigid().
SEE ALSO
EVP_cleanup(3), OBJ_create(3), OBJ_NAME_add(3), OBJ_nid2obj(3)
HISTORY
These functions first appeared in OpenSSL 1.0.0 and have been available since OpenBSD 4.9.