manpages-de - en to de translation catalogue (40 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: capget, capset - set/get capabilities of thread(s)
de: capget, capset - Setzt/ermittelt die Capabilities von Thread(s)

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

note: type: SH
en: DESCRIPTION
de: BESCHREIBUNG

note: type: Plain text
en: These two system calls are the raw kernel interface for getting and setting thread capabilities.  Not only are these system calls specific to Linux, but the kernel API is likely to change and use of these system calls (in particular the format of the I<cap_user_*_t> types) is subject to extension with each kernel revision, but old programs will keep working.
de: Diese zwei Systemaufrufe sind die rohe Kernelschnittstelle zum Ermitteln und Setzen der Thread-Capabilities. Die Systemaufrufe sind nicht nur Linux-spezifisch, auch die Kernel-API wird sich wahrscheinlich ändern und die Verwendung dieser Systemaufrufe (insbesondere das Format der I<cap_user_*_t>-Typen) unterliegt in jeder Kernel-Revision Erweiterungen, aber alte Programme werden weiterhin funktionieren.

note: type: Plain text
en: The portable interfaces are B<cap_set_proc>(3)  and B<cap_get_proc>(3); if possible, you should use those interfaces in applications.
de: Die portablen Schnittstellen sind B<cap_set_proc>(3) und B<cap_get_proc>(3); falls möglich, sollten Sie diese Schnittstellen in Anwendungen benutzen.

note: type: SS
en: Current details
de: Aktuelle Details

note: type: Plain text
en: Now that you have been warned, some current kernel details.  The structures are defined as follows.
de: Nachdem Sie gewarnt wurden, hier einige aktuelle Kernel-Datails. Die Strukturen sind wie folgt definiert:

note: commit e338d263a76af78fe8f38a72131188b58fceb591 Added 64 bit capability support type: Plain text
en:         /* V2 added in Linux 2.6.25; deprecated */
    #define _LINUX_CAPABILITY_VERSION_2  0x20071026
    #define _LINUX_CAPABILITY_U32S_2     2
de:         /* V2 hinzugefügt in Linux 2.6.25; veraltet */
    #define _LINUX_CAPABILITY_VERSION_2  0x20071026
    #define _LINUX_CAPABILITY_U32S_2     2

note: commit ca05a99a54db1db5bca72eccb5866d2a86f8517f type: Plain text
en:         /* V3 added in Linux 2.6.26 */
    #define _LINUX_CAPABILITY_VERSION_3  0x20080522
    #define _LINUX_CAPABILITY_U32S_3     2
de:         /* V3 in Linux 2.6.26 hinzugefügt */
    #define _LINUX_CAPABILITY_VERSION_3  0x20080522
    #define _LINUX_CAPABILITY_U32S_3     2

note: type: Plain text
en: The I<effective>, I<permitted>, and I<inheritable> fields are bit masks of the capabilities defined in B<capabilities>(7).  Note that the B<CAP_*> values are bit indexes and need to be bit-shifted before ORing into the bit fields.  To define the structures for passing to the system call, you have to use the I<struct __user_cap_header_struct> and I<struct __user_cap_data_struct> names because the typedefs are only pointers.
de: Die Felder I<effective>, I<permitted> und I<inheritable> sind Bitmasken der in I<capabilities>(7) definierten Capabilities. Beachten Sie, dass B<CAP_*>-Werte Bitindizes sind und bitweise verschoben werden müssen, bevor per ODER auf die Bitfelder zugegriffen wird. Um die Strukturen zu definieren, die an den Systemaufruf übergeben werden sollen, müssen Sie die Namen I<struct __user_cap_header_struct> und I<struct __user_cap_data_struct> verwenden, da die Typedefs nur Zeiger sind.

note: type: Plain text
en: Kernels prior to 2.6.25 prefer 32-bit capabilities with version B<_LINUX_CAPABILITY_VERSION_1>.  Linux 2.6.25 added 64-bit capability sets, with version B<_LINUX_CAPABILITY_VERSION_2>.  There was, however, an API glitch, and Linux 2.6.26 added B<_LINUX_CAPABILITY_VERSION_3> to fix the problem.
de: Kernel vor 2.6.25 bevorzugen 32-bit-Capabilities mit Version B<_LINUX_CAPABILITY_VERSION_1>. In Linux 2.6.25 wurden 64-bit-Capability-Sets hinzugefügt, mit Version B<_LINUX_CAPABILITY_VERSION_2>. Allerdings gab es einen API-Glitch, und Linux 2.6.26 fügte B<_LINUX_CAPABILITY_VERSION_3> hinzu, um das Problem zu beheben.

note: type: Plain text
en: Note that 64-bit capabilities use I<datap>[0] and I<datap>[1], whereas 32-bit capabilities use only I<datap>[0].
de: Beachten Sie, dass 64-Bit-Capabilities I<datap>[0] und I<datap>[1] verwenden, während 32-Bit-Capabilities nur I<datap>[0] verwenden.

note: type: Plain text
en: On kernels that support file capabilities (VFS capabilities support), these system calls behave slightly differently.  This support was added as an option in Linux 2.6.24, and became fixed (nonoptional) in Linux 2.6.33.
de: In Kerneln, die Datei-Capabilities unterstützen (VFS-Capabilities-Unterstützung), verhalten sich diese Systemaufrufe etwas anders. Diese Unterstützung wurde in Linux 2.6.24 hinzugefügt und wurde später in Linux 2.6.33 korrigiert (nicht-optional).

note: type: Plain text
en: For B<capget>()  calls, one can probe the capabilities of any process by specifying its process ID with the I<hdrp-E<gt>pid> field value.
de: Für B<capget>()-Aufrufe können die Capabilities eines Prozesses über die Angabe der Prozesskennung mit dem Feldwert I<hdrp-E<gt>pid> ermittelt werden.

note: type: Plain text
en: For details on the data, see B<capabilities>(7).
de: Für Details der Daten siehe B<capabilities>(7).

note: type: SS
en: With VFS capabilities support
de: Mit VFS-Capabilities-Unterstützung

note: type: Plain text
en: VFS capabilities employ a file extended attribute (see B<xattr>(7))  to allow capabilities to be attached to executables.  This privilege model obsoletes kernel support for one process asynchronously setting the capabilities of another.  That is, on kernels that have VFS capabilities support, when calling B<capset>(), the only permitted values for I<hdrp-E<gt>pid> are 0 or, equivalently, the value returned by B<gettid>(2).
de: VFS-Capabilities setzen ein erweitertes Dateiattribut ein (siehe B<xattr>(7)), um das Anhängen von Capabilities an Dateien zu erlauben. Dieses Privilegienmodell ersetzt die Kernel-Unterstützung dafür, dass ein Prozess asynchron die Capabilities eines anderen setzt. Das heißt, das auf Kerneln mit VFS-Capability-Unterstützung beim Aufruf von B<capset>() der einzige für I<hdrp-E<gt>pid> erlaubte Wert 0, oder äquivalent der von B<gettid>(2) zurückgelieferte Wert, ist.

note: type: SS
en: Without VFS capabilities support
de: Ohne VFS-Capabilities-Unterstützung

note: type: Plain text
en: On older kernels that do not provide VFS capabilities support B<capset>()  can, if the caller has the B<CAP_SETPCAP> capability, be used to change not only the caller's own capabilities, but also the capabilities of other threads.  The call operates on the capabilities of the thread specified by the I<pid> field of I<hdrp> when that is nonzero, or on the capabilities of the calling thread if I<pid> is 0.  If I<pid> refers to a single-threaded process, then I<pid> can be specified as a traditional process ID; operating on a thread of a multithreaded process requires a thread ID of the type returned by B<gettid>(2).  For B<capset>(), I<pid> can also be: -1, meaning perform the change on all threads except the caller and B<init>(1); or a value less than -1, in which case the change is applied to all members of the process group whose ID is -I<pid>.
de: Auf älteren Kerneln, die keine Unterstützung für VFS-Capabilities bieten, kann B<capset>(), falls der Aufrufende über die Capability B<CAP_SETPCAP> verfügt, nicht nur zum Ändern der Capabilities des Aufrufenden sondern auch der Capabilities anderer Threads verwandt werden. Dieser Aufruf greift auf die Capabilities des durch das I<pid>-Feld von I<hdrp> beschriebenen Threads zu, wenn das Feld von Null verschieden ist; wenn I<pid> gleich 0 ist, wird auf die Capabilities des aufrufenden Threads zugegriffen. Falls sich I<pid> auf einen single-threaded Prozess bezieht, kann I<pid> auch als herkömmliche Prozesskennung angegeben werden. Der Zugriff auf einen Thread eines Multithread-Prozesses erfordert eine Thread-Kennung vom Typ, den B<gettid>(2) zurückgibt. Für B<capset>() kann I<pid> auch -1 sein, d.h. die Änderung wird für alle Threads außer dem Aufrufenden und B<init>(1) durchgeführt; ein Wert kleiner als -1 bewirkt die Änderung für alle Mitglieder der Prozessgruppe, deren ID -I<pid> ist.

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

note: type: Plain text
en: On success, zero is returned.  On error, -1 is returned, and I<errno> is set appropriately.
de: Bei Erfolg wird Null zurückgegeben. Bei einem Fehler wird -1 zurückgegeben und I<errno> entsprechend gesetzt.

note: type: Plain text
en: The calls fail with the error B<EINVAL>, and set the I<version> field of I<hdrp> to the kernel preferred value of B<_LINUX_CAPABILITY_VERSION_?> when an unsupported I<version> value is specified.  In this way, one can probe what the current preferred capability revision is.
de: Die Aufrufe schlagen mit dem Fehler B<EINVAL> fehl und das Feld I<version> von I<hdrp> wird auf den vom Kernel bevorzugten Wert von B<_LINUX_CAPABILITY_VERSION_?> gesetzt, wenn ein nicht unterstützter I<version>-Wert angegeben wird. Auf diese Weise kann herausgefunden werden, wie die derzeit bevorzugte Capability-Revision lautet.

note: type: SH
en: ERRORS
de: FEHLER

note: type: Plain text
en: Bad memory address.  I<hdrp> must not be NULL.  I<datap> may be NULL only when the user is trying to determine the preferred capability version format supported by the kernel.
de: Ungültige Speicheradresse. I<hdrp> darf nicht NULL sein. I<datap> darf NULL nur sein, wenn der Benutzer versucht, das vom Kernel unterstützte bevorzugte Capability-Versionsformat zu ermitteln.

note: type: Plain text
en: One of the arguments was invalid.
de: Eines der Argumente war ungültig.

note: type: Plain text
en: An attempt was made to add a capability to the Permitted set, or to set a capability in the Effective or Inheritable sets that is not in the Permitted set.
de: Es wurde versucht, eine Capability zu der erlaubten Menge hinzuzufügen oder eine Capability in der effektiven oder vererbbaren Menge zu setzen, die nicht in der erlaubten Menge enthalten ist.

note: type: Plain text
en: The caller attempted to use B<capset>()  to modify the capabilities of a thread other than itself, but lacked sufficient privilege.  For kernels supporting VFS capabilities, this is never permitted.  For kernels lacking VFS support, the B<CAP_SETPCAP> capability is required.  (A bug in kernels before 2.6.11 meant that this error could also occur if a thread without this capability tried to change its own capabilities by specifying the I<pid> field as a nonzero value (i.e., the value returned by B<getpid>(2))  instead of 0.)
de: Der Aufrufende versuchte, B<capset>() zu verwenden, um die Capabilities eines von ihm selbst verschiedenen Threads zu verändern, hatte dazu aber nicht die benötigten Privilegien. Für Kernel, die VFS-Capabilities unterstützen, ist dies nie erlaubt. Für Kernel ohne VFS-Unterstützung wird die Capability B<CAP_SETPCAP> benötigt. (Ein Fehler in Kerneln vor 2.6.11 führte dazu, dass dieser Fehler auch auftreten konnte, falls ein Thread ohne diese Capability versuchte, seine eigenen Capabilities zu ändern, indem er das Feld I<pid> auf einen von numerisch Null verschiedenen Wert (d.h. den von B<getpid>(2) zurückgelieferten Wert) anstatt 0 wählte.)

note: type: Plain text
en: No such thread.
de: Kein solcher Thread.

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

note: type: Plain text
en: These system calls are Linux-specific.
de: Diese Systemaufrufe sind Linux-spezifisch.

note: type: SH
en: NOTES
de: ANMERKUNGEN

note: type: Plain text
en: The portable interface to the capability querying and setting functions is provided by the I<libcap> library and is available here:
de: Die portable Schnittstelle der Capability-Abfrage- und -Setzfunktionen wird durch die Bibliothek I<libcap> bereitgestellt, die unter folgender Adresse erhältlich ist:

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