From: Olga Golovanevsky <OLGA@il.ibm.com>
To: Gerald Pfeifer <gerald@pfeifer.com>
Cc: Diego Novillo <dnovillo@google.com>, Jan Hubicka <hubicka@ucw.cz>,
Jan Hubicka <jh@suse.cz>,
Kenneth Zadeck <zadeck@naturalbridge.com>,
Daniel Berlin <dberlin@dberlin.org>,
gcc-patches@gcc.gnu.org
Subject: [patch, doc] documenting new options
Date: Thu, 06 Dec 2007 14:16:00 -0000 [thread overview]
Message-ID: <OF4F40B7D2.A68842A5-ONC22573A9.002E0BB8-C22573A9.004E34AA@il.ibm.com> (raw)
This patch documents recently committed struct-reorg optimization,
i.e. -fipa-struct-reorg option and struct-reorg-cold-struct-ratio
parameter.
Any comments? Ok for mainline?
Olga
ChangeLog
2007-12-06 Olga Golovanevsky <olga@il.ibm.com>
* doc/invoke.texi (Optimize Options): Document new -fipa-struct-reorg
option and struct-reorg-cold-struct-ratio parameter.
Index: invoke.texi
===================================================================
--- invoke.texi (revision 130578)
+++ invoke.texi (working copy)
@@ -329,13 +329,13 @@ Objective-C and Objective-C++ Dialects}.
-fgcse-sm -fif-conversion -fif-conversion2 -finline-functions @gol
-finline-functions-called-once -finline-limit=@var{n} @gol
-finline-small-functions -fipa-pta -fipa-pure-const -fipa-reference @gol
--fipa-type-escape -fivopts -fkeep-inline-functions -fkeep-static-consts
@gol
--fmerge-all-constants -fmerge-constants -fmodulo-sched @gol
--fmodulo-sched-allow-regmoves -fmove-loop-invariants -fmudflap @gol
--fmudflapir -fmudflapth -fno-branch-count-reg -fno-default-inline @gol
--fno-defer-pop -fno-function-cse -fno-guess-branch-probability @gol
--fno-inline -fno-math-errno -fno-peephole -fno-peephole2 @gol
--fno-sched-interblock -fno-sched-spec -fno-signed-zeros @gol
+-fipa-struct-reorg -fipa-type-escape -fivopts -fkeep-inline-functions @gol
+-fkeep-static-consts -fmerge-all-constants -fmerge-constants @gol
+-fmodulo-sched -fmodulo-sched-allow-regmoves -fmove-loop-invariants @gol
+-fmudflap -fmudflapir -fmudflapth -fno-branch-count-reg @gol
+-fno-default-inline -fno-defer-pop -fno-function-cse @gol
+-fno-guess-branch-probability -fno-inline -fno-math-errno -fno-peephole
@gol
+-fno-peephole2 -fno-sched-interblock -fno-sched-spec -fno-signed-zeros
@gol
-fno-toplevel-reorder -fno-trapping-math -fno-zero-initialized-in-bss @gol
-fomit-frame-pointer -foptimize-register-move -foptimize-sibling-calls
@gol
-fpeel-loops -fpredictive-commoning -fprefetch-loop-arrays @gol
@@ -5711,6 +5711,20 @@ Discover which static variables do not e
compilation unit.
Enabled by default at @option{-O} and higher.
+@item -fipa-struct-reorg
+@opindex fipa-struct-reorg
+Perform structure reorganization optimization, that change C-like
structures
+layout in order to better utilize spatial locality. Effective for programs
+containing arrays of structures. Available in two compilation modes:
+profile-based, as with @option{-fprofile-generate} and @option
{-fprofile-use},
+or static. Require @option{-fipa-type-escape} to provide the safety of
+transformations. Work as whole program optimization, i.e. require
+@option{-fwhole-program} and @option{-combine} flags. Cold structures
+can remain intact through
+@option{--param struct-reorg-cold-struct-ratio=@var{value}} option.
+
+With this flag, the program debug info reflects a new structure layout.
+
@item -fipa-pta
@opindex fipa-pta
Perform interprocedural pointer analysis.
@@ -6624,6 +6638,13 @@ of bytes in instantiated fields to the n
structure exceeds this parameter, then block copies are not used. The.
default is 75.
+@item struct-reorg-cold-struct-ratio
+The threshold ratio between current and hotest structure counts
+used by @option{-fipa-struct-reorg}. We say that if the ratio of
+the current structure count, calculated by profiling, to the hotest
+structure count in the program is less than this parameter, then
+structure reorganization is not applied. The default is 10.
+
@item max-crossjump-edges
The maximum number of incoming edges to consider for crossjumping.
The algorithm used by @option{-fcrossjumping} is @math{O(N^2)} in.
next reply other threads:[~2007-12-06 14:16 UTC|newest]
Thread overview: 4+ messages / expand[flat|nested] mbox.gz Atom feed top
2007-12-06 14:16 Olga Golovanevsky [this message]
2007-12-06 15:41 ` Diego Novillo
2007-12-09 13:15 ` Olga Golovanevsky
2007-12-09 13:28 ` Diego Novillo
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=OF4F40B7D2.A68842A5-ONC22573A9.002E0BB8-C22573A9.004E34AA@il.ibm.com \
--to=olga@il.ibm.com \
--cc=dberlin@dberlin.org \
--cc=dnovillo@google.com \
--cc=gcc-patches@gcc.gnu.org \
--cc=gerald@pfeifer.com \
--cc=hubicka@ucw.cz \
--cc=jh@suse.cz \
--cc=zadeck@naturalbridge.com \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).