Provided by: manpages-de-dev_4.27.0-1_all bug

BEZEICHNUNG

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

BIBLIOTHEK

       Standard-C-Bibliothek (libc, -lc)

Ü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 Nullzeiger 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.

RÜCKGABEWERT

       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.

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-Unsicher race:netent race:netentbuf env locale  │
       ├──────────────────────────┼───────────────────────┼────────────────────────────────────────────────────┤
       │ getnetbyname()           │ Multithread-Fähigkeit │ MT-Unsicher race:netbyname env locale              │
       ├──────────────────────────┼───────────────────────┼────────────────────────────────────────────────────┤
       │ getnetbyaddr()           │ Multithread-Fähigkeit │ MT-Unsicher race:netbyaddr locale                  │
       ├──────────────────────────┼───────────────────────┼────────────────────────────────────────────────────┤
       │ setnetent(), endnetent() │ Multithread-Fähigkeit │ MT-Unsicher 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.

STANDARDS

       POSIX.1-2008.

GESCHICHTE

       POSIX.1-2001, 4.3BSD.

       Vore Glibc 2.2 war das Argument Netz von getnetbyaddr() vom Typ long.

SIEHE AUCH

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

Ü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 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.

Linux man-pages 6.9.1                              2. Mai 2024                                      getnetent(3)