getrpcent_r(3) Library Functions Manual getrpcent_r(3) BEZEICHNUNG getrpcent_r, getrpcbyname_r, getrpcbynumber_r - RPC-Eintrag erhalten (wiedereintrittsfahig) BIBLIOTHEK Standard-C-Bibliothek (libc, -lc) UBERSICHT #include int getrpcent_r(struct rpcent *Ergebnispuf, char Puf[.Puflang], size_t Puflang, struct rpcent **Ergebnis); int getrpcbyname_r(const char *Name, struct rpcent *Ergebnispuf, char Puf[.Puflang], size_t Puflang, struct rpcent **Ergebnis); int getrpcbynumber_r(int Nummer, struct rpcent *Ergebnispuf, char Puf[.Puflang], size_t Puflang, struct rpcent **Ergebnis); Mit Glibc erforderliche Feature-Test-Makros (siehe feature_test_macros(7)): getrpcent_r(), getrpcbyname_r(), getrpcbynumber_r(): Seit Glibc 2.19: _DEFAULT_SOURCE Glibc 2.19 und alter: _BSD_SOURCE || _SVID_SOURCE BESCHREIBUNG Die Funktionen getrpcent_r(), getrpcbyname_r() und getrpcbynumber_r() sind die wiedereintrittsfahigen Aquivalente von getrpcent(3), getrpcbyname(3) bzw. getrpcbynumber(3). Sie unterscheiden sich in der Art, wie die Struktur rpcent zuruckgeliefert wird und in der Funktionsaufrufsignatur und im Ruckgabewert. Diese Handbuchseite beschreibt nur die Unterschiede zu den nicht wiedereintrittsfahigen Funktionen. Anstatt den Zeiger auf eine statisch reservierte Struktur rpcent als das Funktionsergebnis zuruckzuliefern, kopieren diese Funktionen die Struktur an den Ort, auf den Ergebnispuf zeigt. Das Feld Puf wird zum Speichern der Zeichenkettenfelder verwandt, auf die die zuruckgelieferte Struktur rpcent zeigt. (Die nicht wiedereintrittsfahigen Funktionen reservieren diese Zeichenketten im statischen Speicher.) Die Grosse dieses Feldes wird in Puflang festgelegt. Falls Puf zu klein ist, schlagt der Aufruf mit dem Fehler ERANGE fehl und der Aufrufende muss es erneut mit einem grosseren Puffer versuchen. (Fur die meisten Anwendungen sollte eine Pufferlange von 1024 byte ausreichend sein.) Falls der Funktionsaufruf erfolgreich einen RPC-Datensatz erhielt, dann wird *Ergebnis so gesetzt, dass es auf Ergebnispuf zeigt; andernfalls wird *Ergebnis auf NULL gesetzt. RUCKGABEWERT Bei Erfolg geben diese Funktionen Null zuruck. Bei einem Fehler wird eine in FEHLER aufgefuhrte positive Zahl zuruckgegeben. Im Fehlerfall, Datensatz nicht gefunden (getrpcbyname_r(), getrpcbynumber_r()) oder Ende der Eingabe (getrpcent_r()), wird Ergebnis auf NULL gesetzt. FEHLER ENOENT (getrpcent_r()) Keine weiteren Datensatze in der Datenbank. ERANGE Puf ist zu klein. Versuchen Sie es mit einem grosseren Puffer erneut (und vergrossern Sie Puflan). ATTRIBUTE Siehe attributes(7) fur eine Erlauterung der in diesem Abschnitt verwandten Ausdrucke. +-------------------------+-------------------------+------------------+ |Schnittstelle | Attribut | Wert | +-------------------------+-------------------------+------------------+ |getrpcent_r(), | Multithread-Fahigkeit | MT-Sicher locale | |getrpcbyname_r(), | | | |getrpcbynumber_r() | | | +-------------------------+-------------------------+------------------+ VERSIONEN Funktionen mit ahnlichem Namen existieren auf einigen anderen Systemen, allerdings typischerweise mit anderen Aufrufsignaturen. STANDARDS GNU. SIEHE AUCH getrpcent(3), rpc(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.8 2. Mai 2024 getrpcent_r(3)