summaryrefslogtreecommitdiff
path: root/src/lib/libcrypto/doc/EVP_PKEY_cmp.pod
diff options
context:
space:
mode:
authorcvs2svn <admin@example.com>2015-03-08 16:48:48 +0000
committercvs2svn <admin@example.com>2015-03-08 16:48:48 +0000
commitda1a9ad3a4a867ba6569c05e6fca66d7f296c553 (patch)
tree44872802e872bdfd60730fa9cf01d9d5751251c1 /src/lib/libcrypto/doc/EVP_PKEY_cmp.pod
parent973703db67a8e73d70e63afa8f2cde19da09144d (diff)
downloadopenbsd-OPENBSD_5_7_BASE.tar.gz
openbsd-OPENBSD_5_7_BASE.tar.bz2
openbsd-OPENBSD_5_7_BASE.zip
This commit was manufactured by cvs2git to create tag 'OPENBSD_5_7_BASE'.OPENBSD_5_7_BASE
Diffstat (limited to 'src/lib/libcrypto/doc/EVP_PKEY_cmp.pod')
-rw-r--r--src/lib/libcrypto/doc/EVP_PKEY_cmp.pod62
1 files changed, 0 insertions, 62 deletions
diff --git a/src/lib/libcrypto/doc/EVP_PKEY_cmp.pod b/src/lib/libcrypto/doc/EVP_PKEY_cmp.pod
deleted file mode 100644
index c389216086..0000000000
--- a/src/lib/libcrypto/doc/EVP_PKEY_cmp.pod
+++ /dev/null
@@ -1,62 +0,0 @@
1=pod
2
3=head1 NAME
4
5EVP_PKEY_copy_parameters, EVP_PKEY_missing_parameters, EVP_PKEY_cmp_parameters,
6EVP_PKEY_cmp - public key parameter and comparison functions
7
8=head1 SYNOPSIS
9
10 #include <openssl/evp.h>
11
12 int EVP_PKEY_missing_parameters(const EVP_PKEY *pkey);
13 int EVP_PKEY_copy_parameters(EVP_PKEY *to, const EVP_PKEY *from);
14
15 int EVP_PKEY_cmp_parameters(const EVP_PKEY *a, const EVP_PKEY *b);
16 int EVP_PKEY_cmp(const EVP_PKEY *a, const EVP_PKEY *b);
17
18=head1 DESCRIPTION
19
20The function EVP_PKEY_missing_parameters() returns 1 if the public key
21parameters of B<pkey> are missing and 0 if they are present or the algorithm
22doesn't use parameters.
23
24The function EVP_PKEY_copy_parameters() copies the parameters from key
25B<from> to key B<to>.
26
27The funcion EVP_PKEY_cmp_parameters() compares the parameters of keys
28B<a> and B<b>.
29
30The funcion EVP_PKEY_cmp() compares the public key components and paramters
31(if present) of keys B<a> and B<b>.
32
33=head1 NOTES
34
35The main purpose of the functions EVP_PKEY_missing_parameters() and
36EVP_PKEY_copy_parameters() is to handle public keys in certificates where the
37parameters are sometimes omitted from a public key if they are inherited from
38the CA that signed it.
39
40Since OpenSSL private keys contain public key components too the function
41EVP_PKEY_cmp() can also be used to determine if a private key matches
42a public key.
43
44=head1 RETURN VALUES
45
46The function EVP_PKEY_missing_parameters() returns 1 if the public key
47parameters of B<pkey> are missing and 0 if they are present or the algorithm
48doesn't use parameters.
49
50These functions EVP_PKEY_copy_parameters() returns 1 for success and 0 for
51failure.
52
53The function EVP_PKEY_cmp_parameters() and EVP_PKEY_cmp() return 1 if the
54keys match, 0 if they don't match, -1 if the key types are different and
55-2 if the operation is not supported.
56
57=head1 SEE ALSO
58
59L<EVP_PKEY_CTX_new(3)|EVP_PKEY_CTX_new(3)>,
60L<EVP_PKEY_keygen(3)|EVP_PKEY_keygen(3)>
61
62=cut