-
Notifications
You must be signed in to change notification settings - Fork 1.5k
Update debugging.rst #16601
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
base: master
Are you sure you want to change the base?
Update debugging.rst #16601
Conversation
- Add right path for debug (nuttx /) - Support for debug not only on ESP32 arch (target extended-remote) but also for STM32 chip arch (target remote :3333)
|
||
Inside ``gdb`` console, connect to the ``gdb`` server with: | ||
|
||
.. code-block:: | ||
|
||
(gdb) target extended-remote :3333 | ||
(gdb) tar remote :3333 |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
tar -> target
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
@simbit18 I use "tar" here too, since GDB accept reduced from (tar: target; mon: monitor, etc). But maybe it is better to use the formal way
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Hi @acassis I also use the abbreviated form but I think for documentation the unabbreviated form is preferable.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Hi, agreed the un-abbreviated form is preferred in documentation, but I have another question:
According to the openocd docs, they show target extended-remote
and they say that "If any backward compatibility issue requires using the old remote protocol in place of the extended remote one, the former protocol is still available through" target remote
.
According to the GDB manual, section 20.1 compares target remote
to target extended-remote
and it looks like target extended-remote
is newer/preferred if it works.
So, is there a reason you're changing from target extended-remote
to target remote
and, if so, could the documentation say why? For example, "We are using target remote
rather than target extended-remote
because the latter interferes with blah blah blah"
Thanks!
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Or, alternately, something like this:
Inside gdb console, connect to the gdb server with:
(gdb) target extended-remote :3333
If this doesn't work as expected, try the older remote protocol with:
(gdb) target remote :3333
Note: Please adhere to Contributing Guidelines.
Summary
Update this section with information on why change is necessary,
what it exactly does and how, if new feature shows up, provide
references (dependencies, similar problems and solutions), etc.
Impact
Update this section, where applicable, on how change affects users,
build process, hardware, documentation, security, compatibility, etc.
Testing
Update this section with details on how did you verify the change,
what Host was used for build (OS, CPU, compiler, ..), what Target was
used for verification (arch, board:config, ..), etc. Providing build
and runtime logs from before and after change is highly appreciated.