From owner-svn-src-head@freebsd.org Wed Nov 15 00:06:19 2017 Return-Path: Delivered-To: svn-src-head@mailman.ysv.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by mailman.ysv.freebsd.org (Postfix) with ESMTP id 532E6DB9DEC; Wed, 15 Nov 2017 00:06:19 +0000 (UTC) (envelope-from imp@FreeBSD.org) Received: from repo.freebsd.org (repo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:0]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client did not present a certificate) by mx1.freebsd.org (Postfix) with ESMTPS id 20A3675EC7; Wed, 15 Nov 2017 00:06:19 +0000 (UTC) (envelope-from imp@FreeBSD.org) Received: from repo.freebsd.org ([127.0.1.37]) by repo.freebsd.org (8.15.2/8.15.2) with ESMTP id vAF06ISU030390; Wed, 15 Nov 2017 00:06:18 GMT (envelope-from imp@FreeBSD.org) Received: (from imp@localhost) by repo.freebsd.org (8.15.2/8.15.2/Submit) id vAF06INu030389; Wed, 15 Nov 2017 00:06:18 GMT (envelope-from imp@FreeBSD.org) Message-Id: <201711150006.vAF06INu030389@repo.freebsd.org> X-Authentication-Warning: repo.freebsd.org: imp set sender to imp@FreeBSD.org using -f From: Warner Losh Date: Wed, 15 Nov 2017 00:06:18 +0000 (UTC) To: src-committers@freebsd.org, svn-src-all@freebsd.org, svn-src-head@freebsd.org Subject: svn commit: r325836 - head/share/man/man7 X-SVN-Group: head X-SVN-Commit-Author: imp X-SVN-Commit-Paths: head/share/man/man7 X-SVN-Commit-Revision: 325836 X-SVN-Commit-Repository: base MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-src-head@freebsd.org X-Mailman-Version: 2.1.25 Precedence: list List-Id: SVN commit messages for the src tree for head/-current List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 15 Nov 2017 00:06:19 -0000 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.