Zahn - Unix-Netzwerkprogramminerung mit Threads, Sockets und SSL

6.3 OpenSSL-Basisfunktionalität 325
und kodierten Daten dann an einen Kommunikationspartner übertragen werden.
Wird aus einer BIO-Kette gelesen, so kehrt sich die Flußrichtung um, die
Daten wandern also aus der am Ende liegenden Quelle in der umgekehrten
Reihenfolge durch die einzelnen Filterobjekte.
Im folgenden picken wir uns die wichtigsten BIO-Funktionen heraus und besprechen
sie im Rahmen einiger einfacher Beispiele.
6.3.2 Lebenszyklus von BIO-Objekten
Mit Hilfe der Funktion BIO_new() wird ein neues BIO-Objekt ins Leben gerufen.
Die Funktion erwartet als einziges Argument den gewünschten BIO-Typ,
der der Aufgabe des Objekts entspricht. OpenSSL stellt eine Vielzahl von
verschieden Quellen/Senken oder Filtern bereit. Praktische Quellen/Senken
für die Ein-/Ausgabe sind Dateien oder Dateideskriptoren und Sockets, zu
den gängigen Filtern zählen neben Verschlüsselungsalgorithmen und kryptographischen
Hashfunktionen auch Speicherpuffer zur Zwischenspeicherung der
Daten im Hauptspeicher. Konnte BIO_new() das gewünschte BIO erfolgreich
erstellen, liefert die Funktion als Rückgabewert einen Zeiger auf das neue BIO,
andernfalls zeigt ein Nullzeiger an, daß die Operation fehlgeschlagen ist.
#include
BIO *BIO_new( BIO_METHOD *type );
BIO *BIO_push( BIO *b, BIO *append );
BIO *BIO_pop( BIO *b );
int BIO_free( BIO *b );
void BIO_free_all( BIO *b );
Für alle BIO-Typen stehen spezielle Hilfsfunktionen zur Verfügung, die einen
passenden BIO_METHOD-Zeiger für den Aufruf von BIO_new() liefern. Die Namenskonvention
der Hilfsfunktionen ist BIO_s_*() für Quellen/Senken (Source/Sink)
und BIO_f_*() für Filter, doch dazu später noch mehr.
Über die Funktionen BIO_push() und BIO_pop() lassen sich Ketten von BIO-
Objekten bilden. Die BIO_push()-Funktion hängt das BIO (oder die BIO-
Kette) append an das BIO (oder die BIO-Kette) b an. Die Funktion liefert
den Kopf der Kette, also b zurück. Abbildung 6.3 zeigt den Zusammenschluß
zweier BIO-Ketten zu einer einzigen neuen Kette. Mit der BIO_pop()-Funktion
wird ein einzelnes BIO-Objekt b aus seiner BIO-Kette entfernt. 17 Das heraus-
17 Da ein BIO gleichzeitig nur in einer einzigen BIO-Kette enthalten sein kann, ist
durch die Angabe des BIO-Objekts gleichzeitig die BIO-Kette bekannt, aus der das
Objekt entfernt werden muß.