#include <netdb.h>
Kernighan-Ritchie-C:
struct protoent *getprotobyname(name);
char *name;
ANSI-C:
struct protoent* getprotobyname(char* name);
Beschreibung
Die Verwendung der Funktion getprotobyname() ist nur in den Adressfamilien AF_INET und AF_INET6 sinnvoll.
getprotobyname() liefert einen Zeiger auf ein Objekt der nachfolgend beschriebenen Struktur protoent zurück, das die zum Protokollnamen name gehörende Protokollnummer enthält.
Die Struktur protoent ist in <netdb.h> wie folgt deklariert:
struct protoent {
char *p_name; /* offizieller Name des Protokolls*/
char **p_aliases; /* Alias-Liste */
int p_proto; /* Protokollnummer */
};
Beschreibung der protoent-Komponenten:
p_name
Name des Protokolls
p_aliases
Eine durch Null abgeschlossene Liste mit alternativen Namen für das Protokoll. Aliasnamen werden derzeit nicht unterstützt.
p_proto
Nummer des Protokolls. Ergebnisfeld von getprotobyname().
Returnwert
Zeiger auf ein Objekt vom Typ struct protoent. Im Fehlerfall wird der Null-Zeiger zurückgeliefert.
Hinweis
Die Informationen des zurückgelieferten protoent-Objekts befinden sich in einem statischen Bereich, der bei jedem neuen getprotobyname()-Aufruf überschrieben wird. Die Informationen müssen kopiert werden, wenn sie gesichert werden sollen.