deploy: 755845a

page/configuration/index.html

@@ -1196,6 +1196,28 @@ <h2 id="python">Python<a class="headerlink" href="#python" title="Permanent link
                (defaults to the value defined in <code>dap-python-debugger</code>)</li>
 </ul>
 <p>Remaining parameters are forwarded to the respective debugger.</p>
+<ol>
+<li>Attach to an existing process
+  <code>dap-python</code> supports also the "attach" mode to attach and debug a long running script.
+    A template named "Python :: Attach to running process" is also pre-registered for this purpose.
+    <div class="highlight"><pre><span></span><code><span class="p">(</span><span class="nv">dap-register-debug-template</span> <span class="s">&quot;Python :: Attach to running process&quot;</span>
+  <span class="p">(</span><span class="nf">list</span> <span class="nb">:type</span> <span class="s">&quot;python&quot;</span>
+        <span class="nb">:request</span> <span class="s">&quot;attach&quot;</span>
+        <span class="nb">:processId</span> <span class="s">&quot;${command:pickProcess}&quot;</span>
+        <span class="nb">:name</span> <span class="s">&quot;Python :: Attach to running process&quot;</span><span class="p">))</span>
+</code></pre></div>
+    The <code>${command:pickProcess}</code> configuration variable used by default to facilitate the user
+    selecting the debug process by a completion popping up window. The real <code>processId</code> can
+    always be specified using its <em>pid</em>.
+    <strong>Note</strong>: on Linux this is achieved using the <a href="https://www.man7.org/linux/man-pages/man2/ptrace.2.html" title="ptrace syscall man page">ptrace syscall</a>
+    wrapped inside the GDB tool, which means that for distributions that enable YAMA (e.g. Ubuntu) some additional steps may be necessary:<ul>
+<li>Install GDB.</li>
+<li>Turn on classic ptrace permission
+    <div class="highlight"><pre><span></span><code>sudo sh -c <span class="s1">&#39;echo 0 &gt; /proc/sys/kernel/yama/ptrace_scope&#39;</span>
+</code></pre></div></li>
+</ul>
+</li>
+</ol>
 <h2 id="ruby">Ruby<a class="headerlink" href="#ruby" title="Permanent link">#</a></h2>
 <ul>
 <li>