Zahn - Unix-Netzwerkprogramminerung mit Threads, Sockets und SSL

6.3 OpenSSL-Basisfunktionalität 343
Im Gegensatz zur ERR_get_error()-Funktion entfernen ERR_peek_error()
und ERR_peek_last_error() allerdings die abgerufenen Fehlerinformationen
nicht aus der Error-Queue, sondern spitzeln lediglich in diese hinein. Die
ERR_peek_error()-Funktion liefert dabei als Ergebnis den ersten, die Schwesterfunktion
ERR_peek_last_error() den letzten und damit jüngsten Fehler
aus der Warteschlange zurück.
Mit der ERR_get_error()-Funktion wird der erste und damit der am längsten
zurückliegende Fehler einer Error-Queue ermittelt und aus der Fehlerwarteschlange
entfernt. Die Funktion und ihre beiden Schwesterfunktionen
ERR_peek_error() und ERR_peek_last_error() liefern einen OpenSSLspezifischen
Fehlercode, der dann weiter analysiert werden kann.
In Ergänzung zu diesen drei Grundfunktionen bietet OpenSSL sechs weitere
Fehlerbehandlungsfunktionen an, die über ihre jeweiligen Parameter erweiterte
Auskünfte über die Fehler erteilen:
#include
unsigned long ERR_get_error_line( const char **file,
int *line );
unsigned long ERR_peek_error_line( const char **file,
int *line );
unsigned long ERR_peek_last_error_line(
const char **file, int *line );
unsigned long ERR_get_error_line_data(
const char **file, int *line, const char **data,
int *flags );
unsigned long ERR_peek_error_line_data(
const char **file, int *line, const char **data,
int *flags );
unsigned long ERR_peek_last_error_line_data(
const char **file, int *line, const char **data,
int *flags );
Die ERR_*_error_line()-Funktionen liefern über den Parameter file und
line Informationen über die Quelldatei und die Zeile, in der der Fehler
aufgetreten ist. Die drei ERR_*_error_line_data()-Funktionen geben
darüber hinaus noch zusätzliche, fehlerspezifische Daten zurück. In welcher
Form die über data referenzierten Daten dann tatsächlich vorliegen, wird
durch den Parameter flags angezeigt. Ist in flags nach einem Aufruf von
ERR_get_error_line_data() etwa das Flag ERR_TXT_STRING gesetzt, so handelt
es sich um eine C-typische, Null-terminierte Zeichenkette, die dann z. B.
mit der printf()-Funktion ausgegeben werden kann: