getpwnam_r(3)                                                 getpwnam_r(3)

NAME
     getpwnamr, getpwuidr - Benutzerdatenbank nach Benutzer-ID oder
     -Namen thread-sicher durchsuchen

SYNTAX
     #include <sys/types.h>
     #include <pwd.h>

     int getpwnamr(const char *nam, struct passwd *pwd, char *buffer,
          sizet bufsize, struct passwd **result);

     int getpwuidr(uidt *nam, struct passwd *pwd, char *buffer,
          sizet bufsize, struct passwd **result);

BESCHREIBUNG
     Die Funktionen getpwnamr() und getpwuidr() aktualisieren die Kenn-
     wortstruktur passwd, auf die pwd zeigt, und speichern einen Zeiger an
     der Adresse, auf die result zeigt.

     Die Struktur enthält einen Eintrag aus der Benutzerdatenbank mit ent-
     sprechendem Namen name oder Benutzer-ID uid. Speicher, auf den die
     Struktur verweist, wird aus dem über den Parameter buffer zur Verfü-
     gung gestellten Speicher zugeordnet, der eine Größe von bufsize Zei-
     chen aufweist.

     Bei einem Fehler, oder wenn der angeforderte Eintrag nicht gefunden
     wird, wird ein NULL-Zeiger an der Adresse zurückgegeben, auf die
     result zeigt.

RÜCKGABEWERTE
     Bei erfolgreicher Ausführung geben die Funktionen getpwnamr() und
     getpwuidr() den Wert Null zurück. Andernfalls wird eine Fehlernummer
     zurückgegeben, um den Fehler anzuzeigen.

FEHLER
     Die Funktionen getpwnamr() und getpwuidr() können bei folgender
     Bedingung fehlschlagen:

     ERANGE    Der über buffer und bufsize zur Verfügung gestellte Speicher
               reicht für die Aufnahme der Daten, auf die die resultierende
               Gruppenstruktur verweist, nicht aus.

SIEHE AUCH
     getpwnam(3C), getpwuid(3C), pwd(5), types(5).











Seite 1                      Reliant UNIX 5.44               Gedruckt 11/98