NOM

       BIO_push, BIO_pop - Ajouter et supprimer des BIO d'une chaîne

SYNOPSIS

        #include <openssl/bio.h>

        BIO *  BIO_push(BIO *b,BIO *append);
        BIO *  BIO_pop(BIO *b);

DESCRIPTION

       La fonction BIO_push() ajoute le BIO append à b, elle renvoie b.

       BIO_pop() supprime le BIO b d'une chaîne et renvoie le BIO suivant de la chaîne ou NULL
       s'il n'y a pas de BIO suivant. Le BIO supprimé devient alors un simple BIO sans
       association avec la chaîne d'origine, il peut donc être libéré ou attaché à une autre
       chaîne.

NOTES

       Les noms de ces fonctions peuvent peut-être prêter un peu à confusion. BIO_push() joint
       deux chaînes de BIO alors que BIO_pop() supprime un seul BIO d'une chaîne, le BIO supprimé
       ne doit pas forcément être à la fin d'une chaîne.

       Le processus d'appeler BIO_push() et BIO_pop() sur un BIO pourrait avoir des conséquences
       supplémentaires (un appel de contrôle est fait sur les BIO affectés), tous les effets
       seront notés dans les descriptions de chaque BIO.

EXEMPLES

       Pour ces exemples, md1 et md2 sont supposés être des BIO de signature, b64 est un BIO en
       base64 et f est un BIO fichier.

       Si l'appel :

        BIO_push(b64, f);

       est fait, alors la nouvelle chaîne sera b64-f. Après avoir fait les appels

        BIO_push(md2, b64);
        BIO_push(md1, md2);

       la nouvelle chaîne est md1-md2-b64-f. Les données écrites vers md1 seront signées par md1
       et md2, encodées en base64 et écrites vers f.

       Remarquez que la lecture force les données à passer en sens inverse, c'est-à-dire que les
       données sont lues de f, décodées de base64 et signées par md1 et md2. Si l'appel :

        BIO_pop(md2);

       L'appel renverra b64 et la nouvelle chaîne sera md1-b64-f, les données peuvent être
       écrites vers md1 comme avant.

VALEURS DE RETOUR

       BIO_push() renvoie la fin de la chaîne, b.

       BIO_pop() renvoie le BIO suivant de la chaîne ou NULL s'il n'y a pas de BIO suivant.

VOIR AUSSI

       À préciser

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.