diff options
| author | Jonathan Wakely <jwakely.gcc@gmail.com> | 2012-01-06 01:26:06 +0000 |
|---|---|---|
| committer | Jonathan Wakely <redi@gcc.gnu.org> | 2012-01-06 01:26:06 +0000 |
| commit | 6e576613f7fd30864546c1da4a9ed4f580a289ae (patch) | |
| tree | 680ea72aee0ab27bd74bd4012057eae063fde26d | |
| parent | ea0463d9d481d4274180c69b516f9ada549fb928 (diff) | |
| download | gcc-6e576613f7fd30864546c1da4a9ed4f580a289ae.zip gcc-6e576613f7fd30864546c1da4a9ed4f580a289ae.tar.gz gcc-6e576613f7fd30864546c1da4a9ed4f580a289ae.tar.bz2 | |
re PR libstdc++/51504 (Data race hunting instructions in manual do not work)
PR libstdc++/51504
* doc/xml/manual/debug.xml: Suggest using symbol interposition
to override symbols using annotation macros.
From-SVN: r182943
| -rw-r--r-- | libstdc++-v3/ChangeLog | 6 | ||||
| -rw-r--r-- | libstdc++-v3/doc/xml/manual/debug.xml | 24 |
2 files changed, 23 insertions, 7 deletions
diff --git a/libstdc++-v3/ChangeLog b/libstdc++-v3/ChangeLog index 56350fe..e0b3bc8 100644 --- a/libstdc++-v3/ChangeLog +++ b/libstdc++-v3/ChangeLog @@ -1,3 +1,9 @@ +2012-01-06 Jonathan Wakely <jwakely.gcc@gmail.com> + + PR libstdc++/51504 + * doc/xml/manual/debug.xml: Suggest using symbol interposition + to override symbols using annotation macros. + 2012-01-05 François Dumont <fdumont@gcc.gnu.org> * include/bits/hashtable_policy.h (_Hashtable_base<>::_M_eq()): diff --git a/libstdc++-v3/doc/xml/manual/debug.xml b/libstdc++-v3/doc/xml/manual/debug.xml index 05994ec..7ee2abf 100644 --- a/libstdc++-v3/doc/xml/manual/debug.xml +++ b/libstdc++-v3/doc/xml/manual/debug.xml @@ -207,14 +207,24 @@ redefining them will only affect inline functions and template instantiations which are compiled in user code. This allows annotation of templates such as <code>shared_ptr</code>, but not code which is - only instantiated in the library. - In order to annotate <code>basic_string</code> reference counting it - is necessary to disable extern templates (by defining - <code>_GLIBCXX_EXTERN_TEMPLATE=-1</code>) or to rebuild the - <code>.so</code> file. + only instantiated in the library. Code which is only instantiated in + the library needs to be recompiled with the annotation macros defined. + That can be done by rebuilding the entire + <filename class="libraryfile">libstdc++.so</filename> file but a simpler + alternative exists for ELF platforms such as GNU/Linux, because ELF + symbol interposition allows symbols defined in the shared library to be + overridden by symbols with the same name that appear earlier in the + runtime search path. This means you only need to recompile the functions + that are affected by the annotation macros, which can be done by + recompiling individual files. + Annotating <code>std::string</code> and <code>std::wstring</code> + reference counting can be done by disabling extern templates (by defining + <code>_GLIBCXX_EXTERN_TEMPLATE=-1</code>) or by rebuilding the + <filename>src/string-inst.cc</filename> file. Annotating the remaining atomic operations (at the time of writing these - are in <code>ios_base::Init::~Init</code>, <code>locale::_Impl</code> and - <code>locale::facet</code>) requires rebuilding the <code>.so</code> file. + are in <code>ios_base::Init::~Init</code>, <code>locale::_Impl</code>, + <code>locale::facet</code> and <code>thread::_M_start_thread</code>) + requires rebuilding the relevant source files. </para> <para> |