X-Git-Url: https://git.openssl.org/?p=openssl.git;a=blobdiff_plain;f=doc%2Fcrypto%2Fdh.pod;h=b1eaa480b7e281c5f2980391ebe92ca34fa3fd3c;hp=c3ccd062078304ad6f237417dae48047bfe0c4f8;hb=0263b992881a03bd98bfd6b76ca54626205e9229;hpb=5bf738737da9c9c09a73686f945c22d5eb2e1a74 diff --git a/doc/crypto/dh.pod b/doc/crypto/dh.pod index c3ccd06207..b1eaa480b7 100644 --- a/doc/crypto/dh.pod +++ b/doc/crypto/dh.pod @@ -12,8 +12,6 @@ dh - Diffie-Hellman key agreement DH * DH_new(void); void DH_free(DH *dh); - int DH_size(const DH *dh); - DH * DH_generate_parameters(int prime_len, int generator, void (*callback)(int, int, void *), void *cb_arg); int DH_check(const DH *dh, int *codes); @@ -27,11 +25,6 @@ dh - Diffie-Hellman key agreement DH *DH_new_method(ENGINE *engine); const DH_METHOD *DH_OpenSSL(void); - int DH_get_ex_new_index(long argl, char *argp, int (*new_func)(), - int (*dup_func)(), void (*free_func)()); - int DH_set_ex_data(DH *d, int idx, char *arg); - char *DH_get_ex_data(DH *d, int idx); - DH * d2i_DHparams(DH **a, unsigned char **pp, long length); int i2d_DHparams(const DH *a, unsigned char **pp); @@ -42,37 +35,27 @@ dh - Diffie-Hellman key agreement These functions implement the Diffie-Hellman key agreement protocol. The generation of shared DH parameters is described in -L; L describes how +L; L describes how to perform a key agreement. -The B structure consists of several BIGNUM components. - - struct - { - BIGNUM *p; // prime number (shared) - BIGNUM *g; // generator of Z_p (shared) - BIGNUM *priv_key; // private DH value x - BIGNUM *pub_key; // public DH value g^x - // ... - }; - DH +The B structure consists of several BIGNUM components. The prime B

, the +generate B, the Private key B and the public key B. +Optionally there may also be an additional parameter B. Note that DH keys may use non-standard B implementations, either directly or by the use of B modules. In some cases (eg. an ENGINE providing support for hardware-embedded keys), these BIGNUM values will not be used by the implementation or may be used for alternative data -storage. For this reason, applications should generally avoid using DH -structure elements directly and instead use API functions to query or -modify keys. +storage. =head1 SEE ALSO -L, L, L, L, -L, L, L, -L, L, -L, -L, -L, L, -L +L, L, L, L, +L, L, L, +L, L, +L, +L, +L, L, L, L, +L =cut