This is the mail archive of the
gcc-patches@gcc.gnu.org
mailing list for the GCC project.
[cfg_branch] Document -funsafe-profile-arcs option
- From: Roger Sayle <roger at eyesopen dot com>
- To: <gcc-patches at gcc dot gnu dot org>
- Date: Sat, 19 Oct 2002 16:19:17 -0600 (MDT)
- Subject: [cfg_branch] Document -funsafe-profile-arcs option
This patch documents the -funsafe-profile-arcs command line option
on the cfg_branch. Whilst I was there I also fixed several overfull
hbox warnings in invoke.texi.
Tested by "make dvi" with no new overfull hboxes on i686-pc-linux-gnu.
Ok for the cfg_branch?
2002-10-19 Roger Sayle <roger@eyesopen.com>
* doc/invoke.texi: Document the -funsafe-profile-arcs option.
Fix up some overfull hboxes in "make dvi".
Index: doc/invoke.texi
===================================================================
RCS file: /cvs/gcc/gcc/gcc/doc/invoke.texi,v
retrieving revision 1.75.2.25
diff -c -3 -p -r1.75.2.25 invoke.texi
*** doc/invoke.texi 22 Jun 2002 13:10:27 -0000 1.75.2.25
--- doc/invoke.texi 19 Oct 2002 20:24:44 -0000
*************** in the following sections.
*** 247,254 ****
-fdump-class-hierarchy@r{[}-@var{n}@r{]} @gol
-fdump-tree-original@r{[}-@var{n}@r{]} -fdump-tree-optimized@r{[}-@var{n}@r{]} @gol
-fdump-tree-inlined@r{[}-@var{n}@r{]} @gol
! -fmem-report @gol
! -fprofile-arcs -ftest-coverage -ftime-report @gol
-g -g@var{level} -gcoff -gdwarf -gdwarf-1 -gdwarf-1+ -gdwarf-2 @gol
-ggdb -gstabs -gstabs+ -gvms -gxcoff -gxcoff+ @gol
-p -pg -print-file-name=@var{library} -print-libgcc-file-name @gol
--- 247,254 ----
-fdump-class-hierarchy@r{[}-@var{n}@r{]} @gol
-fdump-tree-original@r{[}-@var{n}@r{]} -fdump-tree-optimized@r{[}-@var{n}@r{]} @gol
-fdump-tree-inlined@r{[}-@var{n}@r{]} @gol
! -fmem-report -fprofile-arcs -funsafe-profile-arcs @gol
! -ftest-coverage -ftime-report @gol
-g -g@var{level} -gcoff -gdwarf -gdwarf-1 -gdwarf-1+ -gdwarf-2 @gol
-ggdb -gstabs -gstabs+ -gvms -gxcoff -gxcoff+ @gol
-p -pg -print-file-name=@var{library} -print-libgcc-file-name @gol
*************** in the following sections.
*** 447,453 ****
-mno-relocatable -mrelocatable-lib -mno-relocatable-lib @gol
-mtoc -mno-toc -mlittle -mlittle-endian -mbig -mbig-endian @gol
-mcall-aix -mcall-sysv -mcall-netbsd @gol
! -maix-struct-return -msvr4-struct-return
-mabi=altivec -mabi=no-altivec @gol
-mprototype -mno-prototype @gol
-msim -mmvme -mads -myellowknife -memb -msdata @gol
--- 447,453 ----
-mno-relocatable -mrelocatable-lib -mno-relocatable-lib @gol
-mtoc -mno-toc -mlittle -mlittle-endian -mbig -mbig-endian @gol
-mcall-aix -mcall-sysv -mcall-netbsd @gol
! -maix-struct-return -msvr4-struct-return @gol
-mabi=altivec -mabi=no-altivec @gol
-mprototype -mno-prototype @gol
-msim -mmvme -mads -myellowknife -memb -msdata @gol
*************** in the following sections.
*** 612,618 ****
@emph{D30V Options}
@gccoptlist{
! -mextmem -mextmemory -monchip -mno-asm-optimize -masm-optimize @gol
-mbranch-cost=@var{n} -mcond-exec=@var{n}}
@emph{S/390 and zSeries Options}
--- 612,619 ----
@emph{D30V Options}
@gccoptlist{
! -mextmem -mextmemory -monchip @gol
! -mno-asm-optimize -masm-optimize @gol
-mbranch-cost=@var{n} -mcond-exec=@var{n}}
@emph{S/390 and zSeries Options}
*************** in the following sections.
*** 677,683 ****
-fverbose-asm -fpack-struct -fstack-check @gol
-fstack-limit-register=@var{reg} -fstack-limit-symbol=@var{sym} @gol
-fargument-alias -fargument-noalias @gol
! -fargument-noalias-global -fleading-underscore -ftls-model=@var{model}}
@end table
@menu
--- 678,685 ----
-fverbose-asm -fpack-struct -fstack-check @gol
-fstack-limit-register=@var{reg} -fstack-limit-symbol=@var{sym} @gol
-fargument-alias -fargument-noalias @gol
! -fargument-noalias-global -fleading-underscore @gol
! -ftls-model=@var{model}}
@end table
@menu
*************** This option makes it possible to estimat
*** 2850,2855 ****
--- 2852,2864 ----
calculate basic block execution counts. In general, basic block
execution counts as provided by @option{-a} do not give enough
information to estimate all branch probabilities.
+
+ @item -funsafe-profile-arcs
+ @opindex funsafe-profile-arcs
+ When instrumenting the code with @option{-fprofile-arcs}, assume that
+ the application is run single-threaded. This avoids the thread safety
+ overhead required to update profile information in multi-threaded
+ applications.
@need 2000
@item -ftest-coverage
Roger
--
Roger Sayle, E-mail: roger@eyesopen.com
OpenEye Scientific Software, WWW: http://www.eyesopen.com/
Suite 1107, 3600 Cerrillos Road, Tel: (+1) 505-473-7385
Santa Fe, New Mexico, 87507. Fax: (+1) 505-473-0833