manpages-l10n - en to de translation catalogue (37 entries)

note: type: TH
en: 2019-10-10
de: 10. Oktober 2019

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

note: type: SH
en: NAME
de: BEZEICHNUNG

note: type: Plain text
en: close - close a file descriptor
de: close - Dateideskriptor schließen

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

note: type: SH
en: DESCRIPTION
de: BESCHREIBUNG

note: type: Plain text
en: B<close>()  closes a file descriptor, so that it no longer refers to any file and may be reused.  Any record locks (see B<fcntl>(2))  held on the file it was associated with, and owned by the process, are removed (regardless of the file descriptor that was used to obtain the lock).
de: B<close>() schließt einen Dateideskriptor, so dass dieser nicht mehr zu einer Datei gehört und wieder verwendet werden kann. Alle zum Prozess gehörenden Datensatz-Sperren (siehe B<fcntl>(2)) der mit dem Deskriptor verbundenen Datei werden aufgehoben. Die Aufhebung der Sperren erfolgt unabhängig von dem Deskriptor, mit dem die Sperre eingerichtet wurde.

note: type: Plain text
en: If I<fd> is the last file descriptor referring to the underlying open file description (see B<open>(2)), the resources associated with the open file description are freed; if the file descriptor was the last reference to a file which has been removed using B<unlink>(2), the file is deleted.
de: Wenn I<fd> der letzte Deskriptor der zugehörigen offenen Datei ist (siehe B<open>(2)), werden die zugehörigen Ressourcen freigegeben. War der Datei-Deskriptor der letzte Verweis auf eine Datei, die mittels B<unlink>(2) entfernt wurde, wird die Datei gelöscht.

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

note: type: Plain text
en: B<close>()  returns zero on success.  On error, -1 is returned, and I<errno> is set appropriately.
de: Nach erfolgreicher Ausführung gibt B<close>() 0 zurück. Bei Fehlern wird -1 zurückgegeben und I<errno> entsprechend gesetzt.

note: type: SH
en: ERRORS
de: FEHLER

note: type: Plain text
en: I<fd> isn't a valid open file descriptor.
de: I<fd> ist kein gültiger Deskriptor für eine geöffnete Datei.

note: Though, it's in doubt whether this error can ever occur; see https://lwn.net/Articles/576478/ "Returning EINTR from close()" type: Plain text
en: The B<close>()  call was interrupted by a signal; see B<signal>(7).
de: Der Aufruf von B<close>() wurde von einem Signal unterbrochen (siehe B<signal>(7)).

note: type: Plain text
en: An I/O error occurred.
de: Es ist ein E/A-Fehler (engl. I/O) aufgetreten.

note: type: Plain text
en: On NFS, these errors are not normally reported against the first write which exceeds the available storage space, but instead against a subsequent B<write>(2), B<fsync>(2), or B<close>().
de: Auf NFS werden diese Fehler normalerweise nicht beim ersten Schreibversuch, der den verfügbaren Speicherplatz überschreitet, berichtet, sondern stattdessen an nachfolgende B<write>(2), B<fsync>(2) oder B<close>(2).

note: type: Plain text
en: See NOTES for a discussion of why B<close>()  should not be retried after an error.
de: Siehe ANMERKUNGEN für eine Diskussion, warum B<close>() nach einem Fehler nicht erneut versucht werden sollte.

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

note: type: SH
en: NOTES
de: ANMERKUNGEN

note: type: Plain text
en: A successful close does not guarantee that the data has been successfully saved to disk, as the kernel uses the buffer cache to defer writes.  Typically, filesystems do not flush buffers when a file is closed.  If you need to be sure that the data is physically stored on the underlying disk, use B<fsync>(2).  (It will depend on the disk hardware at this point.)
de: Ein erfolgreiches »close« garantiert nicht, dass die Daten erfolgreich auf der Festplatte gespeichert wurden, weil der Kernel den Pufferzwischenspeicher verwendet, um verzögert zu schreiben. Typischerweise leeren Dateisysteme ihre Puffer beim Schließen einer Datei nicht. Wenn Sie sicher sein müssen, dass die Daten physisch auf der darunterliegenen Platte gespeichert sind, verwenden Sie B<fsync>(2). (Hierbei kommt es auf die Hardware Ihrer Festplatte an.)

note: type: Plain text
en: The close-on-exec file descriptor flag can be used to ensure that a file descriptor is automatically closed upon a successful B<execve>(2); see B<fcntl>(2)  for details.
de: Der Dateideskriptor close-on-exec kann dazu verwandt werden, sicherzustellen, dass ein Dateideskriptor automatisch bei einem erfolgreichen B<execve>(2) geschlossen wird; siehe B<fcntl>(2) für Details.

note: Date: Tue, 4 Sep 2007 13:57:35 +0200 From: Fredrik Noring <noring@nocrew.org> One such race involves signals and ERESTARTSYS. If a file descriptor in use by a system call is closed and then reused by e.g. an independent open() in some unrelated thread, before the original system call has restarted a
en: It is probably unwise to close file descriptors while they may be in use by system calls in other threads in the same process.  Since a file descriptor may be reused, there are some obscure race conditions that may cause unintended side effects.
de: Wahrscheinlich ist es unklug, Dateideskriptoren zu schließen, die möglicherweise noch durch Systemaufrufe in anderen Threads desselben Prozesses belegt sein können. Da Dateideskriptoren wiederverwendet werden können, kann dies zu undurchsichtigen »Race Conditions« mit unbeabsichtigten Nebenwirkungen führen.

note: type: SS
en: Dealing with error returns from close()
de: Umngang mit von close() zurückgelieferten Fehlern

note: type: Plain text
en: A careful programmer will check the return value of B<close>(), since it is quite possible that errors on a previous B<write>(2)  operation are reported only on the final B<close>()  that releases the open file description.  Failing to check the return value when closing a file may lead to I<silent> loss of data.  This can especially be observed with NFS and with disk quota.
de: Ein sorgfältiger Programmierer prüft den Rückgabewert von B<close>(), da es durchaus möglich ist, dass Fehler bei einer früheren B<write>(2)-Operation erst bei dem abschließenden B<close>()-Zugriff, bei dem die offenen Dateideskriptoren freigegeben werden, gemeldet werden. Wird der Rückgabewert beim Schließen einer Datei nicht geprüft, kann dies zu I<unbemerktem> Datenverlust führen. Dies kann vor allem mit NFS und »Disk Quotas« beobachtet werden.

note: type: Plain text
en: Note, however, that a failure return should be used only for diagnostic purposes (i.e., a warning to the application that there may still be I/O pending or there may have been failed I/O)  or remedial purposes (e.g., writing the file once more or creating a backup).
de: Beachten Sie allerdings, dass ein zurückgelieferter Fehler nur für diagnostische Zwecke (d.h. einer Warnung an die Anwendung, dass E/A noch in Verarbeitung ist, oder dass es fehlgeschlagene E/A gegeben haben könnte) oder für abhelfende Zwecke (z.B. dem erneuten Schreiben der Datei oder dem Erstellen einer Sicherungskopie) verwandt werden sollte.

note: The file descriptor is released early in close(); close() ==> __close_fd(): __put_unused_fd() ==> __clear_open_fd() return filp_close(file, files); The errors are returned by filp_close() after the FD has been cleared for re-use. filp_close() type: Plain text
en: Retrying the B<close>()  after a failure return is the wrong thing to do, since this may cause a reused file descriptor from another thread to be closed.  This can occur because the Linux kernel I<always> releases the file descriptor early in the close operation, freeing it for reuse; the steps that may return an error, such as flushing data to the filesystem or device, occur only later in the close operation.
de: Es ist falsch, nach einer Rückgabe eines Fehlers B<close>() erneut zu versuchen, da es dazu führen könnte, dass ein wiederverwandter Dateideskriptor von einem anderen Thread geschlossen werden könnte. Dies kann auftreten, da der Linux-Kernel Dateideskriptoren I<immer> früh in der Close-Aktion für die Wiederbenutzung freigibt und die Schritte, die einen Fehler liefern können, wie das Rausschreiben von Daten zu dem Dateisystem oder Gerät, erst später in der Close-Aktion vorkommen.

note: FreeBSD documents this explicitly. From the look of the source code SVR4, ancient SunOS, later Solaris, and AIX all do this. Issue 8 type: Plain text
en: Many other implementations similarly always close the file descriptor (except in the case of B<EBADF>, meaning that the file descriptor was invalid)  even if they subsequently report an error on return from B<close>().  POSIX.1 is currently silent on this point, but there are plans to mandate this behavior in the next major release of the standard.
de: Viele andere Implementierunngen schließen den Dateideskriptor ähnlich (außer im Falle von B<EBADF>, der bedeutet, dass der Dateideskriptor ungültig war), selbst falls sie im folgenden einen Fehler bei der Rückkehr von B<close>() berichten. POSIX.1 sagt derzeit zu diesem Punkt nichts aus, aber es gibt Überlegungen, dieses Verhalten in der nächsten großen Veröffentlichung dieses Standards zu verpflichten.

note: type: Plain text
en: A careful programmer who wants to know about I/O errors may precede B<close>()  with a call to B<fsync>(2).
de: Ein sorgfältiger Programmierer, der über E/A-Fehler Bescheid wissen möchte, kann B<close>() einen Aufruf von B<fsync>(2) vorschalten.

note: type: Plain text
en: The B<EINTR> error is a somewhat special case.  Regarding the B<EINTR> error, POSIX.1-2013 says:
de: Der Fehler B<EINTR> ist etwas speziell. Bezüglich des Fehlers B<EINTR> sagt POSIX.1-2013:

note: type: Plain text
en: If B<close>()  is interrupted by a signal that is to be caught, it shall return -1 with I<errno> set to B<EINTR> and the state of I<fildes> is unspecified.
de: Falls B<close>() von einem Signal unterbrochen wird, das gefangen werden soll, muss es -1 zurückliefern, wobei I<errno> auf B<EINTR> gesetzt werden soll und der Zustand von I<fildes> nicht festgelegt ist.

note: FIXME . for later review when Issue 8 is one day released... POSIX proposes further changes for EINTR http://austingroupbugs.net/tag_view_page.php?tag_id=8 http://austingroupbugs.net/view.php?id=529 FIXME . Review the following glibc bug later https://sourceware.org/bugzilla/show_bug.cgi?id=14627 ty
en: This permits the behavior that occurs on Linux and many other implementations, where, as with other errors that may be reported by B<close>(), the file descriptor is guaranteed to be closed.  However, it also permits another possibility: that the implementation returns an B<EINTR> error and keeps the file descriptor open.  (According to its documentation, HP-UX's B<close>()  does this.)  The caller must then once more use B<close>()  to close the file descriptor, to avoid file descriptor leaks.  This divergence in implementation behaviors provides a difficult hurdle for portable applications, since on many implementations, B<close>()  must not be called again after an B<EINTR> error, and on at least one, B<close>()  must be called again.  There are plans to address this conundrum for the next major release of the POSIX.1 standard.
de: Dies erlaubt das Verhalten, das auf Linux und vielen anderen Implementierungen auftritt, bei dem, wie auch bei anderen von B<close>() berichteten Fehlern, garantiert wird, dass der Dateideskriptor geschlossen ist. Es erlaubt allerdings auch eine andere Möglichkeit: dass die Implementierung einen Fehler B<EINTR> zurückliefert und den Dateideskriptor offen hält. (Laut seiner Beschreibung ist dies für B<close>() unter HP-UX der Fall.) Der Aufrufende muss dann erneut B<close>() verwenden, um den Dateideskriptor zu schließen und Lecks bei Dateideskriptoren zu vermeiden. Diese Divergenz in Implementierungsverhalten stellt eine schwierige Hürde für portable Anwendungen dar, da unter vielen Implementierungen B<close>() nicht nach einem Fehler B<EINTR> erneut aufgerufen werden darf, und bei mindestens einer B<close>() erneut aufgerufen werden muss. Es gibt Überlegungen, dieses Puzzle für die nächste Hauptveröffentlichung des Standards POSIX.1 zu lösen.

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: TH
en: 2017-09-15
de: 15. September 2017

note: type: Plain text
en: On NFS, these errors are not normally reported against the first write which exceeds the available storage space, but instead against a subsequent B<write>(2), B<fsync>(2), or B<close>(2).
de: Auf NFS werden diese Fehler normalerweise nicht beim ersten Schreibversuch, der den verfügbaren Speicherplatz überschreitet, berichtet, sondern stattdessen an nachfolgende B<write>(2), B<fsync>(2) oder B<close>(2).

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