122 lines
9.3 KiB
HTML
122 lines
9.3 KiB
HTML
|
<html lang="en">
|
||
|
|
<head>
|
||
|
|
<title>IPA Protocol Objects - 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="In_002dProcess-Agent-Protocol.html#In_002dProcess-Agent-Protocol" title="In-Process Agent Protocol">
|
||
|
|
<link rel="next" href="IPA-Protocol-Commands.html#IPA-Protocol-Commands" title="IPA Protocol Commands">
|
||
|
|
<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="IPA-Protocol-Objects"></a>
|
||
|
|
<p>
|
||
|
|
Next: <a rel="next" accesskey="n" href="IPA-Protocol-Commands.html#IPA-Protocol-Commands">IPA Protocol Commands</a>,
|
||
|
|
Up: <a rel="up" accesskey="u" href="In_002dProcess-Agent-Protocol.html#In_002dProcess-Agent-Protocol">In-Process Agent Protocol</a>
|
||
|
|
<hr>
|
||
|
|
</div>
|
||
|
|
|
||
|
|
<h4 class="subsection">30.1.1 IPA Protocol Objects</h4>
|
||
|
|
|
||
|
|
<p><a name="index-ipa-protocol-objects-3166"></a>
|
||
|
|
The commands sent to and results received from agent may contain some
|
||
|
|
complex data types called <dfn>objects</dfn>.
|
||
|
|
|
||
|
|
<p>The in-process agent is running on the same machine with <span class="sc">gdb</span>
|
||
|
|
or GDBserver, so it doesn't have to handle as much differences between
|
||
|
|
two ends as remote protocol (see <a href="Remote-Protocol.html#Remote-Protocol">Remote Protocol</a>) tries to handle.
|
||
|
|
However, there are still some differences of two ends in two processes:
|
||
|
|
|
||
|
|
<ol type=1 start=1>
|
||
|
|
<li>word size. On some 64-bit machines, <span class="sc">gdb</span> or GDBserver can be
|
||
|
|
compiled as a 64-bit executable, while in-process agent is a 32-bit one.
|
||
|
|
<li>ABI. Some machines may have multiple types of ABI, <span class="sc">gdb</span> or
|
||
|
|
GDBserver is compiled with one, and in-process agent is compiled with
|
||
|
|
the other one.
|
||
|
|
</ol>
|
||
|
|
|
||
|
|
<p>Here are the IPA Protocol Objects:
|
||
|
|
|
||
|
|
<ol type=1 start=1>
|
||
|
|
<li>agent expression object. It represents an agent expression
|
||
|
|
(see <a href="Agent-Expressions.html#Agent-Expressions">Agent Expressions</a>).
|
||
|
|
<a name="agent-expression-object"></a><li>tracepoint action object. It represents a tracepoint action
|
||
|
|
(see <a href="Tracepoint-Actions.html#Tracepoint-Actions">Tracepoint Action Lists</a>) to collect registers,
|
||
|
|
memory, static trace data and to evaluate expression.
|
||
|
|
<a name="tracepoint-action-object"></a><li>tracepoint object. It represents a tracepoint (see <a href="Tracepoints.html#Tracepoints">Tracepoints</a>).
|
||
|
|
<a name="tracepoint-object"></a>
|
||
|
|
</ol>
|
||
|
|
|
||
|
|
<p>The following table describes important attributes of each IPA protocol
|
||
|
|
object:
|
||
|
|
|
||
|
|
<p><table summary=""><tr align="left"><th valign="top" width="30%">Name </th><th valign="top" width="20%">Size </th><th valign="top" width="50%">Description
|
||
|
|
<br></th></tr><tr align="left"><td valign="top" width="30%"><em>agent expression object</em> </td><td valign="top" width="20%"></td><td valign="top" width="50%">
|
||
|
|
<br></td></tr><tr align="left"><td valign="top" width="30%">length </td><td valign="top" width="20%">4 </td><td valign="top" width="50%">length of bytes code
|
||
|
|
<br></td></tr><tr align="left"><td valign="top" width="30%">byte code </td><td valign="top" width="20%"><var>length</var> </td><td valign="top" width="50%">contents of byte code
|
||
|
|
<br></td></tr><tr align="left"><td valign="top" width="30%"><em>tracepoint action for collecting memory</em> </td><td valign="top" width="20%"></td><td valign="top" width="50%">
|
||
|
|
<br></td></tr><tr align="left"><td valign="top" width="30%">'M' </td><td valign="top" width="20%">1 </td><td valign="top" width="50%">type of tracepoint action
|
||
|
|
<br></td></tr><tr align="left"><td valign="top" width="30%">addr </td><td valign="top" width="20%">8 </td><td valign="top" width="50%">if <var>basereg</var> is ‘<samp><span class="samp">-1</span></samp>’, <var>addr</var> is the
|
||
|
|
address of the lowest byte to collect, otherwise <var>addr</var> is the offset
|
||
|
|
of <var>basereg</var> for memory collecting.
|
||
|
|
<br></td></tr><tr align="left"><td valign="top" width="30%">len </td><td valign="top" width="20%">8 </td><td valign="top" width="50%">length of memory for collecting
|
||
|
|
<br></td></tr><tr align="left"><td valign="top" width="30%">basereg </td><td valign="top" width="20%">4 </td><td valign="top" width="50%">the register number containing the starting
|
||
|
|
memory address for collecting.
|
||
|
|
<br></td></tr><tr align="left"><td valign="top" width="30%"><em>tracepoint action for collecting registers</em> </td><td valign="top" width="20%"></td><td valign="top" width="50%">
|
||
|
|
<br></td></tr><tr align="left"><td valign="top" width="30%">'R' </td><td valign="top" width="20%">1 </td><td valign="top" width="50%">type of tracepoint action
|
||
|
|
<br></td></tr><tr align="left"><td valign="top" width="30%"><em>tracepoint action for collecting static trace data</em> </td><td valign="top" width="20%"></td><td valign="top" width="50%">
|
||
|
|
<br></td></tr><tr align="left"><td valign="top" width="30%">'L' </td><td valign="top" width="20%">1 </td><td valign="top" width="50%">type of tracepoint action
|
||
|
|
<br></td></tr><tr align="left"><td valign="top" width="30%"><em>tracepoint action for expression evaluation</em> </td><td valign="top" width="20%"></td><td valign="top" width="50%">
|
||
|
|
<br></td></tr><tr align="left"><td valign="top" width="30%">'X' </td><td valign="top" width="20%">1 </td><td valign="top" width="50%">type of tracepoint action
|
||
|
|
<br></td></tr><tr align="left"><td valign="top" width="30%">agent expression </td><td valign="top" width="20%">length of </td><td valign="top" width="50%"><a href="agent-expression-object.html#agent-expression-object">agent expression object</a>
|
||
|
|
<br></td></tr><tr align="left"><td valign="top" width="30%"><em>tracepoint object</em> </td><td valign="top" width="20%"></td><td valign="top" width="50%">
|
||
|
|
<br></td></tr><tr align="left"><td valign="top" width="30%">number </td><td valign="top" width="20%">4 </td><td valign="top" width="50%">number of tracepoint
|
||
|
|
<br></td></tr><tr align="left"><td valign="top" width="30%">address </td><td valign="top" width="20%">8 </td><td valign="top" width="50%">address of tracepoint inserted on
|
||
|
|
<br></td></tr><tr align="left"><td valign="top" width="30%">type </td><td valign="top" width="20%">4 </td><td valign="top" width="50%">type of tracepoint
|
||
|
|
<br></td></tr><tr align="left"><td valign="top" width="30%">enabled </td><td valign="top" width="20%">1 </td><td valign="top" width="50%">enable or disable of tracepoint
|
||
|
|
<br></td></tr><tr align="left"><td valign="top" width="30%">step_count </td><td valign="top" width="20%">8 </td><td valign="top" width="50%">step
|
||
|
|
<br></td></tr><tr align="left"><td valign="top" width="30%">pass_count </td><td valign="top" width="20%">8 </td><td valign="top" width="50%">pass
|
||
|
|
<br></td></tr><tr align="left"><td valign="top" width="30%">numactions </td><td valign="top" width="20%">4 </td><td valign="top" width="50%">number of tracepoint actions
|
||
|
|
<br></td></tr><tr align="left"><td valign="top" width="30%">hit count </td><td valign="top" width="20%">8 </td><td valign="top" width="50%">hit count
|
||
|
|
<br></td></tr><tr align="left"><td valign="top" width="30%">trace frame usage </td><td valign="top" width="20%">8 </td><td valign="top" width="50%">trace frame usage
|
||
|
|
<br></td></tr><tr align="left"><td valign="top" width="30%">compiled_cond </td><td valign="top" width="20%">8 </td><td valign="top" width="50%">compiled condition
|
||
|
|
<br></td></tr><tr align="left"><td valign="top" width="30%">orig_size </td><td valign="top" width="20%">8 </td><td valign="top" width="50%">orig size
|
||
|
|
<br></td></tr><tr align="left"><td valign="top" width="30%">condition </td><td valign="top" width="20%">4 if condition is NULL otherwise length of
|
||
|
|
<a href="agent-expression-object.html#agent-expression-object">agent expression object</a>
|
||
|
|
</td><td valign="top" width="50%">zero if condition is NULL, otherwise is
|
||
|
|
<a href="agent-expression-object.html#agent-expression-object">agent expression object</a>
|
||
|
|
<br></td></tr><tr align="left"><td valign="top" width="30%">actions </td><td valign="top" width="20%">variable
|
||
|
|
</td><td valign="top" width="50%">numactions number of <a href="tracepoint-action-object.html#tracepoint-action-object">tracepoint action object</a>
|
||
|
|
<br></td></tr></table>
|
||
|
|
|
||
|
|
</body></html>
|
||
|
|
|