--- wikisrc/ports.mdwn	2015/04/18 14:39:41	1.7
+++ wikisrc/ports.mdwn	2020/10/20 13:42:03	1.25
@@ -1,5 +1,5 @@
 [[!meta title="Platforms supported by NetBSD"]]
-NetBSD calls a supported architecture a 'port'. Most ports run on generic hardware and emulators, although some commercial hardware also exists. The NetBSD Ports History page details the inclusion date for each port.
+NetBSD calls a supported architecture a 'port'. Most ports run on generic hardware and emulators, although some [commercial hardware](http://www.netbsd.org/gallery/hardware.html) also exists. The NetBSD Ports History page details the inclusion date for each port.
 
 Ports are classified into three 'tiers' based on the current importance of the architecture and the level of community activity. Summarizing, the tiers can be viewed to represent ports that NetBSD will support, ports that NetBSD does its best to support, and ports which may be desupported soon. The tier for each port may change over time and is decided by <core@NetBSD.org> based on input from users and developers.
 
@@ -19,15 +19,16 @@ The guidelines are as follows:
 Currently there are 8 ports with Tier I status. They are:
 
 [[!table data="""
-Port		|CPU		|Machines
-[[amd64]]	|x86_64		|64-bit x86-family machines with AMD and Intel CPUs
-[[evbarm]]	|arm		|ARM evaluation boards
-[[evbmips]]	|mips		|MIPS-based evaluation boards
-[[evbppc]]	|powerpc	|PowerPC-based evaluation boards
-[[hpcarm]]	|arm		|StrongARM based Windows CE PDA machines
-[[i386]]	|i386		|32-bit x86-family generic machines ("PC clones")
-[[sparc64]]	|sparc		|Sun UltraSPARC (64-bit)
-[[xen]]		|i386, x86_64	|Xen Virtual Machine Monitor
+Port		|CPU		|Machines						|Latest Release
+[[aarch64]]	|aarch64	|64-bit ARM CPUs					|[9.1](http://www.netbsd.org/releases/formal-9/)
+[[amd64]]	|x86_64		|64-bit x86-family machines with AMD and Intel CPUs	|[9.1](http://www.netbsd.org/releases/formal-9/)
+[[evbarm]]	|arm		|ARM evaluation boards					|[9.1](http://www.netbsd.org/releases/formal-9/)
+[[evbmips]]	|mips		|MIPS-based evaluation boards				|[9.1](http://www.netbsd.org/releases/formal-9/)
+[[evbppc]]	|powerpc	|PowerPC-based evaluation boards			|[9.1](http://www.netbsd.org/releases/formal-9/)
+[[hpcarm]]	|arm		|StrongARM based Windows CE PDA machines		|[9.1](http://www.netbsd.org/releases/formal-9/)
+[[i386]]	|i386		|32-bit x86-family generic machines ("PC clones")	|[9.1](http://www.netbsd.org/releases/formal-9/)
+[[sparc64]]	|sparc		|Sun UltraSPARC (64-bit)				|[9.1](http://www.netbsd.org/releases/formal-9/)
+[[xen]]		|i386, x86_64	|Xen Virtual Machine Monitor				|[9.1](http://www.netbsd.org/releases/formal-9/)
 """]]
 
 
@@ -43,56 +44,57 @@ Organic ports are highly valued by the N
 Currently there are 49 ports with Tier II status. They are:
 
 [[!table data="""
-Port		|CPU		|Machines
-[[acorn32]]	|arm		|Acorn RiscPC/A7000/NC and compatibles
-[[algor]]	|mips		|Algorithmics MIPS evaluation boards
-[[alpha]]	|alpha		|Digital Alpha (64-bit)
-[[amiga]]	|m68k		|Commodore Amiga, MacroSystem DraCo
-[[amigappc]]	|powerpc	|PowerPC-based Amiga boards
-[[arc]]		|mips		|Machines following the Advanced RISC Computing spec
-[[atari]]	|m68k		|Atari TT030, Falcon, Hades
-[[bebox]]	|powerpc	|Be Inc's BeBox
-[[cats]]	|arm		|Chalice Technology's Strong Arm evaluation board
-[[cesfic]]	|m68k		|CES's FIC8234 VME processor board
-[[cobalt]]	|mips		|Cobalt Networks' Microservers
-[[dreamcast]]	|[[sh3]]	|Sega Dreamcast game console
-[[epoc32]]	|arm		|32bit PSION EPOC PDA
-[[emips]]	|mips		|Machines based on "Extensible MIPS"
-[[evbsh3]]	|[[sh3]]	|Evaluation boards with Renesas (Hitachi) Super-H SH3 and SH4 CPUs
-[[ews4800mips]]	|mips		|NEC's MIPS based EWS4800 workstations
-[[hp300]]	|m68k		|Hewlett-Packard 9000/300 and 400 series
-[[hp700]]	|hppa		|Hewlett-Packard 9000/700 series
-[[hpcmips]]	|mips		|MIPS based Windows CE PDA machines
-[[hpcsh]]	|[[sh3]]	|Renesas (Hitachi) SH3 and SH4 based Windows CE PDA machines
-[[ia64]]	|itanium	|Itanium family of processors
-[[ibmnws]]	|powerpc	|IBM Network Station Series 1000
-[[iyonix]]	|arm		|Iyonix ARM pc
-[[landisk]]	|[[sh3]]	|SH4 based NAS appliances by I-O DATA
-[[luna68k]]	|m68k		|OMRON Tateisi Electronics' LUNA series
-[[mac68k]]	|m68k		|Apple Macintosh
-[[macppc]]	|powerpc	|Apple Power Macintosh and clones
-[[mipsco]]	|mips		|Mips family of workstations and servers
-[[mmeye]]	|[[sh3]]	|Brains' mmEye Multi Media Server
-[[mvme68k]]	|m68k		|Motorola MVME 68k SBCs
-[[mvmeppc]]	|powerpc	|Motorola MVME PowerPC SBCs
-[[netwinder]]	|arm		|StrongARM based NetWinder machines
-[[news68k]]	|arm		|Sony's m68k based "NET WORK STATION" series
-[[newsmips]]	|mips		|Sony's MIPS based "NET WORK STATION" series
-[[next68k]]	|m68k		|NeXT 68k 'black' hardware
-[[ofppc]]	|powerpc	|Generic OpenFirmware compliant PowerPC machines
-[[pmax]]	|mips		|Digital MIPS-based DECstations and DECsystems
-[[prep]]	|powerpc	|PReP (PowerPC Reference Platform) and CHRP machines
-[[rs6000]]	|powerpc	|MCA-based IBM RS/6000 workstations
-[[sandpoint]]	|powerpc	|Motorola Sandpoint reference platform
-[[sbmips]]	|mips		|Broadcom SiByte evaluation boards
-[[sgimips]]	|mips		|Silicon Graphics' MIPS-based workstations
-[[shark]]	|arm		|Digital DNARD ("shark")
-[[sparc]]	|sparc		|Sun SPARC (32-bit)
-[[sun2]]	|m68k		|Sun 2
-[[sun3]]	|m68k		|Sun 3 and 3x
-[[vax]]		|vax		|Digital VAX
-[[x68k]]	|m68k		|Sharp X680x0 series
-[[zaurus]]	|arm		|Sharp C7x0/C860/C1000/C3x00 series PDA
+Port		|CPU		|Machines								|Latest Release
+[[acorn32]]	|arm		|Acorn RiscPC/A7000/NC and compatibles					|[8.1](http://www.netbsd.org/releases/formal-8/)
+[[algor]]	|mips		|Algorithmics MIPS evaluation boards					|[9.1](http://www.netbsd.org/releases/formal-9/)
+[[alpha]]	|alpha		|Digital Alpha (64-bit)							|[9.1](http://www.netbsd.org/releases/formal-9/)
+[[amiga]]	|m68k		|Commodore Amiga, MacroSystem DraCo					|[9.1](http://www.netbsd.org/releases/formal-9/)
+[[amigappc]]	|powerpc	|PowerPC-based Amiga boards						|[9.1](http://www.netbsd.org/releases/formal-9/)
+[[arc]]		|mips		|Machines following the Advanced RISC Computing spec			|[9.1](http://www.netbsd.org/releases/formal-9/)
+[[atari]]	|m68k		|Atari TT030, Falcon, Hades						|[9.1](http://www.netbsd.org/releases/formal-9/)
+[[bebox]]	|powerpc	|Be Inc's BeBox								|[9.1](http://www.netbsd.org/releases/formal-9/)
+[[cats]]	|arm		|Chalice Technology's Strong Arm evaluation board			|[9.1](http://www.netbsd.org/releases/formal-9/)
+[[cesfic]]	|m68k		|CES's FIC8234 VME processor board					|[9.1](http://www.netbsd.org/releases/formal-9/)
+[[cobalt]]	|mips		|Cobalt Networks' Microservers						|[9.1](http://www.netbsd.org/releases/formal-9/)
+[[dreamcast]]	|[[sh3]]	|Sega Dreamcast game console						|[9.1](http://www.netbsd.org/releases/formal-9/)
+[[epoc32]]	|arm		|32bit PSION EPOC PDA							|[9.1](http://www.netbsd.org/releases/formal-9/)
+[[emips]]	|mips		|Machines based on "Extensible MIPS"					|[9.1](http://www.netbsd.org/releases/formal-9/)
+[[evbsh3]]	|[[sh3]]	|Evaluation boards with Renesas (Hitachi) Super-H SH3 and SH4 CPUs	|[9.1](http://www.netbsd.org/releases/formal-9/)
+[[ews4800mips]]	|mips		|NEC's MIPS based EWS4800 workstations					|[9.1](http://www.netbsd.org/releases/formal-9/)
+[[hp300]]	|m68k		|Hewlett-Packard 9000/300 and 400 series				|[9.1](http://www.netbsd.org/releases/formal-9/)
+[[hppa]]	|hppa		|Hewlett-Packard 9000/700 series					|[9.1](http://www.netbsd.org/releases/formal-9/)
+[[hpcmips]]	|mips		|MIPS based Windows CE PDA machines					|[9.1](http://www.netbsd.org/releases/formal-9/)
+[[hpcsh]]	|[[sh3]]	|Renesas (Hitachi) SH3 and SH4 based Windows CE PDA machines		|[9.1](http://www.netbsd.org/releases/formal-9/)
+[[ia64]]	|itanium	|Itanium family of processors						|none
+[[ibmnws]]	|powerpc	|IBM Network Station Series 1000					|[9.1](http://www.netbsd.org/releases/formal-9/)
+[[iyonix]]	|arm		|Iyonix ARM pc								|[9.1](http://www.netbsd.org/releases/formal-9/)
+[[landisk]]	|[[sh3]]	|SH4 based NAS appliances by I-O DATA					|[9.1](http://www.netbsd.org/releases/formal-9/)
+[[luna68k]]	|m68k		|OMRON Tateisi Electronics' LUNA series					|[9.1](http://www.netbsd.org/releases/formal-9/)
+[[mac68k]]	|m68k		|Apple Macintosh							|[9.1](http://www.netbsd.org/releases/formal-9/)
+[[macppc]]	|powerpc	|Apple Power Macintosh and clones					|[9.1](http://www.netbsd.org/releases/formal-9/)
+[[mipsco]]	|mips		|Mips family of workstations and servers				|[9.1](http://www.netbsd.org/releases/formal-9/)
+[[mmeye]]	|[[sh3]]	|Brains' mmEye Multi Media Server					|[9.1](http://www.netbsd.org/releases/formal-9/)
+[[mvme68k]]	|m68k		|Motorola MVME 68k SBCs							|[9.1](http://www.netbsd.org/releases/formal-9/)
+[[mvmeppc]]	|powerpc	|Motorola MVME PowerPC SBCs						|[9.1](http://www.netbsd.org/releases/formal-9/)
+[[netwinder]]	|arm		|StrongARM based NetWinder machines					|[9.1](http://www.netbsd.org/releases/formal-9/)
+[[news68k]]	|arm		|Sony's m68k based "NET WORK STATION" series				|[9.1](http://www.netbsd.org/releases/formal-9/)
+[[newsmips]]	|mips		|Sony's MIPS based "NET WORK STATION" series				|[9.1](http://www.netbsd.org/releases/formal-9/)
+[[next68k]]	|m68k		|NeXT 68k 'black' hardware						|[9.1](http://www.netbsd.org/releases/formal-9/)
+[[ofppc]]	|powerpc	|Generic OpenFirmware compliant PowerPC machines			|[9.1](http://www.netbsd.org/releases/formal-9/)
+[[pmax]]	|mips		|Digital MIPS-based DECstations and DECsystems				|[9.1](http://www.netbsd.org/releases/formal-9/)
+[[prep]]	|powerpc	|PReP (PowerPC Reference Platform) and CHRP machines			|[9.1](http://www.netbsd.org/releases/formal-9/)
+[[riscv]]	|riscv		|RISC-V									|none
+[[rs6000]]	|powerpc	|MCA-based IBM RS/6000 workstations					|[9.1](http://www.netbsd.org/releases/formal-9/)
+[[sandpoint]]	|powerpc	|Motorola Sandpoint reference platform					|[9.1](http://www.netbsd.org/releases/formal-9/)
+[[sbmips]]	|mips		|Broadcom SiByte evaluation boards					|[9.1](http://www.netbsd.org/releases/formal-9/)
+[[sgimips]]	|mips		|Silicon Graphics' MIPS-based workstations				|[9.1](http://www.netbsd.org/releases/formal-9/)
+[[shark]]	|arm		|Digital DNARD ("shark")						|[9.1](http://www.netbsd.org/releases/formal-9/)
+[[sparc]]	|sparc		|Sun SPARC (32-bit)							|[9.1](http://www.netbsd.org/releases/formal-9/)
+[[sun2]]	|m68k		|Sun 2									|[9.1](http://www.netbsd.org/releases/formal-9/)
+[[sun3]]	|m68k		|Sun 3 and 3x								|[9.1](http://www.netbsd.org/releases/formal-9/)
+[[vax]]		|vax		|Digital VAX								|[9.1](http://www.netbsd.org/releases/formal-9/)
+[[x68k]]	|m68k		|Sharp X680x0 series							|[9.1](http://www.netbsd.org/releases/formal-9/)
+[[zaurus]]	|arm		|Sharp C7x0/C860/C1000/C3x00 series PDA					|[9.1](http://www.netbsd.org/releases/formal-9/)
 """]]
 
 
@@ -106,12 +108,7 @@ Ports are moved to life support if they 
 * Port will be bumped up to organic when it is shown to be working.
 * If the port is not reported fixed within the next 6-12 months, it will be moved to the Attic.
 
-Currently there is 1 port with Tier III status. It is:
-
-[[!table data="""
-Port		|CPU		|Machines
-[[acorn26]]	|arm		|Acorn Archimedes, A-series and R-series systems
-"""]]
+Currently there are no port with Tier III status.
 
 
 <hr>
@@ -126,15 +123,16 @@ ports are supported.
 
 [[!table data="""
 CPU		|Tier(s)	|Ports(s)
+aarch64		|I		|[[aarch64]]
 alpha		|II		|[[alpha]]
-arm		|I, II, III	|[[acorn26]] [[acorn32]] [[cats]] [[epoc32]] [[evbarm]] [[hpcarm]] [[iyonix]] [[netwinder]] [[shark]] [[zaurus]]
-hppa		|II		|[[hp700]]
+arm		|I, II		|[[acorn32]] [[cats]] [[epoc32]] [[evbarm]] [[hpcarm]] [[iyonix]] [[netwinder]] [[shark]] [[zaurus]]
+hppa		|II		|[[hppa]]
 i386		|I		|[[i386]] [[xen]]
 m68010		|II		|[[sun2]]
 m68k		|II		|[[amiga]] [[atari]] [[cesfic]] [[hp300]] [[luna68k]] [[mac68k]] [[mvme68k]] [[news68k]] [[next68k]] [[sun3]] [[x68k]]
 mipseb		|I, II		|[[emips]] [[evbmips]] [[ews4800mips]] [[mipsco]] [[newsmips]] [[sbmips]] [[sgimips]]
 mipsel		|I, II		|[[algor]] [[arc]] [[cobalt]] [[evbmips]] [[hpcmips]] [[pmax]] [[sbmips]]
-powerpc		|I, II		|[[amigappc]] [[bebox]] [[evbppc]] [[ibmnws]] [[macppc]] [[mvmeppc]] [[ofppc]] [[prep]]] [[rs6000]] [[sandpoint]]
+powerpc		|I, II		|[[amigappc]] [[bebox]] [[evbppc]] [[ibmnws]] [[macppc]] [[mvmeppc]] [[ofppc]] [[prep]] [[rs6000]] [[sandpoint]]
 [[sh3eb|sh3]]	|II		|[[evbsh3]] [[mmeye]]
 [[sh3el|sh3]]	|II		|[[dreamcast]] [[evbsh3]] [[landisk]] [[hpcsh]]
 sparc		|II		|[[sparc]]
@@ -142,3 +140,15 @@ sparc64		|I		|[[sparc64]] (Can also run 
 vax		|II		|[[vax]]
 x86_64		|I		|[[amd64]] (Can also run i386 binaries), xen
 """]]
+
+## Various ways of denoting ports and CPUs
+
+When discussing ports and CPUs, there are two concepts, each of which have three ways of being named.  Strictly, the word port refers to the value shown by "uname -m", and typically corresponds to a directory under src/sys.  build.sh supports aliases, which are passed as if they were a port, but expand to a port and a cpu (MACHINE and MACHINE_ARCH); an example is evbearmv7hf-el which expands to the evbarm port and earmv7hf cpu.
+
+[[!table data="""
+concept | /usr/share/mk variable | uname | build.sh
+port | MACHINE      | uname -m | build.sh -m
+cpu  | MACHINE_ARCH | uname -p | build.sh -a
+"""]]
+
+Additonally, there are things referred to as ports which are not actually "uname -m" values, but are notably different than what would be expected from that port name.  One is xen, which is a system architecture variant of i386/amd64, and another is aarch64, which is a CPU type variant of evbarm.