Zahn - Unix-Netzwerkprogramminerung mit Threads, Sockets und SSL

4.4 Namensauflösung 229
Aufruf erfolgreich war, liefert getaddrinfo() in res eine verkettete Liste von
addrinfo-Strukturen mit den Ergebnissen der Umwandlung zurück. Nachdem
diese Ergebnisliste abgearbeitet wurde, muß sie schließlich über einen Aufruf
der Funktion freeaddrinfo() wieder freigegeben werden.
Über den Parameter hints wird beim Funktionsaufruf gesteuert, welche Art
von Informationen getaddrinfo() zurück liefern soll. Für hints wird dazu
entweder ein Null-Zeiger oder ein Zeiger auf eine entsprechend ausgefüllte
addrinfo-Struktur übergeben. Je nachdem, welche Werte dann für die
vier Elemente ai_flags, ai_family, ai_socktype und ai_protocol der
addrinfo-Struktur eingetragen werden, ändert sich das Verhalten der Funktion.
Alle anderen Felder des hints-Parameters müssen beim Aufruf von
getaddrinfo() auf Null gesetzt sein, weshalb man die addrinfo-Struktur
am besten vorab mit Nullbytes initialisiert.
struct addrinfo
{
int ai_flags; /* Input flags */
int ai_family; /* Address family */
int ai_socktype; /* Socket type */
int ai_protocol; /* Protocol of socket */
socklen_t ai_addrlen; /* Socket address length */
struct sockaddr *ai_addr; /* Socket address */
char *ai_canonname; /* Canonical location name */
struct addrinfo *ai_next; /* Pointer to next in list */
}
Hat ai_family den Wert AF_UNSPEC, so liefert getaddrinfo() sowohl IPv4-
als auch IPv6-Adressen zurück. Mit den Werten AF_INET und AF_INET6 wird
die Namensauflösung dagegen auf IPv4- bzw. IPv6-Adressen eingeschränkt.
Über das Strukturelement ai_socktype kann mit Blick auf z. B. einen späteren
Aufruf von connect() der gewünschte Sockettyp festgelegt werden, wobei
der Wert 0 für einen beliebigen Sockettyp steht. Genauso kann über
ai_protocol das gewünschte IP-Protokoll ausgewählt werden. Auch hier
steht der Wert 0 für einen beliebiges IP-Protokoll.
Mit dem Strukturelement ai_flags können schließlich noch weitere Details
der Ergebnisliste gesteuert werden. Der Wert setzt sich durch bitweise
Oder-Verknüpfung der folgenden Konstanten zusammen: AI_PASSIVE,
AI_CANONNAME, AI_NUMERICHOST, AI_NUMERICSERV, AI_V4MAPPED, AI_ALL,
und AI_ADDRCONFIG. Tabelle 4.8 gibt einen Überblick über die nachfolgend
beschrieben Flags für das ai_flags-Element der hints-Struktur.
Ist in ai_flags das Flag AI_PASSIVE gesetzt und hat der Parameter nodename
den Wert NULL, so soll die zurückgelieferte Adreßinformation für ein passives
Öffnen des Sockets, also einen späteren Aufruf der bind()-Funktion passend
sein und die gelieferte IP-Adresse ist auf den Wert INADDR_ANY (für IPv4)