Ubuntu manuals

Provided by: manpages-fr-extra_20080921_all

NOM

       dh - A~Xchange de clA~Xs Diffie-Hellman

SYNOPSIS

        #include <openssl/dh.h>
        #include <openssl/engine.h>

        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);

        int    DH_generate_key(DH *dh);
        int    DH_compute_key(unsigned char *key, BIGNUM *pub_key, DH *dh);

        void DH_set_default_method(const DH_METHOD *meth);
        const DH_METHOD *DH_get_default_method(void);
        int DH_set_method(DH *dh, const DH_METHOD *meth);
        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);

        int    DHparams_print_fp(FILE *fp, const DH *x);
        int    DHparams_print(BIO *bp, const DH *x);

DESCRIPTION

       Ces fonctions implA~Xmentent le protocol d’A~Xchange de clA~Xs Diffie-
       Hellman. La gA~XnA~Xration de paramA~Xtres DH partagA~Xs est dA~Xcrite
       dans DH_generate_parameters(3) ; DH_generate_key(3) dA~Xcrit comment
       effectuer l’A~Xchange des clA~Xs.

       La structure DH consiste en plusieurs composants BIGNUM.

        struct
               {
               BIGNUM *p;              // nombre premier (partagA~X)
               BIGNUM *g;              // gA~XnA~Xrateur de Z_p (partagA~X)
               BIGNUM *priv_key;       // valeur DH privA~Xe x
               BIGNUM *pub_key;        // valeur DH publique g^x
               // ...
               };
        DH

       Notez que les clA~Xs DH peuvent utiliser des implA~Xmentation DH_METHOD
       non standard, soit directement, soit en utilisant des modules ENGINE.
       Dans certains cas (par exemple un ENGINE fournissant la gestion de
       clA~Xs matA~Xrielle embarquA~Xes), ces valeurs BIGNUM ne seront pas
       utilisA~Xes par l’implA~Xmentation ou peuvent A~Xtre utilisA~Xes pour
       le stockage de d’autres donnA~Xes. Pour cette raison, les applications
       devraient gA~XnA~Xralement A~Xviter d’utiliser les A~XlA~Xments de la
       structure DH directement et devraient A~  la place utiliser les
       fonctions de l’API pour demander ou modifier les clA~Xs.

VOIR AUSSI

       dhparam(1), bn(3), dsa(3), err(3), rand(3), rsa(3), engine(3),
       DH_set_method(3), DH_new(3), DH_get_ex_new_index(3),
       DH_generate_parameters(3), DH_compute_key(3), d2i_DHparams(3),
       RSA_print(3)