SYNOPSIS

#include <openssl/bio.h>
int BIO_read(BIO *b, void *buf, int len);
int BIO_gets(BIO *b,char *buf, int size);
int BIO_write(BIO *b, const void *buf, int len);
int BIO_puts(BIO *b,const char *buf);

DESCRIPTION

BIO_read() essaye de lire len octets du BIO b et place les données dans buf.

BIO_gets() réalise l'opération « gets » des BIO et place les données dans buf. Normalement, cette opération essayera de lire une ligne de données de taille maximale len du BIO. Il y a cependant des exceptions à cela, par exemple BIO_gets() sur un BIO de signature calculera et renverra la signature mais d'autres BIO pourraient ne pas prendre BIO_gets() en charge du tout.

BIO_write() essaye d'écrire len octets de buf sur le BIO b.

BIO_puts() essaye d'écrire une chaîne buf terminée par null sur le BIO b.

VALEURS DE RETOUR

Toutes ces fonctions renvoient soit la quantité de données lues ou écrites correctement (si la valeur de retour est positive), soit 0 ou -1 si aucune donnée n'a été lue ou écrite, soit -2 si l'opération n'est pas implémentée dans ce type de BIO en particulier.

NOTES

Une valeur de retour de 0 ou -1 n'est pas forcément une indication d'erreur. En particulier quand la source ou la destination sont non bloquantes ou d'un certain type, cela pourrait juste être une indication qu'aucune donnée n'est actuellement disponible et que l'application devrait réessayer l'opération plus tard.

Une technique parfois utilisée avec les sockets bloquantes est d'utiliser un appel système (comme select(), poll() ou équivalent) pour déterminer quand les données sont disponibles et ensuite d'appeler read() pour lire les données. L'équivalent avec les BIO (c'est-à-dire appeler select() sur la structure d'entrées et sorties sous-jacente et ensuite d'appeler BIO_read() pour lire les données) ne devrait pas être utilisé parce qu'un simple appel de BIO_read() peut provoquer plusieurs lectures (et écritures dans le cas des BIO SSL) sur la structure d'entrées et sorties sous-jacente et pourrait par conséquent bloquer. À la place, select() (ou équivalent) devrait être combiné avec des entrées et sorties non bloquantes pour que les lectures successives demandent à réessayer au lieu de bloquer.

Consultez BIO_should_retry(3) pour des précisions sur la façon de déterminer la cause d'un réessai ou tout autre problème d'entrées et sorties.

Si la fonction BIO_gets() n'est pas prise en charge par un BIO, alors contourner cela est possible en ajoutant un BIO tampon BIO_f_buffer(3) à la chaîne.

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.