pthread_signal_to_cancel_np(3-thr)

pthread_signal_to_cancel_np(3-thr)       pthread_signal_to_cancel_np(3-thr)

NAME
     pthreadsignaltocancelnp - cancels the specified thread

SYNOPSIS
     #include <pthread.h>

     int pthreadsignaltocancelnp(
          sigsett *sigset,
          pthreadt *thread);

PARAMETERS
     sigset    Signal mask containing a list of signals that, when received
               by the process, cancels the specified thread.

     thread    The thread canceled if a valid signal is received by the
               process.

DESCRIPTION
     The pthreadsignaltocancelnp() routine requests that the specified
     thread be canceled if one of the signals specified in the signal mask
     is received by the process. The set of legal signals is the same as
     that for the sigwait() service. The sigset parameter is not validated.
     If it is invalid, this routine returns successfully but neither the
     specified thread nor the previously specified thread is canceled if a
     signal occurs.

     Note that the address of the specified thread is saved in a per-
     process global variable. Therefore, any subsequent call to this rou-
     tine by your application or any library function will supersede the
     thread specified in the previous call, and that thread will not be
     canceled if one of the signals specified for it is delivered to the
     process. In other words, take care when you call this routine; if
     another thread calls it after you do, the expected result of this rou-
     tine will not occur.

RETURN VALUES
     If the function fails, errno may be set to one of the following
     values:

     EINVAL    The value specified by thread is invalid.

SEE ALSO
     pthreadcancel(3-thr).












Page 1                       Reliant UNIX 5.44                Printed 11/98
Museum
