BIO_push(3) Ajouter et supprimer des BIO d'une chaîne

Other Alias

BIO_pop

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.

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.