summaryrefslogtreecommitdiff
path: root/src/lib/libcrypto/man/dh.3
diff options
context:
space:
mode:
Diffstat (limited to 'src/lib/libcrypto/man/dh.3')
-rw-r--r--src/lib/libcrypto/man/dh.362
1 files changed, 0 insertions, 62 deletions
diff --git a/src/lib/libcrypto/man/dh.3 b/src/lib/libcrypto/man/dh.3
deleted file mode 100644
index 7429a4b6cf..0000000000
--- a/src/lib/libcrypto/man/dh.3
+++ /dev/null
@@ -1,62 +0,0 @@
1.\" $OpenBSD: dh.3,v 1.4 2016/12/10 21:13:25 schwarze Exp $
2.\"
3.Dd $Mdocdate: December 10 2016 $
4.Dt DH 3
5.Os
6.Sh NAME
7.Nm dh
8.Nd Diffie-Hellman key agreement
9.Sh SYNOPSIS
10.In openssl/dh.h
11.Sh DESCRIPTION
12These functions implement the Diffie-Hellman key agreement protocol.
13The generation of shared DH parameters is described in
14.Xr DH_generate_parameters 3 ;
15.Xr DH_generate_key 3
16describes how to perform a key agreement.
17.Pp
18The
19.Vt DH
20structure consists of several
21.Vt BIGNUM
22components.
23.Bd -literal
24typedef struct {
25 BIGNUM *p; // prime number (shared)
26 BIGNUM *g; // generator of Z_p (shared)
27 BIGNUM *priv_key; // private DH value x
28 BIGNUM *pub_key; // public DH value g^x
29 // ...
30} DH;
31.Ed
32.Pp
33Note that DH keys may use non-standard
34.Vt DH_METHOD
35implementations, either directly or by the use of
36.Vt ENGINE
37modules.
38In some cases (e.g. an
39.Vt ENGINE
40providing support for hardware-embedded keys), these
41.Vt BIGNUM
42values will not be used by the implementation or may be used for
43alternative data storage.
44For this reason, applications should generally avoid using
45.Vt DH
46structure elements directly and instead use API functions to query
47or modify keys.
48.Sh SEE ALSO
49.Xr BN_new 3 ,
50.Xr d2i_DHparams 3 ,
51.Xr DH_generate_key 3 ,
52.Xr DH_generate_parameters 3 ,
53.Xr DH_get_ex_new_index 3 ,
54.Xr DH_new 3 ,
55.Xr DH_set_method 3 ,
56.Xr DH_size 3 ,
57.Xr DHparams_print 3 ,
58.Xr dsa 3 ,
59.Xr DSA_dup_DH 3 ,
60.Xr engine 3 ,
61.Xr ERR 3 ,
62.Xr rsa 3