pthread_kill(3) Library Functions Manual pthread_kill(3) BEZEICHNUNG pthread_kill - Ein Signal an einen Thread senden BIBLIOTHEK POSIX-Threads-Bibliothek (libpthread, -lpthread) UBERSICHT #include int pthread_kill(pthread_t Thread, int Sig); Mit Glibc erforderliche Feature-Test-Makros (siehe feature_test_macros(7)): pthread_kill(): _POSIX_C_SOURCE >= 199506L || _XOPEN_SOURCE >= 500 BESCHREIBUNG Die Funktion pthread_kill() sendet das Signal Sig an Thread, einem Thread im gleichen Prozess wie der aufrufende. Das Signal wird asynchron an den Thread geleitet. Falls Sig 0 ist, dann wird kein Signal gesandt, aber die Fehlerprufung wird weiterhin durchgefuhrt. RUCKGABEWERT Im Erfolgsfall liefert pthread_kill() 0 zuruck; im Fehlerfall liefert es eine Fehlernummer zuruck und es wird kein Signal gesandt. FEHLER EINVAL Es wurde ein ungultiges Signal angegeben. ATTRIBUTE Siehe attributes(7) fur eine Erlauterung der in diesem Abschnitt verwandten Ausdrucke. +--------------------------------+-------------------------+-----------+ |Schnittstelle | Attribut | Wert | +--------------------------------+-------------------------+-----------+ |pthread_kill() | Multithread-Fahigkeit | MT-Sicher | +--------------------------------+-------------------------+-----------+ VERSIONEN Die Glibc-Implementierung von pthread_kill() gibt bei Versuchen, eines der von der NPTL-Thread-Implementierung verwandten Echtzeitsignale zu senden, einen Fehler (EINVAL) zuruck. Siehe nptl(7) fur Details. POSIX.1-2008 empfiehlt, dass pthread_kill() den Fehler ESRCH zuruckliefern soll, wenn eine Implementierung die Verwendung einer Thread-Kennung nach dem Ende deren Lebensdauer erkennt. Die Glibc-Implementierung liefert diesen Fehler in Fallen zuruck, bei denen eine ungultige 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 fuhrt und dass ein Versuch, eine ungultige Thread-Kennung in einem Aufruf von pthread_kill() beispielsweise zu einem Speicherzugriffsfehler fuhren kann. STANDARDS POSIX.1-2008. GESCHICHTE POSIX.1-2001. ANMERKUNGEN Signalzuordnungen sind prozessweit: Falls ein Signal-Handler installiert wird, wird der Handler im Thread Thread aufgerufen, aber falls die Zuordnung des Signals >>stop<<, >>continue<< oder >>terminate<< ist, wird diese Aktion den gesamten Prozess betreffen. SIEHE AUCH kill(2), sigaction(2), sigpending(2), pthread_self(3), pthread_sigmask(3), raise(3), pthreads(7), signal(7) UBERSETZUNG Die deutsche Ubersetzung dieser Handbuchseite wurde von Helge Kreutzmann erstellt. Diese Ubersetzung ist Freie Dokumentation; lesen Sie die GNU General Public License Version 3 oder neuer bezuglich der Copyright-Bedingungen. Es wird KEINE HAFTUNG ubernommen. Wenn Sie Fehler in der Ubersetzung dieser Handbuchseite finden, schicken Sie bitte eine E-Mail an die Mailingliste der Ubersetzer . Linux man-pages 6.06 31. Oktober 2023 pthread_kill(3)