Skip to content

[lldb][Docs] Add equivalents of GDB's "skip" to command map #120740

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 3 commits into from
Jan 6, 2025
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
32 changes: 32 additions & 0 deletions lldb/docs/use/map.rst
Original file line number Diff line number Diff line change
Expand Up @@ -235,6 +235,38 @@ Do a source level single step in the currently selected thread
(lldb) step
(lldb) s

Ignore a function when doing a source level single step in
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. code-block:: shell

(gdb) skip abc
Function abc will be skipped when stepping.

.. code-block:: shell

(lldb) settings show target.process.thread.step-avoid-regexp
target.process.thread.step-avoid-regexp (regex) = ^std::
(lldb) settings set target.process.thread.step-avoid-regexp ^std::|^abc

You can ignore a function once using:

.. code-block:: shell

(lldb) thread step-in -r ^abc

Or you can do the opposite, only step into functions matching a certain name:

.. code-block:: shell

# Step in if abc is a substring of the function name.
(lldb) sif abc
# Which is equivalent to:
(lldb) thread step-in -t abc

``thread step-in`` has more options which cover some of ``skip``'s other
features. See ``help thread step-in`` for details.

Do a source level single step over in the currently selected thread
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Expand Down
Loading