manpages-de 1.3-1 - en to de translation catalogue (59 entries)

note: type: TH
en: 2019-03-06
de: 6. März 2019

note: type: TH
en: Linux Programmer's Manual
de: Linux-Programmierhandbuch

note: type: SH
en: NAME
de: BEZEICHNUNG

note: type: Plain text
en: getpwnam, getpwnam_r, getpwuid, getpwuid_r - get password file entry
de: getpwnam, getpwnam_r, getpwuid, getpwuid_r - Eintrag in Passwortdatei abfragen

note: type: SH
en: SYNOPSIS
de: ÜBERSICHT

note: type: Plain text
en: B<int getpwnam_r(const char *>I<name>B<, struct passwd *>I<pwd>B<,>
    B<               char *>I<buf>B<, size_t >I<buflen>B<, struct passwd **>I<result>B<);>
de: B<int getpwnam_r(const char *>I<Name>B<, struct passwd *>I<pwd>B<,>
    B<               char *>I<Puffer>B<, size_t >I<Pufferlänge>B<, struct passwd **>I<Ergebnis>B<);>

note: type: Plain text
en: B<int getpwuid_r(uid_t >I<uid>B<, struct passwd *>I<pwd>B<,>
    B<               char *>I<buf>B<, size_t >I<buflen>B<, struct passwd **>I<result>B<);>
de: B<int getpwuid_r(uid_t >I<uid>B<, struct passwd *>I<pwd>B<,>
    B<               char *>I<Puffer>B<, size_t >I<Pufferlänge>B<, struct passwd **>I<Ergebnis>B<);>

note: type: Plain text
en: Feature Test Macro Requirements for glibc (see B<feature_test_macros>(7)):
de: Mit Glibc erforderliche Makros (siehe B<feature_test_macros>(7)):

note: type: Plain text
en: _POSIX_C_SOURCE
        || /* Glibc versions E<lt>= 2.19: */ _BSD_SOURCE || _SVID_SOURCE
de: _POSIX_C_SOURCE
        || /* Glibc-Versionen E<lt>= 2.19: */ _BSD_SOURCE || _SVID_SOURCE

note: type: SH
en: DESCRIPTION
de: BESCHREIBUNG

note: type: Plain text
en: The B<getpwnam>()  function returns a pointer to a structure containing the broken-out fields of the record in the password database (e.g., the local password file I</etc/passwd>, NIS, and LDAP)  that matches the username I<name>.
de: Die Funktion B<getpwnam>() gibt einen Zeiger auf eine Struktur zurück, die aus einem Datensatz herausgelöste Felder aus der Passwort-Datenbank enthält (z.B. die lokale Passwortdatei, NIS und LDAP), die zum Benutzername I<name> passen.

note: type: Plain text
en: The B<getpwuid>()  function returns a pointer to a structure containing the broken-out fields of the record in the password database that matches the user ID I<uid>.
de: Die Funktion B<getpwnam>() gibt einen Zeiger auf eine Struktur zurück, die aus einem Datensatz herausgelöste Felder aus der Passwort-Datenbank enthält, die zur Benutzerkennung I<uid> passen.

note: type: Plain text
en: The I<passwd> structure is defined in I<E<lt>pwd.hE<gt>> as follows:
de: Die Struktur I<passwd> ist in I<E<lt>pwd.hE<gt>> wie folgt definiert:

note: type: Plain text
en: struct passwd {
        char   *pw_name;       /* username */
        char   *pw_passwd;     /* user password */
        uid_t   pw_uid;        /* user ID */
        gid_t   pw_gid;        /* group ID */
        char   *pw_gecos;      /* user information */
        char   *pw_dir;        /* home directory */
        char   *pw_shell;      /* shell program */
    };
de: struct passwd {
        char   *pw_name;       /* Benutzername */
        char   *pw_passwd;     /* Passwort des Benutzers */
        uid_t   pw_uid;        /* Benutzerkennung */
        gid_t   pw_gid;        /* Gruppenkennung */
        char   *pw_gecos;      /* Benutzerinformationen */
        char   *pw_dir;        /* Home-Verzeichnis */
        char   *pw_shell;      /* Anmelde-Shell */
    };

note: type: Plain text
en: See B<passwd>(5)  for more information about these fields.
de: Weitere Informationen über die Felder dieser Struktur finden Sie unter B<passwd>(5).

note: type: Plain text
en: The B<getpwnam_r>()  and B<getpwuid_r>()  functions obtain the same information as B<getpwnam>()  and B<getpwuid>(), but store the retrieved I<passwd> structure in the space pointed to by I<pwd>.  The string fields pointed to by the members of the I<passwd> structure are stored in the buffer I<buf> of size I<buflen>.  A pointer to the result (in case of success) or NULL (in case no entry was found or an error occurred) is stored in I<*result>.
de: Die Funktionen B<getpwnam_r>() und B<getpwuid_r>() erhalten die gleichen Informationen wie B<getpwnam>()  und B<getpwuid>(), speichern aber die empfangene I<passwd>-Struktur an dem Platz, auf den I<pwd> zeigt. Die Zeichenkettenfelder, auf die die Mitglieder der I<passwd>-Struktur zeigen, werden im Puffer I<puffer> der Länge I<pufferlaenge> gespeichert. Ein Zeiger auf das Ergebnis (im Erfolgsfall) oder NULL (im Fall, dass kein Eintrag gefunden wurde oder ein Fehler auftrat) wird in I<*ergebnis> gespeichert.

note: type: Plain text
en: The call
de: Der Aufruf

note: type: Plain text
en: returns either -1, without changing I<errno>, or an initial suggested size for I<buf>.  (If this size is too small, the call fails with B<ERANGE>, in which case the caller can retry with a larger buffer.)
de: liefert entweder -1 ohne Änderung von I<errno> oder die anfänglich vorgeschlagene Größe für I<buf> zurück. (Falls diese Größe zu klein ist, schlägt der Aufruf mit B<ERANGE> fehl. In diesem Fall kann der Aufrufende es mit einem größeren Puffer erneut versuchen.)

note: type: SH
en: RETURN VALUE
de: RÜCKGABEWERT

note: type: Plain text
en: The B<getpwnam>()  and B<getpwuid>()  functions return a pointer to a I<passwd> structure, or NULL if the matching entry is not found or an error occurs.  If an error occurs, I<errno> is set appropriately.  If one wants to check I<errno> after the call, it should be set to zero before the call.
de: Die Funktionen B<getpwnam>() und B<getpwuid>() geben einen Zeiger auf eine I<passwd>-Struktur oder NULL zurück, falls kein passender Eintrag gefunden wird oder ein Fehler auftritt. Wenn ein Fehler auftritt wird I<errno> entsprechende gesetzt. Falls I<errno> nach dem Aufruf geprüft werden soll, sollte es vor dem Aufruf auf Null gesetzt werden.

note: type: Plain text
en: The return value may point to a static area, and may be overwritten by subsequent calls to B<getpwent>(3), B<getpwnam>(), or B<getpwuid>().  (Do not pass the returned pointer to B<free>(3).)
de: Der Rückgabewert könnte auf einen statischen Bereich zeigen und von nachfolgenden Aufrufen von B<getpwent>(3), B<getpwnam>() oder B<getpwuid>(3) überschrieben werden. (Übergeben Sie den zurückgegebenen Zeiger nicht an B<free>(3).)

note: type: Plain text
en: On success, B<getpwnam_r>()  and B<getpwuid_r>()  return zero, and set I<*result> to I<pwd>.  If no matching password record was found, these functions return 0 and store NULL in I<*result>.  In case of error, an error number is returned, and NULL is stored in I<*result>.
de: Bei Erfolg geben B<getpwnam_r>() und B<getpwuid_r>() Null zurück und setzen I<*ergebnis> auf I<pwd>. Falls kein passender Passwort-Datensatz gefunden wurde, geben diese Funktionen 0 zurück und speichern NULL in I<*ergebnis>. Im Fall eines Fehlers wird eine Fehlernummer zurückgegeben und NULL in I<*ergebnis> gespeichert.

note: type: SH
en: ERRORS
de: FEHLER

note: type: TP
en: B<0> or B<ENOENT> or B<ESRCH> or B<EBADF> or B<EPERM> or ...
de: B<0> oder B<ENOENT> oder B<ESRCH> oder B<EBADF> oder B<EPERM> oder …

note: type: Plain text
en: The given I<name> or I<uid> was not found.
de: Der angegebene I<name> oder die I<uid> wurde nicht gefunden

note: type: Plain text
en: A signal was caught; see B<signal>(7).
de: Ein Signal wurde abgefangen; siehe B<signal>(7).

note: type: Plain text
en: I/O error.
de: E/A-Fehler (engl. I/O).

note: type: Plain text
en: The per-process limit on the number of open file descriptors has been reached.
de: Die Beschränkung pro Prozess der Anzahl offener Datei-Deskriptoren wurde erreicht.

note: type: Plain text
en: The system-wide limit on the total number of open files has been reached.
de: Die systemweite Beschränkung für die Gesamtzahl offener Dateien wurde erreicht.

note: not in POSIX This structure is static, allocated 0 or 1 times. No memory leak. (libc45) type: Plain text
en: Insufficient memory to allocate I<passwd> structure.
de: Der Speicher reicht nicht aus, um ihn für die Struktur I<passwd> zu reservieren.

note: type: Plain text
en: Insufficient buffer space supplied.
de: Zu wenig Pufferspeicher bereitgestellt.

note: type: SH
en: FILES
de: DATEIEN

note: type: Plain text
en: local password database file
de: lokale Passwortdatenbank

note: type: SH
en: ATTRIBUTES
de: ATTRIBUTE

note: type: Plain text
en: For an explanation of the terms used in this section, see B<attributes>(7).
de: Siehe B<attributes>(7) für eine Erläuterung der in diesem Abschnitt verwandten Ausdrücke.

note: type: tbl table
en: Interface
de: Schnittstelle

note: type: tbl table
en: Attribute
de: Attribut

note: type: tbl table
en: Value
de: Wert

note: type: tbl table
en: Thread safety
de: Multithread-Fähigkeit

note: type: SH
en: CONFORMING TO
de: KONFORM ZU

note: type: Plain text
en: POSIX.1-2001, POSIX.1-2008, SVr4, 4.3BSD.  The I<pw_gecos> field is not specified in POSIX, but is present on most implementations.
de: POSIX.1-2001, POSIX.1-2008, SVr4, 4.3BSD. Das Feld I<pw_gecos> ist in POSIX nicht spezifiziert, aber in den meisten Implementierungen vorhanden.

note: type: SH
en: NOTES
de: ANMERKUNGEN

note: more precisely: AIX 5.1 - gives ESRCH OSF1 4.0g - gives EWOULDBLOCK libc, glibc up to version 2.6, Irix 6.5 - give ENOENT glibc since version 2.7 - give 0 FreeBSD 4.8, OpenBSD 3.2, NetBSD 1.6 - give EPERM SunOS 5.8 - gives EBADF Tru64 5.1b, HP-UX-11i, SunOS 5.7 - give 0 type: Plain text
en: The formulation given above under "RETURN VALUE" is from POSIX.1-2001.  It does not call "not found" an error, and hence does not specify what value I<errno> might have in this situation.  But that makes it impossible to recognize errors.  One might argue that according to POSIX I<errno> should be left unchanged if an entry is not found.  Experiments on various UNIX-like systems show that lots of different values occur in this situation: 0, ENOENT, EBADF, ESRCH, EWOULDBLOCK, EPERM, and probably others.
de: Die unter »RÜCKGABEWERT« angegebene Formulierung stammt von POSIX.1-2001. Sie lautet nicht Fehler »nicht gefunden« und gibt daher nicht an, welchen Wert I<errno> in dieser Situation haben könnte. Dies macht es aber unmöglich Fehler zu erkennen. Es kann argumentiert werden, dass I<errno> von POSIX unverändert bleiben sollte, wenn ein Eintrag nicht gefunden wird. Experimente auf verschiedenen UNIX-Systemen zeigen aber, dass viele verschieden Werte in dieser Situation auftreten: 0, ENOENT, EBADF, ESRCH, EWOULDBLOCK, EPERM und wahrscheinlich andere.

note: type: Plain text
en: The I<pw_dir> field contains the name of the initial working directory of the user.  Login programs use the value of this field to initialize the B<HOME> environment variable for the login shell.  An application that wants to determine its user's home directory should inspect the value of B<HOME> (rather than the value I<getpwuid(getuid())-E<gt>pw_dir>)  since this allows the user to modify their notion of "the home directory" during a login session.  To determine the (initial) home directory of another user, it is necessary to use I<getpwnam("username")-E<gt>pw_dir> or similar.
de: Das Feld I<pw_dir> enthält den Namen des anfänglichen Arbeitsverzeichnisses des Benutzers. Anmeldeprogramme benutzen diesen Wert, um die Umgebungsvariable B<HOME> für die Anmelde-Shell zu initialisieren. Eine Anwendung, die das Home-Verzeichnis des Benutzers feststellen möchte, sollte den Wert von B<HOME> (anstatt des Wertes I<getpwuid(getuid())-E<gt>pw_dir>) kontrollieren, da dies dem Benutzer erlaubt, seine Vorstellung von »das Home-Verzeichnis« während einer Anmeldesitzung zu ändern. Um das (anfängliche) Home-Verzeichnis eines anderen Benutzers festzustellen, ist es nötig I<getpwnam(»Benutzername«)-E<gt>pw_dir> oder ähnliches zu benutzen.

note: type: SH
en: EXAMPLE
de: BEISPIEL

note: type: Plain text
en: The program below demonstrates the use of B<getpwnam_r>()  to find the full username and user ID for the username supplied as a command-line argument.
de: Das folgende Programm demonstriert den Gebrauch von B<getpwnam_r>(), um den volständigen Benutzernamen und die Benutzerkennung für den als Befehlszeilenargument angegebenen Benutzernamen herauszufinden.

note: type: Plain text
en: int
    main(int argc, char *argv[])
    {
        struct passwd pwd;
        struct passwd *result;
        char *buf;
        size_t bufsize;
        int s;
de: int
    main(int argc, char *argv[])
    {
        struct passwd pwd;
        struct passwd *ergebnis;
        char *puffer;
        size_t puffergroesse;
        int s;

note: type: Plain text
en:     if (argc != 2) {
            fprintf(stderr, "Usage: %s username\en", argv[0]);
            exit(EXIT_FAILURE);
        }
de:     if (argc != 2) {
            fprintf(stderr, "Aufruf: %s Benutzername\en", argv[0]);
            exit(EXIT_FAILURE);
        }

note: type: Plain text
en:     bufsize = sysconf(_SC_GETPW_R_SIZE_MAX);
        if (bufsize == -1)          /* Value was indeterminate */
            bufsize = 16384;        /* Should be more than enough */
de:     puffergroesse = sysconf(_SC_GETPW_R_SIZE_MAX);
        if (puffergroesse == -1)          /* Wert war unklar */
            puffergroesse = 16384;        /* Sollte mehr als genug sein */

note: type: Plain text
en:     buf = malloc(bufsize);
        if (buf == NULL) {
            perror("malloc");
            exit(EXIT_FAILURE);
        }
de:     buf = malloc(puffergroesse);
        if (puffer == NULL) {
            perror("malloc");
            exit(EXIT_FAILURE);
        }

note: type: Plain text
en:     s = getpwnam_r(argv[1], &pwd, buf, bufsize, &result);
        if (result == NULL) {
            if (s == 0)
                printf("Not found\en");
            else {
                errno = s;
                perror("getpwnam_r");
            }
            exit(EXIT_FAILURE);
        }
de:     s = getpwnam_r(argv[1], &pwd, puffer, puffergroesse, &ergebnis);
        if (ergebnis == NULL) {
            if (s == 0)
                printf("Nicht gefunden\en");
            else {
                errno = s;
                perror("getpwnam_r");
            }
            exit(EXIT_FAILURE);
        }

note: type: SH
en: SEE ALSO
de: SIEHE AUCH

note: type: SH
en: COLOPHON
de: KOLOPHON

note: type: Plain text
en: This page is part of release 5.03 of the Linux I<man-pages> project.  A description of the project, information about reporting bugs, and the latest version of this page, can be found at \%https://www.kernel.org/doc/man-pages/.
de: Diese Seite ist Teil der Veröffentlichung 5.03 des Projekts Linux-I<man-pages>. Eine Beschreibung des Projekts, Informationen, wie Fehler gemeldet werden können sowie die aktuelle Version dieser Seite finden sich unter \%https://www.kernel.org/doc/man-pages/.

note: type: SH
en: NOTE
de: ANMERKUNGEN

note: type: Plain text
en: The user password database mostly refers to I</etc/passwd>.  However, with recent systems it also refers to network wide databases using NIS, LDAP and other local files as configured in I</etc/nsswitch.conf>.
de: Die Benutzer-Passwortdatenbank bezieht sich meistens auf I</etc/passwd>. Bei aktuellen Systemen bezieht sie sich jedoch außerdem auf netzwerkweite Datenbanken, die NIS, LDAP und andere lokale Datenbanken benutzen. Dies ist in I</etc/nsswitch.conf> konfiguriert.

note: type: Plain text
en: System Databases and Name Service Switch configuration file
de: Konfigurationsdatei für Systemdatenbanken und Namens-Dienst-Umschalter (»Name Service Switch«)

note: type: Plain text
en: This page is part of release 5.02 of the Linux I<man-pages> project.  A description of the project, information about reporting bugs, and the latest version of this page, can be found at \%https://www.kernel.org/doc/man-pages/.
de: Diese Seite ist Teil der Veröffentlichung 5.02 des Projekts Linux-I<man-pages>. Eine Beschreibung des Projekts, Informationen, wie Fehler gemeldet werden können sowie die aktuelle Version dieser Seite finden sich unter \%https://www.kernel.org/doc/man-pages/.

note: type: Plain text
en: This page is part of release 5.01 of the Linux I<man-pages> project.  A description of the project, information about reporting bugs, and the latest version of this page, can be found at \%https://www.kernel.org/doc/man-pages/.
de: Diese Seite ist Teil der Veröffentlichung 5.01 des Projekts Linux-I<man-pages>. Eine Beschreibung des Projekts, Informationen, wie Fehler gemeldet werden können sowie die aktuelle Version dieser Seite finden sich unter \%https://www.kernel.org/doc/man-pages/.
