BEZEICHNUNG

       pthread_kill - Ein Signal an einen Thread senden

BIBLIOTHEK

       POSIX-Threads-Bibliothek (libpthread, -lpthread)

ÜBERSICHT

       #include <signal.h>

       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 Fehlerprüfung wird weiterhin durchgeführt.

RÜCKGABEWERT

       Im Erfolgsfall liefert pthread_kill() 0 zurück; im Fehlerfall liefert es eine Fehlernummer zurück und  es
       wird kein Signal gesandt.

FEHLER

       EINVAL Es wurde ein ungültiges Signal angegeben.

ATTRIBUTE

       Siehe attributes(7) für eine Erläuterung der in diesem Abschnitt verwandten Ausdrücke.
       ┌───────────────────────────────────────────────────────────────────┬───────────────────────┬───────────┐
       │ Schnittstelle                                                     │ Attribut              │ Wert      │
       ├───────────────────────────────────────────────────────────────────┼───────────────────────┼───────────┤
       │ pthread_kill()                                                    │ Multithread-Fähigkeit │ 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)  zurück.  Siehe
       nptl(7) für Details.

       POSIX.1-2008   empfiehlt,   dass   pthread_kill()   den   Fehler  ESRCH  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    pthread_kill()    beispielsweise    zu    einem
       Speicherzugriffsfehler führen 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)

ÜBERSETZUNG

       Die deutsche Übersetzung dieser Handbuchseite wurde von Helge Kreutzmann <debian@helgefjell.de> erstellt.

       Diese  Übersetzung ist Freie Dokumentation; lesen Sie die GNU General Public License Version 3 oder neuer
       bezüglich der Copyright-Bedingungen. Es wird KEINE HAFTUNG übernommen.

       Wenn Sie Fehler in der Übersetzung dieser Handbuchseite finden, schicken Sie bitte  eine  E-Mail  an  die
       Mailingliste der Übersetzer: debian-l10n-german@lists.debian.org.

Linux man-pages 6.9.1                              2. Mai 2024                                   pthread_kill(3)