getnetent(3) Library Functions Manual getnetent(3) BEZEICHNUNG getnetent, getnetbyname, getnetbyaddr, setnetent, endnetent - liest einen Netzwerkeintrag BIBLIOTHEK Standard-C-Bibliothek (libc, -lc) UBERSICHT #include 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 nachsten Eintrag der Netzwerkdatenbank und gibt eine Struktur netent zuruck, die die Felder der Zeile enthalt. Falls notwendig, wird eine Verbindung zur Datenbank hergestellt. Die Funktion getnetbyname() gibt eine Struktur netent fur den Datenbankeintrag zuruck, der dem Netz name entspricht. Die Funktion getnetbyaddr() gibt eine Struktur netent fur den Datenbankeintrag zuruck, 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() schliesst die Verbindung zur Datenbank. Die Struktur netent ist in 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 fur das Netz. n_addrtype Der Typ der Netznummer; immer AF_INET. n_net Die Netznummer in der Byte-Ordnung des Rechners. RUCKGABEWERT Die Funktionen getnetent(), getnetbyname() und getnetbyaddr() geben einen Zeiger auf eine statisch bereitgestellte Struktur netent zuruck oder einen Nullzeiger, wenn ein Fehler auftritt oder das Ende der Liste erreicht ist. DATEIEN /etc/networks Netzwerkdatenbank ATTRIBUTE Siehe attributes(7) fur eine Erlauterung der in diesem Abschnitt verwandten Ausdrucke. +---------------+-------------------------+----------------------------+ |Schnittstelle | Attribut | Wert | +---------------+-------------------------+----------------------------+ |getnetent() | Multithread-Fahigkeit | MT-Unsicher race:netent | | | | race:netentbuf env locale | +---------------+-------------------------+----------------------------+ |getnetbyname() | Multithread-Fahigkeit | MT-Unsicher race:netbyname | | | | env locale | +---------------+-------------------------+----------------------------+ |getnetbyaddr() | Multithread-Fahigkeit | MT-Unsicher race:netbyaddr | | | | locale | +---------------+-------------------------+----------------------------+ |setnetent(), | Multithread-Fahigkeit | MT-Unsicher race:netent | |endnetent() | | 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 konnten. 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 UBERSETZUNG Die deutsche Ubersetzung dieser Handbuchseite wurde von Martin Eberhard Schauer und Dr. Tobias Quathamer erstellt. Diese Ubersetzung ist Freie Dokumentation; lesen Sie die GNU General Public License Version 3 oder neuer bezuglich der Copyright-Bedingungen. Es wird KEINE HAFTUNG ubernommen. Wenn Sie Fehler in der Ubersetzung dieser Handbuchseite finden, schicken Sie bitte eine E-Mail an die Mailingliste der Ubersetzer . Linux man-pages 6.06 31. Oktober 2023 getnetent(3)