.\" -*- coding: UTF-8 -*- '\" t .\" Copyright (c) 2009 Linux Foundation, written by Michael Kerrisk .\" .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH pthread_kill 3 "31. Oktober 2023" "Linux man\-pages 6.06" .SH BEZEICHNUNG pthread_kill \- Ein Signal an einen Thread senden .SH BIBLIOTHEK POSIX\-Threads\-Bibliothek (\fIlibpthread\fP, \fI\-lpthread\fP) .SH ÜBERSICHT .nf \fB#include \fP .P \fBint pthread_kill(pthread_t \fP\fIThread\fP\fB, int \fP\fISig\fP\fB);\fP .fi .P .RS -4 Mit Glibc erforderliche Feature\-Test\-Makros (siehe \fBfeature_test_macros\fP(7)): .RE .P \fBpthread_kill\fP(): .nf _POSIX_C_SOURCE >= 199506L || _XOPEN_SOURCE >= 500 .fi .SH BESCHREIBUNG Die Funktion \fBpthread_kill\fP() sendet das Signal \fISig\fP an \fIThread\fP, einem Thread im gleichen Prozess wie der aufrufende. Das Signal wird asynchron an den \fIThread\fP geleitet. .P Falls \fISig\fP 0 ist, dann wird kein Signal gesandt, aber die Fehlerprüfung wird weiterhin durchgeführt. .SH RÜCKGABEWERT Im Erfolgsfall liefert \fBpthread_kill\fP() 0 zurück; im Fehlerfall liefert es eine Fehlernummer zurück und es wird kein Signal gesandt. .SH FEHLER .TP \fBEINVAL\fP Es wurde ein ungültiges Signal angegeben. .SH ATTRIBUTE Siehe \fBattributes\fP(7) für eine Erläuterung der in diesem Abschnitt verwandten Ausdrücke. .TS allbox; lbx lb lb l l l. Schnittstelle Attribut Wert T{ .na .nh \fBpthread_kill\fP() T} Multithread\-Fähigkeit MT\-Sicher .TE .SH VERSIONEN Die Glibc\-Implementierung von \fBpthread_kill\fP() gibt bei Versuchen, eines der von der NPTL\-Thread\-Implementierung verwandten Echtzeitsignale zu senden, einen Fehler (\fBEINVAL\fP) zurück. Siehe \fBnptl\fP(7) für Details. .P POSIX.1\-2008 empfiehlt, dass \fBpthread_kill\fP() den Fehler \fBESRCH\fP zurückliefern soll, wenn eine Implementierung die Verwendung einer Thread\-Kennung nach dem Ende deren Lebensdauer erkennt. Die Glibc\-Implementierung liefert diesen Fehler in Fällen zurück, bei denen eine ungültige Thread\-Kennung erkannt werden kann. Beachten Sie aber auch, dass POSIX sagt, dass Versuche, eine Thread\-Kennung zu verwenden, deren Lebensdauer abgelaufen ist, zu undefiniertem Verhalten führt und dass ein Versuch, eine ungültige Thread\-Kennung in einem Aufruf von \fBpthread_kill\fP() beispielsweise zu einem Speicherzugriffsfehler führen kann. .SH STANDARDS POSIX.1\-2008. .SH GESCHICHTE POSIX.1\-2001. .SH ANMERKUNGEN Signalzuordnungen sind prozessweit: Falls ein Signal\-Handler installiert wird, wird der Handler im Thread \fIThread\fP aufgerufen, aber falls die Zuordnung des Signals »stop«, »continue« oder »terminate« ist, wird diese Aktion den gesamten Prozess betreffen. .SH "SIEHE AUCH" \fBkill\fP(2), \fBsigaction\fP(2), \fBsigpending\fP(2), \fBpthread_self\fP(3), \fBpthread_sigmask\fP(3), \fBraise\fP(3), \fBpthreads\fP(7), \fBsignal\fP(7) .PP .SH ÜBERSETZUNG Die deutsche Übersetzung dieser Handbuchseite wurde von Helge Kreutzmann erstellt. .PP Diese Übersetzung ist Freie Dokumentation; lesen Sie die .UR https://www.gnu.org/licenses/gpl-3.0.html GNU General Public License Version 3 .UE oder neuer bezüglich der Copyright-Bedingungen. Es wird KEINE HAFTUNG übernommen. .PP Wenn Sie Fehler in der Übersetzung dieser Handbuchseite finden, schicken Sie bitte eine E-Mail an die .MT debian-l10n-german@lists.debian.org Mailingliste der Übersetzer .ME .