annotate docs/nitros9guide/kill.refentry @ 1053:b5ff125a1d60

Since this book was only typeset in fixed width, single-font, they used capitalization and quotes (") to show what was commands, files and just text. With today's formatting, this is not necessary, so everywhere capitalization was used to show a command the <command> element is now used instead, and everywhere a file is mentioned the <filename> element is used.
author roug
date Thu, 20 Mar 2003 20:19:53 +0000
parents c565a4700689
children 4dae346c4969
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
138
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
1 <refentry id="kill">
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
2 <refnamediv>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
3 <refname>KILL</refname>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
4 <refpurpose>Abort a process</refpurpose>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
5 </refnamediv>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
6
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
7 <refsynopsisdiv>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
8 <cmdsynopsis>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
9 <command>KILL</command>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
10 <arg choice="plain">
975
c565a4700689 The entitity replstart was replaced with <replaceable>
roug
parents: 138
diff changeset
11 <replaceable>procID</replaceable>
138
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
12 </arg>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
13 </cmdsynopsis>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
14 </refsynopsisdiv>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
15
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
16 <refsect1><title>Description</title>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
17 <para>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
18 This shell &quot;built in&quot; command sends an &quot;abort&quot; signal to the
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
19 process having the process ID number specified. The process to be
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
20 aborted must have the same user ID as the user that executed the
1053
b5ff125a1d60 Since this book was only typeset in fixed width, single-font, they used
roug
parents: 975
diff changeset
21 command. The <command>procs</command> command can be used to obtain the process ID
138
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
22 numbers.
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
23 </para>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
24 <para>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
25 NOTE: If a process is waiting for I/O, it may not die until it
1053
b5ff125a1d60 Since this book was only typeset in fixed width, single-font, they used
roug
parents: 975
diff changeset
26 completes the current I/O operation, therefore, if you <command>kill</command> a
b5ff125a1d60 Since this book was only typeset in fixed width, single-font, they used
roug
parents: 975
diff changeset
27 process and the <command>procs</command> command shows it still exists, it is probably
138
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
28 waiting for receive a line of data from a terminal before it can
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
29 die.
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
30
1053
b5ff125a1d60 Since this book was only typeset in fixed width, single-font, they used
roug
parents: 975
diff changeset
31 Since this is a built-in <command>shell</command> command, it does not appear in the
138
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
32 CMDS directory.
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
33
1053
b5ff125a1d60 Since this book was only typeset in fixed width, single-font, they used
roug
parents: 975
diff changeset
34 For more information see: 4.5, 5.2, <command>procs</command>
138
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
35
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
36 </para>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
37 </refsect1>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
38 <refsect1><title>Examples</title>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
39 <screen>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
40
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
41 kill 5
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
42
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
43 kill 22
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
44
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
45 OS9: procs
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
46
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
47 User # Id pty state Mem Primary module
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
48 ----- --- --- -------- --- --------------
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
49 20 2 0 active 2 Shell &lt;TERM
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
50 20 1 0 waiting 1 Sysgo &lt;TERM
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
51 20 3 0 sleeping 20 Copy &lt;TERM
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
52
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
53 OS9: kill 3
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
54 OS9: procs
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
55
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
56 User # Id pty state Mem Primary module
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
57 ----- --- --- -------- --- --------------
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
58 20 2 0 active 2 Shell &lt;TERM
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
59 20 1 0 waiting 1 Sysgo &lt;TERM
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
60
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
61 OS9:
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
62 </screen>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
63 </refsect1>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
64 </refentry>
d9631713b7cd Split up the commands into individual files.
roug
parents:
diff changeset
65