Zahn - Unix-Netzwerkprogramminerung mit Threads, Sockets und SSL

4 bio = BIO_new( BIO_s_file() );
5 /* BIO mit der Datei verknüpfen */
6 BIO_set_fp( bio, file, BIO_NOCLOSE );
6.3 OpenSSL-Basisfunktionalität 331
7
8 /* Jetzt kann das BIO-Objekt zum Schreiben genutzt werden */
9 BIO_puts( bio, "Äußerst wichtige Mitteilung!\n" );
10
11 /* Abschließend das BIO-Objekt freigeben */
12 BIO_free( bio );
13 /* Wegen BIO_NOCLOSE die Datei separat schließen */
14 fclose( file );
Die beiden Funktionen BIO_new_file() und BIO_new_fp() bieten hilfreiche
Abkürzungen bei der Erstellung eines neuen BIO-Objekts für Dateien.
BIO_new_fp() faßt dazu die Funktionen BIO_new() und BIO_set_fp() in
einem Aufruf zusammen, BIO_new_file() schließt sogar zusätzlich noch das
Öffnen der Datei mittels fopen() in die Funktion mit ein. Der Parameter mode
entspricht dabei den mode-Attributen, die an die fopen()-Funktion übergeben
werden. Da bei BIO_new_file() die Datei implizit geöffnet wird, ist für
das erstellte BIO konsequenterweise auch das Flag BIO_CLOSE gesetzt, d. h. die
Datei wird beim Aufruf von BIO_free() wieder geschlossen.
1 /* Datei-BIO mit zum Schreiben geöffneter Datei erstellen */
2 bio = BIO_new_file( "output.txt", "w+" );
3
4 /* Ausgabe über das neue BIO-Objekt */
5 BIO_puts( bio, "Äußerst wichtige Mitteilung!\n" );
6
7 /* BIO-Objekt freigeben , Datei wird implizit geschlossen */
8 BIO_free( bio );
Analog zu den BIO-Funktionen für Dateien gibt es rund um BIO_s_fd() einen
Satz von BIO-Funktionen, die auf Basis der elementaren Ein- und Ausgabe mit
Dateideskriptoren arbeiten, auf die wir aber nicht weiter eingehen.
Ein BIO für aktive Clientsockets: BIO_s_connect()
Obwohl sich unter Unix Datei- und Socketdeskriptoren über die selbe API bedienen
lassen, haben sich die OpenSSL-Entwickler aus Portabilitätsgründen
dazu entschieden, für die beiden Deskriptortypen zwei unterschiedliche BIO-
Typen einzuführen. Somit gibt es auch auf anderen, nicht-unixbasierten Betriebssystemen
keine Probleme mit den BIO-Objekten dieses Typs.