diff options
| author | Jason Molenda <jmolenda@apple.com> | 2019-10-04 21:01:52 +0000 |
|---|---|---|
| committer | Jason Molenda <jmolenda@apple.com> | 2019-10-04 21:01:52 +0000 |
| commit | 984d08c680a79c72da1fbd55f7c4f8f672ef7f95 (patch) | |
| tree | 26fd6241fb738c721735ecb30a5f3156c1cf04e4 | |
| parent | 6e312388b6f861067285bac45d90bd92b508608c (diff) | |
| download | bcm5719-llvm-984d08c680a79c72da1fbd55f7c4f8f672ef7f95.tar.gz bcm5719-llvm-984d08c680a79c72da1fbd55f7c4f8f672ef7f95.zip | |
Expand on the qfProcessInfo documentation, add examples from
lldb-gdb-remote.txt and text explaining the no-criteria mode.
llvm-svn: 373789
| -rw-r--r-- | lldb/docs/lldb-platform-packets.txt | 37 |
1 files changed, 33 insertions, 4 deletions
diff --git a/lldb/docs/lldb-platform-packets.txt b/lldb/docs/lldb-platform-packets.txt index 3258e4c0dd8..ed5d7170171 100644 --- a/lldb/docs/lldb-platform-packets.txt +++ b/lldb/docs/lldb-platform-packets.txt @@ -181,10 +181,31 @@ incompatible with the flags that gdb specifies. // send: pid:3500;name:612e6f7574; // // The request packet has a criteria to search for, followed by -// a specific name. Other name_match: values include -// starts_with, ends_with, contains, regex. You can specify a pid -// to search for, a uid, all_users, triple, etc etc. The testsuite -// only ever searches for name_match:equals. +// a specific name. +// +// KEY VALUE DESCRIPTION +// =========== ======== ================================================ +// "name" ascii-hex An ASCII hex string that contains the name of +// the process that will be matched. +// "name_match" enum One of: "equals", "starts_with", "ends_with", +// "contains" or "regex" +// "pid" integer A string value containing the decimal process ID +// "parent_pid" integer A string value containing the decimal parent +// process ID +// "uid" integer A string value containing the decimal user ID +// "gid" integer A string value containing the decimal group ID +// "euid" integer A string value containing the decimal effective user ID +// "egid" integer A string value containing the decimal effective group ID +// "all_users" bool A boolean value that specifies if processes should +// be listed for all users, not just the user that the +// platform is running as +// "triple" ascii-hex An ASCII hex target triple string ("x86_64", +// "x86_64-apple-macosx", "armv7-apple-ios") +// +// If no criteria is given, qfProcessInfo will request a list of every process. +// +// The lldb testsuite currently only uses name_match:equals and the +// no-criteria mode to list every process. // // The response should include any information about the process that // can be retrieved in semicolon-separated name:value fields. @@ -195,6 +216,14 @@ incompatible with the flags that gdb specifies. // the search, qsProcessInfo should be sent. // // If no process match is found, Exx should be returned. +// +// Sample packet/response: +// send packet: $qfProcessInfo#00 +// read packet: $pid:60001;ppid:59948;uid:7746;gid:11;euid:7746;egid:11;name:6c6c6462;triple:7838365f36342d6170706c652d6d61636f7378;#00 +// send packet: $qsProcessInfo#00 +// read packet: $pid:59992;ppid:192;uid:7746;gid:11;euid:7746;egid:11;name:6d64776f726b6572;triple:7838365f36342d6170706c652d6d61636f7378;#00 +// send packet: $qsProcessInfo#00 +// read packet: $E04#00 //---------------------------------------------------------------------- // qsProcessInfo |
