--- /dev/null
+<!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>nepi.util.execfuncs — NEPI 3.0 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: '3.0',
+ 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="NEPI 3.0 documentation" href="../../../index.html" />
+ <link rel="up" title="Module code" href="../../index.html" />
+ </head>
+ <body>
+ <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="../../../py-modindex.html" title="Python Module Index"
+ >modules</a> |</li>
+ <li><a href="../../../index.html">NEPI 3.0 documentation</a> »</li>
+ <li><a href="../../index.html" accesskey="U">Module code</a> »</li>
+ </ul>
+ </div>
+ <div class="sphinxsidebar">
+ <div class="sphinxsidebarwrapper">
+<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">
+
+ <h1>Source code for nepi.util.execfuncs</h1><div class="highlight"><pre>
+<span class="c">#</span>
+<span class="c"># NEPI, a framework to manage network experiments</span>
+<span class="c"># Copyright (C) 2013 INRIA</span>
+<span class="c">#</span>
+<span class="c"># This program is free software: you can redistribute it and/or modify</span>
+<span class="c"># it under the terms of the GNU General Public License version 2 as</span>
+<span class="c"># published by the Free Software Foundation;</span>
+<span class="c">#</span>
+<span class="c"># This program is distributed in the hope that it will be useful,</span>
+<span class="c"># but WITHOUT ANY WARRANTY; without even the implied warranty of</span>
+<span class="c"># MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the</span>
+<span class="c"># GNU General Public License for more details.</span>
+<span class="c">#</span>
+<span class="c"># You should have received a copy of the GNU General Public License</span>
+<span class="c"># along with this program. If not, see <http://www.gnu.org/licenses/>.</span>
+<span class="c">#</span>
+<span class="c"># Author: Alina Quereilhac <alina.quereilhac@inria.fr></span>
+
+<span class="kn">from</span> <span class="nn">nepi.util.sshfuncs</span> <span class="kn">import</span> <span class="n">ProcStatus</span><span class="p">,</span> <span class="n">STDOUT</span><span class="p">,</span> <span class="n">log</span><span class="p">,</span> <span class="n">shell_escape</span>
+
+<span class="kn">import</span> <span class="nn">logging</span>
+<span class="kn">import</span> <span class="nn">shlex</span>
+<span class="kn">import</span> <span class="nn">subprocess</span>
+
+<div class="viewcode-block" id="lexec"><a class="viewcode-back" href="../../../_layout/nepi.util.html#nepi.util.execfuncs.lexec">[docs]</a><span class="k">def</span> <span class="nf">lexec</span><span class="p">(</span><span class="n">command</span><span class="p">,</span>
+ <span class="n">user</span> <span class="o">=</span> <span class="bp">None</span><span class="p">,</span>
+ <span class="n">sudo</span> <span class="o">=</span> <span class="bp">False</span><span class="p">,</span>
+ <span class="n">env</span> <span class="o">=</span> <span class="bp">None</span><span class="p">):</span>
+ <span class="sd">"""</span>
+<span class="sd"> Executes a local command, returns ((stdout,stderr),process)</span>
+<span class="sd"> """</span>
+ <span class="k">if</span> <span class="n">env</span><span class="p">:</span>
+ <span class="n">export</span> <span class="o">=</span> <span class="s">''</span>
+ <span class="k">for</span> <span class="n">envkey</span><span class="p">,</span> <span class="n">envval</span> <span class="ow">in</span> <span class="n">env</span><span class="o">.</span><span class="n">iteritems</span><span class="p">():</span>
+ <span class="n">export</span> <span class="o">+=</span> <span class="s">'</span><span class="si">%s</span><span class="s">=</span><span class="si">%s</span><span class="s"> '</span> <span class="o">%</span> <span class="p">(</span><span class="n">envkey</span><span class="p">,</span> <span class="n">envval</span><span class="p">)</span>
+ <span class="n">command</span> <span class="o">=</span> <span class="s">"</span><span class="si">%s</span><span class="s"> </span><span class="si">%s</span><span class="s">"</span> <span class="o">%</span> <span class="p">(</span><span class="n">export</span><span class="p">,</span> <span class="n">command</span><span class="p">)</span>
+
+ <span class="k">if</span> <span class="n">sudo</span><span class="p">:</span>
+ <span class="n">command</span> <span class="o">=</span> <span class="s">"sudo </span><span class="si">%s</span><span class="s">"</span> <span class="o">%</span> <span class="n">command</span>
+
+ <span class="c"># XXX: Doing 'su user' blocks waiting for a password on stdin</span>
+ <span class="c">#elif user:</span>
+ <span class="c"># command = "su %s ; %s " % (user, command)</span>
+
+ <span class="n">proc</span> <span class="o">=</span> <span class="n">subprocess</span><span class="o">.</span><span class="n">Popen</span><span class="p">(</span><span class="n">command</span><span class="p">,</span>
+ <span class="n">shell</span> <span class="o">=</span> <span class="bp">True</span><span class="p">,</span>
+ <span class="n">stdout</span> <span class="o">=</span> <span class="n">subprocess</span><span class="o">.</span><span class="n">PIPE</span><span class="p">,</span>
+ <span class="n">stderr</span> <span class="o">=</span> <span class="n">subprocess</span><span class="o">.</span><span class="n">PIPE</span><span class="p">)</span>
+
+ <span class="n">out</span> <span class="o">=</span> <span class="n">err</span> <span class="o">=</span> <span class="s">""</span>
+ <span class="n">log_msg</span> <span class="o">=</span> <span class="s">"lexec - command </span><span class="si">%s</span><span class="s"> "</span> <span class="o">%</span> <span class="n">command</span>
+
+ <span class="k">try</span><span class="p">:</span>
+ <span class="n">out</span><span class="p">,</span> <span class="n">err</span> <span class="o">=</span> <span class="n">proc</span><span class="o">.</span><span class="n">communicate</span><span class="p">()</span>
+ <span class="n">log</span><span class="p">(</span><span class="n">log_msg</span><span class="p">,</span> <span class="n">logging</span><span class="o">.</span><span class="n">DEBUG</span><span class="p">,</span> <span class="n">out</span><span class="p">,</span> <span class="n">err</span><span class="p">)</span>
+ <span class="k">except</span><span class="p">:</span>
+ <span class="n">log</span><span class="p">(</span><span class="n">log_msg</span><span class="p">,</span> <span class="n">logging</span><span class="o">.</span><span class="n">ERROR</span><span class="p">,</span> <span class="n">out</span><span class="p">,</span> <span class="n">err</span><span class="p">)</span>
+ <span class="k">raise</span>
+
+ <span class="k">return</span> <span class="p">((</span><span class="n">out</span><span class="p">,</span> <span class="n">err</span><span class="p">),</span> <span class="n">proc</span><span class="p">)</span>
+</div>
+<div class="viewcode-block" id="lcopy"><a class="viewcode-back" href="../../../_layout/nepi.util.html#nepi.util.execfuncs.lcopy">[docs]</a><span class="k">def</span> <span class="nf">lcopy</span><span class="p">(</span><span class="n">source</span><span class="p">,</span> <span class="n">dest</span><span class="p">,</span> <span class="n">recursive</span> <span class="o">=</span> <span class="bp">False</span><span class="p">):</span>
+ <span class="sd">"""</span>
+<span class="sd"> Copies from/to localy.</span>
+<span class="sd"> """</span>
+
+ <span class="n">args</span> <span class="o">=</span> <span class="p">[</span><span class="s">"cp"</span><span class="p">]</span>
+ <span class="k">if</span> <span class="n">recursive</span><span class="p">:</span>
+ <span class="n">args</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="s">"-r"</span><span class="p">)</span>
+
+ <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">source</span><span class="p">,</span> <span class="nb">list</span><span class="p">):</span>
+ <span class="n">args</span><span class="o">.</span><span class="n">extend</span><span class="p">(</span><span class="n">source</span><span class="p">)</span>
+ <span class="k">else</span><span class="p">:</span>
+ <span class="n">args</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">source</span><span class="p">)</span>
+
+ <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">dest</span><span class="p">,</span> <span class="nb">list</span><span class="p">):</span>
+ <span class="n">args</span><span class="o">.</span><span class="n">extend</span><span class="p">(</span><span class="n">dest</span><span class="p">)</span>
+ <span class="k">else</span><span class="p">:</span>
+ <span class="n">args</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">dest</span><span class="p">)</span>
+
+ <span class="n">proc</span> <span class="o">=</span> <span class="n">subprocess</span><span class="o">.</span><span class="n">Popen</span><span class="p">(</span><span class="n">args</span><span class="p">,</span>
+ <span class="n">stdout</span><span class="o">=</span><span class="n">subprocess</span><span class="o">.</span><span class="n">PIPE</span><span class="p">,</span>
+ <span class="n">stderr</span><span class="o">=</span><span class="n">subprocess</span><span class="o">.</span><span class="n">PIPE</span><span class="p">)</span>
+
+ <span class="n">out</span> <span class="o">=</span> <span class="n">err</span> <span class="o">=</span> <span class="s">""</span>
+ <span class="n">command</span> <span class="o">=</span> <span class="s">" "</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="n">args</span><span class="p">)</span>
+ <span class="n">log_msg</span> <span class="o">=</span> <span class="s">" lcopy - command </span><span class="si">%s</span><span class="s"> "</span> <span class="o">%</span> <span class="n">command</span>
+
+ <span class="k">try</span><span class="p">:</span>
+ <span class="n">out</span><span class="p">,</span> <span class="n">err</span> <span class="o">=</span> <span class="n">proc</span><span class="o">.</span><span class="n">communicate</span><span class="p">()</span>
+ <span class="n">log</span><span class="p">(</span><span class="n">log_msg</span><span class="p">,</span> <span class="n">logging</span><span class="o">.</span><span class="n">DEBUG</span><span class="p">,</span> <span class="n">out</span><span class="p">,</span> <span class="n">err</span><span class="p">)</span>
+ <span class="k">except</span><span class="p">:</span>
+ <span class="n">log</span><span class="p">(</span><span class="n">log_msg</span><span class="p">,</span> <span class="n">logging</span><span class="o">.</span><span class="n">ERROR</span><span class="p">,</span> <span class="n">out</span><span class="p">,</span> <span class="n">err</span><span class="p">)</span>
+ <span class="k">raise</span>
+
+ <span class="k">return</span> <span class="p">((</span><span class="n">out</span><span class="p">,</span> <span class="n">err</span><span class="p">),</span> <span class="n">proc</span><span class="p">)</span>
+ </div>
+<div class="viewcode-block" id="lspawn"><a class="viewcode-back" href="../../../_layout/nepi.util.html#nepi.util.execfuncs.lspawn">[docs]</a><span class="k">def</span> <span class="nf">lspawn</span><span class="p">(</span><span class="n">command</span><span class="p">,</span> <span class="n">pidfile</span><span class="p">,</span>
+ <span class="n">stdout</span> <span class="o">=</span> <span class="s">'/dev/null'</span><span class="p">,</span>
+ <span class="n">stderr</span> <span class="o">=</span> <span class="n">STDOUT</span><span class="p">,</span>
+ <span class="n">stdin</span> <span class="o">=</span> <span class="s">'/dev/null'</span><span class="p">,</span>
+ <span class="n">home</span> <span class="o">=</span> <span class="bp">None</span><span class="p">,</span>
+ <span class="n">create_home</span> <span class="o">=</span> <span class="bp">False</span><span class="p">,</span>
+ <span class="n">sudo</span> <span class="o">=</span> <span class="bp">False</span><span class="p">,</span>
+ <span class="n">user</span> <span class="o">=</span> <span class="bp">None</span><span class="p">):</span>
+ <span class="sd">"""</span>
+<span class="sd"> Spawn a local command such that it will continue working asynchronously.</span>
+<span class="sd"> </span>
+<span class="sd"> Parameters:</span>
+<span class="sd"> command: the command to run - it should be a single line.</span>
+<span class="sd"> </span>
+<span class="sd"> pidfile: path of a (ideally unique to this task) pidfile for tracking the process.</span>
+<span class="sd"> </span>
+<span class="sd"> stdout: path of a file to redirect standard output to - must be a string.</span>
+<span class="sd"> Defaults to /dev/null</span>
+<span class="sd"> stderr: path of a file to redirect standard error to - string or the special STDOUT value</span>
+<span class="sd"> to redirect to the same file stdout was redirected to. Defaults to STDOUT.</span>
+<span class="sd"> stdin: path of a file with input to be piped into the command's standard input</span>
+<span class="sd"> </span>
+<span class="sd"> home: path of a folder to use as working directory - should exist, unless you specify create_home</span>
+<span class="sd"> </span>
+<span class="sd"> create_home: if True, the home folder will be created first with mkdir -p</span>
+<span class="sd"> </span>
+<span class="sd"> sudo: whether the command needs to be executed as root</span>
+<span class="sd"> </span>
+<span class="sd"> Returns:</span>
+<span class="sd"> (stdout, stderr), process</span>
+<span class="sd"> </span>
+<span class="sd"> Of the spawning process, which only captures errors at spawning time.</span>
+<span class="sd"> Usually only useful for diagnostics.</span>
+<span class="sd"> """</span>
+ <span class="c"># Start process in a "daemonized" way, using nohup and heavy</span>
+ <span class="c"># stdin/out redirection to avoid connection issues</span>
+ <span class="k">if</span> <span class="n">stderr</span> <span class="ow">is</span> <span class="n">STDOUT</span><span class="p">:</span>
+ <span class="n">stderr</span> <span class="o">=</span> <span class="s">'&1'</span>
+ <span class="k">else</span><span class="p">:</span>
+ <span class="n">stderr</span> <span class="o">=</span> <span class="s">' '</span> <span class="o">+</span> <span class="n">stderr</span>
+
+ <span class="n">daemon_command</span> <span class="o">=</span> <span class="s">'{ { </span><span class="si">%(command)s</span><span class="s"> > </span><span class="si">%(stdout)s</span><span class="s"> 2></span><span class="si">%(stderr)s</span><span class="s"> < </span><span class="si">%(stdin)s</span><span class="s"> & } ; echo $! 1 > </span><span class="si">%(pidfile)s</span><span class="s"> ; }'</span> <span class="o">%</span> <span class="p">{</span>
+ <span class="s">'command'</span> <span class="p">:</span> <span class="n">command</span><span class="p">,</span>
+ <span class="s">'pidfile'</span> <span class="p">:</span> <span class="n">shell_escape</span><span class="p">(</span><span class="n">pidfile</span><span class="p">),</span>
+ <span class="s">'stdout'</span> <span class="p">:</span> <span class="n">stdout</span><span class="p">,</span>
+ <span class="s">'stderr'</span> <span class="p">:</span> <span class="n">stderr</span><span class="p">,</span>
+ <span class="s">'stdin'</span> <span class="p">:</span> <span class="n">stdin</span><span class="p">,</span>
+ <span class="p">}</span>
+
+ <span class="n">cmd</span> <span class="o">=</span> <span class="s">"</span><span class="si">%(create)s%(gohome)s</span><span class="s"> rm -f </span><span class="si">%(pidfile)s</span><span class="s"> ; </span><span class="si">%(sudo)s</span><span class="s"> bash -c </span><span class="si">%(command)s</span><span class="s"> "</span> <span class="o">%</span> <span class="p">{</span>
+ <span class="s">'command'</span> <span class="p">:</span> <span class="n">shell_escape</span><span class="p">(</span><span class="n">daemon_command</span><span class="p">),</span>
+ <span class="s">'sudo'</span> <span class="p">:</span> <span class="s">'sudo -S'</span> <span class="k">if</span> <span class="n">sudo</span> <span class="k">else</span> <span class="s">''</span><span class="p">,</span>
+ <span class="s">'pidfile'</span> <span class="p">:</span> <span class="n">shell_escape</span><span class="p">(</span><span class="n">pidfile</span><span class="p">),</span>
+ <span class="s">'gohome'</span> <span class="p">:</span> <span class="s">'cd </span><span class="si">%s</span><span class="s"> ; '</span> <span class="o">%</span> <span class="p">(</span><span class="n">shell_escape</span><span class="p">(</span><span class="n">home</span><span class="p">),)</span> <span class="k">if</span> <span class="n">home</span> <span class="k">else</span> <span class="s">''</span><span class="p">,</span>
+ <span class="s">'create'</span> <span class="p">:</span> <span class="s">'mkdir -p </span><span class="si">%s</span><span class="s"> ; '</span> <span class="o">%</span> <span class="p">(</span><span class="n">shell_escape</span><span class="p">(</span><span class="n">home</span><span class="p">),)</span> <span class="k">if</span> <span class="n">create_home</span> <span class="k">else</span> <span class="s">''</span><span class="p">,</span>
+ <span class="p">}</span>
+
+ <span class="p">(</span><span class="n">out</span><span class="p">,</span><span class="n">err</span><span class="p">),</span> <span class="n">proc</span> <span class="o">=</span> <span class="n">lexec</span><span class="p">(</span><span class="n">cmd</span><span class="p">)</span>
+
+ <span class="k">if</span> <span class="n">proc</span><span class="o">.</span><span class="n">wait</span><span class="p">():</span>
+ <span class="k">raise</span> <span class="ne">RuntimeError</span><span class="p">,</span> <span class="s">"Failed to set up application on host </span><span class="si">%s</span><span class="s">: </span><span class="si">%s</span><span class="s"> </span><span class="si">%s</span><span class="s">"</span> <span class="o">%</span> <span class="p">(</span><span class="n">host</span><span class="p">,</span> <span class="n">out</span><span class="p">,</span><span class="n">err</span><span class="p">,)</span>
+
+ <span class="k">return</span> <span class="p">((</span><span class="n">out</span><span class="p">,</span><span class="n">err</span><span class="p">),</span> <span class="n">proc</span><span class="p">)</span>
+</div>
+<div class="viewcode-block" id="lgetpid"><a class="viewcode-back" href="../../../_layout/nepi.util.html#nepi.util.execfuncs.lgetpid">[docs]</a><span class="k">def</span> <span class="nf">lgetpid</span><span class="p">(</span><span class="n">pidfile</span><span class="p">):</span>
+ <span class="sd">"""</span>
+<span class="sd"> Check the pidfile of a process spawned with remote_spawn.</span>
+<span class="sd"> </span>
+<span class="sd"> Parameters:</span>
+<span class="sd"> pidfile: the pidfile passed to remote_span</span>
+<span class="sd"> </span>
+<span class="sd"> Returns:</span>
+<span class="sd"> </span>
+<span class="sd"> A (pid, ppid) tuple useful for calling remote_status and remote_kill,</span>
+<span class="sd"> or None if the pidfile isn't valid yet (maybe the process is still starting).</span>
+<span class="sd"> """</span>
+
+ <span class="p">(</span><span class="n">out</span><span class="p">,</span><span class="n">err</span><span class="p">),</span> <span class="n">proc</span> <span class="o">=</span> <span class="n">lexec</span><span class="p">(</span><span class="s">"cat </span><span class="si">%s</span><span class="s">"</span> <span class="o">%</span> <span class="n">pidfile</span> <span class="p">)</span>
+
+ <span class="k">if</span> <span class="n">proc</span><span class="o">.</span><span class="n">wait</span><span class="p">():</span>
+ <span class="k">return</span> <span class="bp">None</span>
+
+ <span class="k">if</span> <span class="n">out</span><span class="p">:</span>
+ <span class="k">try</span><span class="p">:</span>
+ <span class="k">return</span> <span class="nb">map</span><span class="p">(</span><span class="nb">int</span><span class="p">,</span><span class="n">out</span><span class="o">.</span><span class="n">strip</span><span class="p">()</span><span class="o">.</span><span class="n">split</span><span class="p">(</span><span class="s">' '</span><span class="p">,</span><span class="mi">1</span><span class="p">))</span>
+ <span class="k">except</span><span class="p">:</span>
+ <span class="c"># Ignore, many ways to fail that don't matter that much</span>
+ <span class="k">return</span> <span class="bp">None</span>
+</div>
+<div class="viewcode-block" id="lstatus"><a class="viewcode-back" href="../../../_layout/nepi.util.html#nepi.util.execfuncs.lstatus">[docs]</a><span class="k">def</span> <span class="nf">lstatus</span><span class="p">(</span><span class="n">pid</span><span class="p">,</span> <span class="n">ppid</span><span class="p">):</span>
+ <span class="sd">"""</span>
+<span class="sd"> Check the status of a process spawned with remote_spawn.</span>
+<span class="sd"> </span>
+<span class="sd"> Parameters:</span>
+<span class="sd"> pid/ppid: pid and parent-pid of the spawned process. See remote_check_pid</span>
+<span class="sd"> </span>
+<span class="sd"> Returns:</span>
+<span class="sd"> </span>
+<span class="sd"> One of NOT_STARTED, RUNNING, FINISHED</span>
+<span class="sd"> """</span>
+
+ <span class="p">(</span><span class="n">out</span><span class="p">,</span><span class="n">err</span><span class="p">),</span> <span class="n">proc</span> <span class="o">=</span> <span class="n">lexec</span><span class="p">(</span>
+ <span class="c"># Check only by pid. pid+ppid does not always work (especially with sudo) </span>
+ <span class="s">" (( ps --pid </span><span class="si">%(pid)d</span><span class="s"> -o pid | grep -c </span><span class="si">%(pid)d</span><span class="s"> && echo 'wait') || echo 'done' ) | tail -n 1"</span> <span class="o">%</span> <span class="p">{</span>
+ <span class="s">'ppid'</span> <span class="p">:</span> <span class="n">ppid</span><span class="p">,</span>
+ <span class="s">'pid'</span> <span class="p">:</span> <span class="n">pid</span><span class="p">,</span>
+ <span class="p">})</span>
+
+ <span class="k">if</span> <span class="n">proc</span><span class="o">.</span><span class="n">wait</span><span class="p">():</span>
+ <span class="k">return</span> <span class="n">ProcStatus</span><span class="o">.</span><span class="n">NOT_STARTED</span>
+
+ <span class="n">status</span> <span class="o">=</span> <span class="bp">False</span>
+ <span class="k">if</span> <span class="n">out</span><span class="p">:</span>
+ <span class="n">status</span> <span class="o">=</span> <span class="p">(</span><span class="n">out</span><span class="o">.</span><span class="n">strip</span><span class="p">()</span> <span class="o">==</span> <span class="s">'wait'</span><span class="p">)</span>
+ <span class="k">else</span><span class="p">:</span>
+ <span class="k">return</span> <span class="n">ProcStatus</span><span class="o">.</span><span class="n">NOT_STARTED</span>
+
+ <span class="k">return</span> <span class="n">ProcStatus</span><span class="o">.</span><span class="n">RUNNING</span> <span class="k">if</span> <span class="n">status</span> <span class="k">else</span> <span class="n">ProcStatus</span><span class="o">.</span><span class="n">FINISHED</span>
+</div>
+<div class="viewcode-block" id="lkill"><a class="viewcode-back" href="../../../_layout/nepi.util.html#nepi.util.execfuncs.lkill">[docs]</a><span class="k">def</span> <span class="nf">lkill</span><span class="p">(</span><span class="n">pid</span><span class="p">,</span> <span class="n">ppid</span><span class="p">,</span> <span class="n">sudo</span> <span class="o">=</span> <span class="bp">False</span><span class="p">):</span>
+ <span class="sd">"""</span>
+<span class="sd"> Kill a process spawned with lspawn.</span>
+<span class="sd"> </span>
+<span class="sd"> First tries a SIGTERM, and if the process does not end in 10 seconds,</span>
+<span class="sd"> it sends a SIGKILL.</span>
+<span class="sd"> </span>
+<span class="sd"> Parameters:</span>
+<span class="sd"> pid/ppid: pid and parent-pid of the spawned process. See remote_check_pid</span>
+<span class="sd"> </span>
+<span class="sd"> sudo: whether the command was run with sudo - careful killing like this.</span>
+<span class="sd"> </span>
+<span class="sd"> Returns:</span>
+<span class="sd"> </span>
+<span class="sd"> Nothing, should have killed the process</span>
+<span class="sd"> """</span>
+
+ <span class="n">subkill</span> <span class="o">=</span> <span class="s">"$(ps --ppid </span><span class="si">%(pid)d</span><span class="s"> -o pid h)"</span> <span class="o">%</span> <span class="p">{</span> <span class="s">'pid'</span> <span class="p">:</span> <span class="n">pid</span> <span class="p">}</span>
+ <span class="n">cmd</span> <span class="o">=</span> <span class="s">"""</span>
+<span class="s">SUBKILL="</span><span class="si">%(subkill)s</span><span class="s">" ;</span>
+<span class="si">%(sudo)s</span><span class="s"> kill -- -</span><span class="si">%(pid)d</span><span class="s"> $SUBKILL || /bin/true</span>
+<span class="si">%(sudo)s</span><span class="s"> kill </span><span class="si">%(pid)d</span><span class="s"> $SUBKILL || /bin/true</span>
+<span class="s">for x in 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 ; do </span>
+<span class="s"> sleep 0.2 </span>
+<span class="s"> if [ `ps --pid </span><span class="si">%(pid)d</span><span class="s"> -o pid | grep -c </span><span class="si">%(pid)d</span><span class="s">` == '0' ]; then</span>
+<span class="s"> break</span>
+<span class="s"> else</span>
+<span class="s"> </span><span class="si">%(sudo)s</span><span class="s"> kill -- -</span><span class="si">%(pid)d</span><span class="s"> $SUBKILL || /bin/true</span>
+<span class="s"> </span><span class="si">%(sudo)s</span><span class="s"> kill </span><span class="si">%(pid)d</span><span class="s"> $SUBKILL || /bin/true</span>
+<span class="s"> fi</span>
+<span class="s"> sleep 1.8</span>
+<span class="s">done</span>
+<span class="s">if [ `ps --pid </span><span class="si">%(pid)d</span><span class="s"> -o pid | grep -c </span><span class="si">%(pid)d</span><span class="s">` != '0' ]; then</span>
+<span class="s"> </span><span class="si">%(sudo)s</span><span class="s"> kill -9 -- -</span><span class="si">%(pid)d</span><span class="s"> $SUBKILL || /bin/true</span>
+<span class="s"> </span><span class="si">%(sudo)s</span><span class="s"> kill -9 </span><span class="si">%(pid)d</span><span class="s"> $SUBKILL || /bin/true</span>
+<span class="s">fi</span>
+<span class="s">"""</span>
+ <span class="k">if</span> <span class="n">nowait</span><span class="p">:</span>
+ <span class="n">cmd</span> <span class="o">=</span> <span class="s">"( </span><span class="si">%s</span><span class="s"> ) >/dev/null 2>/dev/null </dev/null &"</span> <span class="o">%</span> <span class="p">(</span><span class="n">cmd</span><span class="p">,)</span>
+
+ <span class="p">(</span><span class="n">out</span><span class="p">,</span><span class="n">err</span><span class="p">),</span><span class="n">proc</span> <span class="o">=</span> <span class="n">lexec</span><span class="p">(</span>
+ <span class="n">cmd</span> <span class="o">%</span> <span class="p">{</span>
+ <span class="s">'ppid'</span> <span class="p">:</span> <span class="n">ppid</span><span class="p">,</span>
+ <span class="s">'pid'</span> <span class="p">:</span> <span class="n">pid</span><span class="p">,</span>
+ <span class="s">'sudo'</span> <span class="p">:</span> <span class="s">'sudo -S'</span> <span class="k">if</span> <span class="n">sudo</span> <span class="k">else</span> <span class="s">''</span><span class="p">,</span>
+ <span class="s">'subkill'</span> <span class="p">:</span> <span class="n">subkill</span><span class="p">,</span>
+ <span class="p">})</span>
+
+</pre></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="../../../py-modindex.html" title="Python Module Index"
+ >modules</a> |</li>
+ <li><a href="../../../index.html">NEPI 3.0 documentation</a> »</li>
+ <li><a href="../../index.html" >Module code</a> »</li>
+ </ul>
+ </div>
+ <div class="footer">
+ © Copyright 2014, Alina Quereilhac, Lucia Guevgeozian Odizzio, Julien Tribino.
+ Created using <a href="http://sphinx-doc.org/">Sphinx</a> 1.2.3.
+ </div>
+ </body>
+</html>
\ No newline at end of file
git://git.onelab.eu / nepi.git / blobdiff