d/freebsd-skq
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Add note about where to use MACHINE (just src/stand and src/sys and a

Browse Source 
few others). Add note aboute MACHINE_CPUARCH.

Sponsored by: Netflix
This commit is contained in:
imp 2017-11-15 00:06:18 +00:00
parent 135ee48fc0
commit ce9655b3cf
1 changed files with 13 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

13
share/man/man7/arch.7
View File

@ -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 evolution of the x86
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.