getnetent, getnetbyname, getnetbyaddr, setnetent, endnetent - liest einen
Netzwerkeintrag
Standard-C-Bibliothek (
libc,
-lc)
#include <netdb.h>
struct netent *getnetent(void);
struct netent *getnetbyname(const char *name);
struct netent *getnetbyaddr(uint32_t Netz, int Typ);
void setnetent(int offenhalten);
void endnetent(void);
Die Funktion
getnetent() liest den nächsten Eintrag der
Netzwerkdatenbank und gibt eine Struktur
netent zurück, die die
Felder der Zeile enthält. Falls notwendig, wird eine Verbindung zur
Datenbank hergestellt.
Die Funktion
getnetbyname() gibt eine Struktur
netent für
den Datenbankeintrag zurück, der dem Netz
name entspricht.
Die Funktion
getnetbyaddr() gibt eine Struktur
netent für
den Datenbankeintrag zurück, der der Netznummer
Netz des Types
Typ entspricht. Das Argument
Netz muss in der Byteordnung des
Rechners angegeben werden.
Die Funktion
setnetent() stellt eine Datenbankverbindung her und setzt
den Dateizeiger auf den ersten Eintrag. Falls
offenhalten nicht Null
ist, wird die Datenbankverbindung zwischen Aufrufen der
getnet*()-Funktionen aufrecht erhalten.
Die Funktion
endnetent() schließt die Verbindung zur Datenbank.
Die Struktur
netent ist in
<netdb.h> wie folgt definiert:
struct netent {
char *n_name; /* offizieller Netzwerkname */
char **n_aliases; /* Alias-Liste */
int n_addrtype; /* Netz-Adresstyp */
uint32_t n_net; /* Netzwerknummer */
}
Die Elemente der Struktur
netent sind:
- n_name
- Der offizielle Name der Netzes.
- n_aliases
- Eine mit Nullbyte abgeschlossene Liste von alternativen
Namen für das Netz.
- n_addrtype
- Der Typ der Netznummer; immer AF_INET.
- n_net
- Die Netznummer in der Byte-Ordnung des Rechners.
Die Funktionen
getnetent(),
getnetbyname() und
getnetbyaddr() geben einen Zeiger auf eine statisch bereitgestellte
Struktur
netent zurück oder einen Nullzeiger, wenn ein Fehler
auftritt oder das Ende der Liste erreicht ist.
- /etc/networks
- Netzwerkdatenbank
Siehe
attributes(7) für eine Erläuterung der in diesem
Abschnitt verwandten Ausdrücke.
| Schnittstelle |
Attribut |
Wert |
|
getnetent() |
Multithread-Fähigkeit |
MT-Unsafe race:netent race:netentbuf env locale |
|
getnetbyname() |
Multithread-Fähigkeit |
MT-Unsafe race:netbyname env locale |
|
getnetbyaddr() |
Multithread-Fähigkeit |
MT-Unsafe race:netbyaddr locale |
|
setnetent(), endnetent() |
Multithread-Fähigkeit |
MT-Unsafe race:netent env locale |
In der obigen Tabelle bedeutet
netent in
race:netent, dass, falls
eine der Funktionen
setnetent(),
getnetent() oder
endnetent() in verschiedenen Threads eines Programms parallel verwandt
werden, konkurrierende Zugriffe auf Daten (»data races«)
auftreten könnten.
POSIX.1-2001, POSIX.1-2008, 4.3BSD.
Vore Glibc 2.2 war das Argument
Netz von
getnetbyaddr() vom Typ
long.
getnetent_r(3),
getprotoent(3),
getservent(3)
RFC 1101
Die deutsche Übersetzung dieser Handbuchseite wurde von Martin Eberhard
Schauer <
[email protected]> und Dr. Tobias Quathamer
<
[email protected]> erstellt.
Diese Übersetzung ist Freie Dokumentation; lesen Sie die
GNU
General Public License Version 3 oder neuer bezüglich der
Copyright-Bedingungen. Es wird KEINE HAFTUNG übernommen.
Wenn Sie Fehler in der Übersetzung dieser Handbuchseite finden, schicken
Sie bitte eine E-Mail an die
Mailingliste
der Übersetzer