Subroutine getservent

Zweck

Ruft einen Servicedateieintrag ab.

Bibliothek

Standard-C-Bibliothek (libc.a)

Syntax

#include <netdb.h>

struct servent *getservent ( )

Beschreibung

Die Subroutine getservent ist threadsicher. Der Rückgabewert verweist jedoch auf statische Daten, die durch nachfolgende Aufrufe überschrieben werden. Diese Daten müssen kopiert werden, damit sie für nachfolgende Aufrufe gespeichert werden können.

Die Subroutine getservent wird geöffnet und liest die nächste Zeile der Datei /etc/services .

Ein Anwendungsprogramm kann die Subroutine getservent verwenden, um Informationen zu Netzservices und den verwendeten Protokollports abzurufen.

Die Subroutine getservent gibt einen Zeiger auf eine servent -Struktur zurück, die Felder für eine Informationszeile aus der Datei /etc/services enthält. Die Struktur servent ist in der Datei netdb.h definiert.

Die Datei /etc/services bleibt nach einem Aufruf der Subroutine getservent geöffnet. Verwenden Sie zum Schließen der Datei /etc/services nach jedem Aufruf die Subroutine setservent . Andernfalls schließen Sie die Datei /etc/services mit der Subroutine endservent .

Alle Anwendungen, die die Subroutine getservent enthalten, müssen mit einem bestimmten Wert für das Makro _BSD kompiliert werden. Zulässige Werte sind 43 und 44. Außerdem müssen alle Socketanwendungen die BSD-Bibliothek libbsd.a enthalten.

Rückgabewerte

Die Subroutine getservent gibt einen Zeiger auf eine servent -Struktur zurück, wenn eine erfolgreiche Übereinstimmung auftritt.

Wenn ein Fehler auftritt oder das Ende der Datei erreicht wird, gibt die Subroutine getservent einen Nullzeiger zurück.

Dateien