From 662076c9faa2a712196faa766482c79632091828 Mon Sep 17 00:00:00 2001 From: Sandra Loosemore Date: Sun, 18 Nov 2018 20:04:04 -0500 Subject: [PATCH] re PR other/40498 (no_instrument_function attribute not documented to prevent -pg instrumentation) 2018-11-18 Sandra Loosemore 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 --- gcc/ChangeLog | 8 ++++++++ gcc/doc/extend.texi | 5 ++++- gcc/doc/invoke.texi | 17 +++++++++-------- 3 files changed, 21 insertions(+), 9 deletions(-) diff --git a/gcc/ChangeLog b/gcc/ChangeLog index 62dd38eef7b..dd7984c7418 100644 --- a/gcc/ChangeLog +++ b/gcc/ChangeLog @@ -1,3 +1,11 @@ +2018-11-18 Sandra Loosemore + + 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 * config/gnu-user.h (GNU_USER_TARGET_CRTI): Define. diff --git a/gcc/doc/extend.texi b/gcc/doc/extend.texi index 2d00d67fcd7..d230da977d4 100644 --- a/gcc/doc/extend.texi +++ b/gcc/doc/extend.texi @@ -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. diff --git a/gcc/doc/invoke.texi b/gcc/doc/invoke.texi index 417a9bcc3e6..f4fc182a24e 100644 --- a/gcc/doc/invoke.texi +++ b/gcc/doc/invoke.texi @@ -11980,21 +11980,21 @@ program analysis purposes. @table @gcctabopt @cindex @command{prof} +@cindex @command{gprof} @item -p +@itemx -pg @opindex p -Generate extra code to write profile information suitable for the -analysis program @command{prof}. 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 +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. +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 Add code so that program flow @dfn{arcs} are instrumented. During @@ -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 -- 2.30.2