Zahn - Unix-Netzwerkprogramminerung mit Threads, Sockets und SSL

326 6 Netzwerkprogrammierung mit SSL
gelöste Objekt b steht damit wieder als isoliertes BIO zur Verfügung und kann
z. B. freigegeben oder wieder in andere Ketten eingebaut werden.
BIOObj. A BIOObj. B BIOObj. C
BIO_push(A,B)
BIOObj. A BIOObj. B BIOObj. C
Abb. 6.3. BIO-Ketten mit BIO_push() zusammenfügen
Die Namen der beiden Funktionen sind im übrigen recht unglücklich gewählt,
denn die Bezeichnungen Push und Pop suggerieren im Allgemeinen, daß sie
einen Stapel von Objekten verwalten, die dem Stapel einzeln (und immer von
der gleichen Seite) hinzugefügt oder entnommen werden. Das Funktionenpaar
verhält sich jedoch anders: Mit BIO_push() kann gleich eine ganze Menge von
Objekten zusammengeführt werden und BIO_pop() entfernt sogar ein BIO-
Objekt mitten aus einer Kette von Objekten (und nicht nur von deren Ende).
Abbildung 6.4 illustriert, wie ein BIO-Objekt aus der Mitte einer BIO-Kette
entnommen wird.
BIOObj. A BIOObj. B BIOObj. C
BIO_pop(B)
BIOObj. B
BIOObj. A
BIOObj. C
Abb. 6.4. BIO-Ketten mit BIO_pop() zerlegen
Mit BIO_free() und BIO_free_all() werden entweder einzelne BIO-Objekte
oder gleich alle BIO-Objekte einer BIO-Kette wieder freigegeben. Bevor mit
BIO_free() ein einzelnes Objekt einer BIO-Kette freigegeben wird, sollte das
angegebene BIO natürlich tunlichst mit BIO_pop() aus der Kette entfernt werden.
BIO_free() und BIO_free_all() liefern den Rückgabewert 1, falls das
BIO bzw. die gesamte BIO-Kette erfolgreich freigegeben wurde, andernfalls 0.
6.3.3 Ein-/Ausgabe über BIO-Objekte
Zur Ein- und Ausgabe von Daten über BIO-Objekte stehen die vier Funktionen
BIO_read(), BIO_gets(), BIO_write() und BIO_puts() bereit. Die beiden