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

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 (https://www.gnu.org/licenses/gpl-3.0.html) 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).