Add NSH kill command

git-svn-id: svn://svn.code.sf.net/p/nuttx/code/trunk@3322 42af7a65-404d-4744-a932-0658087f49c3

1 files changed, 102 insertions, 74 deletions

diff --git a/nuttx/Documentation/NuttShell.html b/nuttx/Documentation/NuttShell.html
index 74170efee..045117b08 100644
--- a/nuttx/Documentation/NuttShell.html
+++ b/nuttx/Documentation/NuttShell.html
@@ -8,7 +8,7 @@
   <tr align="center" bgcolor="#e4e4e4">
     <td>
       <h1><big><font color="#3c34ec"><i>NuttShell (NSH)</i></font></big></h1>
-      <p>Last Updated: July 06, 2010</p>
+      <p>Last Updated: February 27, 2011</p>
     </td>
   </tr>
 </table>
@@ -149,139 +149,145 @@
 <tr>
   <td><br></td>
   <td>
-    <a href="#cmdlosetup">2.12 Setup/teardown the Loop Device (losetup)</a>
+    <a href="#cmdkill">2.12 Send a signal to a task (kill)</a>
   </td>
 </tr>
 <tr>
   <td><br></td>
   <td>
-    <a href="#cmdls">2.13 List Directory Contents (ls)</a>
+    <a href="#cmdlosetup">2.13 Setup/teardown the Loop Device (losetup)</a>
   </td>
 </tr>
 <tr>
   <td><br></td>
   <td>
-    <a href="#cmdmbhw">2.14 Access Memory (mb, mh, and mw)</a>
+    <a href="#cmdls">2.14 List Directory Contents (ls)</a>
   </td>
 </tr>
 <tr>
   <td><br></td>
   <td>
-    <a href="#cmdmem">2.15 Show Memory Manager Status (mem)</a>
+    <a href="#cmdmbhw">2.15 Access Memory (mb, mh, and mw)</a>
   </td>
 </tr>
 <tr>
   <td><br></td>
   <td>
-    <a href="#cmdps">2.16 Show Current Tasks and Threads (ps)</a>
+    <a href="#cmdmem">2.16 Show Memory Manager Status (mem)</a>
   </td>
 </tr>
 <tr>
   <td><br></td>
   <td>
-    <a href="#cmdmkdir">2.17 Create a Directory (mkdir)</a>
+    <a href="#cmdps">2.17 Show Current Tasks and Threads (ps)</a>
   </td>
 </tr>
 <tr>
   <td><br></td>
   <td>
-    <a href="#cmdmkfatfs">2.18 Create a FAT Filesystem (mkfatfs)</a>
+    <a href="#cmdmkdir">2.18 Create a Directory (mkdir)</a>
   </td>
 </tr>
 <tr>
   <td><br></td>
   <td>
-    <a href="#cmdmkfifo">2.19 Create a FIFO (mkfifo)</a>
+    <a href="#cmdmkfatfs">2.19 Create a FAT Filesystem (mkfatfs)</a>
   </td>
 </tr>
 <tr>
   <td><br></td>
   <td>
-    <a href="#cmdmkrd">2.20 Create a RAMDISK (mkrd)</a>
+    <a href="#cmdmkfifo">2.20 Create a FIFO (mkfifo)</a>
   </td>
 </tr>
 <tr>
   <td><br></td>
   <td>
-    <a href="#cmdmount">2.21 Mount a File System (mount)</a>
+    <a href="#cmdmkrd">2.21 Create a RAMDISK (mkrd)</a>
   </td>
 </tr>
 <tr>
   <td><br></td>
   <td>
-    <a href="#cmdping">2.22 Check Network Peer (ping)</a>
+    <a href="#cmdmount">2.22 Mount a File System (mount)</a>
   </td>
 </tr>
 <tr>
   <td><br></td>
   <td>
-    <a href="#cmdput">2.23 Send File Via TFTP (put)</a>
+    <a href="#cmdping">2.23 Check Network Peer (ping)</a>
   </td>
 </tr>
 <tr>
   <td><br></td>
   <td>
-    <a href="#cmdpwd">2.24 Show Current Working Directory (pwd)</a>
+    <a href="#cmdput">2.24 Send File Via TFTP (put)</a>
   </td>
 </tr>
 <tr>
   <td><br></td>
   <td>
-    <a href="#cmdrm">2.25 Remove a File (rm)</a>
+    <a href="#cmdpwd">2.25 Show Current Working Directory (pwd)</a>
   </td>
 </tr>
 <tr>
   <td><br></td>
   <td>
-    <a href="#cmdrmdir">2.26 Remove a Directory (rmdir)</a>
+    <a href="#cmdrm">2.26 Remove a File (rm)</a>
   </td>
 </tr>
 <tr>
   <td><br></td>
   <td>
-    <a href="#cmdset">2.27 Set an Environment Variable (set)</a>
+    <a href="#cmdrmdir">2.27 Remove a Directory (rmdir)</a>
   </td>
 </tr>
 <tr>
   <td><br></td>
   <td>
-    <a href="#cmdsh">2.28 Execute an NSH Script (sh)</a>
+    <a href="#cmdset">2.28 Set an Environment Variable (set)</a>
   </td>
 </tr>
 <tr>
   <td><br></td>
   <td>
-    <a href="#cmdsleep">2.29 Wait for Seconds (sleep)</a>
+    <a href="#cmdsh">2.29 Execute an NSH Script (sh)</a>
   </td>
 </tr>
 <tr>
   <td><br></td>
   <td>
-    <a href="#cmdunmount">2.30 Unmount a File System (umount)</a>
+    <a href="#cmdsleep">2.30 Wait for Seconds (sleep)</a>
   </td>
 </tr>
 <tr>
   <td><br></td>
   <td>
-    <a href="#cmdunset">2.31 Unset an Environment Variable (unset)</a>
+    <a href="#cmdunmount">2.31 Unmount a File System (umount)</a>
   </td>
 </tr>
 <tr>
   <td><br></td>
   <td>
-    <a href="#cmdusleep">2.32 Wait for Microseconds (usleep)</a>
+    <a href="#cmdunset">2.32 Unset an Environment Variable (unset)</a>
   </td>
 </tr>
 <tr>
   <td><br></td>
   <td>
-    <a href="#cmdwget">2.33 Get File Via HTTP (wget)</a>
+    <a href="#cmdusleep">2.33 Wait for Microseconds (usleep)</a>
   </td>
 </tr>
 <tr>
   <td><br></td>
   <td>
-    <a href="#cmdxd">2.34 Hexadecimal Dump (xd)</a>
+    <a href="#cmdwget">2.34 Get File Via HTTP (wget)</a>
+  </td>
+</tr>
+<tr>
+  <td><br></td>
+  <td>
+    <a href="#cmdxd">2.35 Hexadecimal Dump (xd)</a>
   </td>
 </tr>
 <tr>
@@ -682,7 +688,7 @@ test &lt;expression&gt;
   </tr>
 </table>
 
-<a <p><b>Command Syntax:</b></p>
+<p><b>Command Syntax:</b></p>
 <ul><pre>
 cat <code>&lt;path&gt;</code> [<code>&lt;path&gt;</code> [<code>&lt;path&gt;</code> ...]]
 </pre></ul>
@@ -700,7 +706,7 @@ cat <code>&lt;path&gt;</code> [<code>&lt;path&gt;</code> [<code>&lt;path&gt;</co
   </tr>
 </table>
 
-<a <p><b>Command Syntax:</b></p>
+<p><b>Command Syntax:</b></p>
 <ul><pre>
 cd [&lt;dir-path&gt;|-|~|..]
 </pre></ul>
@@ -742,7 +748,7 @@ cd [&lt;dir-path&gt;|-|~|..]
   </tr>
 </table>
 
-<a <p><b>Command Syntax:</b></p>
+<p><b>Command Syntax:</b></p>
 <ul><pre>
 cp &lt;source-path&gt; &lt;dest-path&gt;
 </pre></ul>
@@ -760,7 +766,7 @@ cp &lt;source-path&gt; &lt;dest-path&gt;
   </tr>
 </table>
 
-<a <p><b>Command Syntax:</b></p>
+<p><b>Command Syntax:</b></p>
 <ul><pre>
 dd if=&lt;infile&gt; of=&lt;outfile&gt; [bs=&lt;sectsize&gt;] [count=&lt;sectors&gt;] [skip=&lt;sectors&gt;]
 </pre></ul>
@@ -819,7 +825,7 @@ nsh&gt; dd if=/dev/ram0 of=/dev/null
   </tr>
 </table>
 
-<a <p><b>Command Syntax:</b></p>
+<p><b>Command Syntax:</b></p>
 <ul><pre>
 echo [&lt;string|$name&gt; [&lt;string|$name&gt;...]]
 </pre></ul>
@@ -856,7 +862,7 @@ exec &lt;hex-address&gt;
   </tr>
 </table>
 
-<a <p><b>Command Syntax:</b></p>
+<p><b>Command Syntax:</b></p>
 <ul><pre>
 get [-b|-n] [-f &lt;local-path&gt;] -h &lt;ip-address&gt; &lt;remote-path&gt;
 </pre></ul>
@@ -891,7 +897,7 @@ get [-b|-n] [-f &lt;local-path&gt;] -h &lt;ip-address&gt; &lt;remote-path&gt;
   </tr>
 </table>
 
-<a <p><b>Command Syntax:</b></p>
+<p><b>Command Syntax:</b></p>
 <ul><pre>
 exit
 </pre></ul>
@@ -910,7 +916,7 @@ exit
   </tr>
 </table>
 
-<a <p><b>Command Syntax:</b></p>
+<p><b>Command Syntax:</b></p>
 <ul><pre>
 help
 </pre></ul>
@@ -927,7 +933,7 @@ help
   </tr>
 </table>
 
-<a <p><b>Command Syntax:</b></p>
+<p><b>Command Syntax:</b></p>
 <ul><pre>
 ifconfig
 </pre></ul>
@@ -948,12 +954,28 @@ eth0    HWaddr 00:18:11:80:10:06
 <table width ="100%">
   <tr bgcolor="#e4e4e4">
   <td>
-    <a name="cmdlosetup"><h2>2.12 Setup/teardown the Loop Device (losetup)</h2></a>
+    <a name="cmdkill"><h2>2.12 Send a signal to a task (kill)</h2></a>
+  </td>
+  </tr>
+</table>
+
+<ul><pre>
+kill -&lt;signal&gt; &lt;pid&gt;
+</pre></ul>
+<p>
+  <b>Synopsis</b>.
+  Send the <signal> to the task identified by <pid>.
+</p>
+
+<table width ="100%">
+  <tr bgcolor="#e4e4e4">
+  <td>
+    <a name="cmdlosetup"><h2>2.13 Setup/teardown the Loop Device (losetup)</h2></a>
   </td>
   </tr>
 </table>
 
-<a <p><b>Command Syntax 1:</b></p>
+<p><b>Command Syntax 1:</b></p>
 <ul><pre>
 losetup [-o <offset>] [-r] &lt;dev-path&gt; &lt;file-path&gt;
 </pre></ul>
@@ -989,7 +1011,7 @@ nsh&gt;
 </pre></ul>
 </p>
 
-<a <p><b>Command Syntax 2:</b></p>
+<p><b>Command Syntax 2:</b></p>
 <ul><pre>
 losetup d &lt;dev-path&gt;
 </pre></ul>
@@ -1001,12 +1023,12 @@ losetup d &lt;dev-path&gt;
 <table width ="100%">
   <tr bgcolor="#e4e4e4">
   <td>
-    <a name="cmdls"><h2>2.13 List Directory Contents (ls)</h2></a>
+    <a name="cmdls"><h2>2.14 List Directory Contents (ls)</h2></a>
   </td>
   </tr>
 </table>
 
-<a <p><b>Command Syntax:</b></p>
+<p><b>Command Syntax:</b></p>
 <ul><pre>
 ls [-lRs] &lt;dir-path&gt;
 </pre></ul>
@@ -1038,7 +1060,7 @@ ls [-lRs] &lt;dir-path&gt;
 <table width ="100%">
   <tr bgcolor="#e4e4e4">
   <td>
-    <a name="cmdmbhw"><h2>2.14 Access Memory (mb, mh, and mw)</h2></a>
+    <a name="cmdmbhw"><h2>2.15 Access Memory (mb, mh, and mw)</h2></a>
   </td>
   </tr>
 </table>
@@ -1092,12 +1114,12 @@ nsh&gt;
 <table width ="100%">
   <tr bgcolor="#e4e4e4">
   <td>
-    <a name="cmdmem"><h2>2.15 Show Memory Manager Status (mem)</h2></a>
+    <a name="cmdmem"><h2>2.16 Show Memory Manager Status (mem)</h2></a>
   </td>
   </tr>
 </table>
 
-<a <p><b>Command Syntax:</b></p>
+<p><b>Command Syntax:</b></p>
 <ul><pre>
 mem
 </pre></ul>
@@ -1141,12 +1163,12 @@ nsh&gt;
 <table width ="100%">
   <tr bgcolor="#e4e4e4">
   <td>
-    <a name="cmdps"><h2>2.16 Show Current Tasks and Threads (ps)</h2></a>
+    <a name="cmdps"><h2>2.17 Show Current Tasks and Threads (ps)</h2></a>
   </td>
   </tr>
 </table>
 
-<a <p><b>Command Syntax:</b></p>
+<p><b>Command Syntax:</b></p>
 <ul><pre>
 ps
 </pre></ul>
@@ -1167,7 +1189,7 @@ nsh&gt;
 <table width ="100%">
   <tr bgcolor="#e4e4e4">
   <td>
-    <a name="cmdmkdir"><h2>2.17 Create a Directory (mkdir)</h2></a>
+    <a name="cmdmkdir"><h2>2.18 Create a Directory (mkdir)</h2></a>
   </td>
 </tr>
 </table>
@@ -1202,7 +1224,7 @@ nsh>
 <table width ="100%">
   <tr bgcolor="#e4e4e4">
   <td>
-    <a name="cmdmkfatfs"><h2>2.18 Create a FAT Filesystem (mkfatfs)</h2></a>
+    <a name="cmdmkfatfs"><h2>2.19 Create a FAT Filesystem (mkfatfs)</h2></a>
   </td>
 </tr>
 </table>
@@ -1222,7 +1244,7 @@ mkfatfs &lt;path&gt;
 <table width ="100%">
   <tr bgcolor="#e4e4e4">
   <td>
-    <a name="cmdmkfifo"><h2>2.19 Create a FIFO (mkfifo)</h2></a>
+    <a name="cmdmkfifo"><h2>2.20 Create a FIFO (mkfifo)</h2></a>
   </td>
 </tr>
 </table>
@@ -1260,7 +1282,7 @@ nsh>
 <table width ="100%">
   <tr bgcolor="#e4e4e4">
   <td>
-    <a name="cmdmkrd"><h2>2.20 Create a RAMDISK (mkrd)</h2></a>
+    <a name="cmdmkrd"><h2>2.21 Create a RAMDISK (mkrd)</h2></a>
   </td>
 </tr>
 </table>
@@ -1311,7 +1333,7 @@ nsh&gt;
 <table width ="100%">
   <tr bgcolor="#e4e4e4">
   <td>
-    <a name="cmdmount"><h2>2.21 Mount a File System (mount)</h2></a>
+    <a name="cmdmount"><h2>2.22 Mount a File System (mount)</h2></a>
   </td>
 </tr>
 </table>
@@ -1378,12 +1400,12 @@ nsh>
 <table width ="100%">
   <tr bgcolor="#e4e4e4">
   <td>
-    <a name="cmdping"><h2>2.22 Check Network Peer (ping)</h2></a>
+    <a name="cmdping"><h2>2.23 Check Network Peer (ping)</h2></a>
   </td>
   </tr>
 </table>
 
-<a <p><b>Command Syntax:</b></p>
+<p><b>Command Syntax:</b></p>
 <ul><pre>
 ping [-c &lt;count&gt;] [-i &lt;interval&gt;] &lt;ip-address&gt;
 </pre></ul>
@@ -1411,12 +1433,12 @@ nsh&gt;
 <table width ="100%">
   <tr bgcolor="#e4e4e4">
   <td>
-    <a name="cmdput"><h2>2.23 Send File Via TFTP (put)</h2></a>
+    <a name="cmdput"><h2>2.24 Send File Via TFTP (put)</h2></a>
   </td>
   </tr>
 </table>
 
-<a <p><b>Command Syntax:</b></p>
+<p><b>Command Syntax:</b></p>
 <ul><pre>
 put [-b|-n] [-f &lt;remote-path&gt;] -h &lt;ip-address&gt; &lt;local-path&gt;
 </pre></ul>
@@ -1446,12 +1468,12 @@ put [-b|-n] [-f &lt;remote-path&gt;] -h &lt;ip-address&gt; &lt;local-path&gt;
 <table width ="100%">
   <tr bgcolor="#e4e4e4">
   <td>
-    <a name="cmdpwd"><h2>2.24 Show Current Working Directory (pwd)</h2></a>
+    <a name="cmdpwd"><h2>2.25 Show Current Working Directory (pwd)</h2></a>
   </td>
   </tr>
 </table>
 
-<a <p><b>Command Syntax:</b></p>
+<p><b>Command Syntax:</b></p>
 <ul><pre>
 pwd
 </pre></ul>
@@ -1476,12 +1498,12 @@ nsh&gt;
 <table width ="100%">
   <tr bgcolor="#e4e4e4">
   <td>
-    <a name="cmdrm"><h2>2.25 Remove a File (rm)</h2></a>
+    <a name="cmdrm"><h2>2.26 Remove a File (rm)</h2></a>
   </td>
 </tr>
 </table>
 
-<a <p><b>Command Syntax:</b></p>
+<p><b>Command Syntax:</b></p>
 <ul><pre>
 rm &lt;file-path&gt;
 </pre></ul>
@@ -1510,12 +1532,12 @@ nsh>
 <table width ="100%">
   <tr bgcolor="#e4e4e4">
   <td>
-    <a name="cmdrmdir"><h2>2.26 Remove a Directory (rmdir)</h2></a>
+    <a name="cmdrmdir"><h2>2.27 Remove a Directory (rmdir)</h2></a>
   </td>
 </tr>
 </table>
 
-<a <p><b>Command Syntax:</b></p>
+<p><b>Command Syntax:</b></p>
 <ul><pre>
 rmdir &lt;dir-path&gt;
 </pre></ul>
@@ -1545,12 +1567,12 @@ nsh>
 <table width ="100%">
   <tr bgcolor="#e4e4e4">
   <td>
-    <a name="cmdset"><h2>2.27 Set an Environment Variable (set)</h2></a>
+    <a name="cmdset"><h2>2.28 Set an Environment Variable (set)</h2></a>
   </td>
   </tr>
 </table>
 
-<a <p><b>Command Syntax:</b></p>
+<p><b>Command Syntax:</b></p>
 <ul><pre>
 set &lt;name&gt; &lt;value&gt;
 </pre></ul>
@@ -1571,12 +1593,12 @@ nsh&gt;
 <table width ="100%">
   <tr bgcolor="#e4e4e4">
   <td>
-    <a name="cmdsh"><h2>2.28 Execute an NSH Script (sh)</h2></a>
+    <a name="cmdsh"><h2>2.29 Execute an NSH Script (sh)</h2></a>
   </td>
   </tr>
 </table>
 
-<a <p><b>Command Syntax:</b></p>
+<p><b>Command Syntax:</b></p>
 <ul><pre>
 sh &lt;script-path&gt;
 </pre></ul>
@@ -1589,12 +1611,12 @@ sh &lt;script-path&gt;
 <table width ="100%">
   <tr bgcolor="#e4e4e4">
   <td>
-    <a name="cmdsleep"><h2>2.29 Wait for Seconds (sleep)</h2></a>
+    <a name="cmdsleep"><h2>2.30 Wait for Seconds (sleep)</h2></a>
   </td>
   </tr>
 </table>
 
-<a <p><b>Command Syntax:</b></p>
+<p><b>Command Syntax:</b></p>
 <ul><pre>
 sleep &lt;sec&gt;
 </pre></ul>
@@ -1606,12 +1628,12 @@ sleep &lt;sec&gt;
 <table width ="100%">
   <tr bgcolor="#e4e4e4">
   <td>
-    <a name="cmdunmount"><h2>2.30 Unmount a File System (umount)</h2></a>
+    <a name="cmdunmount"><h2>2.31 Unmount a File System (umount)</h2></a>
   </td>
 </tr>
 </table>
 
-<a <p><b>Command Syntax:</b></p>
+<p><b>Command Syntax:</b></p>
 <ul><pre>
 umount &lt;dir-path&gt;
 </pre></ul>
@@ -1636,12 +1658,12 @@ nsh>
 <table width ="100%">
   <tr bgcolor="#e4e4e4">
   <td>
-    <a name="cmdunset"><h2>2.31 Unset an Environment Variable (unset)</h2></a>
+    <a name="cmdunset"><h2>2.32 Unset an Environment Variable (unset)</h2></a>
   </td>
   </tr>
 </table>
 
-<a <p><b>Command Syntax:</b></p>
+<p><b>Command Syntax:</b></p>
 <ul><pre>
 unset &lt;name&gt;
 </pre></ul>
@@ -1662,12 +1684,12 @@ nsh&gt;
 <table width ="100%">
   <tr bgcolor="#e4e4e4">
   <td>
-    <a name="cmdusleep"><h2>2.32 Wait for Microseconds (usleep)</h2></a>
+    <a name="cmdusleep"><h2>2.33 Wait for Microseconds (usleep)</h2></a>
   </td>
   </tr>
 </table>
 
-<a <p><b>Command Syntax:</b></p>
+<p><b>Command Syntax:</b></p>
 <ul><pre>
 usleep &lt;usec&gt;
 </pre></ul>
@@ -1679,12 +1701,12 @@ usleep &lt;usec&gt;
 <table width ="100%">
   <tr bgcolor="#e4e4e4">
   <td>
-    <a name="cmdwget">2.33 Get File Via HTTP (wget)</a>
+    <a name="cmdwget">2.34 Get File Via HTTP (wget)</a>
   </td>
   </tr>
 </table>
 
-<a <p><b>Command Syntax:</b></p>
+<p><b>Command Syntax:</b></p>
 <ul><pre>
 wget [-o &lt;local-path&gt;] &lt;url&gt;
 </pre></ul>
@@ -1706,12 +1728,12 @@ wget [-o &lt;local-path&gt;] &lt;url&gt;
 <table width ="100%">
   <tr bgcolor="#e4e4e4">
   <td>
-    <a name="cmdxd"><h2>2.34 Hexadecimal dump (xd)</h2></a>
+    <a name="cmdxd"><h2>2.35 Hexadecimal dump (xd)</h2></a>
   </td>
   </tr>
 </table>
 
-<a <p><b>Command Syntax:</b></p>
+<p><b>Command Syntax:</b></p>
 <ul><pre>
 xd &lt;hex-address&gt; &lt;byte-count&gt;
 </pre></ul>
@@ -1826,6 +1848,11 @@ nsh>
     <td><code>CONFIG_EXAMPLES_NSH_DISABLE_IFCONFIG</code></td>
   </tr>
   <tr>
+    <td><b><code>kill</code></b></td>
+    <td>!<code>CONFIG_DISABLE_SIGNALS</code></td>
+    <td><code>CONFIG_EXAMPLES_NSH_DISABLE_KILL</code></td>
+  </tr>
+  <tr>
     <td><b><code>losetup</code></b></td>
     <td>!<code>CONFIG_DISABLE_MOUNTPOINT</code> &amp;&amp; <code>CONFIG_NFILE_DESCRIPTORS</code> &gt; 0</td>
     <td><code>CONFIG_EXAMPLES_NSH_DISABLE_LOSETUP</code></td>
@@ -2331,6 +2358,7 @@ nsh>
   <li><a href="#cmdhelp"><code>help</code></a></li>
   <li><a href="#conditional"><code>if-then[-else]-fi</code></a></li>
   <li><a href="#cmdifconfig"><code>ifconfig</code></a></li>
+  <li><a href="#cmdkill"><code>kill</code></a></li>
   <li><a href="#cmdlosetup"><code>losetup</code></a></li>
   <li><a href="#cmdls">ls</code></a></li>
   <li><a href="#cmdmbhw"><code>mb</code></a></li>