Home | History | Annotate | Download | only in pthreads-win32
      1 /*
      2  * pthread_kill.c
      3  *
      4  * Description:
      5  * This translation unit implements the pthread_kill routine.
      6  *
      7  * --------------------------------------------------------------------------
      8  *
      9  *      Pthreads-win32 - POSIX Threads Library for Win32
     10  *      Copyright(C) 1998 John E. Bossom
     11  *      Copyright(C) 1999,2005 Pthreads-win32 contributors
     12  *
     13  *      Contact Email: rpj (at) callisto.canberra.edu.au
     14  *
     15  *      The current list of contributors is contained
     16  *      in the file CONTRIBUTORS included with the source
     17  *      code distribution. The list can also be seen at the
     18  *      following World Wide Web location:
     19  *      http://sources.redhat.com/pthreads-win32/contributors.html
     20  *
     21  *      This library is free software; you can redistribute it and/or
     22  *      modify it under the terms of the GNU Lesser General Public
     23  *      License as published by the Free Software Foundation; either
     24  *      version 2 of the License, or (at your option) any later version.
     25  *
     26  *      This library is distributed in the hope that it will be useful,
     27  *      but WITHOUT ANY WARRANTY; without even the implied warranty of
     28  *      MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
     29  *      Lesser General Public License for more details.
     30  *
     31  *      You should have received a copy of the GNU Lesser General Public
     32  *      License along with this library in the file COPYING.LIB;
     33  *      if not, write to the Free Software Foundation, Inc.,
     34  *      59 Temple Place - Suite 330, Boston, MA 02111-1307, USA
     35  */
     36 
     37 #include "pthread.h"
     38 #include "implement.h"
     39 
     40 /*
     41  * Not needed yet, but defining it should indicate clashes with build target
     42  * environment that should be fixed.
     43  */
     44 #if !defined(WINCE)
     45 #  include <signal.h>
     46 #endif
     47 
     48 int
     49 pthread_kill (pthread_t thread, int sig)
     50      /*
     51       * ------------------------------------------------------
     52       * DOCPUBLIC
     53       *      This function requests that a signal be delivered to the
     54       *      specified thread. If sig is zero, error checking is
     55       *      performed but no signal is actually sent such that this
     56       *      function can be used to check for a valid thread ID.
     57       *
     58       * PARAMETERS
     59       *      thread  reference to an instances of pthread_t
     60       *      sig     signal. Currently only a value of 0 is supported.
     61       *
     62       *
     63       * DESCRIPTION
     64       *      This function requests that a signal be delivered to the
     65       *      specified thread. If sig is zero, error checking is
     66       *      performed but no signal is actually sent such that this
     67       *      function can be used to check for a valid thread ID.
     68       *
     69       * RESULTS
     70       *              ESRCH           the thread is not a valid thread ID,
     71       *              EINVAL          the value of the signal is invalid
     72       *                              or unsupported.
     73       *              0               the signal was successfully sent.
     74       *
     75       * ------------------------------------------------------
     76       */
     77 {
     78   int result = 0;
     79   ptw32_thread_t * tp;
     80   ptw32_mcs_local_node_t node;
     81 
     82   ptw32_mcs_lock_acquire(&ptw32_thread_reuse_lock, &node);
     83 
     84   tp = (ptw32_thread_t *) thread.p;
     85 
     86   if (NULL == tp
     87       || thread.x != tp->ptHandle.x
     88       || NULL == tp->threadH)
     89     {
     90       result = ESRCH;
     91     }
     92 
     93   ptw32_mcs_lock_release(&node);
     94 
     95   if (0 == result && 0 != sig)
     96     {
     97       /*
     98        * Currently does not support any signals.
     99        */
    100       result = EINVAL;
    101     }
    102 
    103   return result;
    104 
    105 }				/* pthread_kill */
    106