setnetent, Subroutine

Zweck

Öffnet die Datei /etc/networks und legt die Dateimarkierung fest.

Bibliothek

Standard-C-Bibliothek (libc.a)

Syntax

#include <netdb.h> void setnetent (StayOpen) int StayOpen;

Beschreibung

Die Subroutine setnetent 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 setnetent öffnet die Datei /etc/networks und legt die Dateimarkierung am Anfang der Datei fest.

Alle Anwendungen, die die Subroutine setnetent 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.

Parameter

Element	Beschreibung
StayOpen	Enthält einen Wert, der angibt, wann die Datei /etc/networks geschlossen werden soll Wenn Sie den Wert 0 angeben, wird die Datei /etc/networks nach jedem Aufruf der Subroutine getnetent geschlossen. Bei Angabe eines Werts ungleich null bleibt die Datei /etc/networks nach jedem Aufruf geöffnet.

Element

Beschreibung

StayOpen

Enthält einen Wert, der angibt, wann die Datei /etc/networks geschlossen werden soll

Wenn Sie den Wert 0 angeben, wird die Datei /etc/networks nach jedem Aufruf der Subroutine getnetent geschlossen.

Bei Angabe eines Werts ungleich null bleibt die Datei /etc/networks nach jedem Aufruf geöffnet.

Rückgabewerte

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

Dateien

Element	Beschreibung
/etc/networks	Enthält offizielle Netznamen.