Zahn - Unix-Netzwerkprogramminerung mit Threads, Sockets und SSL

6.3 OpenSSL-Basisfunktionalität 329
also FALSE anzeigt, dann kann man daraus schließen, daß BIO_read() mit
dem Rückgabewert 0 einen geschlossenen Socket angezeigt hat, daß also die
bestehende Netzwerkverbindung von der Gegenstelle terminiert wurde. Liefert
BIO_should_retry() dagegen TRUE, so kann die Leseoperation zu einem
späteren Zeitpunkt wiederholt werden. Dies könnte z. B. dann der Fall sein,
wenn die BIO-Kette bereits Daten von der Gegenseite empfangen hat, aber insgesamt
noch nicht genügend Daten vorliegen, um einen Dechiffriervorgang abzuschließen.
Für diesen Fall würde dann auch das Makro BIO_should_read()
den Wert TRUE liefern und damit darauf hinweisen, daß für den Abschluß der
Operation erst noch weitere Daten gelesen werden müssen. Anders herum gibt
BIO_should_write() Auskunft, ob ein BIO etwa noch weitere Daten benötigt,
um einen Chiffriervorgang abzuschließen.
Die genaue Interpretation der Ergebnisse der Makros BIO_should_read()
und BIO_should_write() hängt immer vom Typ des verursachenden BIO-
Objekts ab. Dies gilt insbesondere für das Makro BIO_should_io_special(),
welches bestimmte Spezialsituationen, also Vorkommnisse, die nicht dierkt mit
dem Schreiben oder Lesen von Daten zu tun haben, anzeigt.
Die gute Nachricht zum Schluß: Sofern auf die Quelle/Senke (eine Datei, ein
Socket, ...) einer BIO-Kette im synchronen, blockierenden Modus zugegriffen
wird, wird das BIO niemals eine Wiederholung der Ein-/Ausgabeoperation
verlangen, da die zugrundeliegenden Operationen dies für blockierende Leseund
Schreiboperationen ebenfalls nicht vorsehen. Die schlechte Nachricht: BIO-
Objekte zur SSL-Kommunikation bilden die Ausnahme zu dieser Regel. Hier
kann es auch bei blockierenden Ein- und Ausgaben zu Wiederholungsanforderungen
kommen, etwa wenn während eines blockierenden BIO_read() ein
SSL-Handshake auftritt. Aber auch hier steht Abhilfe parat, denn zur Vorbeugung
kann für die SSL-Verbindung das Flag SSL_MODE_AUTO_RETRY gesetzt
werden, durch welche auch im Falle der SSL-Kommunikation keine Wiederholungsanforderungen
mehr auftreten.
6.3.4 BIO-Quellen/Senken und BIO-Filter
Wie bereits weiter oben erläutert, wird durch einen Aufruf von BIO_new() ein
neues BIO-Objekt erstellt. Der Typ des BIO-Objekts wird über eine Hilfsfunktion
an die BIO_new()-Funktion übergeben. Im folgenden werfen wir einen Blick
auf die wichtigsten BIO-Typen für Quellen/Senken und Filter und besprechen
die zugehörigen BIO-Objekte für Dateien und Sockets sowie zur Datenpufferung
und zur SSL-Kommunikation. Die Hilfsfunktionen zum Erstellen neuer
Quellen/Senken folgen dabei dem Namensmuster BIO_s_*(), die für Filter
dem Muster BIO_f_*(). Bevor die frisch erzeugten BIO-Objekte tatsächlich
zur Ein-/Ausgabe genutzt werden können, müssen sie allerdings meist noch
geeignet initialisiert werden.
Aus der Vielzahl verschiedener BIO-Objekte (mitsamt der jeweils zugehörigen
Hilfsfunktionen) greifen wir die folgenden wichtigen Vertreter heraus: