121 lines
2.5 KiB
Markdown
121 lines
2.5 KiB
Markdown
# Platform Lexicon
|
|
|
|
This lexicon defines standard platform property names and values that servers
|
|
MAY support in the `Platform` message to facilitate interoperability.
|
|
|
|
The following standard property `name`s are defined:
|
|
|
|
* `OSFamily`: This describes the operating system family. Multiple values
|
|
are not allowed and an exact match is required.
|
|
|
|
The following standard values are defined:
|
|
|
|
- `aix`
|
|
- `freebsd`
|
|
- `linux`
|
|
- `macos`
|
|
- `sunos`
|
|
- `windows`
|
|
|
|
Additional values may be defined by the server. For other POSIX systems
|
|
the recommendation is to use the output of `uname -s` in lower case.
|
|
|
|
* `ISA`: This describes the instruction set architecture including
|
|
instruction set extensions and versions. Multiple values are allowed. If
|
|
multiple values are specified, they are AND-ed together: the worker is
|
|
required to support all of the listed values.
|
|
|
|
The following standard instruction set architecture values are defined:
|
|
|
|
- `arm-a32` (little endian)
|
|
- `arm-a32-be` (big endian)
|
|
- `arm-a64` (little endian)
|
|
- `arm-a64-be` (big endian)
|
|
- `arm-t32` (little endian)
|
|
- `arm-t32-be` (big endian)
|
|
- `power-isa-be` (big endian)
|
|
- `power-isa-le` (little endian)
|
|
- `sparc-v9` (big endian)
|
|
- `x86-32`
|
|
- `x86-64`
|
|
|
|
The following standard instruction set extension and version values are
|
|
defined:
|
|
|
|
- `arm-neon`
|
|
- `arm-sve`
|
|
- `arm-vfpv3`
|
|
- `arm-vfpv4`
|
|
- `armv6`
|
|
- `armv7`
|
|
- `armv8`
|
|
- `x86-avx`
|
|
- `x86-avx2`
|
|
- `x86-avx-512`
|
|
- `x86-sse4.1`
|
|
- `x86-sse4.2`
|
|
|
|
Additional values may be defined by the server. Vendor-neutral names are
|
|
recommended.
|
|
|
|
Clients SHOULD NOT request instruction set extensions or versions without
|
|
requesting an instruction set architecture.
|
|
|
|
Examples with multiple values:
|
|
|
|
```json
|
|
// (Platform proto)
|
|
{
|
|
"properties": [
|
|
{
|
|
"name": "ISA",
|
|
"value": "x86-64"
|
|
},
|
|
{
|
|
"name": "ISA",
|
|
"value": "x86-avx2"
|
|
}
|
|
]
|
|
}
|
|
```
|
|
|
|
```json
|
|
// (Platform proto)
|
|
{
|
|
"properties": [
|
|
{
|
|
"name": "ISA",
|
|
"value": "arm-a64"
|
|
},
|
|
{
|
|
"name": "ISA",
|
|
"value": "armv8"
|
|
},
|
|
{
|
|
"name": "ISA",
|
|
"value": "arm-sve"
|
|
}
|
|
]
|
|
}
|
|
```
|
|
|
|
```json
|
|
// (Platform proto)
|
|
{
|
|
"properties": [
|
|
{
|
|
"name": "ISA",
|
|
"value": "arm-a32"
|
|
},
|
|
{
|
|
"name": "ISA",
|
|
"value": "armv7"
|
|
},
|
|
{
|
|
"name": "ISA",
|
|
"value": "arm-vfpv4"
|
|
}
|
|
]
|
|
}
|
|
```
|