manpages-de 1.4-1 - en to de translation catalogue (53 entries)

note: type: TH
en: 2018-04-30
de: 30. April 2018

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

note: type: SH
en: NAME
de: BEZEICHNUNG

note: type: Plain text
en: getcwd, getwd, get_current_dir_name - get current working directory
de: getcwd, getwd, get_current_dir_name - das aktuelle Verzeichnis abfragen

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

note: type: Plain text
en: B<char *getcwd(char *>I<buf>B<, size_t >I<size>B<);>
de: B<char *getcwd(char *>I<Puffer>B<, size_t >I<Größe>B<);>

note: type: Plain text
en: B<char *getwd(char *>I<buf>B<);>
de: B<char *getwd(char *>I<Puffer>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: TP
en: Since glibc 2.12:
de: Seit Glibc 2.12:

note: type: Plain text
en: (_XOPEN_SOURCE\ E<gt>=\ 500) && ! (_POSIX_C_SOURCE\ E<gt>=\ 200809L)
        || /* Glibc since 2.19: */ _DEFAULT_SOURCE
        || /* Glibc versions E<lt>= 2.19: */ _BSD_SOURCE
de: (_XOPEN_SOURCE\ E<gt>=\ 500) && ! (_POSIX_C_SOURCE\ E<gt>=\ 200809L)
        || /* Glibc seit 2.19: */ _DEFAULT_SOURCE
        || /* Glibc-Versionen E<lt>= 2.19: */ _BSD_SOURCE

note: || _XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED type: Plain text
en: Before glibc 2.12: _BSD_SOURCE || _XOPEN_SOURCE\ E<gt>=\ 500
de: Vor Glibc 2.12: _BSD_SOURCE || _XOPEN_SOURCE\ E<gt>=\ 500

note: type: SH
en: DESCRIPTION
de: BESCHREIBUNG

note: type: Plain text
en: These functions return a null-terminated string containing an absolute pathname that is the current working directory of the calling process.  The pathname is returned as the function result and via the argument I<buf>, if present.
de: Diese Funktionen geben eine Zeichenkette mit abschließender Null zurück, die einen absoluten Pfadnamen enthält, der dem aktuellen Arbeitsverzeichnis des aufrufenden Prozesses entspricht. Der Pfadname wird als das Funktionsergebnis und, falls vorhanden, über das Argument I<Puffer> zurückgegeben.

note: type: Plain text
en: The B<getcwd>()  function copies an absolute pathname of the current working directory to the array pointed to by I<buf>, which is of length I<size>.
de: Die Funktion B<getcwd>() kopiert den absoluten Pfadnamen des aktuellen Arbeitsverzeichnisses in das Feld, auf das I<Puffer> zeigt und das I<Größe> Byte lang ist.

note: type: Plain text
en: If the length of the absolute pathname of the current working directory, including the terminating null byte, exceeds I<size> bytes, NULL is returned, and I<errno> is set to B<ERANGE>; an application should check for this error, and allocate a larger buffer if necessary.
de: Falls die Länge des absoluten Pfadnamens des Arbeitsverzeichnisses, einschließlich abschließender Null I<Größe> Byte überschreitet, wird NULL zurückgegeben und I<errno> auf B<ERANGE> gesetzt. Eine Anwendung sollte prüfen, ob dieser Fehler auftrat und falls nötig einen größeren Puffer reservieren.

note: type: Plain text
en: As an extension to the POSIX.1-2001 standard, glibc's B<getcwd>()  allocates the buffer dynamically using B<malloc>(3)  if I<buf> is NULL.  In this case, the allocated buffer has the length I<size> unless I<size> is zero, when I<buf> is allocated as big as necessary.  The caller should B<free>(3)  the returned buffer.
de: Als eine Erweiterung des POSIX.1-2001-Standards reserviert B<getcwd>() der Linux-Glibc den Puffer dynamisch durch Verwendung von B<malloc>(3), wenn I<Puffer> NULL ist. In diesem Fall hat der reservierte Puffer die Länge I<Größe>, sofern I<Gräße> nicht Null ist, wenn die für I<Puffer>  nötige Größe reserviert ist. Der Aufrufende sollte den zurückgegebenen Puffer mit B<free>(3) freigeben.

note: type: Plain text
en: B<get_current_dir_name>()  will B<malloc>(3)  an array big enough to hold the absolute pathname of the current working directory.  If the environment variable B<PWD> is set, and its value is correct, then that value will be returned.  The caller should B<free>(3)  the returned buffer.
de: B<get_current_dir_name>() wird mit B<malloc>(3) ein Feld reservieren, das groß genug ist, um den absoluten Pfadnamen des aktuellen Arbeitsverzeichnisses aufzunehmen. Wenn die Umgebungsvariable B<PWD> gesetzt ist und ihr Wert stimmt, dann wird dieser Wert zurückgegeben. Der Aufrufende sollte den zurückgegebenen Puffer mit B<free>(3) freigeben.

note: type: Plain text
en: B<getwd>()  does not B<malloc>(3)  any memory.  The I<buf> argument should be a pointer to an array at least B<PATH_MAX> bytes long.  If the length of the absolute pathname of the current working directory, including the terminating null byte, exceeds B<PATH_MAX> bytes, NULL is returned, and I<errno> is set to B<ENAMETOOLONG>.  (Note that on some systems, B<PATH_MAX> may not be a compile-time constant; furthermore, its value may depend on the filesystem, see B<pathconf>(3).)  For portability and security reasons, use of B<getwd>()  is deprecated.
de: B<getwd>() reserviert keinen Speicher mit B<malloc>(3). Das Argument I<Puffer> sollte ein Zeiger auf ein Feld mit einer Mindestlänge von B<PATH_MAX> Byte sein. Falls die Länge des absoluten Pfadnamens des aktuellen Arbeitsverzeichnisses einschließlich des abschließenden Null-Bytes B<PATH_MAX> Byte überschreitet, wird NULL zurückgegeben und I<errno> auf B<ENAMETOOLONG> gesetzt. (Beachten Sie, dass B<PATH_MAX> auf einigen Systemen zur Kompilierzeit möglicherweise keine Konstante ist; außerdem hängt ihr Wert vom Dateisystem ab – siehe B<pathconf>(3).) Aus Gründen der Portierbarkeit und Sicherheit ist die Benutzung von B<getwd>() missbilligt.

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

note: type: Plain text
en: On success, these functions return a pointer to a string containing the pathname of the current working directory.  In the case B<getcwd>()  and B<getwd>()  this is the same value as I<buf>.
de: Bei Erfolg geben diese Funktionen einen Zeiger auf eine Zeichenkette zurück, die den Pfadnamen des aktuellen Arbeitsverzeichnisses enthält. Im Fall von B<getcwd>() und B<getwd>() ist dies der gleiche Wert wie I<Puffer>.

note: type: Plain text
en: On failure, these functions return NULL, and I<errno> is set to indicate the error.  The contents of the array pointed to by I<buf> are undefined on error.
de: Bei einem Fehlschlag geben diese Funktionen Null zurück und I<errno> wird so gesetzt, dass es den Fehler anzeigt. Der Inhalt des Feldes, auf den I<Puffer> zeigt, ist bei einem Fehler nicht definiert.

note: type: SH
en: ERRORS
de: FEHLER

note: type: Plain text
en: Permission to read or search a component of the filename was denied.
de: Lese- oder Suchberechtigung für einen Bestandteil des Dateinamens wurde verweigert.

note: type: Plain text
en: I<buf> points to a bad address.
de: I<Puffer> zeigt auf eine falsche Adresse.

note: type: Plain text
en: The I<size> argument is zero and I<buf> is not a null pointer.
de: Das Argument I<Größe> ist Null und I<Puffer> ist kein Null-Zeiger.

note: type: Plain text
en: B<getwd>(): I<buf> is NULL.
de: B<getwd>(): I<Puffer> ist NULL.

note: type: Plain text
en: B<getwd>(): The size of the null-terminated absolute pathname string exceeds B<PATH_MAX> bytes.
de: B<getwd>(): Die Größe des absoluten Pfadnamens mit abschließender Null überschreitet B<PATH_MAX> Byte.

note: type: Plain text
en: The current working directory has been unlinked.
de: Der Link auf das aktuelle Arbeitsverzeichnis wurde gelöst.

note: type: Plain text
en: Out of memory.
de: Speicher aufgebraucht.

note: type: Plain text
en: The I<size> argument is less than the length of the absolute pathname of the working directory, including the terminating null byte.  You need to allocate a bigger array and try again.
de: Das Argument I<Größe> ist kleiner als die Länge des absoluten Pfadnamens des aktuellen Arbeitsverzeichnisses einschließlich abschließendem Null-Byte. Sie müssen ein größeres Feld reservieren und es erneut versuchen.

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: B<getcwd>()  conforms to POSIX.1-2001.  Note however that POSIX.1-2001 leaves the behavior of B<getcwd>()  unspecified if I<buf> is NULL.
de: B<getcwd>() ist konform zu POSIX.1-2001. Beachten Sie jedoch, dass das Verhalten von B<getcwd>() unter POSIX.1-2001 nicht spezifiziert ist, wenn I<Puffer> NULL ist.

note: type: Plain text
en: B<getwd>()  is present in POSIX.1-2001, but marked LEGACY.  POSIX.1-2008 removes the specification of B<getwd>().  Use B<getcwd>()  instead.  POSIX.1-2001 does not define any errors for B<getwd>().
de: B<getwd>() ist in POSIX.1-2001 vorhanden, aber als VERALTET markiert. POSIX.1-2008 entfernt die Spezifikation von B<getwd>(). Benutzen Sie stattdessen B<getcwd>(). POSIX.1-2001 definiert keine Fehler für B<getwd>().

note: type: Plain text
en: B<get_current_dir_name>()  is a GNU extension.
de: B<get_current_dir_name>() ist eine GNU-Erweiterung.

note: type: SH
en: NOTES
de: ANMERKUNGEN

note: type: Plain text
en: Under Linux, these functions make use of the B<getcwd>()  system call (available since Linux 2.1.92).  On older systems they would query I</proc/self/cwd>.  If both system call and proc filesystem are missing, a generic implementation is called.  Only in that case can these calls fail under Linux with B<EACCES>.
de: Unter Linux nutzen diese Funktionen den Systemaufruf B<getcwd>() (verfügbar seit 2.1.92). Auf älteren Systemen würden sie I</proc/self/cwd> abfragen. Falls sowohl der Systemaufruf, als auch das »proc«-Dateisystem fehlen, wird eine allgemeine Implementierung aufgerufen. Nur in diesem Fall können diese Systemaufrufe unter Linux mit B<EACCES> fehlschlagen.

note: type: Plain text
en: These functions are often used to save the location of the current working directory for the purpose of returning to it later.  Opening the current directory (".") and calling B<fchdir>(2)  to return is usually a faster and more reliable alternative when sufficiently many file descriptors are available, especially on platforms other than Linux.
de: Diese Funktionen werden oft benutzt, um den Ort des aktuellen Arbeitsverzeichnisses zum Zweck der späteren Rückkehr zu speichern. Das aktuelle Verzeichnis ».« zu öffnen und B<fchdir>(2) zur Rückkehr aufzurufen ist normalerweise schneller und eine zuverlässigere Alternative, wenn ausreichend viele Dateideskriptoren zur Verfügung stehen, besonders auf anderen Plattformen als Linux.

note: type: SS
en: C library/kernel differences
de: Unterschiede C-Bibliothek/Kernel

note: commit 3272c544da48f8915a0e34189182aed029bd0f2b type: Plain text
en: On Linux, the kernel provides a B<getcwd>()  system call, which the functions described in this page will use if possible.  The system call takes the same arguments as the library function of the same name, but is limited to returning at most B<PATH_MAX> bytes.  (Before Linux 3.12, the limit on the size of the returned pathname was the system page size.  On many architectures, B<PATH_MAX> and the system page size are both 4096 bytes, but a few architectures have a larger page size.)  If the length of the pathname of the current working directory exceeds this limit, then the system call fails with the error B<ENAMETOOLONG>.  In this case, the library functions fall back to a (slower) alternative implementation that returns the full pathname.
de: Unter Linux stellt der Kernel einen Systemaufruf B<getcwd>() bereit, den die in dieser Seite beschriebenen Funktionen falls möglich benutzen. Der Systemaufruf akzeptiert die gleichen Argumente wie die Bibliotheksfunktion des gleichen Namens, aber sie ist darauf begrenzt, maximal B<PATH_MAX> Byte zurückzuliefern. (Vor Linux 3.12 war die Begrenzung der Größe des zurückgelieferten Pfadnamens die Systemseitengröße. Auf vielen Architekturen sind sowohl B<PATH_MAX> als auch die Systemseitengröße beide 4096 Byte, aber einige Architekturen haben eine größere Seitengröße.) Falls die Länge des Pfadnamens des aktuellen Arbeitsverzeichnisses dies Begrenzung überschreitet, dann schlägt der Systemaufruf mit dem Fehler B<ENAMETOOLONG> fehl. In diesem Fall fällt die Bibliotheksfunktion auf eine (langsamere) alternative Implementierung zurück, die den kompletten Pfadnamen zurückliefert.

note: commit 8df9d1a4142311c084ffeeacb67cd34d190eff74 type: Plain text
en: Following a change in Linux 2.6.36, the pathname returned by the B<getcwd>()  system call will be prefixed with the string "(unreachable)" if the current directory is not below the root directory of the current process (e.g., because the process set a new filesystem root using B<chroot>(2)  without changing its current directory into the new root).  Such behavior can also be caused by an unprivileged user by changing the current directory into another mount namespace.  When dealing with pathname from untrusted sources, callers of the functions described in this page should consider checking whether the returned pathname starts with '/' or '(' to avoid misinterpreting an unreachable path as a relative pathname.
de: Folgend einer Änderung in Linux 2.6.36 wird dem durch den Systemaufruf B<getcwd>() zurückgelieferten Pfadnamen die Zeichenkette »(unreachable)« vorangestellt, falls das aktuelle Verzeichnis nicht unterhalb des Wurzelverzeichnisses des aktuellen Prozesses ist (z.B. da der Prozess auf eine neue Dateisystemwurzel mittels B<chroot>(2) gesetzt wurde, ohne sein aktuelles Verzeichnis in die neue Wurzel zu wechseln). Dieses Verhalten kann auch durch einen nichtprivilegierten Benutzer hervorgerufen werden, der das aktuelle Verzeichnis in einen anderen Einhängenamensraum gewechselt hat. Beim Umgang mit Pfadnamen von nichtvertrauenswürdigen Quellen sollten Aufrufende von in dieser Seite beschriebenen Funktionen in Betracht ziehen, zu überprüfen, ob der zurückgelieferte Pfadname mit »/« oder mit »(« anfängt, um zu vermeiden, dass ein nicht erreichbarer Pfad als relativer Pfadname misinterpretiert wird.

note: type: SH
en: BUGS
de: FEHLER

note: type: Plain text
en: Since the Linux 2.6.36 change that added "(unreachable)" in the circumstances described above, the glibc implementation of B<getcwd>()  has failed to conform to POSIX and returned a relative pathname when the API contract requires an absolute pathname.  With glibc 2.27 onwards this is corrected; calling B<getcwd>()  from such a pathname will now result in failure with B<ENOENT>.
de: Seit der Änderung in Linux 2.6.36, die »(unreachable)« in den oben beschriebenen Gegebenheiten hinzufügte, ist Glibcs Implementierung von B<getcwd>() nicht mehr mit POSIX konform und liefert einen relativen Pfadnamen zurück, wenn der API-Vertrag einen absoluten Pfadnamen verlangt. Ab Glibc 2.27 ist dies korrigiert: ein Aufruf von B<getcwd>() von solch einem Pfadnamen liefert jetzt einen Fehlschlag mit B<ENOENT>.

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