getnetent_r(3) Library Functions Manual getnetent_r(3) BEZEICHNUNG getnetent_r, getnetbyname_r, getnetbyaddr_r - Netzwerkeintrag erhalten (reentrant) BIBLIOTHEK Standard-C-Bibliothek (libc, -lc) UBERSICHT #include int getnetent_r(size_t Grosse; struct netent *restrict Ergebnispuffer, char Puf[restrict Grosse], size_t Grosse, struct netent **restrict Ergebnis, int *restrict h_Fehlernumz); int getnetbyname_r(size_t Grosse; const char *restrict name, struct netent *restrict Ergebnispuffer, char Puf[restrict Grosse], size_t Grosse, struct netent **restrict Ergebnis, int *restrict h_Fehlernumz); int getnetbyaddr_r(size_t Grosse; uint32_t net, int type, struct netent *restrict Ergebnispuffer, char Puf[restrict Grosse], size_t Grosse, struct netent **restrict Ergebnis, int *restrict h_Fehlernumz); Mit Glibc erforderliche Feature-Test-Makros (siehe feature_test_macros(7)): getnetent_r(), getnetbyname_r(), getnetbyaddr_r(): Seit Glibc 2.19: _DEFAULT_SOURCE Glibc 2.19 und alter: _BSD_SOURCE || _SVID_SOURCE BESCHREIBUNG Die Funktionen getnetent_r(), getnetbyname_r() und getnetbyaddr_r() sind die reentranten Aquivalente von getnetent(3), getnetbyname(3) bzw. getnetbynumber(3). Sie unterscheiden sich in der Art, wie die Struktur netent zuruckgeliefert wird und in der Funktionsaufrufsignatur und dem -Ruckgabewert. Diese Handbuchseite beschreibt nur die Unterschiede zu den nicht reentranten Funktionen. Anstatt einen Zeiger auf eine statisch reservierte Struktur netent als Funktionsergebnis zuruckzuliefern, kopieren diese Funktionen die Struktur an einen Ort, auf den Ergebnispuffer zeigt. Das Feld Puf wird zum Speichern der Zeichenkettenfelder verwandt, auf die die zuruckgelieferte Struktur netent zeigt. (Die nicht reentranten Funktionen reservieren diese Zeichenketten in statischem Speicher.) Die Grosse dieses Feldes wird in Grosse angegeben. Falls Puf zu klein ist, schlagt der Aufruf mit dem Fehler ERANGE fehl und der Aufrufende muss es mit einem grosseren Puffer erneut versuchen. (Ein Puffer der Grosse 1024 byte sollte fur die meisten Anwendungen ausreichend sein.) Falls der Funktionsaufruf erfolgreich einen Netzwerkdatensatz erhalt, dann wird *Ergebnis so gesetzt, dass es auf Ergebnispuffer zeigt; andernfalls wird *Ergebnis auf NULL gesetzt. Der Puffer, auf den h_Fehlernumz zeigt, wird dazu verwandt, den Wert zuruckzuliefern, der in der globalen Variable h_errno durch die nicht reentranten Versionen dieser Funktionen gespeichert wurde. RUCKGABEWERT Bei Erfolg geben diese Funktionen Null zuruck. Bei einem Fehler wird eine in FEHLER aufgefuhrte positive Zahl zuruckgegeben. Im Fehlerfall, >>Datensatz nicht gefunden<< (getnetbyname_r(), getnetbyaddr_r()) oder >>Ende der Eingabe<< (getnetent_r()), wird Ergebnis auf NULL gesetzt. FEHLER ENOENT (getnetent_r()) Keine weiteren Datensatze in der Datenbank. ERANGE Puf ist zu klein. Versuchen Sie es mit einem grosseren Puffer erneut (und vergrossern Sie Grosse). ATTRIBUTE Siehe attributes(7) fur eine Erlauterung der in diesem Abschnitt verwandten Ausdrucke. +-------------------------+-------------------------+------------------+ |Schnittstelle | Attribut | Wert | +-------------------------+-------------------------+------------------+ |getnetent_r(), | Multithread-Fahigkeit | MT-Sicher locale | |getnetbyname_r(), | | | |getnetbyaddr_r() | | | +-------------------------+-------------------------+------------------+ VERSIONEN Funktionen mit ahnlichem Namen existieren auf einigen anderen Systemen, allerdings typischerweise mit anderen Aufrufsignaturen. STANDARDS GNU. SIEHE AUCH getnetent(3), networks(5) UBERSETZUNG Die deutsche Ubersetzung dieser Handbuchseite wurde von Helge Kreutzmann 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.18 28. Juni 2025 getnetent_r(3)