Scroll to navigation

getrpcent_r(3) Library Functions Manual getrpcent_r(3)

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



  

  
(getrpcent_r()) Keine weiteren Datensätze in der
    Datenbank.

  

  
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.







  

    2. Mai 2024
    Linux man-pages 6.8