Zahn - Unix-Netzwerkprogramminerung mit Threads, Sockets und SSL

332 6 Netzwerkprogrammierung mit SSL
Für BIO-Objekte vom Typ Socket-BIO steht also ein weiterer Satz von BIO-
Funktionen zur Verfügung, von denen BIO_s_accept() und BIO_s_connect()
der BIO_new()-Funktion einen Bauplan für einen horchenden Serversocket
bzw. einen aktiven Clientsocket liefern. Nachdem ein neuer Socket-BIO erstellt
wurde, muß dieser noch adäquat initialisiert werden. Sowohl für Clientals
auch für Serversockets kann dem BIO dazu einfach per BIO_set_fd() ein
bereits existierender Socket zugewiesen werden. Neben dem zu bearbeitenden
BIO b erwartet die Funktion dazu den Socketdeskriptor fd sowie eines der
Flags BIO_CLOSE oder BIO_NOCLOSE, die anzeigen daß der Socket (nicht) geschlossen
werden soll, wenn das BIO-Objekt b freigegeben wird. BIO_set_fd()
ist als Makro realisiert und liefert immer den Rückgabewert 1.
#include
BIO_METHOD *BIO_s_connect( void );
long BIO_set_fd( BIO *b, int fd, long flags );
long BIO_set_conn_hostname( BIO *b, char *host_port );
long BIO_set_conn_ip( BIO *b, char *ip );
long BIO_set_conn_port( BIO *b, char *port );
long BIO_set_conn_int_port( BIO *b, char *port );
BIO *BIO_new_connect( char *host_port );
int BIO_do_connect( BIO *b );
Soll sich das BIO dagegen selbst um das Erstellen eines geeigneten Sockets
kümmern, so können dem Objekt mittels BIO_set_conn_hostname() die
gewünschten Zielkoordinaten mit auf den Weg gegeben werden. Die Funktion
erwartet hierfür neben dem BIO b einen Hostnamen (oder eine IP-Adresse)
sowie ggf. den Port des Gegenübers. Der String-Parameter host_port hat dazu
die Form "hostname" oder "hostname:port", wobei Hostname ein DNS-
Name oder eine IP-Adresse sein kann und Port entweder als Servicename oder
als numerischer Wert angegeben werden darf. Alternativ stehen für diese Aufgabe
auch die Funktionen BIO_set_conn_ip(), BIO_set_conn_port() und
BIO_set_conn_int_port() zur Verfügung, mit deren Hilfe Hostname/IP-
Adresse und Port auf verschiedenen Wegen gesetzt werden können. Alle Funktionen
(bzw. eigentlich Makros) liefern immer den Rückgabewert 1.
Die Hilfsfunktion BIO_new_connect() vereint die beiden BIO-Funktionen
BIO_new() und BIO_set_conn_hostname() in einem einzigen Funktionsaufruf
und erwartet dazu in host_port den Hostnamen (oder die IP-Adresse)
sowie den Port des Gegenübers. Als Ergebnis wird bei Erfolg ein neues BIO-
Objekt geliefert oder im Fehlerfall ein Nullzeiger zurückgegeben.
Das neue Connect-BIO baut schließlich durch einen Aufruf der Hilfsfunktion
BIO_do_connect() eine neue Socketverbindung zur zuvor hinterlegten Ziel-