Document PowerPC 'native' cpu type

Message ID CAGWvnymU0aBniBriOWanQr1PPGV1soeaiv0Xg51uxnLqcomrrQ@mail.gmail.com
State New
Headers show
Series
  • Document PowerPC 'native' cpu type
Related show

Commit Message

David Edelsohn Jan. 25, 2018, 6:24 p.m.
The PowerPC port(s) of GCC have included auto-detection of host cpu
type through the "native" option, but it had not been documented.
This patch adds the documentation to the GCC Manual.

* doc/invoke.texi (PowerPC Options): Document 'native' cpu type.

Thanks, David

Comments

Segher Boessenkool Jan. 25, 2018, 6:44 p.m. | #1
Hi!

On Thu, Jan 25, 2018 at 01:24:56PM -0500, David Edelsohn wrote:
> +Specifying @samp{native} as cpu type detects and selects the

> +architecture option that corresponds to the host processor of the

> +system performing the compilation.

> +@option{-march=native} has no effect if GCC does not recognize the

> +processor.


This should be -mcpu=native ?


Segher
David Edelsohn Jan. 25, 2018, 6:51 p.m. | #2
On Thu, Jan 25, 2018 at 1:44 PM, Segher Boessenkool
<segher@kernel.crashing.org> wrote:
> Hi!

>

> On Thu, Jan 25, 2018 at 01:24:56PM -0500, David Edelsohn wrote:

>> +Specifying @samp{native} as cpu type detects and selects the

>> +architecture option that corresponds to the host processor of the

>> +system performing the compilation.

>> +@option{-march=native} has no effect if GCC does not recognize the

>> +processor.

>

> This should be -mcpu=native ?


Yep.  Fixed.

Thanks, David

Patch

Index: invoke.texi
===================================================================
--- invoke.texi (revision 257055)
+++ invoke.texi (working copy)
@@ -22333,7 +22333,7 @@ 
 @samp{titan}, @samp{power3}, @samp{power4}, @samp{power5}, @samp{power5+},
 @samp{power6}, @samp{power6x}, @samp{power7}, @samp{power8},
 @samp{power9}, @samp{powerpc}, @samp{powerpc64}, @samp{powerpc64le},
-and @samp{rs64}.
+@samp{rs64}, and @samp{native}.

 @option{-mcpu=powerpc}, @option{-mcpu=powerpc64}, and
 @option{-mcpu=powerpc64le} specify pure 32-bit PowerPC (either
@@ -22341,6 +22341,12 @@ 
 architecture machine types, with an appropriate, generic processor
 model assumed for scheduling purposes.

+Specifying @samp{native} as cpu type detects and selects the
+architecture option that corresponds to the host processor of the
+system performing the compilation.
+@option{-march=native} has no effect if GCC does not recognize the
+processor.
+
 The other options specify a specific processor.  Code generated under
 those options runs best on that processor, and may not run at all on
 others.