NAME

    pthread_signal_to_cancel_np - Cancels the specified thread

 SYNOPSIS

     #include <pthread.h>

     int pthread_signal_to_cancel_np( sigset_t  *sigset,
                                      pthread_t *thread );

 PARAMETERS

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

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

 DESCRIPTION

 The pthread_signal_to_cancel_np() 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 will return successfully but neither the speci-
 fied thread nor the previously specified thread will be 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 routine by your
 application or any library function will supercede 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 routine will not occur.

 RETURN VALUES

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

    Return   Error      Description
    _____________________________________________________________
     0                  Successful completion.

    -1      [EINVAL]    The value specified by thread is invalid.

 RELATED INFORMATION

     FUNCTIONS:  pthread_cancel