Autorefresh Dev Documentation

Author: github-actions[bot]

dev/_modules/libdebug/debugger/debugger.html

@@ -746,9 +746,14 @@ <h1>Source code for libdebug.debugger.debugger</h1><div class="highlight"><pre>
 
 <div class="viewcode-block" id="Debugger.gdb">
 <a class="viewcode-back" href="../../../libdebug.debugger.html#libdebug.debugger.debugger.Debugger.gdb">[docs]</a>
-    <span class="k">def</span> <span class="nf">gdb</span><span class="p">(</span><span class="bp">self</span><span class="p">:</span> <span class="n">Debugger</span><span class="p">,</span> <span class="n">open_in_new_process</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">True</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span><span class="p">:</span>
-<span class="w">        </span><span class="sd">&quot;&quot;&quot;Migrates the current debugging session to GDB.&quot;&quot;&quot;</span>
-        <span class="bp">self</span><span class="o">.</span><span class="n">_internal_debugger</span><span class="o">.</span><span class="n">gdb</span><span class="p">(</span><span class="n">open_in_new_process</span><span class="p">)</span></div>
+    <span class="k">def</span> <span class="nf">gdb</span><span class="p">(</span><span class="bp">self</span><span class="p">:</span> <span class="n">Debugger</span><span class="p">,</span> <span class="n">migrate_breakpoints</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">True</span><span class="p">,</span> <span class="n">open_in_new_process</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">True</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span><span class="p">:</span>
+<span class="w">        </span><span class="sd">&quot;&quot;&quot;Migrates the current debugging session to GDB.</span>
+
+<span class="sd">        Args:</span>
+<span class="sd">            migrate_breakpoints (bool): Whether to migrate over the breakpoints set in libdebug to GDB.</span>
+<span class="sd">            open_in_new_process (bool): Whether to attempt to open GDB in a new process instead of the current one.</span>
+<span class="sd">        &quot;&quot;&quot;</span>
+        <span class="bp">self</span><span class="o">.</span><span class="n">_internal_debugger</span><span class="o">.</span><span class="n">gdb</span><span class="p">(</span><span class="n">migrate_breakpoints</span><span class="p">,</span> <span class="n">open_in_new_process</span><span class="p">)</span></div>
 
 
 <div class="viewcode-block" id="Debugger.r">

dev/_modules/libdebug/debugger/internal_debugger.html

@@ -720,7 +720,7 @@ <h1>Source code for libdebug.debugger.internal_debugger</h1><div class="highligh
         <span class="k">if</span> <span class="ow">not</span> <span class="bp">self</span><span class="o">.</span><span class="n">__polling_thread_command_queue</span><span class="o">.</span><span class="n">empty</span><span class="p">():</span>
             <span class="k">raise</span> <span class="ne">RuntimeError</span><span class="p">(</span><span class="s2">&quot;Polling thread command queue not empty.&quot;</span><span class="p">)</span>
 
-        <span class="bp">self</span><span class="o">.</span><span class="n">__polling_thread_command_queue</span><span class="o">.</span><span class="n">put</span><span class="p">((</span><span class="bp">self</span><span class="o">.</span><span class="n">__threaded_run</span><span class="p">,</span> <span class="p">(</span><span class="n">redirect_pipes</span><span class="p">,</span> <span class="p">)))</span>
+        <span class="bp">self</span><span class="o">.</span><span class="n">__polling_thread_command_queue</span><span class="o">.</span><span class="n">put</span><span class="p">((</span><span class="bp">self</span><span class="o">.</span><span class="n">__threaded_run</span><span class="p">,</span> <span class="p">(</span><span class="n">redirect_pipes</span><span class="p">,)))</span>
 
         <span class="bp">self</span><span class="o">.</span><span class="n">_join_and_check_status</span><span class="p">()</span>
 
@@ -1261,7 +1261,7 @@ <h1>Source code for libdebug.debugger.internal_debugger</h1><div class="highligh
 <a class="viewcode-back" href="../../../libdebug.debugger.html#libdebug.debugger.internal_debugger.InternalDebugger.gdb">[docs]</a>
     <span class="nd">@background_alias</span><span class="p">(</span><span class="n">_background_invalid_call</span><span class="p">)</span>
     <span class="nd">@change_state_function_process</span>
-    <span class="k">def</span> <span class="nf">gdb</span><span class="p">(</span><span class="bp">self</span><span class="p">:</span> <span class="n">InternalDebugger</span><span class="p">,</span> <span class="n">open_in_new_process</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">True</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span><span class="p">:</span>
+    <span class="k">def</span> <span class="nf">gdb</span><span class="p">(</span><span class="bp">self</span><span class="p">:</span> <span class="n">InternalDebugger</span><span class="p">,</span> <span class="n">migrate_breakpoints</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">True</span><span class="p">,</span> <span class="n">open_in_new_process</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">True</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span><span class="p">:</span>
 <span class="w">        </span><span class="sd">&quot;&quot;&quot;Migrates the current debugging session to GDB.&quot;&quot;&quot;</span>
         <span class="c1"># TODO: not needed?</span>
         <span class="bp">self</span><span class="o">.</span><span class="n">interrupt</span><span class="p">()</span>
@@ -1270,21 +1270,23 @@ <h1>Source code for libdebug.debugger.internal_debugger</h1><div class="highligh
 
         <span class="bp">self</span><span class="o">.</span><span class="n">_join_and_check_status</span><span class="p">()</span>
 
+        <span class="n">command</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_craft_gdb_migration_command</span><span class="p">(</span><span class="n">migrate_breakpoints</span><span class="p">)</span>
+
         <span class="k">if</span> <span class="n">open_in_new_process</span> <span class="ow">and</span> <span class="n">libcontext</span><span class="o">.</span><span class="n">terminal</span><span class="p">:</span>
-            <span class="bp">self</span><span class="o">.</span><span class="n">_open_gdb_in_new_process</span><span class="p">()</span>
+            <span class="bp">self</span><span class="o">.</span><span class="n">_open_gdb_in_new_process</span><span class="p">(</span><span class="n">command</span><span class="p">)</span>
         <span class="k">else</span><span class="p">:</span>
             <span class="k">if</span> <span class="n">open_in_new_process</span><span class="p">:</span>
                 <span class="n">liblog</span><span class="o">.</span><span class="n">warning</span><span class="p">(</span>
                     <span class="s2">&quot;Cannot open in a new process. Please configure the terminal in libcontext.terminal.&quot;</span><span class="p">,</span>
                 <span class="p">)</span>
-            <span class="bp">self</span><span class="o">.</span><span class="n">_open_gdb_in_shell</span><span class="p">()</span>
+            <span class="bp">self</span><span class="o">.</span><span class="n">_open_gdb_in_shell</span><span class="p">(</span><span class="n">command</span><span class="p">)</span>
 
         <span class="bp">self</span><span class="o">.</span><span class="n">__polling_thread_command_queue</span><span class="o">.</span><span class="n">put</span><span class="p">((</span><span class="bp">self</span><span class="o">.</span><span class="n">__threaded_migrate_from_gdb</span><span class="p">,</span> <span class="p">()))</span>
 
         <span class="bp">self</span><span class="o">.</span><span class="n">_join_and_check_status</span><span class="p">()</span></div>
 
 
-    <span class="k">def</span> <span class="nf">_craft_gdb_migration_command</span><span class="p">(</span><span class="bp">self</span><span class="p">:</span> <span class="n">InternalDebugger</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">list</span><span class="p">[</span><span class="nb">str</span><span class="p">]:</span>
+    <span class="k">def</span> <span class="nf">_craft_gdb_migration_command</span><span class="p">(</span><span class="bp">self</span><span class="p">:</span> <span class="n">InternalDebugger</span><span class="p">,</span> <span class="n">migrate_breakpoints</span><span class="p">:</span> <span class="nb">bool</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">list</span><span class="p">[</span><span class="nb">str</span><span class="p">]:</span>
 <span class="w">        </span><span class="sd">&quot;&quot;&quot;Crafts the command to migrate to GDB.&quot;&quot;&quot;</span>
         <span class="n">gdb_command</span> <span class="o">=</span> <span class="p">[</span>
             <span class="s2">&quot;/bin/gdb&quot;</span><span class="p">,</span>
@@ -1299,6 +1301,9 @@ <h1>Source code for libdebug.debugger.internal_debugger</h1><div class="highligh
             <span class="s2">&quot;ni&quot;</span><span class="p">,</span>
         <span class="p">]</span>
 
+        <span class="k">if</span> <span class="ow">not</span> <span class="n">migrate_breakpoints</span><span class="p">:</span>
+            <span class="k">return</span> <span class="n">gdb_command</span>
+
         <span class="n">bp_args</span> <span class="o">=</span> <span class="p">[]</span>
         <span class="k">for</span> <span class="n">bp</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">breakpoints</span><span class="o">.</span><span class="n">values</span><span class="p">():</span>
             <span class="k">if</span> <span class="n">bp</span><span class="o">.</span><span class="n">enabled</span><span class="p">:</span>
@@ -1320,10 +1325,8 @@ <h1>Source code for libdebug.debugger.internal_debugger</h1><div class="highligh
 
         <span class="k">return</span> <span class="n">gdb_command</span> <span class="o">+</span> <span class="n">bp_args</span>
 
-    <span class="k">def</span> <span class="nf">_open_gdb_in_new_process</span><span class="p">(</span><span class="bp">self</span><span class="p">:</span> <span class="n">InternalDebugger</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span><span class="p">:</span>
+    <span class="k">def</span> <span class="nf">_open_gdb_in_new_process</span><span class="p">(</span><span class="bp">self</span><span class="p">:</span> <span class="n">InternalDebugger</span><span class="p">,</span> <span class="n">args</span><span class="p">:</span> <span class="nb">list</span><span class="p">[</span><span class="nb">str</span><span class="p">])</span> <span class="o">-&gt;</span> <span class="kc">None</span><span class="p">:</span>
 <span class="w">        </span><span class="sd">&quot;&quot;&quot;Opens GDB in a new process following the configuration in libcontext.terminal.&quot;&quot;&quot;</span>
-        <span class="n">args</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_craft_gdb_migration_command</span><span class="p">()</span>
-
         <span class="n">initial_pid</span> <span class="o">=</span> <span class="n">Popen</span><span class="p">(</span><span class="n">libcontext</span><span class="o">.</span><span class="n">terminal</span> <span class="o">+</span> <span class="n">args</span><span class="p">)</span><span class="o">.</span><span class="n">pid</span>
 
         <span class="n">os</span><span class="o">.</span><span class="n">waitpid</span><span class="p">(</span><span class="n">initial_pid</span><span class="p">,</span> <span class="mi">0</span><span class="p">)</span>
@@ -1348,11 +1351,10 @@ <h1>Source code for libdebug.debugger.internal_debugger</h1><div class="highligh
             <span class="c1"># So we must keep polling it until it is no longer running</span>
             <span class="k">pass</span>
 
-    <span class="k">def</span> <span class="nf">_open_gdb_in_shell</span><span class="p">(</span><span class="bp">self</span><span class="p">:</span> <span class="n">InternalDebugger</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span><span class="p">:</span>
+    <span class="k">def</span> <span class="nf">_open_gdb_in_shell</span><span class="p">(</span><span class="bp">self</span><span class="p">:</span> <span class="n">InternalDebugger</span><span class="p">,</span> <span class="n">args</span><span class="p">:</span> <span class="nb">list</span><span class="p">[</span><span class="nb">str</span><span class="p">])</span> <span class="o">-&gt;</span> <span class="kc">None</span><span class="p">:</span>
 <span class="w">        </span><span class="sd">&quot;&quot;&quot;Open GDB in the current shell.&quot;&quot;&quot;</span>
         <span class="n">gdb_pid</span> <span class="o">=</span> <span class="n">os</span><span class="o">.</span><span class="n">fork</span><span class="p">()</span>
         <span class="k">if</span> <span class="n">gdb_pid</span> <span class="o">==</span> <span class="mi">0</span><span class="p">:</span>  <span class="c1"># This is the child process.</span>
-            <span class="n">args</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_craft_gdb_migration_command</span><span class="p">()</span>
             <span class="n">os</span><span class="o">.</span><span class="n">execv</span><span class="p">(</span><span class="s2">&quot;/bin/gdb&quot;</span><span class="p">,</span> <span class="n">args</span><span class="p">)</span>
         <span class="k">else</span><span class="p">:</span>  <span class="c1"># This is the parent process.</span>
             <span class="c1"># Parent ignores SIGINT, so only GDB (child) receives it</span>

dev/_modules/libdebug/utils/debugger_wrappers.html

@@ -486,7 +486,7 @@ <h1>Source code for libdebug.utils.debugger_wrappers</h1><div class="highlight">
 
         <span class="c1"># We have to ensure that at least one thread is alive before executing the method</span>
         <span class="k">if</span> <span class="n">thread</span><span class="o">.</span><span class="n">dead</span><span class="p">:</span>
-            <span class="k">raise</span> <span class="ne">RuntimeError</span><span class="p">(</span><span class="s2">&quot;The threads is dead.&quot;</span><span class="p">)</span>
+            <span class="k">raise</span> <span class="ne">RuntimeError</span><span class="p">(</span><span class="s2">&quot;The thread is dead.&quot;</span><span class="p">)</span>
         <span class="k">return</span> <span class="n">method</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">thread</span><span class="p">,</span> <span class="o">*</span><span class="n">args</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span>
 
     <span class="k">return</span> <span class="n">wrapper</span></div>