VMS Help DCE_THREADS, Application Routines, pthread_signal_to_cancel_np  *Conan The Librarian (sorry for the slow response - running on an old VAX)

  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