[all-commits] [llvm/llvm-project] 339874: [lldb][Docs] Additions to debuging LLDB page (#65635)

[David Spickett via All-commits]

  Branch: refs/heads/main
  Home:   https://github.com/llvm/llvm-project
  Commit: 3398744a6106c83993611bd3c5e79ec6b94417dc
      https://github.com/llvm/llvm-project/commit/3398744a6106c83993611bd3c5e79ec6b94417dc
  Author: David Spickett <david.spickett at linaro.org>
  Date:   2023-09-08 (Fri, 08 Sep 2023)

  Changed paths:
    M lldb/docs/resources/debugging.rst
    A lldb/examples/ptrace_example.c

  Log Message:
  -----------
  [lldb][Docs] Additions to debuging LLDB page (#65635)

Adds the following:
* A note that you can use attaching to debug the right lldb-server
process, though there are drawbacks.
* A section on debugging the remote protocol.
* Reducing bugs, including reducing ptrace bugs to remove the need for
LLDB.

I've added a standlone ptrace program to the examples folder because:
* There's no better place to put it.
* Adding it to the page seems like wasting space, and would be harder to
update.
* I link to Eli Bendersky's classic blog on the subject, but we are
safer with our own example as well.
* Eli's example is for 32 bit Intel, AArch64 is more common these days.
* It's easier to show the software breakpoint steps in code than explain
it (though I still do that in the text).
* It was living on my laptop not helping anyone so I think it's good to
have it upstream for others, including future me.