<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>Falcon Feathers - The Standard Modules Reference.</title>
<link href="faldoc.css" rel="stylesheet" type="text/css"/>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
</head>
<body class="faldoc_body">
<div class="navitop">
<div class="tabs">
<ul>
<li><a href="./index.html"><span>Main</span></a></li>
<li><a href="./modules.html"><span>Modules</span></a></li>
<li><a href="./pages.html"><span>Related pages</span></a></li>
<li><a href="./groups.html"><span>Groups</span></a></li>
<li><a href="./classes.html"><span>Classes</span></a></li>
<li><a href="./objects.html"><span>Objects</span></a></li>
<li><a href="./functions.html"><span>All functions</span></a></li>
<li><a href="./enum.html"><span>Enumerations</span></a></li>
</ul>
</div>
</div>
<hr/>
<h1 class="faldoc_title">Module Process </h1>
<p class="faldoc_brief">Process enumeration and subprocess control. </p>
<p class="faldoc_text"><p class="faldoc_text">The process module provides several functions to manage processes in the system and to manage interprocess communication. Child processes can be created and managed via the Process class, which provides a set of streams that can be read and written synchronously and polled for activity. </p>
<p class="faldoc_text">To provide this functionality, the Process class requires the service called "Stream" normally provided by the core module. Embedders that wish to allow the scripts to load this module should provide core to scripts, or provide otherwise the "Stream" service in the Virtual Machines that will run those scripts. Failing to do so will cause the stream oriented methods of the Process class to raise an error. The generic process management functions in the module, and also the generic child-process management methods in the Process class do not require this service, so embedders not willing to provide core may just turn overload the sensible Process methods or mask the Process class right away (or just ignore this fact letting the error to be raised in case of mis-usage). </p>
<p class="faldoc_text">As the Falcon command line automatically loads the core module, this remark does not apply to stand-alone scripts. </p>
<p class="faldoc_text">The Process module declares a ProcessError class, derived from core Error class, which doesn't change any of its property or method. The ProcessError class is used to mark errors raised by this module. </p>
<p class="faldoc_text">While the OS typically ensures that none of the functions declared in this module may actually fail, unless system conditions are critical, every function or method in this module may raise this error in case of unexpected system behavior. </p>
<p class="faldoc_note"><span class="faldoc_notetype">Note:</span> To make the entities delcared in this module available to falcon scripts use the command: </p>
<pre class="faldoc_code">
load process
</pre>
</p>
<h2 class="faldoc_title">Classes</h2>
<table class="faldoc_list">
<tr><td class="faldoc_funcname"><a href="./class_Process.html">Process</a></td><td class="faldoc_funcbrief">Execute and control child processes. </td></tr>
<tr><td class="faldoc_funcname"><a href="./class_ProcessEnum.html">ProcessEnum</a></td><td class="faldoc_funcbrief">Provides a list of currently executed process. </td></tr>
<tr><td class="faldoc_funcname"><a href="./class_ProcessError.html">ProcessError</a></td><td class="faldoc_funcbrief">Error generated by process related system failures. </td></tr>
</table>
<h2 class="faldoc_title">All functions</h2>
<table class="faldoc_list">
<tr><td class="faldoc_funcname"><a href="./functions.html#exec">exec</a></td><td class="faldoc_funcbrief">Launches a process in place of the host process. </td></tr>
<tr><td class="faldoc_funcname"><a href="./functions.html#pread">pread</a></td><td class="faldoc_funcbrief">Executes an external process and waits for its termination. </td></tr>
<tr><td class="faldoc_funcname"><a href="./functions.html#processId">processId</a></td><td class="faldoc_funcbrief">Returns the process ID of the process hosting the Falcon VM. </td></tr>
<tr><td class="faldoc_funcname"><a href="./functions.html#processKill">processKill</a></td><td class="faldoc_funcbrief">Terminates the given process given its ID, if possible. </td></tr>
<tr><td class="faldoc_funcname"><a href="./functions.html#system">system</a></td><td class="faldoc_funcbrief">Executes an external process via command shell, and waits for its termination. </td></tr>
<tr><td class="faldoc_funcname"><a href="./functions.html#systemCall">systemCall</a></td><td class="faldoc_funcbrief">Executes an external process and waits for its termination. </td></tr>
</table>
<hr/>
<div class="navibottom">
<center>
<a href="./index.html">Main</a> - <a href="./modules.html">Modules</a> - <a href="./pages.html">Related pages</a> - <a href="./groups.html">Groups</a> - <a href="./classes.html">Classes</a> - <a href="./objects.html">Objects</a> - <a href="./functions.html">All functions</a> - <a href="./enum.html">Enumerations</a>
</center>
</div>
</div>
<div class="faldoc_signature">Made with <a href="http://www.falconpl.org">faldoc 2.2.0</div>
</body>
</html>
