Provided by: manpages-de-dev_4.13-4_all bug

BEZEICHNUNG

       getnetent, getnetbyname, getnetbyaddr, setnetent, endnetent - liest einen Netzwerkeintrag

ÜBERSICHT

       #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);

BESCHREIBUNG

       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 NULL beendete 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.

RÜCKGABEWERT

       Die Funktionen getnetent(), getnetbyname() und getnetbyaddr() geben einen Zeiger auf  eine
       statisch  bereitgestellte  Struktur  netent zurück oder einen Null-Zeiger, wenn ein Fehler
       auftritt oder das Ende der Liste erreicht ist.

DATEIEN

       /etc/networks
              Netzwerkdatenbank

ATTRIBUTE

       Siehe attributes(7) für eine Erläuterung der in diesem Abschnitt verwandten Ausdrücke.

       ┌───────────────┬───────────────────────┬───────────────────────────┐
       │SchnittstelleAttributWert                      │
       ├───────────────┼───────────────────────┼───────────────────────────┤
       │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(),   │ Multithread-Fähigkeit │ MT-Unsafe race:netent env │
       │endnetent()    │                       │ 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.

KONFORM ZU

       POSIX.1-2001, POSIX.1-2008, 4.3BSD.

ANMERKUNGEN

       In Glibc-Versionen vor 2.2 war das Argument Netz von getnetbyaddr() vom Typ long.

SIEHE AUCH

       getnetent_r(3), getprotoent(3), getservent(3)
       RFC 1101

KOLOPHON

       Diese  Seite  ist  Teil  der  Veröffentlichung  5.10  des  Projekts  Linux-man-pages. Eine
       Beschreibung des Projekts, Informationen, wie Fehler  gemeldet  werden  können  sowie  die
       aktuelle Version dieser Seite finden sich unter https://www.kernel.org/doc/man-pages/.

ÜBERSETZUNG

       Die   deutsche   Übersetzung  dieser  Handbuchseite  wurde  von  Martin  Eberhard  Schauer
       <Martin.E.Schauer@gmx.de> und Dr. Tobias Quathamer <toddy@debian.org> erstellt.

       Diese Übersetzung ist Freie Dokumentation;  lesen  Sie  die  GNU  General  Public  License
       Version  3 ⟨https://www.gnu.org/licenses/gpl-3.0.html⟩ 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 ⟨debian-l10n-german@lists.debian.org⟩.