view docs/nitros9guide/kill.refentry @ 321:2c0ddf807efa

Made some changes
author boisy
date Tue, 23 Jul 2002 23:43:29 +0000
parents d9631713b7cd
children c565a4700689
line wrap: on
line source

<refentry id="kill">
<refnamediv>
<refname>KILL</refname>
<refpurpose>Abort a process</refpurpose>
</refnamediv>

<refsynopsisdiv>
<cmdsynopsis>
<command>KILL</command>
<arg choice="plain">
  &replstart;procID&replend;
</arg>
</cmdsynopsis>
</refsynopsisdiv>

<refsect1><title>Description</title>
<para>
This shell &quot;built in&quot; command sends an &quot;abort&quot; signal to the
process having the process ID number specified. The process to be
aborted must have the same user ID as the user that executed the
command. The &quot;procs&quot; command can be used to obtain the process ID
numbers.
</para>
<para>
NOTE: If a process is waiting for I/O, it may not die until it
completes the current I/O operation, therefore, if you KILL a
process and the PROCS command shows it still exists, it is probably
waiting for receive a line of data from a terminal before it can
die.

Since this is a built-in SHELL command, it does not appear in the
CMDS directory.

For more information see: 4.5, 5.2, PROCS

</para>
</refsect1>
<refsect1><title>Examples</title>
<screen>

kill 5

kill 22

OS9: procs

User # Id pty  state   Mem Primary module
----- --- --- -------- --- --------------
   20  2   0   active   2  Shell &lt;TERM
   20  1   0   waiting  1  Sysgo &lt;TERM
   20  3   0  sleeping 20  Copy &lt;TERM

OS9: kill 3
OS9: procs

User # Id pty  state   Mem Primary module
----- --- --- -------- --- --------------
   20  2   0   active   2  Shell &lt;TERM
   20  1   0   waiting  1  Sysgo &lt;TERM

OS9:
</screen>
</refsect1>
</refentry>