re PR other/40498 (no_instrument_function attribute not documented to prevent -pg instrumentation)

2018-11-18  Sandra Loosemore  <sandra@codesourcery.com>

	PR other/40498

	gcc/
	* doc/extend.texi (Common Function Attributes): Document that
	no_instrument_function applies to -p and -pg, too.
	* doc/invoke.texi (Instrumentation Options): Add cross-references
	to docs for -p, -pg, and -finstrument-functions.

From-SVN: r266260
This commit is contained in:
Sandra Loosemore 2018-11-18 20:04:04 -05:00 committed by Sandra Loosemore
parent 45f27e5c6c
commit 662076c9fa
3 changed files with 21 additions and 9 deletions

View file

@ -1,3 +1,11 @@
2018-11-18 Sandra Loosemore <sandra@codesourcery.com>
PR other/40498
* doc/extend.texi (Common Function Attributes): Document that
no_instrument_function applies to -p and -pg, too.
* doc/invoke.texi (Instrumentation Options): Add cross-references
to docs for -p, -pg, and -finstrument-functions.
2018-11-18 Alan Modra <amodra@gmail.com>
* config/gnu-user.h (GNU_USER_TARGET_CRTI): Define.

View file

@ -3015,7 +3015,10 @@ semantically equivalent function.
@item no_instrument_function
@cindex @code{no_instrument_function} function attribute
@opindex finstrument-functions
If @option{-finstrument-functions} is given, profiling function calls are
@opindex p
@opindex pg
If any of @option{-finstrument-functions}, @option{-p}, or @option{-pg} are
given, profiling function calls are
generated at entry and exit of most user-compiled functions.
Functions with this attribute are not so instrumented.

View file

@ -11980,20 +11980,20 @@ program analysis purposes.
@table @gcctabopt
@cindex @command{prof}
@cindex @command{gprof}
@item -p
@itemx -pg
@opindex p
@opindex pg
Generate extra code to write profile information suitable for the
analysis program @command{prof}. You must use this option when compiling
analysis program @command{prof} (for @option{-p}) or @command{gprof}
(for @option{-pg}). You must use this option when compiling
the source files you want data about, and you must also use it when
linking.
@cindex @command{gprof}
@item -pg
@opindex pg
Generate extra code to write profile information suitable for the
analysis program @command{gprof}. You must use this option when compiling
the source files you want data about, and you must also use it when
linking.
You can use the function attribute @code{no_instrument_function} to
suppress profiling of individual functions when compiling with these options.
@xref{Common Function Attributes}.
@item -fprofile-arcs
@opindex fprofile-arcs
@ -12742,6 +12742,7 @@ example, for the profiling functions listed above, high-priority
interrupt routines, and any functions from which the profiling functions
cannot safely be called (perhaps signal handlers, if the profiling
routines generate output or allocate memory).
@xref{Common Function Attributes}.
@item -finstrument-functions-exclude-file-list=@var{file},@var{file},@dots{}
@opindex finstrument-functions-exclude-file-list