Mercurial > hg > Members > kono > nitros9-code
view docs/ccguide/kill.refentry @ 2798:b70d93f8d7ce lwtools-port
Updated coco1/modules/makefile and coco3/modules/makefile to help resolve issues with i(x) and s(x) descriptors.
Updated level1/coco1/modules/makefile & level2/coco3/modules/makefile
so that correct values would be sent to assembler when
building superdesc.asm for s(x).dd and i(x).dd descriptors.
author | drencor-xeen |
---|---|
date | Mon, 28 Jan 2013 16:13:05 -0600 |
parents | 42b2c775f05f |
children |
line wrap: on
line source
<refentry id="kill"> <refnamediv> <refname>Kill</refname> <refpurpose>send an interrupt to a task</refpurpose> </refnamediv> <refsynopsisdiv> <funcsynopsis> <funcsynopsisinfo> #include <signal.h> </funcsynopsisinfo> <funcprototype> <funcdef><function>kill</function></funcdef> <paramdef>int <parameter>tid</parameter></paramdef> <paramdef>int <parameter>interrupt</parameter></paramdef> </funcprototype> </funcsynopsis> </refsynopsisdiv> <refsect1><title>Description</title> <para> Kill sends the interrupt type "interrupt" to the task with id "tid". </para> <para> Both tasks, sender and receiver, must have the same user id unless the user is the super user. </para> <para> The include file contains definitions of the defined signals as follows: <programlisting> /* OS-9 signals */ #define SIGKILL 0 /* system abort (cannot be caught or ignored)*/ #define SIGWAKE 1 /* wake up */ #define SIGQUIT 2 /* keyboard abort */ #define SIGINT 3 /* keyboard interrupt */ </programlisting> Other user-defined signals may, of course, be sent. </para> </refsect1> <refsect1><title>Diagnostics</title> <para> Kill returns 0 from a successful call and -1 if the task does not exist, the effective user ids do not match, or the user is not the system manager. </para> </refsect1> <refsect1><title>See Also</title> <para> <link linkend="signal">signal()</link>, OS-9 shell command "kill" </para> </refsect1> </refentry>