The profile mode headers are included with
-D_GLIBCXX_PROFILE through preprocessor directives in
include/std/*.
Instrumented implementations are provided in
include/profile/*. All instrumentation hooks are macros
defined in include/profile/profiler.h.
All the implementation of the instrumentation hooks is in
include/profile/impl/*. Although all the code gets included,
thus is publicly visible, only a small number of functions are called from
outside this directory. All calls to hook implementations must be
done through macros defined in profiler.h. The macro
must ensure (1) that the call is guarded against reentrance and
(2) that the call can be turned off at compile time using a
-D_GLIBCXX_PROFILE_... compiler option.
Let's say the diagnostic name is "magic".
If you need to instrument a header not already under
include/profile/*, first edit the corresponding header
under include/std/ and add a preprocessor directive such
as the one in include/std/vector:
#ifdef _GLIBCXX_PROFILE # include <profile/vector> #endif
If the file you need to instrument is not yet under
include/profile/, make a copy of the one in
include/debug, or the main implementation.
You'll need to include the main implementation and inherit the classes
you want to instrument. Then define the methods you want to instrument,
define the instrumentation hooks and add calls to them.
Look at include/profile/vector for an example.
Add macros for the instrumentation hooks in
include/profile/impl/profiler.h.
Hook names must start with __profcxx_.
Make sure they transform
in no code with -D_NO_GLBICXX_PROFILE_MAGIC.
Make sure all calls to any method in namespace __gnu_profile
is protected against reentrance using macro
_GLIBCXX_PROFILE_REENTRANCE_GUARD.
All names of methods in namespace __gnu_profile called from
profiler.h must start with __trace_magic_.
Add the implementation of the diagnostic.
Create new file include/profile/impl/profiler_magic.h.
Define class __magic_info: public __object_info_base.
This is the representation of a line in the object table.
The __merge method is used to aggregate information
across all dynamic instances created at the same call context.
The __magnitude must return the estimation of the benefit
as a number of small operations, e.g., number of words copied.
The __write method is used to produce the raw trace.
The __advice method is used to produce the advice string.
Define class __magic_stack_info: public __magic_info.
This defines the content of a line in the stack table.
Define class __trace_magic: public __trace_base<__magic_info,
__magic_stack_info>.
It defines the content of the trace associated with this diagnostic.
Add initialization and reporting calls in
include/profile/impl/profiler_trace.h. Use
__trace_vector_to_list as an example.
Add documentation in file doc/xml/manual/profile_mode.xml.
The profile mode headers are included with
d37 1
a37 1
in no code with -D_NO_GLIBCXX_PROFILE_MAGIC.
@
1.1.1.1.28.1
log
@Sync with HEAD, resolve a couple of conflicts
@
text
@d2 1
a2 1
The profile mode headers are included with
@
1.1.1.1.28.2
log
@Sync with HEAD
@
text
@d37 1
a37 1
in no code with -D_NO_GLIBCXX_PROFILE_MAGIC.
@
1.1.1.2
log
@import GCC 6.5.0. this is largely a maint release with no
particularly features listed here:
http://gcc.gnu.org/gcc-6/changes.html
this fixes over 250 PRs in the GCC bugzilla:
https://gcc.gnu.org/bugzilla/buglist.cgi?bug_status=RESOLVED&resolution=FIXED&target_milestone=6.5
@
text
@d2 1
a2 1
The profile mode headers are included with
@
1.1.1.3
log
@import GCC 7.4.0. main changes include:
The non-standard C++0x type traits has_trivial_default_constructor,
has_trivial_copy_constructor and has_trivial_copy_assign have been
removed.
On ARM targets (arm*-*-*), a bug introduced in GCC 5 that affects
conformance to the procedure call standard (AAPCS) has been fixed.
Many optimiser improvements
DWARF-5 support.
Many new and enhanced warnings.
Warnings about format strings now underline the pertinent part of
the string, and can offer suggested fixes.
Several new warnings related to buffer overflows and buffer
truncation.
New __builtin_add_overflow_p, __builtin_sub_overflow_p,
__builtin_mul_overflow_p built-ins added that test for overflow.
The C++ front end has experimental support for all of the current
C++17 draft.
The -fverbose-asm option has been expanded to prints comments
showing the source lines that correspond to the assembly.
The gcc and g++ driver programs will now provide suggestions for
misspelled arguments to command-line options.
AArch64 specific:
GCC has been updated to the latest revision of the procedure call
standard (AAPCS64) to provide support for parameter passing when
data types have been over-aligned.
The ARMv8.2-A and ARMv8.3-A architecture are now supported.
ARM specific:
Support for the ARMv5 and ARMv5E architectures has been
deprecated (which have no known implementations).
A new command-line option -mpure-code has been added. It does not
allow constant data to be placed in code sections.
x86 specific:
Support for the AVX-512 4FMAPS, 4VNNIW, VPOPCNTDQ and Software
Guard Extensions (SGX) ISA extensions has been added.
PPC specific:
GCC now diagnoses inline assembly that clobbers register r2.
RISC-V specific:
Support for the RISC-V instruction set has been added.
SH specific:
Support for SH5/SH64 has been removed.
Support for SH2A has been enhanced.
@
text
@d37 1
a37 1
in no code with -D_NO_GLIBCXX_PROFILE_MAGIC.
@
1.1.1.1.8.1
log
@file profile_mode_devel.html was added on branch tls-maxphys on 2014-08-19 23:54:46 +0000
@
text
@d1 67
@
1.1.1.1.8.2
log
@Rebase to HEAD as of a few days ago.
@
text
@a0 67
The profile mode headers are included with
-D_GLIBCXX_PROFILE through preprocessor directives in
include/std/*.
Instrumented implementations are provided in
include/profile/*. All instrumentation hooks are macros
defined in include/profile/profiler.h.
All the implementation of the instrumentation hooks is in
include/profile/impl/*. Although all the code gets included,
thus is publicly visible, only a small number of functions are called from
outside this directory. All calls to hook implementations must be
done through macros defined in profiler.h. The macro
must ensure (1) that the call is guarded against reentrance and
(2) that the call can be turned off at compile time using a
-D_GLIBCXX_PROFILE_... compiler option.
Let's say the diagnostic name is "magic".
If you need to instrument a header not already under
include/profile/*, first edit the corresponding header
under include/std/ and add a preprocessor directive such
as the one in include/std/vector:
#ifdef _GLIBCXX_PROFILE # include <profile/vector> #endif
If the file you need to instrument is not yet under
include/profile/, make a copy of the one in
include/debug, or the main implementation.
You'll need to include the main implementation and inherit the classes
you want to instrument. Then define the methods you want to instrument,
define the instrumentation hooks and add calls to them.
Look at include/profile/vector for an example.
Add macros for the instrumentation hooks in
include/profile/impl/profiler.h.
Hook names must start with __profcxx_.
Make sure they transform
in no code with -D_NO_GLBICXX_PROFILE_MAGIC.
Make sure all calls to any method in namespace __gnu_profile
is protected against reentrance using macro
_GLIBCXX_PROFILE_REENTRANCE_GUARD.
All names of methods in namespace __gnu_profile called from
profiler.h must start with __trace_magic_.
Add the implementation of the diagnostic.
Create new file include/profile/impl/profiler_magic.h.
Define class __magic_info: public __object_info_base.
This is the representation of a line in the object table.
The __merge method is used to aggregate information
across all dynamic instances created at the same call context.
The __magnitude must return the estimation of the benefit
as a number of small operations, e.g., number of words copied.
The __write method is used to produce the raw trace.
The __advice method is used to produce the advice string.
Define class __magic_stack_info: public __magic_info.
This defines the content of a line in the stack table.
Define class __trace_magic: public __trace_base<__magic_info,
__magic_stack_info>.
It defines the content of the trace associated with this diagnostic.
Add initialization and reporting calls in
include/profile/impl/profiler_trace.h. Use
__trace_vector_to_list as an example.
Add documentation in file doc/xml/manual/profile_mode.xml.
The profile mode headers are included with
-D_GLIBCXX_PROFILE through preprocessor directives in
include/std/*.
Instrumented implementations are provided in
include/profile/*. All instrumentation hooks are macros
defined in include/profile/profiler.h.
All the implementation of the instrumentation hooks is in
include/profile/impl/*. Although all the code gets included,
thus is publicly visible, only a small number of functions are called from
outside this directory. All calls to hook implementations must be
done through macros defined in profiler.h. The macro
must ensure (1) that the call is guarded against reentrance and
(2) that the call can be turned off at compile time using a
-D_GLIBCXX_PROFILE_... compiler option.
Let's say the diagnostic name is "magic".
If you need to instrument a header not already under
include/profile/*, first edit the corresponding header
under include/std/ and add a preprocessor directive such
as the one in include/std/vector:
#ifdef _GLIBCXX_PROFILE # include <profile/vector> #endif
If the file you need to instrument is not yet under
include/profile/, make a copy of the one in
include/debug, or the main implementation.
You'll need to include the main implementation and inherit the classes
you want to instrument. Then define the methods you want to instrument,
define the instrumentation hooks and add calls to them.
Look at include/profile/vector for an example.
Add macros for the instrumentation hooks in
include/profile/impl/profiler.h.
Hook names must start with __profcxx_.
Make sure they transform
in no code with -D_NO_GLBICXX_PROFILE_MAGIC.
Make sure all calls to any method in namespace __gnu_profile
is protected against reentrance using macro
_GLIBCXX_PROFILE_REENTRANCE_GUARD.
All names of methods in namespace __gnu_profile called from
profiler.h must start with __trace_magic_.
Add the implementation of the diagnostic.
Create new file include/profile/impl/profiler_magic.h.
Define class __magic_info: public __object_info_base.
This is the representation of a line in the object table.
The __merge method is used to aggregate information
across all dynamic instances created at the same call context.
The __magnitude must return the estimation of the benefit
as a number of small operations, e.g., number of words copied.
The __write method is used to produce the raw trace.
The __advice method is used to produce the advice string.
Define class __magic_stack_info: public __magic_info.
This defines the content of a line in the stack table.
Define class __trace_magic: public __trace_base<__magic_info,
__magic_stack_info>.
It defines the content of the trace associated with this diagnostic.
Add initialization and reporting calls in
include/profile/impl/profiler_trace.h. Use
__trace_vector_to_list as an example.
Add documentation in file doc/xml/manual/profile_mode.xml.