libstdc++-v3/doc/html/manual/bk01pt03ch19s05.html

   1 <html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>Implementation Issues</title><meta name="generator" content="DocBook XSL-NS Stylesheets V1.76.1"><meta name="keywords" content="
   2       C++
   3     ,
   4       library
   5     ,
   6       profile
   7     "><meta name="keywords" content="
   8       ISO C++
   9     ,
  10       library
  11     "><meta name="keywords" content="
  12       ISO C++
  13     ,
  14       runtime
  15     ,
  16       library
  17     "><link rel="home" href="../index.html" title="The GNU C++ Library"><link rel="up" href="profile_mode.html" title="Chapter 19. Profile Mode"><link rel="prev" href="bk01pt03ch19s04.html" title="Empirical Cost Model"><link rel="next" href="bk01pt03ch19s06.html" title="Developer Information"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Implementation Issues</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="bk01pt03ch19s04.html">Prev</a> </td><th width="60%" align="center">Chapter 19. Profile Mode</th><td width="20%" align="right"> <a accesskey="n" href="bk01pt03ch19s06.html">Next</a></td></tr></table><hr></div><div class="section" title="Implementation Issues"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="manual.ext.profile_mode.implementation"></a>Implementation Issues</h2></div></div></div><div class="section" title="Stack Traces"><div class="titlepage"><div><div><h3 class="title"><a name="manual.ext.profile_mode.implementation.stack"></a>Stack Traces</h3></div></div></div><p>
  18   Accurate stack traces are needed during profiling since we group events by
  19   call context and dynamic instance.  Without accurate traces, diagnostics
  20   may be hard to interpret.  For instance, when giving advice to the user
  21   it is imperative to reference application code, not library code.
  22   </p><p>
  23   Currently we are using the libc <code class="code">backtrace</code> routine to get
  24   stack traces.
  25   <code class="code">_GLIBCXX_PROFILE_STACK_DEPTH</code> can be set
  26   to 0 if you are willing to give up call context information, or to a small
  27   positive value to reduce run time overhead.
  28   </p></div><div class="section" title="Symbolization of Instruction Addresses"><div class="titlepage"><div><div><h3 class="title"><a name="manual.ext.profile_mode.implementation.symbols"></a>Symbolization of Instruction Addresses</h3></div></div></div><p>
  29   The profiling and analysis phases use only instruction addresses.
  30   An external utility such as addr2line is needed to postprocess the result.
  31   We do not plan to add symbolization support in the profile extension.
  32   This would require access to symbol tables, debug information tables,
  33   external programs or libraries and other system dependent information.
  34   </p></div><div class="section" title="Concurrency"><div class="titlepage"><div><div><h3 class="title"><a name="manual.ext.profile_mode.implementation.concurrency"></a>Concurrency</h3></div></div></div><p>
  35   Our current model is simplistic, but precise.
  36   We cannot afford to approximate because some of our diagnostics require
  37   precise matching of operations to container instance and call context.
  38   During profiling, we keep a single information table per diagnostic.
  39   There is a single lock per information table.
  40   </p></div><div class="section" title="Using the Standard Library in the Instrumentation Implementation"><div class="titlepage"><div><div><h3 class="title"><a name="manual.ext.profile_mode.implementation.stdlib-in-proflib"></a>Using the Standard Library in the Instrumentation Implementation</h3></div></div></div><p>
  41   As much as we would like to avoid uses of libstdc++ within our
  42   instrumentation library, containers such as unordered_map are very
  43   appealing.  We plan to use them as long as they are named properly
  44   to avoid ambiguity.
  45   </p></div><div class="section" title="Malloc Hooks"><div class="titlepage"><div><div><h3 class="title"><a name="manual.ext.profile_mode.implementation.malloc-hooks"></a>Malloc Hooks</h3></div></div></div><p>
  46   User applications/libraries can provide malloc hooks.
  47   When the implementation of the malloc hooks uses stdlibc++, there can
  48   be an infinite cycle between the profile mode instrumentation and the
  49   malloc hook code.
  50   </p><p>
  51   We protect against reentrance to the profile mode instrumentation code,
  52   which should avoid this problem in most cases.
  53   The protection mechanism is thread safe and exception safe.
  54   This mechanism does not prevent reentrance to the malloc hook itself,
  55   which could still result in deadlock, if, for instance, the malloc hook
  56   uses non-recursive locks.
  57   XXX: A definitive solution to this problem would be for the profile extension
  58   to use a custom allocator internally, and perhaps not to use libstdc++.
  59   </p></div><div class="section" title="Construction and Destruction of Global Objects"><div class="titlepage"><div><div><h3 class="title"><a name="manual.ext.profile_mode.implementation.construction-destruction"></a>Construction and Destruction of Global Objects</h3></div></div></div><p>
  60   The profiling library state is initialized at the first call to a profiling
  61   method.  This allows us to record the construction of all global objects.
  62   However, we cannot do the same at destruction time.  The trace is written
  63   by a function registered by <code class="code">atexit</code>, thus invoked by
  64   <code class="code">exit</code>.
  65   </p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="bk01pt03ch19s04.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="profile_mode.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="bk01pt03ch19s06.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Empirical Cost Model </td><td width="20%" align="center"><a accesskey="h" href="../index.html">Home</a></td><td width="40%" align="right" valign="top"> Developer Information</td></tr></table></div></body></html>