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@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 * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, 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
pthread_kill(pthread_t thread,int sig)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