pthread_setasynccancel(3-thr) — Reliant UNIX 5.44c4

pthread_setasynccancel(3-thr)                 pthread_setasynccancel(3-thr)

NAME
     pthreadsetasynccancel - Asynchrone Abbruchmöglichkeit des aktuellen
     Thread aktivieren/deaktivieren

SYNTAX
     #include <pthread.h>

     int pthreadsetasynccancel(int state);

PARAMETER
     state     Der Status der asynchronen Abbruchmöglichkeit, der für den
               aufrufenden Thread gesetzt ist. Bei Rückkehr der Routine
               wird der vorherige Status für die asynchrone Abbruchmöglich-
               keit ausgegeben. Gültige Werte sind:

               CANCELON    Die asynchrone Abbruchmöglichkeit ist aktiviert.

               CANCELOFF   Die asynchrone Abbruchmöglichkeit ist deakti-
                            viert.

BESCHREIBUNG
     Die Routine pthreadsetasynccancel() aktiviert bzw. deaktiviert die
     asynchrone Abbruchmöglichkeit des aktuellen Thread und gibt den vor-
     herigen Status für die asynchrone Abbruchmöglichkeit zurück.

     Wenn die allgemeine Abbruchmöglichkeit auf CANCELOFF gesetzt ist,
     kann eine Abbruchanforderung nicht an den Thread übergeben werden,
     auch dann nicht, wenn eine abbruchfähige Routine aufgerufen oder die
     asynchrone Abbruchmöglichkeit aktiviert wird. Wenn die allgemeine
     Abbruchmöglichkeit auf CANCELON gesetzt ist, hängt die Möglichkeit
     eines Abbruchs vom Status der asynchronen Abbruchmöglichkeit ab, der
     für den Thread gesetzt ist.

     Wenn die allgemeine Abbruchmöglichkeit auf CANCELON und die asyn-
     chrone Abbruchmöglichkeit auf CANCELOFF gesetzt ist, kann der Thread
     eine Abbruchanforderung nur an bestimmten Abbruchpunkten empfangen
     (zum Beispiel bei bedingtem Warten, Thread-Verknüpfungen und bei Auf-
     rufen der Routine pthreadtestcancel()). Wenn sowohl die allgemeine
     als auch die asynchrone Abbruchmöglichkeit auf CANCELON gesetzt sind,
     kann der Thread an jedem Punkt während seiner Ausführung abgebrochen
     werden.

     Bei der Erstellung eines Thread wird der Status der asynchronen
     Abbruchmöglichkeit auf CANCELOFF gesetzt.

     Wenn Sie diese Routine zum Aktivieren asynchroner Abbrüche aufrufen,
     rufen Sie sie in einem Codebereich auf, in dem die asynchrone Ausgabe
     von Abbruchanforderungen durch einen vorherigen Aufruf dieser Routine
     deaktiviert worden ist. Rufen Sie Thread-Routinen nicht in Codeberei-
     chen auf, in denen die asynchrone Ausgabe von Abbruchanforderungen
     aktiviert ist. Der vorherige Status kann später durch einen erneuten
     Aufruf dieser Routine wiederhergestellt werden.



Seite 1                      Reliant UNIX 5.44               Gedruckt 11/98

pthread_setasynccancel(3-thr)                 pthread_setasynccancel(3-thr)

RÜCKGABEWERTE
     Bei erfolgreicher Ausführung wird der vorherige Status der asynchronen
     Abbruchmöglichkeit zurückgegeben. Wenn die Funktion fehlschlägt, wird
     -1 zurückgegeben. Im folgenden werden die möglichen Rückgabewerte und
     die entsprechenden Werte (falls vorhanden) für errno aufgeführt:

     CANCELON    Die asynchrone Abbruchmöglichkeit war aktiviert.

     CANCELOFF   Die asynchrone Abbruchmöglichkeit war deaktiviert.

     EINVAL       Der angegebene Status ist weder CANCELON noch
                  CANCELOFF.

SIEHE AUCH
     pthreadcancel(3-thr), pthreadsetcancel(3-thr),
     pthreadtestcancel(3-thr).






































Seite 2                      Reliant UNIX 5.44               Gedruckt 11/98

Museum