Skip to content

Commit 4fb7785

Browse files
committed
Replace "debugee" with "inferior"
1 parent ecb34e1 commit 4fb7785

File tree

1 file changed

+19
-19
lines changed

1 file changed

+19
-19
lines changed

lldb/docs/resources/debugging.rst

Lines changed: 19 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -9,8 +9,8 @@ As LLDB is generally split into 2 tools, ``lldb`` and ``lldb-server``
99
(``debugserver`` on Mac OS), the techniques shown here will not always apply to
1010
both. With some knowledge of them all, you can mix and match as needed.
1111

12-
In this document we refer to the initial ``lldb`` as the debugger and the
13-
program being debugged as the debugee.
12+
In this document we refer to the initial ``lldb`` as the "debugger" and the
13+
program being debugged as the "inferior".
1414

1515
Building For Debugging
1616
----------------------
@@ -63,11 +63,11 @@ makes it very confusing which one is which:
6363
Process 1741640 launched: '<...>/bin/lldb' (aarch64)
6464
Process 1741640 stopped and restarted: thread 1 received signal: SIGCHLD
6565

66-
(the debugee)
66+
(the inferior)
6767
(lldb) target create "/tmp/test.o"
6868
Current executable set to '/tmp/test.o' (aarch64).
6969

70-
Another issue is that when you resume the debugee, it will not print the
70+
Another issue is that when you resume the inferior, it will not print the
7171
``(lldb)`` prompt because as far as it knows it hasn't changed state. A quick
7272
way around that is to type something that is clearly not a command and hit
7373
enter.
@@ -84,30 +84,30 @@ enter.
8484
error: 'notacommand' is not a valid command.
8585
(lldb)
8686

87-
You could just remember whether you are in the debugger or the debugee but
88-
it's thinking overhead, and for interrupt based events you simply may not be
89-
able to know.
87+
You could just remember whether you are in the debugger or the inferior but
88+
it's more for you to remember, and for interrupt based events you simply may not
89+
be able to know.
9090

9191
Here are some better approaches. First, you could use another debugger like GDB
9292
to debug LLDB. Perhaps an IDE like Xcode or Visual Studio Code. Something which
9393
runs LLDB under the hood so you don't have to type in commands to the debugger
9494
yourself.
9595

96-
Or you could change the prompt text for the debugger and/or debugee.
96+
Or you could change the prompt text for the debugger and/or inferior.
9797

9898
::
9999

100100
$ ./bin/lldb -o "settings set prompt \"(lldb debugger) \"" -- \
101-
./bin/lldb -o "settings set prompt \"(lldb debuggee) \"" /tmp/test.o
101+
./bin/lldb -o "settings set prompt \"(lldb inferior) \"" /tmp/test.o
102102
<...>
103103
(lldb) settings set prompt "(lldb debugger) "
104104
(lldb debugger) run
105105
<...>
106-
(lldb) settings set prompt "(lldb debuggee) "
107-
(lldb debuggee)
106+
(lldb) settings set prompt "(lldb inferior) "
107+
(lldb inferior)
108108

109-
If you want spacial separation you can run the debugee in one terminal then
110-
attach to it in another. Remember that while paused in the debugger, the debugee
109+
If you want spacial separation you can run the inferior in one terminal then
110+
attach to it in another. Remember that while paused in the debugger, the inferior
111111
will not respond to input so you will have to ``continue`` in the debugger
112112
first.
113113

@@ -122,14 +122,14 @@ first.
122122
Placing Breakpoints
123123
*******************
124124

125-
Generally you will want to hit some breakpoint in the debugee ``lldb``. To place
126-
that breakpoint you must first stop the debugee.
125+
Generally you will want to hit some breakpoint in the inferior ``lldb``. To place
126+
that breakpoint you must first stop the inferior.
127127

128128
If you're debugging from another window this is done with ``process interrupt``.
129-
The debugee will stop, you place the breakpoint and then ``continue``. Go back
130-
to the debugee and input the command that should trigger the breakpoint.
129+
The inferior will stop, you place the breakpoint and then ``continue``. Go back
130+
to the inferior and input the command that should trigger the breakpoint.
131131

132-
If you are running debugger and debugee in the same window, input ``ctrl+c``
132+
If you are running debugger and inferior in the same window, input ``ctrl+c``
133133
instead of ``process interrupt`` and then folllow the rest of the steps.
134134

135135
If you are doing this with ``lldb-server`` and find your breakpoint is never
@@ -224,7 +224,7 @@ In the example below we're debugging an ``lldb-server`` ``gdbserver`` mode
224224
command running on a remote machine.
225225

226226
For simplicity we'll use the same ``lldb-server`` as the debug server
227-
and the debugee, but it doesn't need to be that way. You can use ``gdbserver``
227+
and the inferior, but it doesn't need to be that way. You can use ``gdbserver``
228228
(as in, GDB's debug server program) or a system installed ``lldb-server`` if you
229229
suspect your local copy is not stable. As is the case in many of these
230230
scenarios.

0 commit comments

Comments
 (0)