<!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>GNU CommonC++: ost::Process Class Reference</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="index.html"><span>Main Page</span></a></li>
<li><a href="namespaces.html"><span>Namespaces</span></a></li>
<li class="current"><a href="annotated.html"><span>Classes</span></a></li>
<li><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="annotated.html"><span>Class List</span></a></li>
<li><a href="classes.html"><span>Class Index</span></a></li>
<li><a href="hierarchy.html"><span>Class Hierarchy</span></a></li>
<li><a href="functions.html"><span>Class Members</span></a></li>
</ul>
</div>
<div class="navpath"><a class="el" href="namespaceost.html">ost</a>::<a class="el" href="classost_1_1_process.html">Process</a>
</div>
</div>
<div class="contents">
<h1>ost::Process Class Reference</h1><!-- doxytag: class="ost::Process" -->
<p>A class for containing portable process related functions that help create portable code.
<a href="#_details">More...</a></p>
<p><code>#include <<a class="el" href="process_8h_source.html">process.h</a>></code></p>
<p><a href="classost_1_1_process-members.html">List of all members.</a></p>
<table border="0" cellpadding="0" cellspacing="0">
<tr><td colspan="2"><h2>Public Types</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">typedef void(* </td><td class="memItemRight" valign="bottom"><a class="el" href="classost_1_1_process.html#afd1f34ba1583f0dd14cfeb7207663829">Trap</a> )(int)</td></tr>
<tr><td colspan="2"><h2>Public Member Functions</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classost_1_1_process.html#a3f8660a112bf25128a743fb599681cf2">lock</a> (bool future=true)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Lock a process in memory. <a href="#a3f8660a112bf25128a743fb599681cf2"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classost_1_1_process.html#a3cc2b549525e914931a2829faccc4f44">unlock</a> (void)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Unlock process pages. <a href="#a3cc2b549525e914931a2829faccc4f44"></a><br/></td></tr>
<tr><td colspan="2"><h2>Static Public Member Functions</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">static void </td><td class="memItemRight" valign="bottom"><a class="el" href="classost_1_1_process.html#a43102f60a1dd16da2d812e9c6d77d2b9">detach</a> (void)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Detach current process into a daemon, posix only. <a href="#a43102f60a1dd16da2d812e9c6d77d2b9"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">static void </td><td class="memItemRight" valign="bottom"><a class="el" href="classost_1_1_process.html#a65113d14afb60393a852c859e0ddf037">attach</a> (const char *devname)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Attach the current process to another device or i/o session. <a href="#a65113d14afb60393a852c859e0ddf037"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">static <a class="el" href="classost_1_1_process.html#afd1f34ba1583f0dd14cfeb7207663829">Trap</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classost_1_1_process.html#ad864f14f892fd2ff09483748e7d6a328">setPosixSignal</a> (int signo, <a class="el" href="classost_1_1_process.html#afd1f34ba1583f0dd14cfeb7207663829">Trap</a> handler)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Set a posix compliant signal handler. <a href="#ad864f14f892fd2ff09483748e7d6a328"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">static <a class="el" href="classost_1_1_process.html#afd1f34ba1583f0dd14cfeb7207663829">Trap</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classost_1_1_process.html#adf3c850256b0e817298ddeb95f4b4630">setInterruptSignal</a> (int signo, <a class="el" href="classost_1_1_process.html#afd1f34ba1583f0dd14cfeb7207663829">Trap</a> handler)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Set system call interuptable signal handler. <a href="#adf3c850256b0e817298ddeb95f4b4630"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">static int </td><td class="memItemRight" valign="bottom"><a class="el" href="classost_1_1_process.html#af689ef760fdefb3dfb998950ad1c62a9">spawn</a> (const char *exec, const char **argv, bool wait=true)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Spawn a process and wait for it's exit code. <a href="#af689ef760fdefb3dfb998950ad1c62a9"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">static int </td><td class="memItemRight" valign="bottom"><a class="el" href="classost_1_1_process.html#acc251d46caa853b285ba1d4e19d500ac">join</a> (int pid)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Get the exit status of another process, waiting for it to exit. <a href="#acc251d46caa853b285ba1d4e19d500ac"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">static bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classost_1_1_process.html#a6a94b9da9e6f879663520f774b140249">cancel</a> (int pid, int sig=0)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Cancel a running child process. <a href="#a6a94b9da9e6f879663520f774b140249"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">static const char * </td><td class="memItemRight" valign="bottom"><a class="el" href="classost_1_1_process.html#a24a26249ddd3dd99104d71d37bf02064">getEnv</a> (const char *name)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Get system environment. <a href="#a24a26249ddd3dd99104d71d37bf02064"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">static void </td><td class="memItemRight" valign="bottom"><a class="el" href="classost_1_1_process.html#a94a4b4f321b076d59b0fe8902c6ba794">setEnv</a> (const char *name, const char *value, bool overwrite)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Set system environment in a standard manner. <a href="#a94a4b4f321b076d59b0fe8902c6ba794"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">static const char * </td><td class="memItemRight" valign="bottom"><a class="el" href="classost_1_1_process.html#a9d7c073f3c473f7eead6a6613ff98c00">getConfigDir</a> (void)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Get etc prefix path. <a href="#a9d7c073f3c473f7eead6a6613ff98c00"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">static const char * </td><td class="memItemRight" valign="bottom"><a class="el" href="classost_1_1_process.html#a3d99258c5b247accaaf8fa5344288428">getHomeDir</a> (void)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Get home directory. <a href="#a3d99258c5b247accaaf8fa5344288428"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">static const char * </td><td class="memItemRight" valign="bottom"><a class="el" href="classost_1_1_process.html#a1d1fd732ed82e74b8f749ad2e171361a">getUser</a> (void)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Get user name. <a href="#a1d1fd732ed82e74b8f749ad2e171361a"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">static bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classost_1_1_process.html#a2682d8f8aec63d61201b247b4d437aa3">setUser</a> (const char *id, bool grp=true)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Set user id by name. <a href="#a2682d8f8aec63d61201b247b4d437aa3"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">static bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classost_1_1_process.html#abf659310fab24472fb1b8f9797383b8e">setGroup</a> (const char *id)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Set the effective group id by name. <a href="#abf659310fab24472fb1b8f9797383b8e"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">static size_t </td><td class="memItemRight" valign="bottom"><a class="el" href="classost_1_1_process.html#a00d16fe1c73744546658a1a0f13906df">getPageSize</a> (void)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Return the effective operating system page size. <a href="#a00d16fe1c73744546658a1a0f13906df"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">static void </td><td class="memItemRight" valign="bottom"><a class="el" href="classost_1_1_process.html#a6b17c10f9f12ba9a965400c87e17a62a">setPriority</a> (int pri)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Used to set process priority and optionally enable realtime. <a href="#a6b17c10f9f12ba9a965400c87e17a62a"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">static void </td><td class="memItemRight" valign="bottom"><a class="el" href="classost_1_1_process.html#a4751f7ca53e7c15ae0ab5e29952fe65d">setScheduler</a> (const char *policy)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Used to set process scheduling policy. <a href="#a4751f7ca53e7c15ae0ab5e29952fe65d"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">static void </td><td class="memItemRight" valign="bottom"><a class="el" href="classost_1_1_process.html#a26cf80b6ae71b5baa323fe8e0ede944b">setRealtime</a> (int pri=0)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Portable shortcut for setting realtime. <a href="#a26cf80b6ae71b5baa323fe8e0ede944b"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">static bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classost_1_1_process.html#afdd74b2a47c76ad88df0ba81991ef947">isScheduler</a> (void)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Return true if scheduler settable. <a href="#afdd74b2a47c76ad88df0ba81991ef947"></a><br/></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">static bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classost_1_1_process.html#a5f2fe33d0088b1c2db43613581fe04e2">isRealtime</a> (void)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Return true if realtime scheduling. <a href="#a5f2fe33d0088b1c2db43613581fe04e2"></a><br/></td></tr>
</table>
<hr/><a name="_details"></a><h2>Detailed Description</h2>
<p>A class for containing portable process related functions that help create portable code. </p>
<p>These are typically referenced thru Process::xxx static member functions. Many of these members are used both for win32 and posix systems although some may be platform specific.</p>
<p>Peocess wrapper class. </p>
<dl class="author"><dt><b>Author:</b></dt><dd>David Sugar <<a href="mailto:dyfet@ostel.com">dyfet@ostel.com</a>> </dd></dl>
<hr/><h2>Member Typedef Documentation</h2>
<a class="anchor" id="afd1f34ba1583f0dd14cfeb7207663829"></a><!-- doxytag: member="ost::Process::Trap" ref="afd1f34ba1583f0dd14cfeb7207663829" args=")(int)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">typedef void(* <a class="el" href="classost_1_1_process.html#afd1f34ba1583f0dd14cfeb7207663829">ost::Process::Trap</a>)(int)</td>
</tr>
</table>
</div>
<div class="memdoc">
</div>
</div>
<hr/><h2>Member Function Documentation</h2>
<a class="anchor" id="a65113d14afb60393a852c859e0ddf037"></a><!-- doxytag: member="ost::Process::attach" ref="a65113d14afb60393a852c859e0ddf037" args="(const char *devname)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">static void ost::Process::attach </td>
<td>(</td>
<td class="paramtype">const char * </td>
<td class="paramname"> <em>devname</em></td>
<td> ) </td>
<td><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Attach the current process to another device or i/o session. </p>
<p>It is deamonified and dissasociated with the prior parent process and controlling terminal.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>devname</em> </td><td>path to attach to. </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<a class="anchor" id="a6a94b9da9e6f879663520f774b140249"></a><!-- doxytag: member="ost::Process::cancel" ref="a6a94b9da9e6f879663520f774b140249" args="(int pid, int sig=0)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">static bool ost::Process::cancel </td>
<td>(</td>
<td class="paramtype">int </td>
<td class="paramname"> <em>pid</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"> <em>sig</em> = <code>0</code></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Cancel a running child process. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>0 on success. </dd></dl>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>pid</em> </td><td>process id. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>sig</em> </td><td>cancel signal to apply. </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<a class="anchor" id="a43102f60a1dd16da2d812e9c6d77d2b9"></a><!-- doxytag: member="ost::Process::detach" ref="a43102f60a1dd16da2d812e9c6d77d2b9" args="(void)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">static void ost::Process::detach </td>
<td>(</td>
<td class="paramtype">void </td>
<td class="paramname"></td>
<td> ) </td>
<td><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Detach current process into a daemon, posix only. </p>
<p>Perhaps a similar method can be used for creating win32 "services"? </p>
</div>
</div>
<a class="anchor" id="a9d7c073f3c473f7eead6a6613ff98c00"></a><!-- doxytag: member="ost::Process::getConfigDir" ref="a9d7c073f3c473f7eead6a6613ff98c00" args="(void)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">static const char* ost::Process::getConfigDir </td>
<td>(</td>
<td class="paramtype">void </td>
<td class="paramname"></td>
<td> ) </td>
<td><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Get etc prefix path. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>etc prefix. </dd></dl>
</div>
</div>
<a class="anchor" id="a24a26249ddd3dd99104d71d37bf02064"></a><!-- doxytag: member="ost::Process::getEnv" ref="a24a26249ddd3dd99104d71d37bf02064" args="(const char *name)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">static const char* ost::Process::getEnv </td>
<td>(</td>
<td class="paramtype">const char * </td>
<td class="paramname"> <em>name</em></td>
<td> ) </td>
<td><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Get system environment. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>system environ symbol. </dd></dl>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>name</em> </td><td>of symbol. </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<a class="anchor" id="a3d99258c5b247accaaf8fa5344288428"></a><!-- doxytag: member="ost::Process::getHomeDir" ref="a3d99258c5b247accaaf8fa5344288428" args="(void)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">static const char* ost::Process::getHomeDir </td>
<td>(</td>
<td class="paramtype">void </td>
<td class="paramname"></td>
<td> ) </td>
<td><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Get home directory. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>user home directory. </dd></dl>
</div>
</div>
<a class="anchor" id="a00d16fe1c73744546658a1a0f13906df"></a><!-- doxytag: member="ost::Process::getPageSize" ref="a00d16fe1c73744546658a1a0f13906df" args="(void)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">static size_t ost::Process::getPageSize </td>
<td>(</td>
<td class="paramtype">void </td>
<td class="paramname"></td>
<td> ) </td>
<td><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Return the effective operating system page size. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>system page size. </dd></dl>
</div>
</div>
<a class="anchor" id="a1d1fd732ed82e74b8f749ad2e171361a"></a><!-- doxytag: member="ost::Process::getUser" ref="a1d1fd732ed82e74b8f749ad2e171361a" args="(void)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">static const char* ost::Process::getUser </td>
<td>(</td>
<td class="paramtype">void </td>
<td class="paramname"></td>
<td> ) </td>
<td><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Get user name. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>user login id. </dd></dl>
</div>
</div>
<a class="anchor" id="a5f2fe33d0088b1c2db43613581fe04e2"></a><!-- doxytag: member="ost::Process::isRealtime" ref="a5f2fe33d0088b1c2db43613581fe04e2" args="(void)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">static bool ost::Process::isRealtime </td>
<td>(</td>
<td class="paramtype">void </td>
<td class="paramname"></td>
<td> ) </td>
<td><code> [inline, static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Return true if realtime scheduling. </p>
</div>
</div>
<a class="anchor" id="afdd74b2a47c76ad88df0ba81991ef947"></a><!-- doxytag: member="ost::Process::isScheduler" ref="afdd74b2a47c76ad88df0ba81991ef947" args="(void)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">static bool ost::Process::isScheduler </td>
<td>(</td>
<td class="paramtype">void </td>
<td class="paramname"></td>
<td> ) </td>
<td><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Return true if scheduler settable. </p>
</div>
</div>
<a class="anchor" id="acc251d46caa853b285ba1d4e19d500ac"></a><!-- doxytag: member="ost::Process::join" ref="acc251d46caa853b285ba1d4e19d500ac" args="(int pid)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">static int ost::Process::join </td>
<td>(</td>
<td class="paramtype">int </td>
<td class="paramname"> <em>pid</em></td>
<td> ) </td>
<td><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Get the exit status of another process, waiting for it to exit. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>exit code from process. </dd></dl>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>pid</em> </td><td>process id. </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<a class="anchor" id="a3f8660a112bf25128a743fb599681cf2"></a><!-- doxytag: member="ost::Process::lock" ref="a3f8660a112bf25128a743fb599681cf2" args="(bool future=true)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">bool ost::Process::lock </td>
<td>(</td>
<td class="paramtype">bool </td>
<td class="paramname"> <em>future</em> = <code>true</code></td>
<td> ) </td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Lock a process in memory. </p>
<p>Ideally you should be deep enough where additional memallocs for functions will not kill you, or use false for future.</p>
<dl class="return"><dt><b>Returns:</b></dt><dd>true if successful. </dd></dl>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>future</em> </td><td>pages as well... </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<a class="anchor" id="a94a4b4f321b076d59b0fe8902c6ba794"></a><!-- doxytag: member="ost::Process::setEnv" ref="a94a4b4f321b076d59b0fe8902c6ba794" args="(const char *name, const char *value, bool overwrite)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">static void ost::Process::setEnv </td>
<td>(</td>
<td class="paramtype">const char * </td>
<td class="paramname"> <em>name</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"> <em>value</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">bool </td>
<td class="paramname"> <em>overwrite</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Set system environment in a standard manner. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>name</em> </td><td>of environment symbol to set. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>value</em> </td><td>of environment symbol. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>overwrite</em> </td><td>true if replace existing symbol. </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<a class="anchor" id="abf659310fab24472fb1b8f9797383b8e"></a><!-- doxytag: member="ost::Process::setGroup" ref="abf659310fab24472fb1b8f9797383b8e" args="(const char *id)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">static bool ost::Process::setGroup </td>
<td>(</td>
<td class="paramtype">const char * </td>
<td class="paramname"> <em>id</em></td>
<td> ) </td>
<td><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Set the effective group id by name. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>true if successful. </dd></dl>
</div>
</div>
<a class="anchor" id="adf3c850256b0e817298ddeb95f4b4630"></a><!-- doxytag: member="ost::Process::setInterruptSignal" ref="adf3c850256b0e817298ddeb95f4b4630" args="(int signo, Trap handler)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">static <a class="el" href="classost_1_1_process.html#afd1f34ba1583f0dd14cfeb7207663829">Trap</a> ost::Process::setInterruptSignal </td>
<td>(</td>
<td class="paramtype">int </td>
<td class="paramname"> <em>signo</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="classost_1_1_process.html#afd1f34ba1583f0dd14cfeb7207663829">Trap</a> </td>
<td class="paramname"> <em>handler</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Set system call interuptable signal handler. </p>
<p>return previous handler. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>signo</em> </td><td>signal no. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>handler</em> </td><td>trap handler. </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<a class="anchor" id="ad864f14f892fd2ff09483748e7d6a328"></a><!-- doxytag: member="ost::Process::setPosixSignal" ref="ad864f14f892fd2ff09483748e7d6a328" args="(int signo, Trap handler)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">static <a class="el" href="classost_1_1_process.html#afd1f34ba1583f0dd14cfeb7207663829">Trap</a> ost::Process::setPosixSignal </td>
<td>(</td>
<td class="paramtype">int </td>
<td class="paramname"> <em>signo</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="classost_1_1_process.html#afd1f34ba1583f0dd14cfeb7207663829">Trap</a> </td>
<td class="paramname"> <em>handler</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Set a posix compliant signal handler. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>previous handler. </dd></dl>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>signo</em> </td><td>signal no. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>handler</em> </td><td>trap handler. </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<a class="anchor" id="a6b17c10f9f12ba9a965400c87e17a62a"></a><!-- doxytag: member="ost::Process::setPriority" ref="a6b17c10f9f12ba9a965400c87e17a62a" args="(int pri)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">static void ost::Process::setPriority </td>
<td>(</td>
<td class="paramtype">int </td>
<td class="paramname"> <em>pri</em></td>
<td> ) </td>
<td><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Used to set process priority and optionally enable realtime. </p>
</div>
</div>
<a class="anchor" id="a26cf80b6ae71b5baa323fe8e0ede944b"></a><!-- doxytag: member="ost::Process::setRealtime" ref="a26cf80b6ae71b5baa323fe8e0ede944b" args="(int pri=0)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">static void ost::Process::setRealtime </td>
<td>(</td>
<td class="paramtype">int </td>
<td class="paramname"> <em>pri</em> = <code>0</code></td>
<td> ) </td>
<td><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Portable shortcut for setting realtime. </p>
<p>.. </p>
</div>
</div>
<a class="anchor" id="a4751f7ca53e7c15ae0ab5e29952fe65d"></a><!-- doxytag: member="ost::Process::setScheduler" ref="a4751f7ca53e7c15ae0ab5e29952fe65d" args="(const char *policy)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">static void ost::Process::setScheduler </td>
<td>(</td>
<td class="paramtype">const char * </td>
<td class="paramname"> <em>policy</em></td>
<td> ) </td>
<td><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Used to set process scheduling policy. </p>
</div>
</div>
<a class="anchor" id="a2682d8f8aec63d61201b247b4d437aa3"></a><!-- doxytag: member="ost::Process::setUser" ref="a2682d8f8aec63d61201b247b4d437aa3" args="(const char *id, bool grp=true)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">static bool ost::Process::setUser </td>
<td>(</td>
<td class="paramtype">const char * </td>
<td class="paramname"> <em>id</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">bool </td>
<td class="paramname"> <em>grp</em> = <code>true</code></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Set user id by name. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>true if successful. </dd></dl>
</div>
</div>
<a class="anchor" id="af689ef760fdefb3dfb998950ad1c62a9"></a><!-- doxytag: member="ost::Process::spawn" ref="af689ef760fdefb3dfb998950ad1c62a9" args="(const char *exec, const char **argv, bool wait=true)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">static int ost::Process::spawn </td>
<td>(</td>
<td class="paramtype">const char * </td>
<td class="paramname"> <em>exec</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char ** </td>
<td class="paramname"> <em>argv</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">bool </td>
<td class="paramname"> <em>wait</em> = <code>true</code></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Spawn a process and wait for it's exit code. </p>
<p>In win32 this is done with the spawn system call. In posix, this is done with a fork, an execvp, and a waitpid.</p>
<dl class="warning"><dt><b>Warning:</b></dt><dd>The implementation differences between posix and win32 systems may cause side effects. For instance, if you use atexit() and this spawn method, on posix systems the function set up with atexit() will be called when the parent process of the fork exits, which will not happen on Win32 systems.</dd></dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>error code from process. </dd></dl>
<dl><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>exec</em> </td><td>name of executable. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>argv</em> </td><td>list of command arguments. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>wait</em> </td><td>for process to exit before return. </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<a class="anchor" id="a3cc2b549525e914931a2829faccc4f44"></a><!-- doxytag: member="ost::Process::unlock" ref="a3cc2b549525e914931a2829faccc4f44" args="(void)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void ost::Process::unlock </td>
<td>(</td>
<td class="paramtype">void </td>
<td class="paramname"></td>
<td> ) </td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Unlock process pages. </p>
</div>
</div>
<hr/>The documentation for this class was generated from the following file:<ul>
<li><a class="el" href="process_8h_source.html">process.h</a></li>
</ul>
</div>
<hr class="footer"/><address style="text-align: right;"><small>Generated on Fri Nov 12 09:57:39 2010 for GNU CommonC++ 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.1
>
x86_64
>
media
>
main-updates
>
by-pkgid
>
f36f42783f75191f5f2d47f1e8c5504e
>
files
>
291
