METAL-CONFIG(1) Metal METAL-CONFIG(1)

metal-config - metal configuration tool

metal-config [options]

metal-config allows to retrieve information about the capabilities of the metal compiler.

Display available options.

Prints all the supported native architectures.

Prints each supported native architecture prefixed with the -arch flag.

Print all the supported implementations of the specified architecture.

Print each supported implementation for the specified architecture prefixed with the -mcpu flag.

Print whether the specified architecture is supported on the given platform version. <platform> is one of the following strings:
  • ios
  • ios-simulator
  • mac-catalyst
  • tvos
  • tvos-simulator
  • watchos
  • watchos-simulator
  • xros
  • xros-simulator
  • macos

The format of <min_version> is a version number such as 16.0 or 16.2.


Prints all the supported native architectures on the given platform version.

<platform> and <min_version> follow the same rules documented for the -native-arch-supported flag.


Prints each supported native architecture on the given platform version prefixed with the -arch flag.

<platform> and <min_version> follow the same rules documented for the -native-arch-supported flag.


Ignore native architectures not belonging to any of the specified families in the output of -native-archs, -native-arch-flags, -native-impls, and -native-impl-flags.

Supported families are apple[1-8], mac2, common[1-3], metal3.


To print all the native architectures conforming to either the apple1 or mac2 gpu family:

$ metal-config -gpu-family apple1,mac2 -native-archs


Multiple options case:

$ metal-config -gpu-family apple1 -gpu-family mac2 -native-archs


To report bugs, please visit <https://developer.apple.com/bug-reporting/>.

metal-arch(1)

Metal Shading Language Specification: <https://developer.apple.com/metal/Metal-Shading-Language-Specification.pdf>
Metal Feature Set Tables: <https://developer.apple.com/metal/Metal-Feature-Set-Tables.pdf>

2014-2024, The Metal Team

April 30, 2024 32023