<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<title>ucommon: ucommon/shell.h Source File</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<link href="doxygen.css" rel="stylesheet" type="text/css"/>
</head>
<body>
<!-- Generated by Doxygen 1.6.3 -->
<div class="navigation" id="top">
<div class="tabs">
<ul>
<li><a href="main.html"><span>Main Page</span></a></li>
<li><a href="namespaces.html"><span>Namespaces</span></a></li>
<li><a href="annotated.html"><span>Data Structures</span></a></li>
<li class="current"><a href="files.html"><span>Files</span></a></li>
<li><a href="examples.html"><span>Examples</span></a></li>
</ul>
</div>
<div class="tabs">
<ul>
<li><a href="files.html"><span>File List</span></a></li>
<li><a href="globals.html"><span>Globals</span></a></li>
</ul>
</div>
<h1>ucommon/shell.h</h1><a href="a00197.html">Go to the documentation of this file.</a><div class="fragment"><pre class="fragment"><a name="l00001"></a>00001 <span class="comment">// Copyright (C) 2006-2010 David Sugar, Tycho Softworks.</span>
<a name="l00002"></a>00002 <span class="comment">//</span>
<a name="l00003"></a>00003 <span class="comment">// This file is part of GNU uCommon C++.</span>
<a name="l00004"></a>00004 <span class="comment">//</span>
<a name="l00005"></a>00005 <span class="comment">// GNU uCommon C++ is free software: you can redistribute it and/or modify</span>
<a name="l00006"></a>00006 <span class="comment">// it under the terms of the GNU Lesser General Public License as published</span>
<a name="l00007"></a>00007 <span class="comment">// by the Free Software Foundation, either version 3 of the License, or</span>
<a name="l00008"></a>00008 <span class="comment">// (at your option) any later version.</span>
<a name="l00009"></a>00009 <span class="comment">//</span>
<a name="l00010"></a>00010 <span class="comment">// GNU uCommon C++ is distributed in the hope that it will be useful,</span>
<a name="l00011"></a>00011 <span class="comment">// but WITHOUT ANY WARRANTY; without even the implied warranty of</span>
<a name="l00012"></a>00012 <span class="comment">// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the</span>
<a name="l00013"></a>00013 <span class="comment">// GNU Lesser General Public License for more details.</span>
<a name="l00014"></a>00014 <span class="comment">//</span>
<a name="l00015"></a>00015 <span class="comment">// You should have received a copy of the GNU Lesser General Public License</span>
<a name="l00016"></a>00016 <span class="comment">// along with GNU uCommon C++. If not, see <http://www.gnu.org/licenses/>.</span>
<a name="l00017"></a>00017
<a name="l00028"></a>00028 <span class="preprocessor">#ifndef _UCOMMON_STRING_H_</span>
<a name="l00029"></a>00029 <span class="preprocessor"></span><span class="preprocessor">#include <<a class="code" href="a00201.html" title="A common string class and character string support functions.">ucommon/string.h</a>></span>
<a name="l00030"></a>00030 <span class="preprocessor">#endif</span>
<a name="l00031"></a>00031 <span class="preprocessor"></span>
<a name="l00032"></a>00032 <span class="preprocessor">#ifndef _UCOMMON_MEMORY_H_</span>
<a name="l00033"></a>00033 <span class="preprocessor"></span><span class="preprocessor">#include <<a class="code" href="a00190.html" title="Private heaps, pools, and associations.">ucommon/memory.h</a>></span>
<a name="l00034"></a>00034 <span class="preprocessor">#endif</span>
<a name="l00035"></a>00035 <span class="preprocessor"></span>
<a name="l00036"></a>00036 <span class="preprocessor">#ifndef _UCOMMON_BUFFER_H_</span>
<a name="l00037"></a>00037 <span class="preprocessor"></span><span class="preprocessor">#include <<a class="code" href="a00180.html" title="Classes which use the buffer protocol to stream data.">ucommon/buffer.h</a>></span>
<a name="l00038"></a>00038 <span class="preprocessor">#endif</span>
<a name="l00039"></a>00039 <span class="preprocessor"></span>
<a name="l00040"></a>00040 <span class="preprocessor">#ifndef _UCOMMON_SHELL_H_</span>
<a name="l00041"></a>00041 <span class="preprocessor"></span><span class="preprocessor">#define _UCOMMON_SHELL_H_</span>
<a name="l00042"></a>00042 <span class="preprocessor"></span>
<a name="l00043"></a>00043 <span class="preprocessor">#ifdef _MSWINDOWS_</span>
<a name="l00044"></a>00044 <span class="preprocessor"></span><span class="preprocessor">#define INVALID_PID_VALUE INVALID_HANDLE_VALUE</span>
<a name="l00045"></a>00045 <span class="preprocessor"></span><span class="preprocessor">#else</span>
<a name="l00046"></a>00046 <span class="preprocessor"></span><span class="preprocessor">#define INVALID_PID_VALUE -1</span>
<a name="l00047"></a>00047 <span class="preprocessor"></span><span class="preprocessor">#endif</span>
<a name="l00048"></a>00048 <span class="preprocessor"></span>
<a name="l00049"></a>00049 NAMESPACE_UCOMMON
<a name="l00050"></a>00050
<a name="l00058"></a><a class="code" href="a00129.html">00058</a> <span class="keyword">class </span>__EXPORT <a class="code" href="a00129.html" title="A utility class for generic shell operations.">shell</a> : <span class="keyword">public</span> <a class="code" href="a00081.html" title="A managed private heap for small allocations.">mempager</a>
<a name="l00059"></a>00059 {
<a name="l00060"></a>00060 <span class="keyword">private</span>:
<a name="l00061"></a>00061 <span class="keywordtype">char</span> **_argv;
<a name="l00062"></a>00062 <span class="keywordtype">unsigned</span> _argc;
<a name="l00063"></a>00063 <span class="keywordtype">char</span> *_argv0;
<a name="l00064"></a>00064 <span class="keywordtype">char</span> *_exedir;
<a name="l00065"></a>00065 <a class="code" href="a00067.html" title="Common base class for all objects that can be formed into a linked list.">LinkedObject</a> *_syms;
<a name="l00066"></a>00066
<a name="l00067"></a>00067 <span class="keyword">class </span>__LOCAL args : <span class="keyword">public</span> <a class="code" href="a00101.html" title="A linked object base class for ordered objects.">OrderedObject</a>
<a name="l00068"></a>00068 {
<a name="l00069"></a>00069 <span class="keyword">public</span>:
<a name="l00070"></a>00070 <span class="keywordtype">char</span> *item;
<a name="l00071"></a>00071 };
<a name="l00072"></a>00072
<a name="l00073"></a>00073 <span class="keyword">class </span>__LOCAL syms : <span class="keyword">public</span> <a class="code" href="a00067.html" title="Common base class for all objects that can be formed into a linked list.">LinkedObject</a>
<a name="l00074"></a>00074 {
<a name="l00075"></a>00075 <span class="keyword">public</span>:
<a name="l00076"></a>00076 <span class="keyword">const</span> <span class="keywordtype">char</span> *name;
<a name="l00077"></a>00077 <span class="keyword">const</span> <span class="keywordtype">char</span> *value;
<a name="l00078"></a>00078 };
<a name="l00079"></a>00079
<a name="l00085"></a>00085 <span class="keywordtype">void</span> collapse(<a class="code" href="a00067.html" title="Common base class for all objects that can be formed into a linked list.">LinkedObject</a> *first);
<a name="l00086"></a>00086
<a name="l00090"></a>00090 <span class="keywordtype">void</span> set0(<span class="keywordtype">char</span> *argv0);
<a name="l00091"></a>00091
<a name="l00092"></a>00092 <span class="keyword">public</span>:
<a name="l00096"></a><a class="code" href="a00129.html#aa85210037109d22dc079643fa9f15094">00096</a> <span class="keyword">typedef</span> <span class="keyword">enum</span> {NOARGS = 0, NOARGUMENT, INVARGUMENT, BADOPTION, OPTION_USED, BAD_VALUE, NUMERIC_SET} errmsg_t;
<a name="l00097"></a>00097
<a name="l00101"></a><a class="code" href="a00129.html#a6f95e91e743357238d4476457fce306e">00101</a> <span class="keyword">typedef</span> <span class="keyword">enum</span> {NONE = 0, CONSOLE_LOG, USER_LOG, SYSTEM_LOG, SECURITY_LOG} logmode_t;
<a name="l00102"></a>00102
<a name="l00106"></a><a class="code" href="a00129.html#a325164953bbbb7999d0b2bc17a93864b">00106</a> <span class="keyword">typedef</span> <span class="keyword">enum</span> {FAIL = 0, ERR, WARN, NOTIFY, INFO, DEBUG0} loglevel_t;
<a name="l00107"></a>00107
<a name="l00111"></a><a class="code" href="a00129.html#ab81b7df395500694279b393547a1f04d">00111</a> <span class="keyword">typedef</span> <span class="keyword">enum</span> {NO_NUMERIC, NUMERIC_PLUS, NUMERIC_DASH, NUMERIC_ALL} numeric_t;
<a name="l00112"></a>00112
<a name="l00116"></a><a class="code" href="a00129.html#ac857d627ac6d21b4d1e8ceb03d9fe06d">00116</a> <span class="keyword">typedef</span> <span class="keyword">enum</span> {
<a name="l00117"></a>00117 PROGRAM_CONFIG, SERVICE_CONFIG, USER_DEFAULTS, SERVICE_CONTROL,
<a name="l00118"></a>00118 USER_HOME = USER_DEFAULTS + 3, SERVICE_DATA, SYSTEM_TEMP, USER_CACHE,
<a name="l00119"></a>00119 SERVICE_CACHE, USER_DATA, USER_CONFIG, SYSTEM_CFG, SYSTEM_ETC,
<a name="l00120"></a>00120 SYSTEM_VAR, SYSTEM_PREFIX, SYSTEM_SHARE, PROGRAM_PLUGINS,
<a name="l00121"></a>00121 PROGRAM_TEMP} path_t;
<a name="l00122"></a>00122
<a name="l00126"></a><a class="code" href="a00129.html#a68de7a97ff70afc4c075cd249f16181b">00126</a> <span class="keyword">typedef</span> bool (*logproc_t)(<a class="code" href="a00129.html#a325164953bbbb7999d0b2bc17a93864b" title="Level of error logging.">loglevel_t</a> level, <span class="keyword">const</span> <span class="keywordtype">char</span> *text);
<a name="l00127"></a>00127
<a name="l00131"></a><a class="code" href="a00129.html#a563b5db6aad3329ac41ac85e4e420a8d">00131</a> <span class="keyword">typedef</span> cpr_service_t mainproc_t;
<a name="l00132"></a>00132
<a name="l00136"></a><a class="code" href="a00129.html#aa623b4c04fd621b2b5c0a09269402a75">00136</a> <span class="keyword">typedef</span> void (*exitproc_t)(void);
<a name="l00137"></a>00137
<a name="l00138"></a>00138 <span class="preprocessor">#ifdef _MSWINDOWS_</span>
<a name="l00139"></a>00139 <span class="preprocessor"></span> <span class="keyword">typedef</span> HANDLE <a class="code" href="a00129.html#a5367b49de6e926e692be2f36c8e9690c" title="Standard type of process id for shell class.">pid_t</a>;
<a name="l00140"></a>00140 <span class="preprocessor">#else</span>
<a name="l00141"></a>00141 <span class="preprocessor"></span>
<a name="l00144"></a><a class="code" href="a00129.html#a5367b49de6e926e692be2f36c8e9690c">00144</a> <span class="keyword">typedef</span> <span class="keywordtype">int</span> <a class="code" href="a00129.html#a5367b49de6e926e692be2f36c8e9690c" title="Standard type of process id for shell class.">pid_t</a>;
<a name="l00145"></a>00145 <span class="preprocessor">#endif</span>
<a name="l00146"></a>00146 <span class="preprocessor"></span>
<a name="l00150"></a><a class="code" href="a00129.html#af9ecb49c552362dc89694221e4de7de5">00150</a> <span class="keyword">typedef</span> <span class="keyword">enum</span> {RD = BufferProtocol::BUF_RD, WR = BufferProtocol::BUF_WR, RDWR = BufferProtocol::BUF_RDWR} pmode_t;
<a name="l00151"></a>00151
<a name="l00160"></a><a class="code" href="a00138.html">00160</a> <span class="keyword">class </span>__EXPORT <a class="code" href="a00138.html" title="A class to control a process that is piped.">pipeio</a>
<a name="l00161"></a>00161 {
<a name="l00162"></a>00162 <span class="keyword">protected</span>:
<a name="l00163"></a>00163 <span class="keyword">friend</span> <span class="keyword">class </span><a class="code" href="a00129.html" title="A utility class for generic shell operations.">shell</a>;
<a name="l00164"></a>00164
<a name="l00168"></a>00168 <a class="code" href="a00138.html" title="A class to control a process that is piped.">pipeio</a>();
<a name="l00169"></a>00169
<a name="l00179"></a>00179 <span class="keywordtype">int</span> spawn(<span class="keyword">const</span> <span class="keywordtype">char</span> *path, <span class="keywordtype">char</span> **argv, <a class="code" href="a00129.html#af9ecb49c552362dc89694221e4de7de5" title="Pipe I/O mode.">pmode_t</a> mode, <span class="keywordtype">size_t</span> size = 512, <span class="keywordtype">char</span> **env = NULL);
<a name="l00180"></a>00180
<a name="l00185"></a>00185 <span class="keywordtype">int</span> <a class="code" href="a00208.html#a5c50c87fd1eb5b1ac93dffa0ee6f9af5" title="Convenience function to wait on a barrier.">wait</a>(<span class="keywordtype">void</span>);
<a name="l00186"></a>00186
<a name="l00192"></a>00192 <span class="keywordtype">int</span> cancel(<span class="keywordtype">void</span>);
<a name="l00193"></a>00193
<a name="l00202"></a>00202 <span class="keywordtype">size_t</span> read(<span class="keywordtype">void</span> *address, <span class="keywordtype">size_t</span> size);
<a name="l00203"></a>00203
<a name="l00212"></a>00212 <span class="keywordtype">size_t</span> write(<span class="keyword">const</span> <span class="keywordtype">void</span> *address, <span class="keywordtype">size_t</span> size);
<a name="l00213"></a>00213
<a name="l00214"></a>00214 <a class="code" href="a00129.html#a5367b49de6e926e692be2f36c8e9690c" title="Standard type of process id for shell class.">pid_t</a> pid;
<a name="l00215"></a>00215 fd_t input, output; <span class="comment">// input to and output from child process...</span>
<a name="l00216"></a>00216 <span class="keywordtype">int</span> perror, presult;
<a name="l00217"></a>00217 };
<a name="l00218"></a>00218
<a name="l00225"></a><a class="code" href="a00135.html">00225</a> <span class="keyword">class </span>__EXPORT <a class="code" href="a00135.html" title="Process pipe with I/O buffering.">iobuf</a> : <span class="keyword">public</span> <a class="code" href="a00028.html" title="Common buffer protocol class.">BufferProtocol</a>, <span class="keyword">private</span> <a class="code" href="a00138.html" title="A class to control a process that is piped.">pipeio</a>
<a name="l00226"></a>00226 {
<a name="l00227"></a>00227 <span class="keyword">protected</span>:
<a name="l00228"></a>00228 <span class="keyword">friend</span> <span class="keyword">class </span><a class="code" href="a00129.html" title="A utility class for generic shell operations.">shell</a>;
<a name="l00229"></a>00229
<a name="l00230"></a>00230 <span class="keywordtype">int</span> ioerror;
<a name="l00231"></a>00231
<a name="l00232"></a>00232 <span class="keyword">virtual</span> <span class="keywordtype">int</span> _err(<span class="keywordtype">void</span>) <span class="keyword">const</span>;
<a name="l00233"></a>00233 <span class="keyword">virtual</span> <span class="keywordtype">void</span> _clear(<span class="keywordtype">void</span>);
<a name="l00234"></a>00234
<a name="l00235"></a>00235 <span class="keyword">virtual</span> <span class="keywordtype">size_t</span> _push(<span class="keyword">const</span> <span class="keywordtype">char</span> *address, <span class="keywordtype">size_t</span> size);
<a name="l00236"></a>00236 <span class="keyword">virtual</span> <span class="keywordtype">size_t</span> _pull(<span class="keywordtype">char</span> *address, <span class="keywordtype">size_t</span> size);
<a name="l00237"></a>00237
<a name="l00238"></a>00238 <span class="keyword">public</span>:
<a name="l00244"></a>00244 <a class="code" href="a00135.html" title="Process pipe with I/O buffering.">iobuf</a>(<span class="keywordtype">size_t</span> size = 0);
<a name="l00245"></a>00245
<a name="l00256"></a>00256 <a class="code" href="a00135.html" title="Process pipe with I/O buffering.">iobuf</a>(<span class="keyword">const</span> <span class="keywordtype">char</span> *path, <span class="keywordtype">char</span> **argv, <a class="code" href="a00129.html#af9ecb49c552362dc89694221e4de7de5" title="Pipe I/O mode.">pmode_t</a> mode, <span class="keywordtype">size_t</span> size = 512, <span class="keywordtype">char</span> **env = NULL);
<a name="l00257"></a>00257
<a name="l00262"></a>00262 ~<a class="code" href="a00135.html" title="Process pipe with I/O buffering.">iobuf</a>();
<a name="l00263"></a>00263
<a name="l00272"></a>00272 <span class="keywordtype">void</span> open(<span class="keyword">const</span> <span class="keywordtype">char</span> *path, <span class="keywordtype">char</span> **argv, <a class="code" href="a00129.html#af9ecb49c552362dc89694221e4de7de5" title="Pipe I/O mode.">pmode_t</a> mode, <span class="keywordtype">size_t</span> size = 512, <span class="keywordtype">char</span> **env = NULL);
<a name="l00273"></a>00273
<a name="l00278"></a>00278 <span class="keywordtype">void</span> close(<span class="keywordtype">void</span>);
<a name="l00279"></a>00279
<a name="l00284"></a>00284 <span class="keywordtype">void</span> cancel(<span class="keywordtype">void</span>);
<a name="l00285"></a>00285 };
<a name="l00286"></a>00286
<a name="l00290"></a><a class="code" href="a00129.html#af31cd990e1ff48bca745acb8b06fa5be">00290</a> <span class="keyword">typedef</span> <a class="code" href="a00135.html" title="Process pipe with I/O buffering.">iobuf</a> <a class="code" href="a00135.html" title="Process pipe with I/O buffering.">io_t</a>;
<a name="l00291"></a>00291
<a name="l00295"></a><a class="code" href="a00129.html#afdcfc77d6e41d04c097795bfa61e3c5b">00295</a> <span class="keyword">typedef</span> <a class="code" href="a00138.html" title="A class to control a process that is piped.">pipeio</a> *<a class="code" href="a00138.html" title="A class to control a process that is piped.">pipe_t</a>;
<a name="l00296"></a>00296
<a name="l00303"></a>00303 <span class="keyword">static</span> <span class="keyword">const</span> <span class="keywordtype">char</span> *<a class="code" href="a00129.html#a359323bbac86adbea92c40f4ba395ad2" title="This can be used to get internationalized error messages.">errmsg</a>(<a class="code" href="a00129.html#aa85210037109d22dc079643fa9f15094" title="Error table index.">errmsg_t</a> <span class="keywordtype">id</span>);
<a name="l00304"></a>00304
<a name="l00311"></a>00311 <span class="keyword">static</span> <span class="keywordtype">void</span> <a class="code" href="a00129.html#a359323bbac86adbea92c40f4ba395ad2" title="This can be used to get internationalized error messages.">errmsg</a>(<a class="code" href="a00129.html#aa85210037109d22dc079643fa9f15094" title="Error table index.">errmsg_t</a> <span class="keywordtype">id</span>, <span class="keyword">const</span> <span class="keywordtype">char</span> *text);
<a name="l00312"></a>00312
<a name="l00319"></a><a class="code" href="a00132.html">00319</a> <span class="keyword">class </span>__EXPORT <a class="code" href="a00132.html" title="A class to redefine error messages.">errormap</a>
<a name="l00320"></a>00320 {
<a name="l00321"></a>00321 <span class="keyword">public</span>:
<a name="l00322"></a>00322 <span class="keyword">inline</span> <a class="code" href="a00132.html" title="A class to redefine error messages.">errormap</a>(<a class="code" href="a00129.html#aa85210037109d22dc079643fa9f15094" title="Error table index.">errmsg_t</a> <span class="keywordtype">id</span>, <span class="keyword">const</span> <span class="keywordtype">char</span> *text)
<a name="l00323"></a>00323 {shell::errmsg(<span class="keywordtype">id</span>, text);};
<a name="l00324"></a>00324 };
<a name="l00325"></a>00325
<a name="l00333"></a><a class="code" href="a00137.html">00333</a> <span class="keyword">class </span>__EXPORT <a class="code" href="a00137.html" title="A base class used to create parsable shell options.">Option</a> : <span class="keyword">public</span> <a class="code" href="a00101.html" title="A linked object base class for ordered objects.">OrderedObject</a>
<a name="l00334"></a>00334 {
<a name="l00335"></a>00335 <span class="keyword">public</span>:
<a name="l00336"></a>00336 <span class="keywordtype">char</span> short_option;
<a name="l00337"></a>00337 <span class="keyword">const</span> <span class="keywordtype">char</span> *long_option;
<a name="l00338"></a>00338 <span class="keyword">const</span> <span class="keywordtype">char</span> *uses_option;
<a name="l00339"></a>00339 <span class="keyword">const</span> <span class="keywordtype">char</span> *help_string;
<a name="l00340"></a>00340 <span class="keywordtype">bool</span> trigger_option;
<a name="l00341"></a>00341
<a name="l00349"></a>00349 <a class="code" href="a00137.html" title="A base class used to create parsable shell options.">Option</a>(<span class="keywordtype">char</span> short_option = 0, <span class="keyword">const</span> <span class="keywordtype">char</span> *long_option = NULL, <span class="keyword">const</span> <span class="keywordtype">char</span> *value_type = NULL, <span class="keyword">const</span> <span class="keywordtype">char</span> *help = NULL);
<a name="l00350"></a>00350
<a name="l00351"></a>00351 <span class="keyword">virtual</span> ~<a class="code" href="a00137.html" title="A base class used to create parsable shell options.">Option</a>();
<a name="l00352"></a>00352
<a name="l00353"></a>00353 <span class="keyword">static</span> <a class="code" href="a00067.html" title="Common base class for all objects that can be formed into a linked list.">LinkedObject</a> *first(<span class="keywordtype">void</span>);
<a name="l00354"></a>00354
<a name="l00359"></a>00359 <span class="keywordtype">void</span> disable(<span class="keywordtype">void</span>);
<a name="l00360"></a>00360
<a name="l00366"></a>00366 <span class="keyword">virtual</span> <span class="keyword">const</span> <span class="keywordtype">char</span> *assign(<span class="keyword">const</span> <span class="keywordtype">char</span> *value) = 0;
<a name="l00367"></a>00367
<a name="l00368"></a>00368 <span class="keyword">static</span> <span class="keywordtype">void</span> reset(<span class="keywordtype">void</span>);
<a name="l00369"></a>00369 };
<a name="l00370"></a>00370
<a name="l00378"></a><a class="code" href="a00133.html">00378</a> <span class="keyword">class </span>__EXPORT <a class="code" href="a00133.html" title="Flag option for shell parsing.">flagopt</a> : <span class="keyword">public</span> <a class="code" href="a00137.html" title="A base class used to create parsable shell options.">Option</a>
<a name="l00379"></a>00379 {
<a name="l00380"></a>00380 <span class="keyword">private</span>:
<a name="l00381"></a>00381 <span class="keywordtype">unsigned</span> <a class="code" href="a00040.html" title="Automatic integer counting class.">counter</a>;
<a name="l00382"></a>00382 <span class="keywordtype">bool</span> single;
<a name="l00383"></a>00383
<a name="l00384"></a>00384 <span class="keyword">virtual</span> <span class="keyword">const</span> <span class="keywordtype">char</span> *assign(<span class="keyword">const</span> <span class="keywordtype">char</span> *value);
<a name="l00385"></a>00385
<a name="l00386"></a>00386 <span class="keyword">public</span>:
<a name="l00387"></a>00387 <a class="code" href="a00133.html" title="Flag option for shell parsing.">flagopt</a>(<span class="keywordtype">char</span> short_option, <span class="keyword">const</span> <span class="keywordtype">char</span> *long_option = NULL, <span class="keyword">const</span> <span class="keywordtype">char</span> *help = NULL, <span class="keywordtype">bool</span> single_use = <span class="keyword">true</span>);
<a name="l00388"></a>00388
<a name="l00389"></a>00389 <span class="keyword">inline</span> operator bool()
<a name="l00390"></a>00390 {<span class="keywordflow">return</span> <a class="code" href="a00040.html" title="Automatic integer counting class.">counter</a> > 0;};
<a name="l00391"></a>00391
<a name="l00392"></a>00392 <span class="keyword">inline</span> <span class="keywordtype">bool</span> operator!()
<a name="l00393"></a>00393 {<span class="keywordflow">return</span> <a class="code" href="a00040.html" title="Automatic integer counting class.">counter</a> == 0;};
<a name="l00394"></a>00394
<a name="l00395"></a>00395 <span class="keyword">inline</span> operator unsigned()
<a name="l00396"></a>00396 {<span class="keywordflow">return</span> <a class="code" href="a00040.html" title="Automatic integer counting class.">counter</a>;};
<a name="l00397"></a>00397
<a name="l00398"></a>00398 <span class="keyword">inline</span> <span class="keywordtype">unsigned</span> operator*()
<a name="l00399"></a>00399 {<span class="keywordflow">return</span> <a class="code" href="a00040.html" title="Automatic integer counting class.">counter</a>;};
<a name="l00400"></a>00400
<a name="l00401"></a>00401 <span class="keyword">inline</span> <span class="keywordtype">void</span> <span class="keyword">set</span>(<span class="keywordtype">unsigned</span> value = 1)
<a name="l00402"></a>00402 {<a class="code" href="a00040.html" title="Automatic integer counting class.">counter</a> = value;};
<a name="l00403"></a>00403 };
<a name="l00404"></a>00404
<a name="l00410"></a><a class="code" href="a00134.html">00410</a> <span class="keyword">class </span>__EXPORT <a class="code" href="a00134.html" title="Grouping option.">groupopt</a> : <span class="keyword">public</span> <a class="code" href="a00137.html" title="A base class used to create parsable shell options.">Option</a>
<a name="l00411"></a>00411 {
<a name="l00412"></a>00412 <span class="keyword">private</span>:
<a name="l00413"></a>00413 <span class="keyword">virtual</span> <span class="keyword">const</span> <span class="keywordtype">char</span> *assign(<span class="keyword">const</span> <span class="keywordtype">char</span> *value);
<a name="l00414"></a>00414
<a name="l00415"></a>00415 <span class="keyword">public</span>:
<a name="l00416"></a>00416 <a class="code" href="a00134.html" title="Grouping option.">groupopt</a>(<span class="keyword">const</span> <span class="keywordtype">char</span> *help);
<a name="l00417"></a>00417 };
<a name="l00418"></a>00418
<a name="l00425"></a><a class="code" href="a00139.html">00425</a> <span class="keyword">class </span>__EXPORT <a class="code" href="a00139.html" title="Text option for shell parsing.">stringopt</a> : <span class="keyword">public</span> <a class="code" href="a00137.html" title="A base class used to create parsable shell options.">Option</a>
<a name="l00426"></a>00426 {
<a name="l00427"></a>00427 <span class="keyword">private</span>:
<a name="l00428"></a>00428 <span class="keywordtype">bool</span> used;
<a name="l00429"></a>00429
<a name="l00430"></a>00430 <span class="keyword">protected</span>:
<a name="l00431"></a>00431 <span class="keyword">const</span> <span class="keywordtype">char</span> *text;
<a name="l00432"></a>00432
<a name="l00433"></a>00433 <span class="keyword">virtual</span> <span class="keyword">const</span> <span class="keywordtype">char</span> *assign(<span class="keyword">const</span> <span class="keywordtype">char</span> *value);
<a name="l00434"></a>00434
<a name="l00435"></a>00435 <span class="keyword">public</span>:
<a name="l00436"></a>00436 <a class="code" href="a00139.html" title="Text option for shell parsing.">stringopt</a>(<span class="keywordtype">char</span> short_option, <span class="keyword">const</span> <span class="keywordtype">char</span> *long_option = NULL, <span class="keyword">const</span> <span class="keywordtype">char</span> *help = NULL, <span class="keyword">const</span> <span class="keywordtype">char</span> *type = <span class="stringliteral">"text"</span>, <span class="keyword">const</span> <span class="keywordtype">char</span> *def_text = NULL);
<a name="l00437"></a>00437
<a name="l00438"></a>00438 <span class="keyword">inline</span> <span class="keywordtype">void</span> <span class="keyword">set</span>(<span class="keyword">const</span> <span class="keywordtype">char</span> *<a class="code" href="a00148.html" title="A copy-on-write string class that operates by reference count.">string</a>)
<a name="l00439"></a>00439 {text = <a class="code" href="a00148.html" title="A copy-on-write string class that operates by reference count.">string</a>;};
<a name="l00440"></a>00440
<a name="l00441"></a>00441 <span class="keyword">inline</span> operator bool()
<a name="l00442"></a>00442 {<span class="keywordflow">return</span> used;};
<a name="l00443"></a>00443
<a name="l00444"></a>00444 <span class="keyword">inline</span> <span class="keywordtype">bool</span> operator!()
<a name="l00445"></a>00445 {<span class="keywordflow">return</span> !used;};
<a name="l00446"></a>00446
<a name="l00447"></a>00447 <span class="keyword">inline</span> operator const char *()
<a name="l00448"></a>00448 {<span class="keywordflow">return</span> text;};
<a name="l00449"></a>00449
<a name="l00450"></a>00450 <span class="keyword">inline</span> <span class="keyword">const</span> <span class="keywordtype">char</span> *operator*()
<a name="l00451"></a>00451 {<span class="keywordflow">return</span> text;};
<a name="l00452"></a>00452 };
<a name="l00453"></a>00453
<a name="l00460"></a><a class="code" href="a00130.html">00460</a> <span class="keyword">class </span>__EXPORT <a class="code" href="a00130.html" title="Character option for shell parsing.">charopt</a> : <span class="keyword">public</span> <a class="code" href="a00137.html" title="A base class used to create parsable shell options.">Option</a>
<a name="l00461"></a>00461 {
<a name="l00462"></a>00462 <span class="keyword">private</span>:
<a name="l00463"></a>00463 <span class="keywordtype">bool</span> used;
<a name="l00464"></a>00464
<a name="l00465"></a>00465 <span class="keyword">protected</span>:
<a name="l00466"></a>00466 <span class="keywordtype">char</span> code;
<a name="l00467"></a>00467
<a name="l00468"></a>00468 <span class="keyword">virtual</span> <span class="keyword">const</span> <span class="keywordtype">char</span> *assign(<span class="keyword">const</span> <span class="keywordtype">char</span> *value);
<a name="l00469"></a>00469
<a name="l00470"></a>00470 <span class="keyword">public</span>:
<a name="l00471"></a>00471 <a class="code" href="a00130.html" title="Character option for shell parsing.">charopt</a>(<span class="keywordtype">char</span> short_option, <span class="keyword">const</span> <span class="keywordtype">char</span> *long_option = NULL, <span class="keyword">const</span> <span class="keywordtype">char</span> *help = NULL, <span class="keyword">const</span> <span class="keywordtype">char</span> *type = <span class="stringliteral">"char"</span>, <span class="keywordtype">char</span> default_code = <span class="charliteral">' '</span>);
<a name="l00472"></a>00472
<a name="l00473"></a>00473 <span class="keyword">inline</span> <span class="keywordtype">void</span> <span class="keyword">set</span>(<span class="keywordtype">char</span> value)
<a name="l00474"></a>00474 {code = value;};
<a name="l00475"></a>00475
<a name="l00476"></a>00476 <span class="keyword">inline</span> operator bool()
<a name="l00477"></a>00477 {<span class="keywordflow">return</span> used;};
<a name="l00478"></a>00478
<a name="l00479"></a>00479 <span class="keyword">inline</span> <span class="keywordtype">bool</span> operator!()
<a name="l00480"></a>00480 {<span class="keywordflow">return</span> !used;};
<a name="l00481"></a>00481
<a name="l00482"></a>00482 <span class="keyword">inline</span> operator char()
<a name="l00483"></a>00483 {<span class="keywordflow">return</span> code;};
<a name="l00484"></a>00484
<a name="l00485"></a>00485 <span class="keyword">inline</span> <span class="keywordtype">char</span> operator*()
<a name="l00486"></a>00486 {<span class="keywordflow">return</span> code;};
<a name="l00487"></a>00487 };
<a name="l00488"></a>00488
<a name="l00495"></a><a class="code" href="a00136.html">00495</a> <span class="keyword">class </span>__EXPORT <a class="code" href="a00136.html" title="Numeric option for shell parsing.">numericopt</a> : <span class="keyword">public</span> <a class="code" href="a00137.html" title="A base class used to create parsable shell options.">Option</a>
<a name="l00496"></a>00496 {
<a name="l00497"></a>00497 <span class="keyword">private</span>:
<a name="l00498"></a>00498 <span class="keywordtype">bool</span> used;
<a name="l00499"></a>00499
<a name="l00500"></a>00500 <span class="keyword">protected</span>:
<a name="l00501"></a>00501 <span class="keywordtype">long</span> number;
<a name="l00502"></a>00502
<a name="l00503"></a>00503 <span class="keyword">virtual</span> <span class="keyword">const</span> <span class="keywordtype">char</span> *assign(<span class="keyword">const</span> <span class="keywordtype">char</span> *value);
<a name="l00504"></a>00504
<a name="l00505"></a>00505 <span class="keyword">public</span>:
<a name="l00506"></a>00506 <a class="code" href="a00136.html" title="Numeric option for shell parsing.">numericopt</a>(<span class="keywordtype">char</span> short_option, <span class="keyword">const</span> <span class="keywordtype">char</span> *long_option = NULL, <span class="keyword">const</span> <span class="keywordtype">char</span> *help = NULL, <span class="keyword">const</span> <span class="keywordtype">char</span> *type = <span class="stringliteral">"numeric"</span>, <span class="keywordtype">long</span> def_value = 0);
<a name="l00507"></a>00507
<a name="l00508"></a>00508 <span class="keyword">inline</span> <span class="keywordtype">void</span> <span class="keyword">set</span>(<span class="keywordtype">long</span> value)
<a name="l00509"></a>00509 {number = value;};
<a name="l00510"></a>00510
<a name="l00511"></a>00511 <span class="keyword">inline</span> operator bool()
<a name="l00512"></a>00512 {<span class="keywordflow">return</span> used;};
<a name="l00513"></a>00513
<a name="l00514"></a>00514 <span class="keyword">inline</span> <span class="keywordtype">bool</span> operator!()
<a name="l00515"></a>00515 {<span class="keywordflow">return</span> !used;};
<a name="l00516"></a>00516
<a name="l00517"></a>00517 <span class="keyword">inline</span> operator long()
<a name="l00518"></a>00518 {<span class="keywordflow">return</span> number;};
<a name="l00519"></a>00519
<a name="l00520"></a>00520 <span class="keyword">inline</span> <span class="keywordtype">long</span> operator*()
<a name="l00521"></a>00521 {<span class="keywordflow">return</span> number;};
<a name="l00522"></a>00522 };
<a name="l00523"></a>00523
<a name="l00532"></a><a class="code" href="a00131.html">00532</a> <span class="keyword">class </span>__EXPORT <a class="code" href="a00131.html" title="Counter option for shell parsing.">counteropt</a> : <span class="keyword">public</span> <a class="code" href="a00137.html" title="A base class used to create parsable shell options.">Option</a>
<a name="l00533"></a>00533 {
<a name="l00534"></a>00534 <span class="keyword">private</span>:
<a name="l00535"></a>00535 <span class="keywordtype">bool</span> used;
<a name="l00536"></a>00536
<a name="l00537"></a>00537 <span class="keyword">protected</span>:
<a name="l00538"></a>00538 <span class="keywordtype">long</span> number;
<a name="l00539"></a>00539
<a name="l00540"></a>00540 <span class="keyword">virtual</span> <span class="keyword">const</span> <span class="keywordtype">char</span> *assign(<span class="keyword">const</span> <span class="keywordtype">char</span> *value);
<a name="l00541"></a>00541
<a name="l00542"></a>00542 <span class="keyword">public</span>:
<a name="l00543"></a>00543 <a class="code" href="a00131.html" title="Counter option for shell parsing.">counteropt</a>(<span class="keywordtype">char</span> short_option, <span class="keyword">const</span> <span class="keywordtype">char</span> *long_option = NULL, <span class="keyword">const</span> <span class="keywordtype">char</span> *help = NULL, <span class="keyword">const</span> <span class="keywordtype">char</span> *type = <span class="stringliteral">"numeric"</span>, <span class="keywordtype">long</span> def_value = 0);
<a name="l00544"></a>00544
<a name="l00545"></a>00545 <span class="keyword">inline</span> <span class="keywordtype">void</span> <span class="keyword">set</span>(<span class="keywordtype">long</span> value)
<a name="l00546"></a>00546 {number = value;};
<a name="l00547"></a>00547
<a name="l00548"></a>00548 <span class="keyword">inline</span> operator bool()
<a name="l00549"></a>00549 {<span class="keywordflow">return</span> used;};
<a name="l00550"></a>00550
<a name="l00551"></a>00551 <span class="keyword">inline</span> <span class="keywordtype">bool</span> operator!()
<a name="l00552"></a>00552 {<span class="keywordflow">return</span> !used;};
<a name="l00553"></a>00553
<a name="l00554"></a>00554 <span class="keyword">inline</span> operator long()
<a name="l00555"></a>00555 {<span class="keywordflow">return</span> number;};
<a name="l00556"></a>00556
<a name="l00557"></a>00557 <span class="keyword">inline</span> <span class="keywordtype">long</span> operator*()
<a name="l00558"></a>00558 {<span class="keywordflow">return</span> number;};
<a name="l00559"></a>00559 };
<a name="l00560"></a>00560
<a name="l00568"></a>00568 <a class="code" href="a00129.html#a338d21594fb21a67778f6b68993b01ff" title="Construct a shell argument list by parsing a simple command string.">shell</a>(<span class="keyword">const</span> <span class="keywordtype">char</span> *<span class="keywordtype">string</span>, <span class="keywordtype">size_t</span> pagesize = 0);
<a name="l00569"></a>00569
<a name="l00578"></a>00578 <a class="code" href="a00129.html#a338d21594fb21a67778f6b68993b01ff" title="Construct a shell argument list by parsing a simple command string.">shell</a>(<span class="keywordtype">int</span> argc, <span class="keywordtype">char</span> **argv, <span class="keywordtype">size_t</span> pagesize = 0);
<a name="l00579"></a>00579
<a name="l00584"></a>00584 <a class="code" href="a00129.html#a338d21594fb21a67778f6b68993b01ff" title="Construct a shell argument list by parsing a simple command string.">shell</a>(<span class="keywordtype">size_t</span> pagesize = 0);
<a name="l00585"></a>00585
<a name="l00586"></a>00586 <span class="keyword">static</span> <span class="keywordtype">void</span> setNumeric(<a class="code" href="a00129.html#ab81b7df395500694279b393547a1f04d" title="Numeric mode of parser.">numeric_t</a>);
<a name="l00587"></a>00587
<a name="l00588"></a>00588 <span class="keyword">static</span> <span class="keywordtype">long</span> getNumeric(<span class="keywordtype">void</span>);
<a name="l00589"></a>00589
<a name="l00593"></a>00593 <span class="keyword">static</span> <span class="keywordtype">void</span> <a class="code" href="a00129.html#a52fd93df70988b0dca71a92501fa32f3" title="Display shell options.">help</a>(<span class="keywordtype">void</span>);
<a name="l00594"></a>00594
<a name="l00602"></a>00602 <span class="keyword">static</span> <span class="keywordtype">int</span> <a class="code" href="a00129.html#ad96fea35ae522f1a2b9789ec557a8c17" title="A shell system call.">system</a>(<span class="keyword">const</span> <span class="keywordtype">char</span> *command, <span class="keyword">const</span> <span class="keywordtype">char</span> **env = NULL);
<a name="l00603"></a>00603
<a name="l00610"></a>00610 <span class="keyword">static</span> <span class="keywordtype">int</span> <a class="code" href="a00129.html#ae539b600666cf940c49fda95adf185cb" title="A shell system call that can be issued using a formatted string.">systemf</a>(<span class="keyword">const</span> <span class="keywordtype">char</span> *format, ...) __PRINTF(1,2);
<a name="l00611"></a>00611
<a name="l00616"></a>00616 static <span class="keywordtype">void</span> relocate(const <span class="keywordtype">char</span> *argv0);
<a name="l00617"></a>00617
<a name="l00624"></a>00624 static <a class="code" href="a00148.html" title="A copy-on-write string class that operates by reference count.">String</a> path(<a class="code" href="a00129.html#ac857d627ac6d21b4d1e8ceb03d9fe06d" title="Path types to retrieve.">path_t</a> <span class="keywordtype">id</span>);
<a name="l00625"></a>00625
<a name="l00630"></a>00630 static <a class="code" href="a00148.html" title="A copy-on-write string class that operates by reference count.">String</a> userid(<span class="keywordtype">void</span>);
<a name="l00631"></a>00631
<a name="l00638"></a>00638 static <a class="code" href="a00148.html" title="A copy-on-write string class that operates by reference count.">String</a> path(<a class="code" href="a00129.html#ac857d627ac6d21b4d1e8ceb03d9fe06d" title="Path types to retrieve.">path_t</a> <span class="keywordtype">id</span>, const <span class="keywordtype">char</span> *directory);
<a name="l00639"></a>00639
<a name="l00645"></a>00645 static <a class="code" href="a00148.html" title="A copy-on-write string class that operates by reference count.">String</a> path(<a class="code" href="a00148.html" title="A copy-on-write string class that operates by reference count.">String</a>& prefix, const <span class="keywordtype">char</span> *directory);
<a name="l00646"></a>00646
<a name="l00658"></a>00658 static <span class="keywordtype">void</span> bind(const <span class="keywordtype">char</span> *name);
<a name="l00659"></a>00659
<a name="l00669"></a>00669 static <span class="keywordtype">void</span> rebind(const <span class="keywordtype">char</span> *name = NULL);
<a name="l00670"></a>00670
<a name="l00676"></a>00676 <span class="keywordtype">char</span> **parse(const <span class="keywordtype">char</span> *<span class="keywordtype">string</span>);
<a name="l00677"></a>00677
<a name="l00686"></a>00686 <span class="keywordtype">void</span> parse(<span class="keywordtype">int</span> argc, <span class="keywordtype">char</span> **argv);
<a name="l00687"></a>00687
<a name="l00695"></a>00695 const <span class="keywordtype">char</span> *getenv(const <span class="keywordtype">char</span> *name, const <span class="keywordtype">char</span> *value = NULL);
<a name="l00696"></a>00696
<a name="l00703"></a>00703 const <span class="keywordtype">char</span> *getsym(const <span class="keywordtype">char</span> *name, const <span class="keywordtype">char</span> *value = NULL);
<a name="l00704"></a>00704
<a name="l00710"></a>00710 <span class="keywordtype">void</span> setsym(const <span class="keywordtype">char</span> *name, const <span class="keywordtype">char</span> *value);
<a name="l00711"></a>00711
<a name="l00717"></a>00717 <span class="keywordtype">bool</span> issym(const <span class="keywordtype">char</span> *name);
<a name="l00718"></a>00718
<a name="l00724"></a>00724 <span class="keywordtype">char</span> *getargv0(<span class="keywordtype">char</span> **argv);
<a name="l00725"></a>00725
<a name="l00733"></a>00733 <span class="keywordtype">char</span> **getargv(<span class="keywordtype">char</span> **argv);
<a name="l00734"></a>00734
<a name="l00741"></a>00741 <span class="keywordtype">void</span> restart(<span class="keywordtype">char</span> *argv0, <span class="keywordtype">char</span> **argv, <span class="keywordtype">char</span> **list);
<a name="l00742"></a>00742
<a name="l00749"></a><a class="code" href="a00129.html#a110573a16492aad314e84afb25d1943a">00749</a> inline static <span class="keywordtype">char</span> **parse(<a class="code" href="a00129.html" title="A utility class for generic shell operations.">shell</a> &args, const <span class="keywordtype">char</span> *<span class="keywordtype">string</span>)
<a name="l00750"></a>00750 {<span class="keywordflow">return</span> args.parse(<span class="keywordtype">string</span>);}
<a name="l00751"></a>00751
<a name="l00755"></a><a class="code" href="a00129.html#ae4514af5964b0a897766cb2c6076772b">00755</a> <span class="keyword">inline</span> <span class="keyword">const</span> <span class="keywordtype">char</span> *<a class="code" href="a00129.html#ae4514af5964b0a897766cb2c6076772b" title="Get program name (argv0).">argv0</a>()<span class="keyword"> const</span>
<a name="l00756"></a>00756 <span class="keyword"> </span>{<span class="keywordflow">return</span> _argv0;}
<a name="l00757"></a>00757
<a name="l00761"></a><a class="code" href="a00129.html#a8474ac9e2f2e8840e47536e19615d38b">00761</a> <span class="keyword">inline</span> <span class="keyword">const</span> <span class="keywordtype">char</span> *<a class="code" href="a00129.html#a8474ac9e2f2e8840e47536e19615d38b" title="Get the exec directory.">execdir</a>()<span class="keyword"> const</span>
<a name="l00762"></a>00762 <span class="keyword"> </span>{<span class="keywordflow">return</span> _exedir;}
<a name="l00763"></a>00763
<a name="l00769"></a>00769 <span class="keyword">static</span> <span class="keywordtype">void</span> <a class="code" href="a00129.html#a9a0a517430bafa85177e949ebe0f88aa" title="Print error message and exit.">errexit</a>(<span class="keywordtype">int</span> exitcode, <span class="keyword">const</span> <span class="keywordtype">char</span> *format = NULL, ...) __PRINTF(2, 3);
<a name="l00770"></a>00770
<a name="l00776"></a>00776 static <span class="keywordtype">void</span> debug(<span class="keywordtype">unsigned</span> level, const <span class="keywordtype">char</span> *format, ...) __PRINTF(2, 3);
<a name="l00777"></a>00777
<a name="l00783"></a>00783 static <span class="keywordtype">void</span> log(loglevel_t level, const <span class="keywordtype">char</span> *format, ...) __PRINTF(2, 3);
<a name="l00784"></a>00784
<a name="l00790"></a>00790 static <span class="keywordtype">void</span> security(loglevel_t level, const <span class="keywordtype">char</span> *format, ...) __PRINTF(2, 3);
<a name="l00791"></a>00791
<a name="l00799"></a>00799 static <span class="keywordtype">void</span> log(const <span class="keywordtype">char</span> *name, loglevel_t level = ERR, logmode_t mode = USER_LOG, logproc_t handler = (logproc_t)NULL);
<a name="l00800"></a>00800
<a name="l00805"></a>00805 static <span class="keywordtype">size_t</span> printf(const <span class="keywordtype">char</span> *format, ...) __PRINTF(1, 2);
<a name="l00806"></a>00806
<a name="l00807"></a>00807 static <span class="keywordtype">size_t</span> readln(<span class="keywordtype">char</span> *address, <span class="keywordtype">size_t</span> size);
<a name="l00808"></a>00808
<a name="l00809"></a>00809 static <span class="keywordtype">size_t</span> writes(const <span class="keywordtype">char</span> *<span class="keywordtype">string</span>);
<a name="l00810"></a>00810
<a name="l00811"></a>00811 static <span class="keywordtype">size_t</span> read(<a class="code" href="a00148.html" title="A copy-on-write string class that operates by reference count.">String</a>& <span class="keywordtype">string</span>);
<a name="l00812"></a>00812
<a name="l00813"></a>00813 inline static <span class="keywordtype">size_t</span> write(<a class="code" href="a00148.html" title="A copy-on-write string class that operates by reference count.">String</a>& <span class="keywordtype">string</span>)
<a name="l00814"></a>00814 {<span class="keywordflow">return</span> writes(<span class="keywordtype">string</span>.c_str());};
<a name="l00815"></a>00815
<a name="l00822"></a>00822 <span class="keyword">static</span> <span class="keywordtype">size_t</span> <a class="code" href="a00129.html#a51dca79f751b9766a9ea670a3a6b5224" title="Print to standard output.">printf</a>(pipe_t pipe, <span class="keyword">const</span> <span class="keywordtype">char</span> *format, ...) __PRINTF(2, 3);
<a name="l00823"></a>00823
<a name="l00831"></a>00831 static <span class="keywordtype">size_t</span> readln(pipe_t pipe, <span class="keywordtype">char</span> *buffer, <span class="keywordtype">size_t</span> size);
<a name="l00832"></a>00832
<a name="l00833"></a>00833 static <span class="keywordtype">size_t</span> read(pipe_t pipe, <a class="code" href="a00208.html#a9045ddbf2980f6330c065a6935f40161" title="A convenience type when mixing std::string in old compilers that are bad with namespaces...">String</a>& <span class="keywordtype">string</span>);
<a name="l00834"></a>00834
<a name="l00835"></a>00835 static <span class="keywordtype">size_t</span> writes(pipe_t pipe, const <span class="keywordtype">char</span> *<span class="keywordtype">string</span>);
<a name="l00836"></a>00836
<a name="l00837"></a>00837 inline static <span class="keywordtype">size_t</span> write(pipe_t pipe, <a class="code" href="a00208.html#a9045ddbf2980f6330c065a6935f40161" title="A convenience type when mixing std::string in old compilers that are bad with namespaces...">String</a>& <span class="keywordtype">string</span>)
<a name="l00838"></a>00838 {<span class="keywordflow">return</span> writes(pipe, <span class="keywordtype">string</span>.c_str());};
<a name="l00839"></a>00839
<a name="l00845"></a><a class="code" href="a00129.html#aeb0ca04f262905f6300c8e395f34936d">00845</a> <span class="keyword">inline</span> <span class="keywordtype">unsigned</span> <a class="code" href="a00129.html#aeb0ca04f262905f6300c8e395f34936d" title="Get saved internal argc count for items.">argc</a>(<span class="keywordtype">void</span>)<span class="keyword"> const</span>
<a name="l00846"></a>00846 <span class="keyword"> </span>{<span class="keywordflow">return</span> _argc;};
<a name="l00847"></a>00847
<a name="l00854"></a><a class="code" href="a00129.html#ab82ea0cd3db344f32ea056a99470f8f0">00854</a> <span class="keyword">inline</span> <span class="keywordtype">char</span> **<a class="code" href="a00129.html#ab82ea0cd3db344f32ea056a99470f8f0" title="Get saved internal argv count for items in this shell object.">argv</a>(<span class="keywordtype">void</span>)<span class="keyword"> const</span>
<a name="l00855"></a>00855 <span class="keyword"> </span>{<span class="keywordflow">return</span> _argv;};
<a name="l00856"></a>00856
<a name="l00862"></a><a class="code" href="a00129.html#aab0f38c86f4b7c99ce714df6f39fe188">00862</a> <span class="keyword">inline</span> <span class="keyword">const</span> <span class="keywordtype">char</span> *<a class="code" href="a00129.html#aab0f38c86f4b7c99ce714df6f39fe188" title="Return parser argv element.">operator[]</a>(<span class="keywordtype">unsigned</span> offset)
<a name="l00863"></a>00863 {<span class="keywordflow">return</span> _argv[offset];};
<a name="l00864"></a>00864
<a name="l00865"></a>00865 <span class="keyword">static</span> <span class="keywordtype">void</span> exiting(exitproc_t);
<a name="l00866"></a>00866
<a name="l00870"></a>00870 <span class="keywordtype">void</span> <a class="code" href="a00129.html#a47b60d4504a5e77c8cee72ea3be9c386" title="Detach current process to daemon for service entry.">detach</a>(mainproc_t mainentry = (mainproc_t)NULL);
<a name="l00871"></a>00871
<a name="l00875"></a>00875 <span class="keywordtype">void</span> <a class="code" href="a00129.html#a03afd03ee5ad6f254828d022defaa4eb" title="Make current process restartable.">restart</a>(<span class="keywordtype">void</span>);
<a name="l00876"></a>00876
<a name="l00888"></a>00888 <span class="keyword">static</span> <a class="code" href="a00129.html#a5367b49de6e926e692be2f36c8e9690c" title="Standard type of process id for shell class.">shell::pid_t</a> <a class="code" href="a00129.html#a31066dd320471150d93a4f6c2bcc1d0a" title="Spawn a child process.">spawn</a>(<span class="keyword">const</span> <span class="keywordtype">char</span> *path, <span class="keywordtype">char</span> **argv, <span class="keywordtype">char</span> **env = NULL, fd_t *stdio = NULL);
<a name="l00889"></a>00889
<a name="l00901"></a>00901 <span class="keyword">static</span> <a class="code" href="a00138.html" title="A class to control a process that is piped.">shell::pipe_t</a> <a class="code" href="a00129.html#a31066dd320471150d93a4f6c2bcc1d0a" title="Spawn a child process.">spawn</a>(<span class="keyword">const</span> <span class="keywordtype">char</span> *path, <span class="keywordtype">char</span> **argv, pmode_t mode, <span class="keywordtype">size_t</span> size = 512, <span class="keywordtype">char</span> **env = NULL);
<a name="l00902"></a>00902
<a name="l00911"></a>00911 <span class="keyword">static</span> <span class="keywordtype">void</span> <a class="code" href="a00129.html#ad7728c86e3cf69d987b7da14ab480139" title="Set priority level and enable priority scheduler.">priority</a>(<span class="keywordtype">int</span> pri = 1);
<a name="l00912"></a>00912
<a name="l00922"></a>00922 <span class="keyword">static</span> <span class="keywordtype">int</span> <a class="code" href="a00129.html#a47b60d4504a5e77c8cee72ea3be9c386" title="Detach current process to daemon for service entry.">detach</a>(<span class="keyword">const</span> <span class="keywordtype">char</span> *path, <span class="keywordtype">char</span> **argv, <span class="keywordtype">char</span> **env = NULL, fd_t *stdio = NULL);
<a name="l00923"></a>00923
<a name="l00929"></a>00929 <span class="keyword">static</span> <span class="keywordtype">int</span> <a class="code" href="a00129.html#ab702f813b6f74ab45b854b3e376ab38e" title="Wait for a child process to terminate.">wait</a>(<a class="code" href="a00129.html#a5367b49de6e926e692be2f36c8e9690c" title="Standard type of process id for shell class.">shell::pid_t</a> pid);
<a name="l00930"></a>00930
<a name="l00936"></a>00936 <span class="keyword">static</span> <span class="keywordtype">int</span> <a class="code" href="a00129.html#a22e01ea97d975c26cafb76d2572f1eec" title="Cancel a child process.">cancel</a>(<a class="code" href="a00129.html#a5367b49de6e926e692be2f36c8e9690c" title="Standard type of process id for shell class.">shell::pid_t</a> pid);
<a name="l00937"></a>00937
<a name="l00944"></a>00944 <span class="keyword">static</span> <span class="keywordtype">int</span> <a class="code" href="a00129.html#ab702f813b6f74ab45b854b3e376ab38e" title="Wait for a child process to terminate.">wait</a>(<a class="code" href="a00138.html" title="A class to control a process that is piped.">shell::pipe_t</a> <a class="code" href="a00110.html" title="Generic smart pointer class.">pointer</a>);
<a name="l00945"></a>00945
<a name="l00951"></a>00951 <span class="keyword">static</span> <span class="keywordtype">int</span> <a class="code" href="a00129.html#a22e01ea97d975c26cafb76d2572f1eec" title="Cancel a child process.">cancel</a>(<a class="code" href="a00138.html" title="A class to control a process that is piped.">shell::pipe_t</a> <a class="code" href="a00110.html" title="Generic smart pointer class.">pointer</a>);
<a name="l00952"></a>00952
<a name="l00957"></a><a class="code" href="a00129.html#a80cd40a2918701c2089cb2a94dc54a27">00957</a> <span class="keyword">inline</span> <span class="keywordtype">unsigned</span> <a class="code" href="a00129.html#a80cd40a2918701c2089cb2a94dc54a27" title="Return argc count.">operator()</a>(<span class="keywordtype">void</span>)
<a name="l00958"></a>00958 {<span class="keywordflow">return</span> _argc;};
<a name="l00959"></a>00959
<a name="l00972"></a>00972 <span class="keyword">static</span> <span class="keyword">const</span> <span class="keywordtype">char</span> *<a class="code" href="a00129.html#a70cddbd6e3fd5352433b01edff3dc2a4" title="Text translation and localization.">text</a>(<span class="keyword">const</span> <span class="keywordtype">char</span> *<span class="keywordtype">string</span>);
<a name="l00973"></a>00973
<a name="l00983"></a>00983 <span class="keyword">static</span> <span class="keyword">const</span> <span class="keywordtype">char</span> *<a class="code" href="a00129.html#a2a3369cf118fe7a8dece5b25c5ed7280" title="Plural text translation and localization.">texts</a>(<span class="keyword">const</span> <span class="keywordtype">char</span> *singular, <span class="keyword">const</span> <span class="keywordtype">char</span> *plural, <span class="keywordtype">unsigned</span> <span class="keywordtype">long</span> count);
<a name="l00984"></a>00984
<a name="l00990"></a>00990 <span class="keyword">static</span> <span class="keywordtype">unsigned</span> <a class="code" href="a00067.html#a07d7fcec13030f492fb718230c89e2e3" title="Count the number of linked objects in a list.">count</a>(<span class="keywordtype">char</span> **argv);
<a name="l00991"></a>00991
<a name="l00992"></a>00992 <span class="preprocessor">#ifdef _MSWINDOWS_</span>
<a name="l00993"></a>00993 <span class="preprocessor"></span>
<a name="l00994"></a>00994 <span class="keyword">static</span> <span class="keyword">inline</span> fd_t input(<span class="keywordtype">void</span>)
<a name="l00995"></a>00995 {<span class="keywordflow">return</span> GetStdHandle(STD_INPUT_HANDLE);};
<a name="l00996"></a>00996
<a name="l00997"></a>00997 <span class="keyword">static</span> <span class="keyword">inline</span> fd_t output(<span class="keywordtype">void</span>)
<a name="l00998"></a>00998 {<span class="keywordflow">return</span> GetStdHandle(STD_OUTPUT_HANDLE);};
<a name="l00999"></a>00999
<a name="l01000"></a>01000 <span class="keyword">static</span> <span class="keyword">inline</span> fd_t error(<span class="keywordtype">void</span>)
<a name="l01001"></a>01001 {<span class="keywordflow">return</span> GetStdHandle(STD_ERROR_HANDLE);};
<a name="l01002"></a>01002
<a name="l01003"></a>01003 <span class="preprocessor">#else</span>
<a name="l01004"></a>01004 <span class="preprocessor"></span> <span class="keyword">static</span> <span class="keyword">inline</span> fd_t input(<span class="keywordtype">void</span>)
<a name="l01005"></a>01005 {<span class="keywordflow">return</span> 0;};
<a name="l01006"></a>01006
<a name="l01007"></a>01007 <span class="keyword">static</span> <span class="keyword">inline</span> fd_t output(<span class="keywordtype">void</span>)
<a name="l01008"></a>01008 {<span class="keywordflow">return</span> 1;};
<a name="l01009"></a>01009
<a name="l01010"></a>01010 <span class="keyword">static</span> <span class="keyword">inline</span> fd_t error(<span class="keywordtype">void</span>)
<a name="l01011"></a>01011 {<span class="keywordflow">return</span> 2;};
<a name="l01012"></a>01012 <span class="preprocessor">#endif</span>
<a name="l01013"></a>01013 <span class="preprocessor"></span>
<a name="l01014"></a>01014 <span class="keyword">static</span> <span class="keywordtype">int</span> inkey(<span class="keyword">const</span> <span class="keywordtype">char</span> *prompt = NULL);
<a name="l01015"></a>01015
<a name="l01016"></a>01016 <span class="keyword">static</span> <span class="keywordtype">char</span> *getpass(<span class="keyword">const</span> <span class="keywordtype">char</span> *prompt, <span class="keywordtype">char</span> *buffer, <span class="keywordtype">size_t</span> size);
<a name="l01017"></a>01017
<a name="l01018"></a>01018 <span class="keyword">static</span> <span class="keywordtype">char</span> *getline(<span class="keyword">const</span> <span class="keywordtype">char</span> *prompt, <span class="keywordtype">char</span> *buffer, <span class="keywordtype">size_t</span> size);
<a name="l01019"></a>01019
<a name="l01020"></a>01020 };
<a name="l01021"></a>01021
<a name="l01025"></a><a class="code" href="a00208.html#a43325a3985e498a2de91a046edd496ae">01025</a> <span class="keyword">typedef</span> <a class="code" href="a00129.html" title="A utility class for generic shell operations.">shell</a> <a class="code" href="a00129.html" title="A utility class for generic shell operations.">shell_t</a>;
<a name="l01026"></a>01026
<a name="l01030"></a>01030 <span class="preprocessor">#undef _TEXT</span>
<a name="l01031"></a>01031 <span class="preprocessor"></span><span class="preprocessor">#undef _STR</span>
<a name="l01032"></a>01032 <span class="preprocessor"></span>
<a name="l01040"></a><a class="code" href="a00208.html#afbf255b5ca1f4a456179441d8ade34d6">01040</a> <span class="keyword">inline</span> <span class="keyword">const</span> <span class="keywordtype">char</span> *<a class="code" href="a00208.html#afbf255b5ca1f4a456179441d8ade34d6" title="Abusive compilers.">_TEXT</a>(<span class="keyword">const</span> <span class="keywordtype">char</span> *s)
<a name="l01041"></a>01041 {<span class="keywordflow">return</span> shell::text(s);}
<a name="l01042"></a>01042
<a name="l01043"></a>01043 <span class="keyword">inline</span> <span class="keyword">const</span> <span class="keywordtype">char</span> *_STR(<a class="code" href="a00208.html#a9045ddbf2980f6330c065a6935f40161" title="A convenience type when mixing std::string in old compilers that are bad with namespaces...">String</a>& s)
<a name="l01044"></a>01044 {<span class="keywordflow">return</span> *s;}
<a name="l01045"></a>01045
<a name="l01046"></a>01046 END_NAMESPACE
<a name="l01047"></a>01047
<a name="l01048"></a>01048 <span class="preprocessor">#endif</span>
</pre></div></div>
<hr class="footer"/><address style="text-align: right;"><small>Generated on Thu Jul 14 16:38:56 2011 for ucommon by
<a href="http://www.doxygen.org/index.html">
<img class="footer" src="doxygen.png" alt="doxygen"/></a> 1.6.3 </small></address>
</body>
</html>
distrib
>
Mandriva
>
2010.2
>
i586
>
media
>
contrib-backports
>
by-pkgid
>
4f5f2dc0f55b453456458df885792b0b
>
files
>
520
