toolchain/share/doc/gdb/Pointer-Values.html

68 lines
3.2 KiB
HTML

<html lang="en">
<head>
<title>Pointer Values - 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="Protocol_002dspecific-Representation-of-Datatypes.html#Protocol_002dspecific-Representation-of-Datatypes" title="Protocol-specific Representation of Datatypes">
<link rel="prev" href="Integral-Datatypes.html#Integral-Datatypes" title="Integral Datatypes">
<link rel="next" href="Memory-Transfer.html#Memory-Transfer" title="Memory Transfer">
<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="Pointer-Values"></a>
<p>
Next:&nbsp;<a rel="next" accesskey="n" href="Memory-Transfer.html#Memory-Transfer">Memory Transfer</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="Integral-Datatypes.html#Integral-Datatypes">Integral Datatypes</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="Protocol_002dspecific-Representation-of-Datatypes.html#Protocol_002dspecific-Representation-of-Datatypes">Protocol-specific Representation of Datatypes</a>
<hr>
</div>
<h5 class="unnumberedsubsubsec">Pointer Values</h5>
<p><a name="index-pointer-values_002c-in-file_002di_002fo-protocol-3620"></a>
Pointers to target data are transmitted as they are. An exception
is made for pointers to buffers for which the length isn't
transmitted as part of the function call, namely strings. Strings
are transmitted as a pointer/length pair, both as hex values, e.g.
<pre class="smallexample"> <code>1aaf/12</code>
</pre>
<p class="noindent">which is a pointer to data of length 18 bytes at position 0x1aaf.
The length is defined as the full string length in bytes, including
the trailing null byte. For example, the string <code>"hello world"</code>
at address 0x123456 is transmitted as
<pre class="smallexample"> <code>123456/d</code>
</pre>
</body></html>