toolchain/share/doc/gdb/Process-list.html

76 lines
3.4 KiB
HTML

<html lang="en">
<head>
<title>Process list - Debugging with GDB</title>
<meta http-equiv="Content-Type" content="text/html">
<meta name="description" content="Debugging with GDB">
<meta name="generator" content="makeinfo 4.13">
<link title="Top" rel="start" href="index.html#Top">
<link rel="up" href="Operating-System-Information.html#Operating-System-Information" title="Operating System Information">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage">
<!--
Copyright (C) 1988-2019 Free Software Foundation, Inc.
Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.3 or
any later version published by the Free Software Foundation; with the
Invariant Sections being ``Free Software'' and ``Free Software Needs
Free Documentation'', with the Front-Cover Texts being ``A GNU Manual,''
and with the Back-Cover Texts as in (a) below.
(a) The FSF's Back-Cover Text is: ``You are free to copy and modify
this GNU Manual. Buying copies from GNU Press supports the FSF in
developing GNU and promoting software freedom.''
-->
<meta http-equiv="Content-Style-Type" content="text/css">
<style type="text/css"><!--
pre.display { font-family:inherit }
pre.format { font-family:inherit }
pre.smalldisplay { font-family:inherit; font-size:smaller }
pre.smallformat { font-family:inherit; font-size:smaller }
pre.smallexample { font-size:smaller }
pre.smalllisp { font-size:smaller }
span.sc { font-variant:small-caps }
span.roman { font-family:serif; font-weight:normal; }
span.sansserif { font-family:sans-serif; font-weight:normal; }
--></style>
</head>
<body>
<div class="node">
<a name="Process-list"></a>
<p>
Up:&nbsp;<a rel="up" accesskey="u" href="Operating-System-Information.html#Operating-System-Information">Operating System Information</a>
<hr>
</div>
<h3 class="appendixsec">H.1 Process list</h3>
<p><a name="index-operating-system-information_002c-process-list-3677"></a>
When requesting the process list, the <var>annex</var> field in the
&lsquo;<samp><span class="samp">qXfer</span></samp>&rsquo; request should be &lsquo;<samp><span class="samp">processes</span></samp>&rsquo;. The returned data is
an XML document. The formal syntax of this document is defined in
<samp><span class="file">gdb/features/osdata.dtd</span></samp>.
<p>An example document is:
<pre class="smallexample"> &lt;?xml version="1.0"?&gt;
&lt;!DOCTYPE target SYSTEM "osdata.dtd"&gt;
&lt;osdata type="processes"&gt;
&lt;item&gt;
&lt;column name="pid"&gt;1&lt;/column&gt;
&lt;column name="user"&gt;root&lt;/column&gt;
&lt;column name="command"&gt;/sbin/init&lt;/column&gt;
&lt;column name="cores"&gt;1,2,3&lt;/column&gt;
&lt;/item&gt;
&lt;/osdata&gt;
</pre>
<p>Each item should include a column whose name is &lsquo;<samp><span class="samp">pid</span></samp>&rsquo;. The value
of that column should identify the process on the target. The
&lsquo;<samp><span class="samp">user</span></samp>&rsquo; and &lsquo;<samp><span class="samp">command</span></samp>&rsquo; columns are optional, and will be
displayed by <span class="sc">gdb</span>. The &lsquo;<samp><span class="samp">cores</span></samp>&rsquo; column, if present,
should contain a comma-separated list of cores that this process
is running on. Target may provide additional columns,
which <span class="sc">gdb</span> currently ignores.
</body></html>