manpages-de - en to de translation catalogue (58 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: readlink, readlinkat - read value of a symbolic link
de: readlink, readlinkat - liest das Ziel eines symbolischen Links

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

note: type: Plain text
en: B<ssize_t readlink(const char *>I<pathname>B<, char *>I<buf>B<, size_t >I<bufsiz>B<);>
de: B<ssize_t readlink(const char *>I<Pfadname>B<, char *>I<Puffer>B<, size_t >I<Puffergröße>B<);>

note: type: Plain text
en: B<#include E<lt>fcntl.hE<gt>           >/* Definition of AT_* constants */
    B<#include E<lt>unistd.hE<gt>>
de: B<#include E<lt>fcntl.hE<gt>           >/* Definition der AT_*-Konstanten */
    B<#include E<lt>unistd.hE<gt>>

note: type: Plain text
en: B<ssize_t readlinkat(int >I<dirfd>B<, const char *>I<pathname>B<,>
    B<                   char *>I<buf>B<, size_t >I<bufsiz>B<);>
de: B<int readlinkat(int >I<dirfd>B<, const char *>I<Pfadname>B<,>
    B<               char *>I<Puffer>B<, size_t >I<Puffergröße>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: || _XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED type: Plain text
en: _XOPEN_SOURCE\ E<gt>=\ 500 || _POSIX_C_SOURCE\ E<gt>=\ 200112L
        || /* Glibc versions E<lt>= 2.19: */ _BSD_SOURCE
de: _XOPEN_SOURCE\ E<gt>=\ 500 || _POSIX_C_SOURCE\ E<gt>=\ 200112L
        || /* Glibc-Versionen E<lt>= 2.19: */ _BSD_SOURCE

note: type: TP
en: Since glibc 2.10:
de: Seit Glibc 2.10:

note: type: TP
en: Before glibc 2.10:
de: Vor Glibc 2.10:

note: type: SH
en: DESCRIPTION
de: BESCHREIBUNG

note: type: Plain text
en: B<readlink>()  places the contents of the symbolic link I<pathname> in the buffer I<buf>, which has size I<bufsiz>.  B<readlink>()  does not append a null byte to I<buf>.  It will (silently) truncate the contents (to a length of I<bufsiz> characters), in case the buffer is too small to hold all of the contents.
de: B<readlink>() platziert den Inhalt des symbolischen Links I<Pfadname> in den I<Puffer>, der die Größe I<Puffergröße> hat. B<readlink>() hängt kein Null-Byte an I<Puffer>. Ist der Puffer zu klein, um den ganzen Inhalt aufzunehmen, verkürzt es (stillschweigend) den Inhalt (auf die Länge von I<Puffergröße> Zeichen).

note: type: Plain text
en: The B<readlinkat>()  system call operates in exactly the same way as B<readlink>(), except for the differences described here.
de: Der Systemaufruf B<readlinkat>() funktioniert genauso wie B<readlink>(), außer den hier beschriebenen Unterschieden.

note: type: Plain text
en: If the pathname given in I<pathname> is relative, then it is interpreted relative to the directory referred to by the file descriptor I<dirfd> (rather than relative to the current working directory of the calling process, as is done by B<readlink>()  for a relative pathname).
de: Falls der in I<Pfadname> übergebene Pfadname relativ ist wird er als relativ zu dem im Dateideskriptor I<dirfd> referenzierten Verzeichnis interpretiert (statt relativ zum aktuellen Arbeitsverzeichnis des aufrufenden Prozesses, wie es bei B<readlink>() für einen relativen Pfadnamen erfolgt).

note: type: Plain text
en: If I<pathname> is relative and I<dirfd> is the special value B<AT_FDCWD>, then I<pathname> is interpreted relative to the current working directory of the calling process (like B<readlink>()).
de: Falls I<Pfadname> relativ ist und I<dirfd> den besonderen Wert B<AT_FDCWD> annimmt wird I<Pfadname> als relativ zum aktuellen Arbeitsverzeichnis des aufrufenden Prozesses interpretiert (wie B<readlink>()).

note: type: Plain text
en: If I<pathname> is absolute, then I<dirfd> is ignored.
de: Falls I<Pfadname> absolut ist wird I<dirfd> ignoriert.

note: commit 65cfc6722361570bfe255698d9cd4dccaf47570d type: Plain text
en: Since Linux 2.6.39, I<pathname> can be an empty string, in which case the call operates on the symbolic link referred to by I<dirfd> (which should have been obtained using B<open>(2)  with the B<O_PATH> and B<O_NOFOLLOW> flags).
de: Seit Linux 2.6.39 kann I<Pfadname> eine leere Zeichenkette sein. In diesem Fall arbeitet der Aufruf auf dem durch I<dirfd> referenzierten symbolischen Link (der durch die Verwendung der Schalter B<O_PATH> und B<O_NOFOLLOW> von B<open>(2) erlangt worden sein kann).

note: type: Plain text
en: See B<openat>(2)  for an explanation of the need for B<readlinkat>().
de: Lesen Sie B<openat>(2) für eine Beschreibung der Notwendigkeit von B<readlinkat>().

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

note: type: Plain text
en: On success, these calls return the number of bytes placed in I<buf>.  (If the returned value equals I<bufsiz>, then truncation may have occurred.)  On error, -1 is returned and I<errno> is set to indicate the error.
de: Bei Erfolg geben diese Aufrufe die Anzahl der Byte zurück, die in I<Puffer> platziert wurden. (Falls der zurückgegebene Wert gleich I<Puffergröße> ist, könnte eine Verkürzung aufgetreten sein.) Bei einem Fehler wird -1 zurückgegeben und I<errno> so gesetzt, dass es den Fehler angibt.

note: type: SH
en: ERRORS
de: FEHLER

note: type: Plain text
en: Search permission is denied for a component of the path prefix.  (See also B<path_resolution>(7).)
de: Für einen Bestandteil des Pfad-Präfix fehlt die Sucherlaubnis. (Siehe auch B<path_resolution>(7).)

note: type: Plain text
en: I<buf> extends outside the process's allocated address space.
de: I<Puffer> überschreitet den reservierten Adressbereich dieses Prozesses.

note: At the glibc level, bufsiz is unsigned, so this error can only occur if bufsiz==0.  However, the in the kernel syscall, bufsiz is signed, and this error can also occur if bufsiz < 0. See: http://thread.gmane.org/gmane.linux.man/380 Subject: [patch 0/3] [RFC] kernel/glibc mismatch of "readlink" sysca
en: I<bufsiz> is not positive.
de: I<Puffergröße> ist nicht positiv.

note: type: Plain text
en: The named file (i.e., the final filename component of I<pathname>)  is not a symbolic link.
de: Die benannte Datei (d.h. die endgültige Dateinamenkomponente von I<Pfadname>) ist kein symbolischer Link.

note: type: Plain text
en: An I/O error occurred while reading from the filesystem.
de: Beim Lesen vom Dateisystem trat ein E/A-Fehler (engl. I/O) auf.

note: type: Plain text
en: Too many symbolic links were encountered in translating the pathname.
de: Beim Übersetzen des Pfadnamens wurden zu viele symbolische Links vorgefunden.

note: type: Plain text
en: A pathname, or a component of a pathname, was too long.
de: Ein Pfadname oder eine Komponente eines Pfadnamens war zu lang.

note: type: Plain text
en: The named file does not exist.
de: Die angegebene Datei existiert nicht.

note: type: Plain text
en: Insufficient kernel memory was available.
de: Es war nicht genügend Kernelspeicher verfügbar.

note: type: Plain text
en: A component of the path prefix is not a directory.
de: Eine Komponente des Pfad-Präfixes ist kein Verzeichnis.

note: type: Plain text
en: The following additional errors can occur for B<readlinkat>():
de: Die folgenden zusätzlichen Fehler können bei B<readlinkat>() auftreten:

note: type: Plain text
en: I<dirfd> is not a valid file descriptor.
de: I<dirfd> ist kein zulässiger Dateideskriptor.

note: type: Plain text
en: I<pathname> is relative and I<dirfd> is a file descriptor referring to a file other than a directory.
de: I<Pfadname> ist relativ und I<dirfd> ist ein Dateideskriptor, der sich auf eine Datei bezieht, die kein Verzeichnis ist.

note: type: SH
en: VERSIONS
de: VERSIONEN

note: type: Plain text
en: B<readlinkat>()  was added to Linux in kernel 2.6.16; library support was added to glibc in version 2.4.
de: B<readlinkat>() wurde zu Linux in Kernel 2.6.16 hinzugefügt; Bibliotheksunterstützung wurde zu Glibc in Version 2.4 hinzugefügt.

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

note: type: Plain text
en: B<readlink>(): 4.4BSD (B<readlink>()  first appeared in 4.2BSD), POSIX.1-2001, POSIX.1-2008.
de: B<readlink>(): 4.4BSD (B<readlink>() erschien erstmalig in 4.2BSD), POSIX.1-2001, POSIX.1-2008.

note: type: SH
en: NOTES
de: ANMERKUNGEN

note: type: Plain text
en: In versions of glibc up to and including glibc 2.4, the return type of B<readlink>()  was declared as I<int>.  Nowadays, the return type is declared as I<ssize_t>, as (newly) required in POSIX.1-2001.
de: In Glibc-Versionen bis einschließlich Glibc 2.4 wurde der Typ des Rückgabewerts von B<readlink>() als I<int> deklariert. Heutzutage ist der Typ des Rückgabewerts als I<ssize_t> deklariert, wie es (neuerdings) in POSIX.1-2001 benötigt wird.

note: type: Plain text
en: Using a statically sized buffer might not provide enough room for the symbolic link contents.  The required size for the buffer can be obtained from the I<stat.st_size> value returned by a call to B<lstat>(2)  on the link.  However, the number of bytes written by B<readlink>()  and B<readlinkat>()  should be checked to make sure that the size of the symbolic link did not increase between the calls.  Dynamically allocating the buffer for B<readlink>()  and B<readlinkat>()  also addresses a common portability problem when using I<PATH_MAX> for the buffer size, as this constant is not guaranteed to be defined per POSIX if the system does not have such limit.
de: Wenn Sie einen Puffer mit einer festen Größe verwenden, ist eventuell nicht genug Platz für die Inhalte des symbolischen Links vorhanden. Die erforderliche Größe für den Puffer kann aus dem Wert I<stat.st_size> ermittelt werden, der nach einem Aufruf der Funktion B<lstat>(2) für den Link zurückgegeben wird. Allerdings sollte die Anzahl der Byte, die von B<readlink>() und B<readlinkat>() geschrieben wurden, überprüft werden. Damit kann sichergestellt werden, dass die Größe des symbolischen Links zwischen den Aufrufen nicht zugenommen hat. Die dynamische Zuweisung des Puffers für B<readlink>() und B<readlinkat>() behebt außerdem ein verbreitetes Portabilitätsproblem, wenn Sie I<PATH_MAX> für die Puffergröße benutzen. Diese Konstante muss laut POSIX nicht zwingend definiert sein, wenn das System eine solche Beschränkung nicht hat.

note: type: SS
en: Glibc notes
de: Anmerkungen zur Glibc

note: type: Plain text
en: On older kernels where B<readlinkat>()  is unavailable, the glibc wrapper function falls back to the use of B<readlink>().  When I<pathname> is a relative pathname, glibc constructs a pathname based on the symbolic link in I</proc/self/fd> that corresponds to the I<dirfd> argument.
de: Unter älteren Kernels, in denen B<readlinkat>() nicht verfügbar ist, weicht die Glibc-Wrapper-Funktion auf B<readlink>() aus. Wenn I<Pfadname> ein relativer Pfadname ist, dann konstruiert die Glibc einen Pfadnamen, der auf jenem symbolischen Link in I</proc/self/fd> basiert, der dem Argument I<dirfd> entspricht.

note: type: SH
en: EXAMPLE
de: BEISPIEL

note: type: Plain text
en: The following program allocates the buffer needed by B<readlink>()  dynamically from the information provided by B<lstat>(2), falling back to a buffer of size B<PATH_MAX> in cases where B<lstat>(2)  reports a size of zero.
de: Das folgende Programm reserviert den von B<readlink>() benötigten Puffer dynamisch mittels der Information, die von B<lstat>(2) bereitgestellt wird. Dabei wird in Fällen, in denen B<lstat>(2) die Größe Null zurückliefert, auf einen Puffer der Größe B<PATH_MAX> zurückgefallen.

note: type: Plain text
en:     if (argc != 2) {
            fprintf(stderr, "Usage: %s E<lt>pathnameE<gt>\en", argv[0]);
            exit(EXIT_FAILURE);
        }
de:     if (argc != 2) {
            fprintf(stderr, "Aufruf: %s E<lt>PfadnameE<gt>\en", argv[0]);
            exit(EXIT_FAILURE);
        }

note: type: Plain text
en:     /* Add one to the link size, so that we can determine whether
           the buffer returned by readlink() was truncated. */
de:     /* Einen zur Linkgröße hinzufügen, so dass bestimmt werden
           kann, ob der von readlink() zurückgelieferte Puffer
           abgeschnitten wurde. */

note: type: Plain text
en:     /* Some magic symlinks under (for example) /proc and /sys
           report \(aqst_size\(aq as zero. In that case, take PATH_MAX as
           a "good enough" estimate. */
de:     /* Einige magische Symlinks unter (beispielsweise) /proc und /sys
           geben \(aqst_size\(aq als Null zurück. In diesem Fall wird PATH_MAX als
           eine »genügend gute« Schätzung angenommen. */

note: type: Plain text
en:     printf("\(aq%s\(aq points to \(aq%.*s\(aq\en", argv[1], (int) nbytes, buf);
de:     printf("\(aq%s\(aq zeigt auf \(aq%.*s\(aq\en", argv[1], (int) nbytes, buf);

note: type: Plain text
en:     /* If the return value was equal to the buffer size, then the
           the link target was larger than expected (perhaps because the
           target was changed between the call to lstat() and the call to
           readlink()). Warn the user that the returned target may have
           been truncated. */
de:     /* Falls der Rückgabewert der Puffergröße entsprach, dann wir das
           Link-Ziel größer als erwartet (vielleicht weil das Ziel zwischen
           dem Aufruf von lstat() und dem Aufruf von readlink() geändert
           wurde). Den Benutzer warnen, dass das zurückgelieferte Ziel
           abgeschnitten worden sein kann. */

note: type: Plain text
en:     if (nbytes == bufsiz)
            printf("(Returned buffer may have been truncated)\en");
de:     if (nbytes == bufsiz)
            printf("(Zurückgelieferter Puffer könnte abgeschnitten worden sein)\en");

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: 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/.
