peridot/build/bazel/remote/execution/v2/platform.md
2022-07-07 22:13:21 +02:00

2.5 KiB

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 names 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:

    // (Platform proto)
    {
      "properties": [
        {
          "name": "ISA",
          "value": "x86-64"
        },
        {
          "name": "ISA",
          "value": "x86-avx2"
        }
      ]
    }
    
    // (Platform proto)
    {
      "properties": [
        {
          "name": "ISA",
          "value": "arm-a64"
        },
        {
          "name": "ISA",
          "value": "armv8"
        },
        {
          "name": "ISA",
          "value": "arm-sve"
        }
      ]
    }
    
    // (Platform proto)
    {
      "properties": [
        {
          "name": "ISA",
          "value": "arm-a32"
        },
        {
          "name": "ISA",
          "value": "armv7"
        },
        {
          "name": "ISA",
          "value": "arm-vfpv4"
        }
      ]
    }