native_client_sdk/src/doc/devguide/devcycle/debugging.rst - Issue 1051653004: Add NaCl SDK release note about LLVM 3.6 and debug metadata changes.

Side by Side Diff: native_client_sdk/src/doc/devguide/devcycle/debugging.rst

Issue 1051653004: Add NaCl SDK release note about LLVM 3.6 and debug metadata changes. (Closed) Base URL: https://chromium.googlesource.com/chromium/src.git@master

Patch Set: line wrap Created 5 years, 8 months ago

Use n/p to move between diff chunks; N/P to move between comments. Draft comments are only viewable by you.

Jump to:

View unified diff | Download patch

« no previous file with comments | « native_client_sdk/doc_generated/sdk/release-notes.html ('k') | native_client_sdk/src/doc/sdk/release-notes.rst » ('j') | native_client_sdk/src/doc/sdk/release-notes.rst » ('J')
Toggle Intra-line Diffs ('i') | Expand Comments ('e') | Collapse Comments ('c') | Hide Comments ('s')

OLD	NEW
1 .. _devcycle-debugging:	1 .. _devcycle-debugging:

2	2

3 #########	3 #########

4 Debugging	4 Debugging

5 #########	5 #########

6	6

7 This document describes tools and techniques you can use to debug, monitor,	7 This document describes tools and techniques you can use to debug, monitor,

8 and measure your application's performance.	8 and measure your application's performance.

9	9

10 .. contents:: Table Of Contents	10 .. contents:: Table Of Contents

(...skipping 213 matching lines...) Expand 10 before \| Expand all \| Expand 10 after Loading...
224 <running_nacl_gdb>`	224 <running_nacl_gdb>`

225	225

226 Whether you publish the NMF file containing the debug URL to the	226 Whether you publish the NMF file containing the debug URL to the

227 release web server, is up to you. One reason to avoid publishing the	227 release web server, is up to you. One reason to avoid publishing the

228 debug URL is that it is only guaranteed to work for the Chrome version	228 debug URL is that it is only guaranteed to work for the Chrome version

229 that matches the SDK version. Developers who may have left the	229 that matches the SDK version. Developers who may have left the

230 ``--enable-nacl-debug`` flag turned on may end up loading the debug	230 ``--enable-nacl-debug`` flag turned on may end up loading the debug

231 copy of your application (which may or may not work, depending on	231 copy of your application (which may or may not work, depending on

232 their version of Chrome).	232 their version of Chrome).

233	233

	234 .. _debugging_pexes_via_nexes:

234	235

235 Debugging PNaCl pexes (with older Pepper toolchains)	236 Debugging PNaCl pexes (with older Pepper toolchains)

236 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~	237 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

237	238

238 If you want to use GDB to debug a program that is compiled with the PNaCl	239 If you want to use GDB to debug a program that is compiled with the PNaCl

239 toolchain, you must convert the ``pexe`` file to a ``nexe``. (You can skip	240 toolchain, you must convert the ``pexe`` file to a ``nexe``. (You can skip

240 this step if you are using the GCC toolchain, or if you are using	241 this step if you are using the GCC toolchain, or if you are using

241 pepper 35 or later.)	242 pepper 35 or later.)

242	243

243 * Firstly, make sure you are passing the ``-g`` :ref:`compile option	244 * Firstly, make sure you are passing the ``-g`` :ref:`compile option

(...skipping 295 matching lines...) Expand 10 before \| Expand all \| Expand 10 after Loading...
539 plugin, you need to port it to Native Client (i.e., build the module with one of	540 plugin, you need to port it to Native Client (i.e., build the module with one of

540 the toolchains in the NaCl SDK so that the module runs in Native Client). For	541 the toolchains in the NaCl SDK so that the module runs in Native Client). For

541 details on this advanced development technique, see `Debugging a Trusted Plugin	542 details on this advanced development technique, see `Debugging a Trusted Plugin

542 <http://www.chromium.org/nativeclient/how-tos/debugging-documentation/debugging- a-trusted-plugin>`_.	543 <http://www.chromium.org/nativeclient/how-tos/debugging-documentation/debugging- a-trusted-plugin>`_.

543 Note that starting with the ``pepper_22`` bundle, the NaCl SDK for Windows	544 Note that starting with the ``pepper_22`` bundle, the NaCl SDK for Windows

544 includes pre-built libraries and library source code, making it much easier to	545 includes pre-built libraries and library source code, making it much easier to

545 build a module into a .DLL.	546 build a module into a .DLL.

546	547

547 .. \|menu-icon\| image:: /images/menu-icon.png	548 .. \|menu-icon\| image:: /images/menu-icon.png

548 .. \|puzzle\| image:: /images/puzzle.png	549 .. \|puzzle\| image:: /images/puzzle.png

OLD	NEW