python-execnet 1.0.9-0.1 / usr / share / doc / python-execnet / html / basics.html

This file is indexed.

/usr/share/doc/python-execnet/html/basics.html is in python-execnet 1.0.9-0.1.

This file is owned by root:root, with mode 0o644.

The actual contents of the file can be viewed below. 

  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
<!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/html; charset=utf-8" />
    
    <title>API in a nutshell &mdash; execnet 1.0.8 documentation</title>
    
    <link rel="stylesheet" href="_static/sphinxdoc.css" type="text/css" />
    <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
    
    <script type="text/javascript">
      var DOCUMENTATION_OPTIONS = {
        URL_ROOT:    '',
        VERSION:     '1.0.8',
        COLLAPSE_INDEX: false,
        FILE_SUFFIX: '.html',
        HAS_SOURCE:  true
      };
    </script>
    <script type="text/javascript" src="_static/jquery.js"></script>
    <script type="text/javascript" src="_static/underscore.js"></script>
    <script type="text/javascript" src="_static/doctools.js"></script>
    <link rel="top" title="execnet 1.0.8 documentation" href="index.html" />
    <link rel="up" title="Info in a nutshell" href="install.html" />
    <link rel="next" title="execnet CHANGELOG" href="changelog.html" />
    <link rel="prev" title="Receive file contents from remote SSH account" href="example/test_ssh_fileserver.html" /> 
  </head>
  <body>
<div style="background-color: white; text-align: left; padding: 10px 10px 15px 15px">
<!--<img src="_static/codespeak2.png" target="http://codespeak.net" alt="codespeak projects" />
-->
<h1>execnet: rapid multi-Python deployment</h1>
<code style="font-size: 130%; vertical-align: middle;">
        <a href="index.html">home</a>&nbsp;|&nbsp;
        <a href="install.html">install</a>&nbsp;|&nbsp;
        <a href="examples.html">examples</a>&nbsp;|&nbsp;
        <a href="#">basic API</a>&nbsp;|&nbsp;
        <a href="support.html">support</a>&nbsp;
</code>
</div>

    <div class="related">
      <h3>Navigation</h3>
      <ul>
        <li class="right" style="margin-right: 10px">
          <a href="genindex.html" title="General Index"
             accesskey="I">index</a></li>
        <li class="right" >
          <a href="changelog.html" title="execnet CHANGELOG"
             accesskey="N">next</a> |</li>
        <li class="right" >
          <a href="example/test_ssh_fileserver.html" title="Receive file contents from remote SSH account"
             accesskey="P">previous</a> |</li>
        <!-- <a href="index.html">index</a>&raquo;</li> -->

          <li><a href="install.html" accesskey="U">Info in a nutshell</a> &raquo;</li> 
      </ul>
    </div>
      <div class="sphinxsidebar">
        <div class="sphinxsidebarwrapper">
  <h3><a href="index.html">Table Of Contents</a></h3>
  <ul>
<li><a class="reference internal" href="#">API in a nutshell</a><ul>
<li><a class="reference internal" href="#gateways-bootstrapping-python-interpreters">Gateways: bootstrapping Python interpreters</a><ul>
<li><a class="reference internal" href="#examples-for-valid-gateway-specifications">examples for valid gateway specifications</a></li>
</ul>
</li>
<li><a class="reference internal" href="#remote-exec-execute-source-code-remotely">remote_exec: execute source code remotely</a></li>
<li><a class="reference internal" href="#channels-exchanging-data-with-remote-code">Channels: exchanging data with remote code</a></li>
<li><a class="reference internal" href="#grouped-gateways-and-robust-termination">Grouped Gateways and robust termination</a></li>
<li><a class="reference internal" href="#remote-status-get-low-level-execution-info">remote_status: get low-level execution info</a></li>
<li><a class="reference internal" href="#rsync-synchronise-filesystem-with-remote">rsync: synchronise filesystem with remote</a></li>
<li><a class="reference internal" href="#debugging-execnet">Debugging execnet</a></li>
</ul>
</li>
</ul>

  <h4>Previous topic</h4>
  <p class="topless"><a href="example/test_ssh_fileserver.html"
                        title="previous chapter">Receive file contents from remote SSH account</a></p>
  <h4>Next topic</h4>
  <p class="topless"><a href="changelog.html"
                        title="next chapter">execnet CHANGELOG</a></p>
<div id="searchbox" style="display: none">
  <h3>Quick search</h3>
    <form class="search" action="search.html" method="get">
      <input type="text" name="q" />
      <input type="submit" value="Go" />
      <input type="hidden" name="check_keywords" value="yes" />
      <input type="hidden" name="area" value="default" />
    </form>
    <p class="searchtip" style="font-size: 90%">
    Enter search terms or a module, class or function name.
    </p>
</div>
<script type="text/javascript">$('#searchbox').show(0);</script>
        </div>
      </div>

    <div class="document">
      <div class="documentwrapper">
        <div class="bodywrapper">
          <div class="body">
            
  <div class="section" id="api-in-a-nutshell">
<h1>API in a nutshell<a class="headerlink" href="#api-in-a-nutshell" title="Permalink to this headline"></a></h1>
<p>execnet ad-hoc instantiates local and remote Python interpreters.
Each interpreter is accessible through a <strong>Gateway</strong> which manages
code and data communication.  <strong>Channels</strong> allow to exchange
data between the local and the remote end.  <strong>Groups</strong>
help to manage creation and termination of sub interpreters.</p>
<img alt="_images/basic1.png" src="_images/basic1.png" />
<div class="section" id="gateways-bootstrapping-python-interpreters">
<h2>Gateways: bootstrapping Python interpreters<a class="headerlink" href="#gateways-bootstrapping-python-interpreters" title="Permalink to this headline"></a></h2>
<p>All Gateways are instantiated via a call to <tt class="docutils literal"><span class="pre">makegateway()</span></tt>
passing it a gateway specification or URL.</p>
<span class="target" id="xspec"></span><dl class="function">
<dt id="execnet.makegateway">
<tt class="descclassname">execnet.</tt><tt class="descname">makegateway</tt><big>(</big><em>spec</em><big>)</big><a class="headerlink" href="#execnet.makegateway" title="Permalink to this definition"></a></dt>
<dd><p>create and configure a gateway to a Python interpreter.
The <tt class="docutils literal"><span class="pre">spec</span></tt> string encodes the target gateway type
and configuration information. The general format is:</p>
<div class="highlight-python"><div class="highlight"><pre><span class="n">key1</span><span class="o">=</span><span class="n">value1</span><span class="o">//</span><span class="n">key2</span><span class="o">=</span><span class="n">value2</span><span class="o">//...</span>
</pre></div>
</div>
<p>If you leave out the <tt class="docutils literal"><span class="pre">=value</span></tt> part a True value is assumed.
Valid types: <tt class="docutils literal"><span class="pre">popen</span></tt>, <tt class="docutils literal"><span class="pre">ssh=hostname</span></tt>, <tt class="docutils literal"><span class="pre">socket=host:port</span></tt>.
Valid configuration:</p>
<div class="highlight-python"><pre>id=&lt;string&gt;     specifies the gateway id
python=&lt;path&gt;   specifies which python interpreter to execute
chdir=&lt;path&gt;    specifies to which directory to change
nice=&lt;path&gt;     specifies process priority of new process
env:NAME=value  specifies a remote environment variable setting.</pre>
</div>
<p>If no spec is given, self.defaultspec is used.</p>
</dd></dl>

<p>Here is an example which instantiates a simple Python subprocess:</p>
<div class="highlight-python"><div class="highlight"><pre><span class="gp">&gt;&gt;&gt; </span><span class="n">gateway</span> <span class="o">=</span> <span class="n">execnet</span><span class="o">.</span><span class="n">makegateway</span><span class="p">()</span>
</pre></div>
</div>
<p>gateways allow to <a class="reference internal" href="#remote-execute-code">remote execute code</a> and
<a class="reference internal" href="#exchange-data">exchange data</a> bidirectionally.</p>
<div class="section" id="examples-for-valid-gateway-specifications">
<h3>examples for valid gateway specifications<a class="headerlink" href="#examples-for-valid-gateway-specifications" title="Permalink to this headline"></a></h3>
<ul class="simple">
<li><tt class="docutils literal"><span class="pre">ssh=wyvern//python=python2.4//chdir=mycache</span></tt> specifies a Python2.4
interpreter on the host <tt class="docutils literal"><span class="pre">wyvern</span></tt>.  The remote process will have
<tt class="docutils literal"><span class="pre">mycache</span></tt> as its current working directory.</li>
<li><tt class="docutils literal"><span class="pre">popen//python=2.5//nice=20</span></tt> specification of a python2.5
subprocess; running with the lowest CPU priority (&#8220;nice&#8221; level).
By default current dir will be the current dir of the instantiator.</li>
<li><tt class="docutils literal"><span class="pre">popen//env:NAME=value</span></tt> specifies a subprocess that uses the
same interpreter as the one it is initiated from and additionally
remotely sets an environment variable <tt class="docutils literal"><span class="pre">NAME</span></tt> to <tt class="docutils literal"><span class="pre">value</span></tt>.</li>
<li><tt class="docutils literal"><span class="pre">socket=192.168.1.4:8888</span></tt> specifies a Python Socket server
process that listens on 192.168.1.4:8888``</li>
</ul>
</div>
</div>
<div class="section" id="remote-exec-execute-source-code-remotely">
<span id="remote-execute-code"></span><h2>remote_exec: execute source code remotely<a class="headerlink" href="#remote-exec-execute-source-code-remotely" title="Permalink to this headline"></a></h2>
<p>All gateways offer a simple method to execute source code
in the connected interpreter:</p>
<dl class="method">
<dt id="execnet.gateway.Gateway.remote_exec">
<tt class="descclassname">Gateway.</tt><tt class="descname">remote_exec</tt><big>(</big><em>source</em><big>)</big><a class="headerlink" href="#execnet.gateway.Gateway.remote_exec" title="Permalink to this definition"></a></dt>
<dd><p>return channel object and connect it to a remote
execution thread where the given <tt class="docutils literal"><span class="pre">source</span></tt> executes.</p>
<ul class="simple">
<li><tt class="docutils literal"><span class="pre">source</span></tt> is a string: execute source string remotely
with a <tt class="docutils literal"><span class="pre">channel</span></tt> put into the global namespace.</li>
<li><tt class="docutils literal"><span class="pre">source</span></tt> is a pure function: serialize source and
call function with <tt class="docutils literal"><span class="pre">**kwargs</span></tt>, adding a
<tt class="docutils literal"><span class="pre">channel</span></tt> object to the keyword arguments.</li>
<li><tt class="docutils literal"><span class="pre">source</span></tt> is a pure module: execute source of module
with a <tt class="docutils literal"><span class="pre">channel</span></tt> in its global namespace</li>
</ul>
<p>In all cases the binding <tt class="docutils literal"><span class="pre">__name__='__channelexec__'</span></tt>
will be available in the global namespace of the remotely
executing code.</p>
</dd></dl>

<p>It is allowed to pass a module object as source code
in which case it&#8217;s source code will be obtained and
get sent for remote execution.  <tt class="docutils literal"><span class="pre">remote_exec</span></tt> returns
a channel object whose symmetric counterpart channel
is available to the remotely executing source.</p>
<dl class="method">
<dt id="execnet.gateway.Gateway.reconfigure">
<tt class="descclassname">Gateway.</tt><tt class="descname">reconfigure</tt><big>(</big><span class="optional">[</span><em>py2str_as_py3str=True</em>, <em>py3str_as_py2str=False</em><span class="optional">]</span><big>)</big><a class="headerlink" href="#execnet.gateway.Gateway.reconfigure" title="Permalink to this definition"></a></dt>
<dd><p>reconfigures the string-coercion behaviour of the gateway</p>
</dd></dl>

</div>
<div class="section" id="channels-exchanging-data-with-remote-code">
<span id="exchange-data"></span><span id="channel-api"></span><span id="channel"></span><h2>Channels: exchanging data with remote code<a class="headerlink" href="#channels-exchanging-data-with-remote-code" title="Permalink to this headline"></a></h2>
<p>A channel object allows to send and receive data between
two asynchronously running programs.</p>
<blockquote>
<div><dl class="method">
<dt id="execnet.gateway_base.Channel.send">
<tt class="descclassname">Channel.</tt><tt class="descname">send</tt><big>(</big><em>item</em><big>)</big><a class="headerlink" href="#execnet.gateway_base.Channel.send" title="Permalink to this definition"></a></dt>
<dd><p>sends the given item to the other side of the channel,
possibly blocking if the sender queue is full.
The item must be a simple python type and will be
copied to the other side by value.  IOError is
raised if the write pipe was prematurely closed.</p>
</dd></dl>

<dl class="method">
<dt id="execnet.gateway_base.Channel.receive">
<tt class="descclassname">Channel.</tt><tt class="descname">receive</tt><big>(</big><em>timeout</em><big>)</big><a class="headerlink" href="#execnet.gateway_base.Channel.receive" title="Permalink to this definition"></a></dt>
<dd><p>receive a data item that was sent from the other side.
timeout: -1 [default] blocked waiting, but wake up periodically
to let CTRL-C through.  A positive number indicates the
number of seconds after which a channel.TimeoutError exception
will be raised if no item was received.
Note that exceptions from the remotely executing code will be
reraised as channel.RemoteError exceptions containing
a textual representation of the remote traceback.</p>
</dd></dl>

<dl class="method">
<dt id="execnet.gateway_base.Channel.setcallback">
<tt class="descclassname">Channel.</tt><tt class="descname">setcallback</tt><big>(</big><em>callback</em>, <em>endmarker=_NOENDMARKER</em><big>)</big><a class="headerlink" href="#execnet.gateway_base.Channel.setcallback" title="Permalink to this definition"></a></dt>
<dd><p>set a callback function for receiving items.</p>
<p>All already queued items will immediately trigger the callback.
Afterwards the callback will execute in the receiver thread
for each received data item and calls to <tt class="docutils literal"><span class="pre">receive()</span></tt> will
raise an error.
If an endmarker is specified the callback will eventually
be called with the endmarker when the channel closes.</p>
</dd></dl>

<dl class="method">
<dt id="execnet.gateway_base.Channel.makefile">
<tt class="descclassname">Channel.</tt><tt class="descname">makefile</tt><big>(</big><em>mode</em>, <em>proxyclose=False</em><big>)</big><a class="headerlink" href="#execnet.gateway_base.Channel.makefile" title="Permalink to this definition"></a></dt>
<dd><p>return a file-like object.
mode can be &#8216;w&#8217; or &#8216;r&#8217; for writeable/readable files.
if proxyclose is true file.close() will also close the channel.</p>
</dd></dl>

<dl class="method">
<dt id="execnet.gateway_base.Channel.close">
<tt class="descclassname">Channel.</tt><tt class="descname">close</tt><big>(</big><em>error</em><big>)</big><a class="headerlink" href="#execnet.gateway_base.Channel.close" title="Permalink to this definition"></a></dt>
<dd><p>close down this channel with an optional error message.
Note that closing of a channel tied to remote_exec happens
automatically at the end of execution and cannot be done explicitely.</p>
</dd></dl>

<dl class="method">
<dt id="execnet.gateway_base.Channel.waitclose">
<tt class="descclassname">Channel.</tt><tt class="descname">waitclose</tt><big>(</big><em>timeout</em><big>)</big><a class="headerlink" href="#execnet.gateway_base.Channel.waitclose" title="Permalink to this definition"></a></dt>
<dd><p>wait until this channel is closed (or the remote side
otherwise signalled that no more data was being sent).
The channel may still hold receiveable items, but not receive
any more after waitclose() has returned.  Exceptions from executing
code on the other side are reraised as local channel.RemoteErrors.
EOFError is raised if the reading-connection was prematurely closed,
which often indicates a dying process.
self.TimeoutError is raised after the specified number of seconds
(default is None, i.e. wait indefinitely).</p>
</dd></dl>

<dl class="attribute">
<dt id="execnet.gateway_base.Channel.RemoteError">
<tt class="descclassname">Channel.</tt><tt class="descname">RemoteError</tt><em class="property"> = &lt;class 'execnet.gateway_base.RemoteError'&gt;</em><a class="headerlink" href="#execnet.gateway_base.Channel.RemoteError" title="Permalink to this definition"></a></dt>
<dd></dd></dl>

<dl class="attribute">
<dt id="execnet.gateway_base.Channel.TimeoutError">
<tt class="descclassname">Channel.</tt><tt class="descname">TimeoutError</tt><em class="property"> = &lt;class 'execnet.gateway_base.TimeoutError'&gt;</em><a class="headerlink" href="#execnet.gateway_base.Channel.TimeoutError" title="Permalink to this definition"></a></dt>
<dd></dd></dl>

</div></blockquote>
</div>
<div class="section" id="grouped-gateways-and-robust-termination">
<span id="group"></span><h2>Grouped Gateways and robust termination<a class="headerlink" href="#grouped-gateways-and-robust-termination" title="Permalink to this headline"></a></h2>
<p>All created gateway instances are part of a group.  If you
call <tt class="docutils literal"><span class="pre">execnet.makegateway</span></tt> it actually is forwarded to
the <tt class="docutils literal"><span class="pre">execnet.default_group</span></tt>. Group objects are container
objects (see <a class="reference internal" href="example/test_group.html"><em>group examples</em></a>)
and manage the final termination procedure:</p>
<dl class="method">
<dt id="execnet.multi.Group.terminate">
<tt class="descclassname">Group.</tt><tt class="descname">terminate</tt><big>(</big><em>timeout=None</em><big>)</big><a class="headerlink" href="#execnet.multi.Group.terminate" title="Permalink to this definition"></a></dt>
<dd><p>trigger exit of member gateways and wait for termination
of member gateways and associated subprocesses.  After waiting
timeout seconds try to to kill local sub processes of popen-
and ssh-gateways.  Timeout defaults to None meaning
open-ended waiting and no kill attempts.</p>
</dd></dl>

<p>This method is implicitely called for each gateway group at
process-exit, using a small timeout.  This is fine
for interactive sessions or random scripts which
you rather like to error out than hang.  If you start many
processes then you often want to call <tt class="docutils literal"><span class="pre">group.terminate()</span></tt>
yourself and specify a larger or not timeout.</p>
</div>
<div class="section" id="remote-status-get-low-level-execution-info">
<h2>remote_status: get low-level execution info<a class="headerlink" href="#remote-status-get-low-level-execution-info" title="Permalink to this headline"></a></h2>
<p>All gateways offer a simple method to obtain some status
information from the remote side.</p>
<dl class="method">
<dt id="execnet.gateway.Gateway.remote_status">
<tt class="descclassname">Gateway.</tt><tt class="descname">remote_status</tt><big>(</big><em>source</em><big>)</big><a class="headerlink" href="#execnet.gateway.Gateway.remote_status" title="Permalink to this definition"></a></dt>
<dd><p>return information object about remote execution status.</p>
</dd></dl>

<p>Calling this method tells you e.g. how many execution
tasks are queued, how many are executing and how many
channels are active.  Note that <tt class="docutils literal"><span class="pre">remote_status()</span></tt>
works even if the other side is busy executing code
and can thus be used to query status in a non-blocking manner.</p>
</div>
<div class="section" id="rsync-synchronise-filesystem-with-remote">
<h2>rsync: synchronise filesystem with remote<a class="headerlink" href="#rsync-synchronise-filesystem-with-remote" title="Permalink to this headline"></a></h2>
<p><tt class="docutils literal"><span class="pre">execnet</span></tt> implements a simple efficient rsyncing protocol.
Here is a basic example for using RSync:</p>
<div class="highlight-python"><div class="highlight"><pre><span class="n">rsync</span> <span class="o">=</span> <span class="n">execnet</span><span class="o">.</span><span class="n">RSync</span><span class="p">(</span><span class="s">&#39;/tmp/source&#39;</span><span class="p">)</span>
<span class="n">gw</span> <span class="o">=</span> <span class="n">execnet</span><span class="o">.</span><span class="n">makegateway</span><span class="p">()</span>
<span class="n">rsync</span><span class="o">.</span><span class="n">add_target</span><span class="p">(</span><span class="n">gw</span><span class="p">,</span> <span class="s">&#39;/tmp/dest&#39;</span><span class="p">)</span>
<span class="n">rsync</span><span class="o">.</span><span class="n">send</span><span class="p">()</span>
</pre></div>
</div>
<p>And here is API info about the RSync class.</p>
<dl class="class">
<dt id="execnet.RSync">
<em class="property">class </em><tt class="descclassname">execnet.</tt><tt class="descname">RSync</tt><big>(</big><em>sourcedir</em>, <em>callback=None</em>, <em>verbose=True</em><big>)</big><a class="headerlink" href="#execnet.RSync" title="Permalink to this definition"></a></dt>
<dd><p>This class allows to send a directory structure (recursively)
to one or multiple remote filesystems.</p>
<p>There is limited support for symlinks, which means that symlinks
pointing to the sourcetree will be send &#8220;as is&#8221; while external
symlinks will be just copied (regardless of existance of such
a path on remote side).</p>
<dl class="method">
<dt id="execnet.RSync.add_target">
<tt class="descname">add_target</tt><big>(</big><em>gateway</em>, <em>destdir</em>, <em>finishedcallback=None</em>, <em>**options</em><big>)</big><a class="headerlink" href="#execnet.RSync.add_target" title="Permalink to this definition"></a></dt>
<dd><p>Adds a remote target specified via a gateway
and a remote destination directory.</p>
</dd></dl>

<dl class="method">
<dt id="execnet.RSync.send">
<tt class="descname">send</tt><big>(</big><em>raises=True</em><big>)</big><a class="headerlink" href="#execnet.RSync.send" title="Permalink to this definition"></a></dt>
<dd><p>Sends a sourcedir to all added targets. Flag indicates
whether to raise an error or return in case of lack of
targets</p>
</dd></dl>

</dd></dl>

</div>
<div class="section" id="debugging-execnet">
<h2>Debugging execnet<a class="headerlink" href="#debugging-execnet" title="Permalink to this headline"></a></h2>
<p>By setting the environment variable <tt class="docutils literal"><span class="pre">EXECNET_DEBUG</span></tt> you can
configure a tracing mechanism:</p>
<table class="docutils field-list" frame="void" rules="none">
<col class="field-name" />
<col class="field-body" />
<tbody valign="top">
<tr class="field-odd field"><th class="field-name" colspan="2">EXECNET_DEBUG=1:</th></tr>
<tr class="field-odd field"><td>&nbsp;</td><td class="field-body">write per-process trace-files to <tt class="docutils literal"><span class="pre">execnet-debug-PID</span></tt></td>
</tr>
<tr class="field-even field"><th class="field-name" colspan="2">EXECNET_DEUBG=2:</th></tr>
<tr class="field-even field"><td>&nbsp;</td><td class="field-body">perform tracing to stderr (popen-gateway slaves will send this to their instantiator)</td>
</tr>
</tbody>
</table>
</div>
</div>


          </div>
        </div>
      </div>
      <div class="clearer"></div>
    </div>
    <div class="related">
      <h3>Navigation</h3>
      <ul>
        <li class="right" style="margin-right: 10px">
          <a href="genindex.html" title="General Index"
             >index</a></li>
        <li class="right" >
          <a href="changelog.html" title="execnet CHANGELOG"
             >next</a> |</li>
        <li class="right" >
          <a href="example/test_ssh_fileserver.html" title="Receive file contents from remote SSH account"
             >previous</a> |</li>
        <!-- <a href="index.html">index</a>&raquo;</li> -->

          <li><a href="install.html" >Info in a nutshell</a> &raquo;</li> 
      </ul>
    </div>

    <div class="footer">
        &copy; Copyright 2009, holger krekel and others.
      Created using <a href="http://sphinx.pocoo.org/">Sphinx</a> 1.1.3.
    </div>
<script type="text/javascript">
var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www.");
document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));
</script>
<script type="text/javascript">
try {
var pageTracker = _gat._getTracker("UA-7597274-7");
pageTracker._trackPageview();
} catch(err) {}</script>

  </body>
</html>

APT Browse - Built by Thomas Orozco.