|
466
|
1 <refentry id="kill">
|
|
|
2 <refnamediv>
|
|
468
|
3 <refname>Kill</refname>
|
|
|
4 <refpurpose>send an interrupt to a task</refpurpose>
|
|
466
|
5 </refnamediv>
|
|
|
6
|
|
|
7 <refsynopsisdiv>
|
|
|
8 <funcsynopsis>
|
|
468
|
9 <funcsynopsisinfo>
|
|
|
10 #include <signal.h>
|
|
|
11 </funcsynopsisinfo>
|
|
466
|
12 <funcprototype>
|
|
|
13 <funcdef><function>kill</function></funcdef>
|
|
570
|
14 <paramdef>int <parameter>tid</parameter></paramdef>
|
|
|
15 <paramdef>int <parameter>interrupt</parameter></paramdef>
|
|
466
|
16 </funcprototype>
|
|
|
17 </funcsynopsis>
|
|
|
18
|
|
|
19 </refsynopsisdiv>
|
|
|
20
|
|
|
21 <refsect1><title>Description</title>
|
|
|
22 <para>
|
|
602
|
23 Kill sends the interrupt type "interrupt" to the task with id
|
|
|
24 "tid".
|
|
|
25 </para>
|
|
|
26 <para>
|
|
|
27 Both tasks, sender and receiver, must have the same user id
|
|
|
28 unless the user is the super user.
|
|
|
29 </para>
|
|
|
30 <para>
|
|
|
31 The include file contains definitions of the defined signals as
|
|
|
32 follows:
|
|
|
33 <programlisting>
|
|
|
34 /* OS-9 signals */
|
|
|
35 #define SIGKILL 0 /* system abort (cannot be caught or ignored)*/
|
|
|
36 #define SIGWAKE 1 /* wake up */
|
|
|
37 #define SIGQUIT 2 /* keyboard abort */
|
|
|
38 #define SIGINT 3 /* keyboard interrupt */
|
|
|
39 </programlisting>
|
|
|
40 Other user-defined signals may, of course, be sent.
|
|
466
|
41 </para>
|
|
|
42 </refsect1>
|
|
542
|
43
|
|
552
|
44 <refsect1><title>Diagnostics</title>
|
|
|
45 <para>
|
|
|
46 Kill returns 0 from a successful call and -1 if the task does
|
|
|
47 not exist, the effective user ids do not match, or the user is
|
|
|
48 not the system manager.
|
|
|
49 </para>
|
|
|
50 </refsect1>
|
|
|
51
|
|
542
|
52 <refsect1><title>See Also</title>
|
|
|
53 <para>
|
|
|
54 <link linkend="signal">signal()</link>,
|
|
|
55 OS-9 shell command "kill"
|
|
|
56 </para>
|
|
|
57 </refsect1>
|
|
|
58
|
|
466
|
59 </refentry>
|
