Date: Wed, 15 Nov 2017 00:06:18 +0000 (UTC) From: Warner Losh <imp@FreeBSD.org> To: src-committers@freebsd.org, svn-src-all@freebsd.org, svn-src-head@freebsd.org Subject: svn commit: r325836 - head/share/man/man7 Message-ID: <201711150006.vAF06INu030389@repo.freebsd.org>
next in thread | raw e-mail | index | archive | help
Author: imp Date: Wed Nov 15 00:06:18 2017 New Revision: 325836 URL: https://svnweb.freebsd.org/changeset/base/325836 Log: Add note about where to use MACHINE (just src/stand and src/sys and a few others). Add note aboute MACHINE_CPUARCH. Sponsored by: Netflix Modified: head/share/man/man7/arch.7 Modified: head/share/man/man7/arch.7 ============================================================================== --- head/share/man/man7/arch.7 Tue Nov 14 23:50:30 2017 (r325835) +++ head/share/man/man7/arch.7 Wed Nov 15 00:06:18 2017 (r325836) @@ -378,6 +378,10 @@ Both of these hardware platforms supported only the of i386 where they shared a common ABI, except for certain kernel / userland interfaces relating to underlying hardware platform differences in bus architecture, device enumeration and boot interface. +Generally, +.Dv MACHINE +should only be used in src/sys and src/stand or in system imagers or +installers. .It Dv MACHINE_ARCH Represents the CPU processor architecture. This is the same as the native platforms .Xr uname 1 @@ -408,6 +412,15 @@ It is unfortunate that amd64 speifies the 64-bit evolu platform (it matches the 'first rule') as everybody else uses x86_64. There is no standard name for the processor: each OS selects its own conventions. +.It Dv MACHINE_CPUARCH Represents the source location for a given +.Dv MACHINE_ARCH . +For example, +.Dv MACHINE_CPUARCH +is defined to be mips for all the flavors of mips that we support +since we support them all with a shared set of sources. +One might thing that it should be x86 for both amd64 and i386. +However, since we don't support these two architectures with the same +source base, that's not done despite it's logical appeal. .It Dv CPUTYPE Sets the flavor of .Dv MACHINE_ARCH to build.
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201711150006.vAF06INu030389>