BEZEICHNUNG

       getrpcent_r, getrpcbyname_r, getrpcbynumber_r - RPC-Eintrag erhalten (wiedereintrittsfähig)

BIBLIOTHEK

       Standard-C-Bibliothek (libc, -lc)

ÜBERSICHT

       #include <netdb.h>

       int getrpcent_r(struct rpcent *Ergebnispuf, char Puf[.Pufläng],
                       size_t Pufläng, struct rpcent **Ergebnis);
       int getrpcbyname_r(const char *Name,
                       struct rpcent *Ergebnispuf, char Puf[.Pufläng],
                       size_t Pufläng, struct rpcent **Ergebnis);
       int getrpcbynumber_r(int Nummer,
                       struct rpcent *Ergebnispuf, char Puf[.Pufläng],
                       size_t Pufläng, 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 älter:
               _BSD_SOURCE || _SVID_SOURCE

BESCHREIBUNG

       Die  Funktionen  getrpcent_r(),  getrpcbyname_r()  und getrpcbynumber_r() sind die wiedereintrittsfähigen
       Äquivalente von getrpcent(3), getrpcbyname(3) bzw. getrpcbynumber(3). Sie unterscheiden sich in der  Art,
       wie  die  Struktur  rpcent  zurückgeliefert  wird und in der Funktionsaufrufsignatur und im Rückgabewert.
       Diese Handbuchseite beschreibt nur die Unterschiede zu den nicht wiedereintrittsfähigen Funktionen.

       Anstatt  den  Zeiger  auf  eine  statisch  reservierte  Struktur   rpcent   als   das   Funktionsergebnis
       zurückzuliefern, kopieren diese Funktionen die Struktur an den Ort, auf den Ergebnispuf zeigt.

       Das  Feld  Puf wird zum Speichern der Zeichenkettenfelder verwandt, auf die die zurückgelieferte Struktur
       rpcent zeigt. (Die nicht wiedereintrittsfähigen Funktionen reservieren diese Zeichenketten im  statischen
       Speicher.) Die Größe dieses Feldes wird in Pufläng festgelegt. Falls Puf zu klein ist, schlägt der Aufruf
       mit  dem  Fehler  ERANGE fehl und der Aufrufende muss es erneut mit einem größeren Puffer versuchen. (Für
       die meisten Anwendungen sollte eine Pufferlänge 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.

RÜCKGABEWERT

       Bei  Erfolg geben diese Funktionen Null zurück. Bei einem Fehler wird eine in FEHLER aufgeführte positive
       Zahl zurückgegeben.

       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 Datensätze in der Datenbank.

       ERANGE Puf ist zu klein. Versuchen Sie es mit einem größeren Puffer erneut (und vergrößern Sie Puflän).

ATTRIBUTE

       Siehe attributes(7) für eine Erläuterung der in diesem Abschnitt verwandten Ausdrücke.
       ┌────────────────────────────────────────────────────────────┬───────────────────────┬──────────────────┐
       │ Schnittstelle                                              │ Attribut              │ Wert             │
       ├────────────────────────────────────────────────────────────┼───────────────────────┼──────────────────┤
       │ getrpcent_r(), getrpcbyname_r(), getrpcbynumber_r()        │ Multithread-Fähigkeit │ MT-Sicher locale │
       └────────────────────────────────────────────────────────────┴───────────────────────┴──────────────────┘

VERSIONEN

       Funktionen  mit  ähnlichem  Namen  existieren auf einigen anderen Systemen, allerdings typischerweise mit
       anderen Aufrufsignaturen.

STANDARDS

       GNU.

SIEHE AUCH

       getrpcent(3), rpc(5)

ÜBERSETZUNG

       Die deutsche Übersetzung dieser Handbuchseite wurde von Helge Kreutzmann <debian@helgefjell.de> 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                                    getrpcent_r(3)