view docs/nitros9guide/kill.refentry @ 2772:0a3f4d8ea6d5

Found ENDC in wrong location in dwread.asm and dwwrite.asm. Corrected. Moved the native 6309 code in dwread.asm and dwwrite.asm into the H6309 labeled area and changed IFEQ H6309 to IFNE H6309. Also moved the 57600bps 6809 code to the default location. This change had been done in the old dwread.asm and dwwrite.asm files to make it easier to follow. Though these two files were overwritten from the HDBDOS project dwread.asm and dwwrite.asm files. So this conversion needed to be done again so it made the source easier to follow.
author drencor-xeen
date Wed, 23 Jan 2013 12:36:55 -0600
parents 4dae346c4969
children
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">
  <replaceable>procID</replaceable>
</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 <command>procs</command> 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 <command>kill</command> a
process and the <command>procs</command> 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 <command>shell</command> command, it does not appear in the
CMDS directory.

For more information see: <xref linkend="sec4.5"/>,
<xref linkend="sec5.2"/>, <command>procs</command>

</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>