a00107.html 12 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268
  1. <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
  2. <html><head><meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1">
  3. <title>uIP 1.0: apps/telnetd/shell.h File Reference</title>
  4. <link href="doxygen.css" rel="stylesheet" type="text/css">
  5. <link href="tabs.css" rel="stylesheet" type="text/css">
  6. </head><body>
  7. <!-- Generated by Doxygen 1.4.6 -->
  8. <div class="tabs">
  9. <ul>
  10. <li><a href="main.html"><span>Main&nbsp;Page</span></a></li>
  11. <li><a href="modules.html"><span>Modules</span></a></li>
  12. <li><a href="classes.html"><span>Data&nbsp;Structures</span></a></li>
  13. <li id="current"><a href="files.html"><span>Files</span></a></li>
  14. <li><a href="examples.html"><span>Examples</span></a></li>
  15. </ul></div>
  16. <div class="tabs">
  17. <ul>
  18. <li><a href="files.html"><span>File&nbsp;List</span></a></li>
  19. <li><a href="globals.html"><span>Globals</span></a></li>
  20. </ul></div>
  21. <h1>apps/telnetd/shell.h File Reference</h1><hr><a name="_details"></a><h2>Detailed Description</h2>
  22. Interface for the Contiki shell.
  23. <p>
  24. <dl compact><dt><b>Author:</b></dt><dd>Adam Dunkels &lt;<a href="mailto:adam@dunkels.com">adam@dunkels.com</a>&gt;</dd></dl>
  25. Some of the functions declared in this file must be implemented as a shell back-end in the architecture specific files of a Contiki port.
  26. <p>
  27. Definition in file <a class="el" href="a00177.html">shell.h</a>.
  28. <p>
  29. <p>
  30. <a href="a00177.html">Go to the source code of this file.</a><table border="0" cellpadding="0" cellspacing="0">
  31. <tr><td></td></tr>
  32. <tr><td colspan="2"><br><h2>Functions</h2></td></tr>
  33. <tr><td class="memItemLeft" nowrap align="right" valign="top">void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="a00107.html#69b075ef7e4d7bcf5a903d3d75baac02">shell_init</a> (void)</td></tr>
  34. <tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Initialize the shell. <a href="#69b075ef7e4d7bcf5a903d3d75baac02"></a><br></td></tr>
  35. <tr><td class="memItemLeft" nowrap align="right" valign="top">void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="a00107.html#d1f18f739da7703628c3663209463a0d">shell_start</a> (void)</td></tr>
  36. <tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Start the shell back-end. <a href="#d1f18f739da7703628c3663209463a0d"></a><br></td></tr>
  37. <tr><td class="memItemLeft" nowrap align="right" valign="top">void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="a00107.html#86beee1f69d05b16022dfb430470e9ce">shell_input</a> (char *command)</td></tr>
  38. <tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Process a shell command. <a href="#86beee1f69d05b16022dfb430470e9ce"></a><br></td></tr>
  39. <tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="984c4a8b65a3cb35460b073a40568c25"></a><!-- doxytag: member="shell.h::shell_quit" ref="984c4a8b65a3cb35460b073a40568c25" args="(char *)" -->
  40. void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="a00107.html#984c4a8b65a3cb35460b073a40568c25">shell_quit</a> (char *)</td></tr>
  41. <tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Quit the shell. <br></td></tr>
  42. <tr><td class="memItemLeft" nowrap align="right" valign="top">void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="a00107.html#f11c966b0e4f4ecaa73deb14bfb6830f">shell_output</a> (char *str1, char *str2)</td></tr>
  43. <tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Print a string to the shell window. <a href="#f11c966b0e4f4ecaa73deb14bfb6830f"></a><br></td></tr>
  44. <tr><td class="memItemLeft" nowrap align="right" valign="top">void&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="a00107.html#123c95a7bb55143cabba92446ce8f513">shell_prompt</a> (char *prompt)</td></tr>
  45. <tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Print a prompt to the shell window. <a href="#123c95a7bb55143cabba92446ce8f513"></a><br></td></tr>
  46. </table>
  47. <hr><h2>Function Documentation</h2>
  48. <a class="anchor" name="69b075ef7e4d7bcf5a903d3d75baac02"></a><!-- doxytag: member="shell.h::shell_init" ref="69b075ef7e4d7bcf5a903d3d75baac02" args="(void)" --><p>
  49. <table class="mdTable" cellpadding="2" cellspacing="0">
  50. <tr>
  51. <td class="mdRow">
  52. <table cellpadding="0" cellspacing="0" border="0">
  53. <tr>
  54. <td class="md" nowrap valign="top">void shell_init </td>
  55. <td class="md" valign="top">(&nbsp;</td>
  56. <td class="md" nowrap valign="top">void&nbsp;</td>
  57. <td class="mdname1" valign="top" nowrap> </td>
  58. <td class="md" valign="top">&nbsp;)&nbsp;</td>
  59. <td class="md" nowrap></td>
  60. </tr>
  61. </table>
  62. </td>
  63. </tr>
  64. </table>
  65. <table cellspacing="5" cellpadding="0" border="0">
  66. <tr>
  67. <td>
  68. &nbsp;
  69. </td>
  70. <td>
  71. <p>
  72. Initialize the shell.
  73. <p>
  74. Called when the shell front-end process starts. This function may be used to start listening for signals. <dl compact><dt><b>Examples: </b></dt><dd>
  75. <a class="el" href="a00044.html#a221">telnetd.c</a>.</dl>
  76. <p>
  77. Definition at line <a class="el" href="a00176.html#l00105">105</a> of file <a class="el" href="a00176.html">shell.c</a>.
  78. <p>
  79. References <a class="el" href="a00176.html#l00105">shell_init()</a>.
  80. <p>
  81. Referenced by <a class="el" href="a00176.html#l00105">shell_init()</a>. </td>
  82. </tr>
  83. </table>
  84. <a class="anchor" name="86beee1f69d05b16022dfb430470e9ce"></a><!-- doxytag: member="shell.h::shell_input" ref="86beee1f69d05b16022dfb430470e9ce" args="(char *command)" --><p>
  85. <table class="mdTable" cellpadding="2" cellspacing="0">
  86. <tr>
  87. <td class="mdRow">
  88. <table cellpadding="0" cellspacing="0" border="0">
  89. <tr>
  90. <td class="md" nowrap valign="top">void shell_input </td>
  91. <td class="md" valign="top">(&nbsp;</td>
  92. <td class="md" nowrap valign="top">char *&nbsp;</td>
  93. <td class="mdname1" valign="top" nowrap> <em>command</em> </td>
  94. <td class="md" valign="top">&nbsp;)&nbsp;</td>
  95. <td class="md" nowrap></td>
  96. </tr>
  97. </table>
  98. </td>
  99. </tr>
  100. </table>
  101. <table cellspacing="5" cellpadding="0" border="0">
  102. <tr>
  103. <td>
  104. &nbsp;
  105. </td>
  106. <td>
  107. <p>
  108. Process a shell command.
  109. <p>
  110. This function will be called by the shell GUI / telnet server whan a command has been entered that should be processed by the shell back-end.<p>
  111. <dl compact><dt><b>Parameters:</b></dt><dd>
  112. <table border="0" cellspacing="2" cellpadding="0">
  113. <tr><td valign="top"></td><td valign="top"><em>command</em>&nbsp;</td><td>The command to be processed. </td></tr>
  114. </table>
  115. </dl>
  116. <dl compact><dt><b>Examples: </b></dt><dd>
  117. <a class="el" href="a00044.html#a229">telnetd.c</a>.</dl>
  118. <p>
  119. Definition at line <a class="el" href="a00176.html#l00118">118</a> of file <a class="el" href="a00176.html">shell.c</a>.
  120. <p>
  121. References <a class="el" href="a00176.html#l00118">shell_input()</a>.
  122. <p>
  123. Referenced by <a class="el" href="a00176.html#l00118">shell_input()</a>. </td>
  124. </tr>
  125. </table>
  126. <a class="anchor" name="f11c966b0e4f4ecaa73deb14bfb6830f"></a><!-- doxytag: member="shell.h::shell_output" ref="f11c966b0e4f4ecaa73deb14bfb6830f" args="(char *str1, char *str2)" --><p>
  127. <table class="mdTable" cellpadding="2" cellspacing="0">
  128. <tr>
  129. <td class="mdRow">
  130. <table cellpadding="0" cellspacing="0" border="0">
  131. <tr>
  132. <td class="md" nowrap valign="top">void shell_output </td>
  133. <td class="md" valign="top">(&nbsp;</td>
  134. <td class="md" nowrap valign="top">char *&nbsp;</td>
  135. <td class="mdname" nowrap> <em>str1</em>, </td>
  136. </tr>
  137. <tr>
  138. <td class="md" nowrap align="right"></td>
  139. <td class="md"></td>
  140. <td class="md" nowrap>char *&nbsp;</td>
  141. <td class="mdname" nowrap> <em>str2</em></td>
  142. </tr>
  143. <tr>
  144. <td class="md"></td>
  145. <td class="md">)&nbsp;</td>
  146. <td class="md" colspan="2"></td>
  147. </tr>
  148. </table>
  149. </td>
  150. </tr>
  151. </table>
  152. <table cellspacing="5" cellpadding="0" border="0">
  153. <tr>
  154. <td>
  155. &nbsp;
  156. </td>
  157. <td>
  158. <p>
  159. Print a string to the shell window.
  160. <p>
  161. This function is implemented by the shell GUI / telnet server and can be called by the shell back-end to output a string in the shell window. The string is automatically appended with a linebreak.<p>
  162. <dl compact><dt><b>Parameters:</b></dt><dd>
  163. <table border="0" cellspacing="2" cellpadding="0">
  164. <tr><td valign="top"></td><td valign="top"><em>str1</em>&nbsp;</td><td>The first half of the string to be output. </td></tr>
  165. <tr><td valign="top"></td><td valign="top"><em>str2</em>&nbsp;</td><td>The second half of the string to be output. </td></tr>
  166. </table>
  167. </dl>
  168. <dl compact><dt><b>Examples: </b></dt><dd>
  169. <a class="el" href="a00044.html#a215">telnetd.c</a>.</dl>
  170. <p>
  171. Definition at line <a class="el" href="a00178.html#l00113">113</a> of file <a class="el" href="a00178.html">telnetd.c</a>.
  172. <p>
  173. References <a class="el" href="a00174.html#l00071">ISO_cr</a>, <a class="el" href="a00174.html#l00070">ISO_nl</a>, and <a class="el" href="a00172.html#l00069">NULL</a>. </td>
  174. </tr>
  175. </table>
  176. <a class="anchor" name="123c95a7bb55143cabba92446ce8f513"></a><!-- doxytag: member="shell.h::shell_prompt" ref="123c95a7bb55143cabba92446ce8f513" args="(char *prompt)" --><p>
  177. <table class="mdTable" cellpadding="2" cellspacing="0">
  178. <tr>
  179. <td class="mdRow">
  180. <table cellpadding="0" cellspacing="0" border="0">
  181. <tr>
  182. <td class="md" nowrap valign="top">void shell_prompt </td>
  183. <td class="md" valign="top">(&nbsp;</td>
  184. <td class="md" nowrap valign="top">char *&nbsp;</td>
  185. <td class="mdname1" valign="top" nowrap> <em>prompt</em> </td>
  186. <td class="md" valign="top">&nbsp;)&nbsp;</td>
  187. <td class="md" nowrap></td>
  188. </tr>
  189. </table>
  190. </td>
  191. </tr>
  192. </table>
  193. <table cellspacing="5" cellpadding="0" border="0">
  194. <tr>
  195. <td>
  196. &nbsp;
  197. </td>
  198. <td>
  199. <p>
  200. Print a prompt to the shell window.
  201. <p>
  202. This function can be used by the shell back-end to print out a prompt to the shell window.<p>
  203. <dl compact><dt><b>Parameters:</b></dt><dd>
  204. <table border="0" cellspacing="2" cellpadding="0">
  205. <tr><td valign="top"></td><td valign="top"><em>prompt</em>&nbsp;</td><td>The prompt to be printed. </td></tr>
  206. </table>
  207. </dl>
  208. <dl compact><dt><b>Examples: </b></dt><dd>
  209. <a class="el" href="a00044.html#a214">telnetd.c</a>.</dl>
  210. <p>
  211. Definition at line <a class="el" href="a00178.html#l00101">101</a> of file <a class="el" href="a00178.html">telnetd.c</a>.
  212. <p>
  213. References <a class="el" href="a00172.html#l00069">NULL</a>. </td>
  214. </tr>
  215. </table>
  216. <a class="anchor" name="d1f18f739da7703628c3663209463a0d"></a><!-- doxytag: member="shell.h::shell_start" ref="d1f18f739da7703628c3663209463a0d" args="(void)" --><p>
  217. <table class="mdTable" cellpadding="2" cellspacing="0">
  218. <tr>
  219. <td class="mdRow">
  220. <table cellpadding="0" cellspacing="0" border="0">
  221. <tr>
  222. <td class="md" nowrap valign="top">void shell_start </td>
  223. <td class="md" valign="top">(&nbsp;</td>
  224. <td class="md" nowrap valign="top">void&nbsp;</td>
  225. <td class="mdname1" valign="top" nowrap> </td>
  226. <td class="md" valign="top">&nbsp;)&nbsp;</td>
  227. <td class="md" nowrap></td>
  228. </tr>
  229. </table>
  230. </td>
  231. </tr>
  232. </table>
  233. <table cellspacing="5" cellpadding="0" border="0">
  234. <tr>
  235. <td>
  236. &nbsp;
  237. </td>
  238. <td>
  239. <p>
  240. Start the shell back-end.
  241. <p>
  242. Called by the front-end when a new shell is started. <dl compact><dt><b>Examples: </b></dt><dd>
  243. <a class="el" href="a00044.html#a233">telnetd.c</a>.</dl>
  244. <p>
  245. Definition at line <a class="el" href="a00176.html#l00110">110</a> of file <a class="el" href="a00176.html">shell.c</a>.
  246. <p>
  247. References <a class="el" href="a00176.html#l00110">shell_start()</a>.
  248. <p>
  249. Referenced by <a class="el" href="a00176.html#l00110">shell_start()</a>. </td>
  250. </tr>
  251. </table>
  252. <hr size="1"><address style="align: right;"><small>Generated on Mon Jun 12 10:23:01 2006 for uIP 1.0 by&nbsp;
  253. <a href="http://www.doxygen.org/index.html">
  254. <img src="doxygen.png" alt="doxygen" align="middle" border="0"></a> 1.4.6 </small></address>
  255. </body>
  256. </html>