Zahn - Unix-Netzwerkprogramminerung mit Threads, Sockets und SSL

6.3 OpenSSL-Basisfunktionalität 345
Adresse eines Speicherbereichs mit len Zeichen Fassungsvermögen. Ab der angegebenen
Speicheradresse wird dann die lesbare, evtl. aber auf len-1 Zeichen
gekürzte Fehlermeldung hinterlegt und mit einem Nullzeichen abgeschlossen.
Um den ERR_error_string*()-Funktionen die Klartext-Fehlermeldungen bekannt
zu machen, müssen vom Programm vorab die Fehlertexte geladen werden.
Dies geschieht mit ERR_load_crypto_strings() für alle Fehlermeldungen
der Funktionen aus der crypto-Bibliothek (dazu zählen u. a. auch die
zuvor besprochenen BIO-Funktionen) und mit SSL_load_error_strings()
für sämtliche Fehlermeldungen der ssl-Bibliothek.
#include
#include
void ERR_load_crypto_strings( void );
void SSL_load_error_strings( void );
Der Fehlertext selbst setzt sich aus dem Fehlercode, dem Namen der Bibliothek
und dem Namen der Funktion, in der der Fehler aufgetreten ist, sowie
einer Kurzbeschreibung der Fehlerursache zusammen und hat die Form
error:[code]:[library]:[function]:[reason].
Last but not least gibt es noch zwei weitere Funktionen, mit deren Hilfe die
Fehler einer Error-Queue direkt über ein BIO oder ein FILE-Handle ausgegeben
werden können: ERR_print_errors() und ERR_print_errors_fp().
#include
void ERR_print_errors( BIO *bp );
void ERR_print_errors_fp( FILE *fp );
Die beiden Hilfsfunktionen erwarten als einzige Information eine Referenz
auf das BIO-Objekt bzw. das FILE-Handle, über das die Ausgabe der Fehlermeldungen
erfolgen soll. Danach iteriert sowohl ERR_print_errors() als
auch ERR_print_errors_fp() über alle in der Error-Queue notierten Fehlermeldungen,
gibt diese aus und leert dabei gleichzeitig die Error-Queue. Das
Funktionenpaar arbeitet damit ähnlich zu der oben beispielhaft vorgestellten
Funktion print_all_errors().
6.3.6 Thread-Support
Die OpenSSL-Bibliotheken wurden von den Entwicklern so ausgelegt, daß sie
auch in nebenläufigen, mit mehreren Threads arbeitenden Programmen eingesetzt
werden können. Allerdings operieren die OpenSSL-Funktionen intern