Zahn - Unix-Netzwerkprogramminerung mit Threads, Sockets und SSL

6.3 OpenSSL-Basisfunktionalität 351
88 {
89 st = pthread_mutex_init( &openssl_mutex[i], NULL );
90 if( st != 0 )
91 return( 0 ); /* Rücksprung mit Fehler */
92 }
93 }
94
95 /* Callback zur Bestimmung der Thread -ID registrieren */
96 CRYPTO_set_id_callback( openssl_thread_id );
97
98 /* statischen Mutex -Lock-Callback registrieren */
99 CRYPTO_set_locking_callback( openssl_mutex_lock );
100
101 /* Callbacks für dynamische Mutexe registrieren */
102 CRYPTO_set_dynlock_create_callback( openssl_dl_create );
103 CRYPTO_set_dynlock_destroy_callback( openssl_dl_destroy );
104 CRYPTO_set_dynlock_lock_callback( openssl_dl_lock );
105
106 return( 1 ); /* Erfolgsmeldung zurückgeben */
107 }
33–53
55–62
64–72
64–72
Die Callback-Funktion openssl_dl_create() legt auf Wunsch einen neuen
Mutex für die OpenSSL-Bibliotheken an. openssl_dl_create() fordert dazu
vom System einen Speicherblock in der Größe der zuvor vereinbarten Datenstruktur
CRYPTO_dynlock_value an, initialisiert den in dieser neuen Struktur
enthaltenen Mutex über pthread_mutex_init() und gibt eine Referenz auf
die dynamisch erzeugte Datenstruktur zurück. Sollte das System die Speicheranforderung
nicht erfüllen können oder sollte die Initialisierung des Mutex’
fehlschlagen, so liefert die Funktion stattdessen einen Nullzeiger.
Die Callback-Funktion openssl_dl_destroy() gibt eine zuvor dynamisch
per openssl_dl_create() angelegte CRYPTO_dynlock_value-Struktur wieder
frei. Dazu wird zunächst der zugehörige Mutex zerstört und danach der
vom System bereitgestellte Speicherbereich wieder freigegeben.
Mit Hilfe der Callback-Funktion openssl_dl_lock() sperrt oder entsperrt
OpenSSL schließlich einen zuvor dynamisch angelegten Mutex. Wie bei der
openssl_mutex_lock()-Funktion (siehe oben), zeigt das CRYPTO_LOCK-Flag
des Parameters mode an, wie mit der Datenstruktur verfahren werden soll. Die
Pthreads-Funktionen pthread_mutex_lock() und pthread_mutex_unlock()
greifen zum (Ent-)Sperren der CRYPTO_dynlock_value-Struktur dl auf die
darin eingebettete Mutex-Strukturkomponente mutex zu.
Die openssl_thread_init()-Funktion dient der Initialisierung der Thread-
Unterstützung. Die Funktion erstellt und initialisiert dazu als erstes das
statische Feld der Mutex-Variablen. Sollte dabei etwas schief laufen (nicht
genügend Speicher, Fehler in pthread_mutex_init()), dann kehrt die Funktion
mit dem Rückgabewert 0 zurück. Andernfalls werden zum Schluß die