Zahn - Unix-Netzwerkprogramminerung mit Threads, Sockets und SSL

170 4 Grundlagen der Socket-Programmierung
6–11
13–24
Mit inet_ntop() wird die in Netzwerkdarstellung übergebene Adresse aus
src in eine lesbare Darstellung konvertiert. Der von NULL verschiedene Zeiger
dst referenziert dabei einen ausreichend großen Puffer, der die resultierende
IP-Adresse in Präsentationsdarstellung aufnehmen kann. Der Parameter
size gibt Auskunft über den zur Verfügung stehenden Platz im Puffer.
Die beiden in definierten Konstanten INET_ADDRSTRLEN und
INET6_ADDRSTRLEN helfen uns dabei, den Puffer ausreichend zu dimensionieren.
War die Konvertierung erfolgreich, liefert inet_ntop() die Adresse des
gefüllten Puffers zurück. Andernfalls gibt die Funktion NULL zurück und errno
gibt über den aufgetretenen Fehler Auskunft.
Im Gegenzug konvertiert inet_pton() eine in src übergebene IP-Adresse aus
der Textdarstellung in die Netzwerkdarstellung. Das Ergebnis wird im durch
dst referenzierten Puffer abgelegt. War die Konvertierung erfolgreich, liefert
inet_pton() den Wert 1 zurück. War die übergebene Zeichenkette nicht in
gültiger gepunkteter Dezimaldarstellung (IPv4, af = AF_INET) oder korrekter
Hexadezimaldarstellung (IPv6, af = AF_INET6), liefert die Funktion den
Wert 0 zurück. Der Rückgabewert -1 zeigt an, daß für den Parameter af ein
ungültiger Wert angegeben wurde, die Fehlervariable errno hat in diesem Fall
den Wert EAFNOSUPPORT.
Die Parameter src bei inet_ntop() bzw. dst bei inet_pton() sind jeweils
vom Typ void *, um sowohl IPv4- als auch IPv6-Adreßstrukturen annehmen
zu können. Für die Adreßfamilie AF_INET erwarten die Funktionen einen
Zeiger auf die Struktur in_addr, die eine IPv4-Adresse beherbergt. Für die
Adreßfamilie AF_INET6 bzw. IPv6-Adressen wird ein Zeiger auf die Struktur
in6_addr übergeben.
Zur Veranschaulichung der Adreßumwandlung verwandeln wir in Beispiel 4.2
die an das Programm übergebenen IP-Adressen in ihre Netzwerkdarstellung
und geben sie in binärer Schreibweise aus. Bei der Darstellung als Binärzahl
kommt uns die Network Byte Order, also die Darstellung im Big-Endian-
Format sehr gelegen. Anschließend kehren wir den Vorgang um und wandeln
die Netzwerkdarstellung wieder in ihre lesbare Form zurück.
Nach der Einbindung der benötigten Header-Dateien erstellen wir zunächst
eine Hilfsfunktion is_ipv4(), mit deren Hilfe wir IPv4-Adressen von IPv6-
Adressen unterscheiden können. Die Funktion geht alle Zeichen der in Textdarstellung
übergebenen IP-Adresse durch und testet, ob die Zeichenkette
ausschließlich aus Zeichen besteht, die in der gepunkteten Dezimaldarstellung
zulässig sind.
Eine zweite Hilfsfunktion erledigt die Ausgabe der IP-Adressen in Binärdarstellung.
Der Funktion print_bitwise() wird als erstes Argument die Adreßfamilie
der auszugebenden IP-Adresse übergeben. Die IP-Adresse selbst wird
als Feld von vorzeichenlosen 8-Bit Werten erwartet. Dies funktioniert sowohl
für IPv4-Adressen (vier 8-Bit Werte) als auch für IPv6-Adressen (sechzehn
8-Bit Werte).