This is an archive of the discontinued LLVM Phabricator instance.

[www] list command: lldb run <args>
ClosedPublic

Authored by kkleine on May 3 2019, 3:03 AM.

Details

Summary

The run command is only an abbreviation for the more verbose process launch -- <args>
but it works just as with GDB and therefore should be
mentioned in the GDB to LLDB command map.

For educational purposes I've not listed it as the first option on the LLDB side so that new LLDB user can, if they want, also know what the "native" way is for LLDB.

Here's the help documentation for the run command in lldb which gives
proof:

(lldb) help run
     Launch the executable in the debugger.

Syntax: run [<run-args>]

Command Options Usage:
  run [<run-args>]

'run' is an abbreviation for 'process launch -c /bin/sh --'

Diff Detail

Repository
rLLDB LLDB

Event Timeline

kkleine created this revision.May 3 2019, 3:03 AM
Herald added a project: Restricted Project. · View Herald TranscriptMay 3 2019, 3:03 AM
kwk edited the summary of this revision. (Show Details)May 3 2019, 3:03 AM
kkleine updated this revision to Diff 197943.May 3 2019, 3:05 AM

Amend previous commit with copy paste error.

Harbormaster completed remote builds in B31337: Diff 197943.
kkleine updated this revision to Diff 197944.May 3 2019, 3:07 AM
  • [www] move run <args> command down for educational purposes
kwk edited the summary of this revision. (Show Details)May 3 2019, 3:09 AM
kwk added a reviewer: jasonmolenda.
teemperor accepted this revision.May 3 2019, 3:10 AM
teemperor added a subscriber: teemperor.

LGTM, seems consistent with the row above

This revision is now accepted and ready to land.May 3 2019, 3:10 AM
labath added a subscriber: labath.May 3 2019, 3:55 AM

This is the old documentation. You should edit the new one in docs/use/map.rst.

kkleine updated this revision to Diff 198223.May 5 2019, 11:34 PM
  • [www] move run <args> command down for educational purposes
  • Add documentation to docs/use/map.rst
kwk added a subscriber: kwk.May 5 2019, 11:36 PM

This is the old documentation. You should edit the new one in docs/use/map.rst.

Oh, good to know. The new documentation is also updated. May I ask why we have two documentation and don't just throw away one of them? What are they both used for?

The www was the original version, which Jonas replaced with with the rst version. We were waiting to get rid of the www version till we were sure we could iron out all the wrinkles of generating the docs on lldb.llvm.org from the rst version. That's close, though we still don't have the API docs working yet.

@labath @jingham @teemperor I've updated the documentation in both, the new and the old places. Can you please merge this?

This revision was automatically updated to reflect the committed changes.