os/doc
3
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity

handbook: add a section on remote debugging via LLDB

Browse source 
PR:		251709
Obtained from:	Moritz Systems
Submitted by:	Michał Górny <mgorny@moritz.systems>
Sponsored by:	The FreeBSD Foundation
Reviewed by:	bcr
Discussed with:	dim, emaste
Differential Revision:	https://reviews.freebsd.org/D27524
This commit is contained in:
Guangyuan Yang 2020-12-28 16:26:55 +00:00
parent a496aac425
commit 192a5729e5
1 changed files with 42 additions and 0 deletions

42
en_US.ISO8859-1/books/developers-handbook/tools/chapter.xml
View file

@ -1655,6 +1655,48 @@ else if (pid == 0) { /* child */
<userinput>expr PauseMode = 0</userinput> and wait
for the <function>sleep()</function> call to return.</para>
</sect3>
<sect3>
<title>Remote Debugging Using LLDB</title>
<note>
<para>The described functionality is available starting with
LLDB version 12.0.0. Users of &os; releases containing an
earlier LLDB version may wish to use the snapshot
available in <link
xlink:href="&url.books.handbook;/ports-using.html">ports
or packages</link>, as
<package>devel/llvm-devel</package>.</para>
</note>
<para>Starting with LLDB 12.0.0, remote debugging is supported
on &os;. This means that <command>lldb-server</command>
can be started to debug a program on one host, while
the interactive <command>lldb</command> client connects
to it from another one.</para>
<para>To launch a new process to be debugged remotely, run
<command>lldb-server</command> on the remote server
by typing</para>
<screen>&prompt.user; <userinput>lldb-server g <replaceable>host:port</replaceable> -- <replaceable>progname</replaceable></userinput></screen>
<para>The process will be stopped immediately after launching,
and <command>lldb-server</command> will wait for the client
to connect.</para>
<para>Start <command>lldb</command> locally and type
the following command to connect to the remote
server:</para>
<screen>(lldb) <userinput>gdb-remote <replaceable>host:port</replaceable></userinput></screen>
<para><command>lldb-server</command> can also attach to
a running process. To do that, type the following
on the remote server:</para>
<screen>&prompt.user; <userinput>lldb-server g <replaceable>host:port</replaceable> --attach <replaceable>pid-or-name</replaceable></userinput></screen>
</sect3>
</sect2>
<sect2>