#include <net.if.h>
struct * if_nameindex if_nameindex(void);
Beschreibung
Die Funktion if_nameindex() erstellt ein Array mit den Interface-Namen und dem dazu gehörenden Interface-Index.
Für jedes vorhandene Interface wird eine Struktur if_nameindex angelegt.
Die Struktur if_nameindex ist in <net.if.h> wie folgt deklariert:
struct if_nameindex {
unsigned int if_index; /*1, 2, .....*/
char * if_name; /* mit Null-Byte abgeschlossener Name*/
};
Returnwert
Als Ergebnis wird ein Array mit Strukturen vom Typ if_nameindex zurückgegeben. Das Ende ist dadurch gekennzeichnet, dass die letzte Struktur if_nameindex die Werte 0 für if_index und NULL für if_name enthält.
Im Fehlerfall wird ein NULL-Zeiger zurückgeliefert und errno entsprechend gesetzt.
Fehleranzeige durch errno
EINVAL
Es sind keine Interface-Informationen verfügbar
Hinweis
Der benötigte Speicher für das Array wird dynamisch angefordert und muss durch die Funktion if_freenameindex() wieder freigegeben werden.