NOM

       BUF_MEM_new, BUF_MEM_free, BUF_MEM_grow, BUF_strdup - Structure de tableaux de caractères simples

SYNOPSIS

        #include <openssl/buffer.h>

        BUF_MEM *BUF_MEM_new(void);

        void   BUF_MEM_free(BUF_MEM *a);

        int    BUF_MEM_grow(BUF_MEM *str, int len);

        char * BUF_strdup(const char *str);

DESCRIPTION

       La bibliothèque de tampon utilise des tableaux de caractères simples. Les tampons sont utilisés à des
       fins diverses dans la bibliothèque, notamment pour les BIO mémoires.

       La bibliothèque utilise la structure BUF_MEM définie dans buffer.h

        typedef struct buf_mem_st
        {
               int length;     /* nombre actuel d'octets */
               char *data;
               int max;        /* taille du tampon */
        } BUF_MEM;

       length est la taille actuelle du tampon en octets, max est la quantité de mémoire allouée au tampon. Il y
       a trois fonctions qui gèrent celles-ci, ainsi qu'une fonction « divers ».

       BUF_MEM_new() alloue un nouveau tampon de taille 0.

       BUF_MEM_free() libère un tampon préexistant. Les données sont mises à 0 avant d'être libérées au cas où
       le tampon contiendrait des données sensibles.

       BUF_MEM_grow() change la taille d'un tampon déjà existant à la taille len. Les données présentes dans le
       tampon sont préservées si celui-ci est agrandi.

       BUF_strdup() copie une chaîne terminée par null dans un bloc de mémoire alloué et renvoie un pointeur
       vers ce bloc. À la différence de la fonction strdup() de la bibliothèque standard de C, cette fonction
       utilise OPENSSL_malloc() et donc devrait être préférée à strdup() car elle peut être utilisée pour
       détecter des fuites de mémoire ou pour remplacer la fonction malloc().

       La mémoire allouée par BUF_strdup() doit être libérée en utilisant la fonction OPENSSL_free().

VALEURS DE RETOUR

       BUF_MEM_new() renvoie le tampon ou NULL en cas d'erreur.

       BUF_MEM_free() n'a pas de valeur de retour.

       BUF_MEM_grow() renvoie la nouvelle taille (c'est-à-dire len), ou 0 en cas d'erreur.

VOIR AUSSI

       bio(3)

HISTORIQUE

       BUF_MEM_new(), BUF_MEM_free() et BUF_MEM_grow() sont disponibles dans toutes les versions de SSLeay et
       d'OpenSSL. BUF_strdup() a été ajouté dans SSLeay 0.8.

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.

1.0.2a 1.0.2c                                      2015-12-31                           fr::crypto::buffer(3SSL)