public inbox for gentoo-dev@lists.gentoo.org
 help / color / mirror / Atom feed
* [gentoo-dev] [RFC] CFLAGS paragraph for the GWN, 3rd version
@ 2006-10-03 23:08 Lionel Bouton
  2006-10-04  6:18 ` [gentoo-dev] " Duncan
  0 siblings, 1 reply; 2+ messages in thread
From: Lionel Bouton @ 2006-10-03 23:08 UTC (permalink / raw
  To: gentoo-dev

Here's the third version of the draft, wiki-free and with less sugar
too. More warnings.

Thanks again for the input.

--- Draft BEGIN ---
<section>
<title>CFLAGS</title>
<body>

<p>
Being able to tune the CFLAGS is part of one of the core principles of
Gentoo: let the user be in control. Being in control brings both
benefits and problems. CFLAGS tuning is not an exception.
</p>

<warn>
We would like to remind you that using anything beyond -O2
-fomit-frame-pointer -march/-mcpu/-mtune in CFLAGS or CXXFLAGS (and
-mieee, -mabi etc. on selected archs that tell you to do this), and
using anything at all in LDFLAGS or ASFLAGS, is usually not worth it for
most users. There's usually very little benefit, high risks and much
time spent on frustating tuning that could be enjoyed doing far more
interesting things.
</warn>

<p>
The recent upgrade to gcc-4.1.1 for x86 and amd64 users changed the
CFLAGS landscape. Users that spent some time tuning their CFLAGS with
gcc-3.4.6 might find out that an upgrade to gcc-4.1.1 leaves them with
an unstable system.
</p>
<p>Example of this are :</p>
<ul>
<li>nss_ldap stopped working with <c>-ffast-math</c> (reported to break
many packages changing with the actual gcc version)</li>
<li><c>-fvisibility-inlines-hidden</c> still breaks some code</li>
<li>if you used gcc-4.0, <c>-ftree-loop-linear</c> now breaks in
gcc-4.1 (at least with mesa)</li>
<li>again for gcc-4.0 users, <c>-ftree-vectorize</c> is known to be
broken in gcc-4.1 (at least for x86 and ppc, amd64 users seem to be
safe)</li>
<li><c>-fforce-addr</c> and <c>-fweb</c> break regularly on x86 with
video libraries or graphic processing apps which use hand-optimised ASM</li>
</ul>

<p>There are known-to-be-broken flags for all GCC versions that you want
to check for too:</p>
<ul>
<li>-fvisibility=hidden</li>
<li>-frename-registers</li>
<li>-ftracer</li>
<li>-D_FILE_OFFSET_BITS=64</li>
<li>-msse -mmmx -m3dnow</li>
<li>-W</li>
<li>-mfpmath=sse,387</li>
<li>-malign-double</li>
</ul>

<p>
Users with unsupported CFLAGS might want to return to safe CFLAGS (see
warning above) if recent updates caused them stability problems. On the
other hand, more adventurous users might want to experiment with CFLAGS
that didn't work properly with gcc-3.4.6... As always, the user is in
control (and the gun pointed to their feet is in his/her hand).
</p>

<p>Final notes:</p>
<ul>
<li>The gcc man page contains warnings for some unsafe optimization
options. You should read it carefully when you experiment with CFLAGS or
upgrade GCC on a CFLAGS-customized Gentoo.</li>
<li>Some options that are unsafe in the system-wide CFLAGS might be
added automatically in some ebuilds if the developper deems them safe
(by redefining CFLAGS or using append-flags of the flag-o-matic eclass).
For example <c>-ffast-math</c> is added by the xmame/xmess ebuilds on
most architectures even if you don't put it in your CFLAGS.</li>
<li>You might get an idea of the stability issues of a specific
optimization option by running: <c>find /usr/portage -name '*.ebuild'|
xargs grep -- '-<your-risky-optimization-option>'</c>. It takes quite
some time, but might be enlightening: look for the 'filter-flags'.</li>
</ul>

</body>
</section>
--- Draft END ---

Lionel
-- 
gentoo-dev@gentoo.org mailing list


-- 
gentoo-dev@gentoo.org mailing list



^ permalink raw reply	[flat|nested] 2+ messages in thread

end of thread, other threads:[~2006-10-04  6:22 UTC | newest]

Thread overview: 2+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2006-10-03 23:08 [gentoo-dev] [RFC] CFLAGS paragraph for the GWN, 3rd version Lionel Bouton
2006-10-04  6:18 ` [gentoo-dev] " Duncan

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox