Provided by: manpages-fr-extra_20080921_all bug

NOM

       SHA1, SHA1_Init, SHA1_Update, SHA1_Final - Algorithme SHA (AX Secure
       Hash Algorithm AX)

SYNOPSIS

        #include <openssl/sha.h>

        unsigned char *SHA1(const unsigned char *d, unsigned long n,
                         unsigned char *md);

        int SHA1_Init(SHA_CTX *c);
        int SHA1_Update(SHA_CTX *c, const void *data,
                         unsigned long len);
        int SHA1_Final(unsigned char *md, SHA_CTX *c);

DESCRIPTION

       SHA-1 (AX Secure Hash Algorithm AX) est une fonction de hachage
       cryptographique avec une sortie de 160 bits.

       SHA1() calcule le condensA~X de message SHA-1 des n octets de d et le
       place dans md (qui doit avoir de la place pour SHA_DIGEST_LENGTH == 20
       octets de sortie). Si md est NULL, le condensA~X est placA~X dans un
       tableau statique.

       Les fonctions suivantes peuvent A~Xtre utiles si le message n’est pas
       stockA~X en entier dans la mA~Xmoire :

       SHA1_Init() initialise une structure SHA_CTX.

       SHA1_Update() peut A~Xtre appelA~Xe de faA~Xon rA~XpA~XtA~Xe avec des
       bouts du message dont il faut calculer le hachA~X (len octets de data).

       SHA1_Final() place le condensA~X du message dans md, qui doit avoir de
       la place pour SHA_DIGEST_LENGTH == 20 octets de donnA~Xes, et efface
       SHA_CTX.

       Les applications devraient utiliser les fonctions de haut niveau
       EVP_DigestInit(3), etc. plutA~Xt que d’appeler les fonctions de hachage
       directement.

       Le prA~XdA~Xcesseur de SHA-1, SHA, est aussi implA~XmentA~X, mais ne
       devrait A~Xtre utilisA~X que si nA~Xcessaire pour des raisons de
       compatibilitA~X.

VALEURS DE RETOUR

       SHA1() renvoie un pointeur vers la valeur du hachA~X.

       SHA1_Init(), SHA1_Update() et SHA1_Final() renvoie 1 en cas de succA~Xs
       et 0 sinon.

CONFORMITA~X A~X

       SHA : US Federal Information Processing Standard FIPS PUB 180 (Secure
       Hash Standard), SHA-1: US Federal Information Processing Standard FIPS
       PUB 180-1 (Secure Hash Standard), ANSI X9.30

VOIR AUSSI

       ripemd(3), hmac(3), EVP_DigestInit(3)

HISTORIQUE

       SHA1(), SHA1_Init(), SHA1_Update() et SHA1_Final() sont disponibles
       dans toutes les versions de SSLeay et OpenSSL.