Provided by: manpages-fr-extra_20101103_all bug

NOM

       dh - Echange de cles 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 implementent le protocol d'echange de cles Diffie-
       Hellman. La generation de parametres DH partages est decrite dans
       DH_generate_parameters(3); DH_generate_key(3) decrit comment effectuer
       l'echange des cles.

       La structure DH consiste en plusieurs composants BIGNUM.

        struct
               {
               BIGNUM *p;              // nombre premier (partage)
               BIGNUM *g;              // generateur de Z_p (partage)
               BIGNUM *priv_key;       // valeur DH privee x
               BIGNUM *pub_key;        // valeur DH publique g^x
               // ...
               };
        DH

       Notez que les cles DH peuvent utiliser des implementation DH_METHOD non
       standard, soit directement, soit en utilisant des modules ENGINE. Dans
       certains cas (par exemple un ENGINE fournissant la gestion de cles
       materielle embarquees), ces valeurs BIGNUM ne seront pas utilisees par
       l'implementation ou peuvent etre utilisees pour le stockage de d'autres
       donnees. Pour cette raison, les applications devraient generalement
       eviter d'utiliser les elements de la structure DH directement et
       devraient a la place utiliser les fonctions de l'API pour demander ou
       modifier les cles.

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)

TRADUCTION

       La traduction de cette page de manuel est maintenue par les membres de
       la liste <debian\-l10n\-french AT lists DOT debian DOT org>.  Veuillez
       signaler toute erreur de traduction par un rapport de bogue sur le
       paquet manpages-fr-extra.