METAL-PACKAGE(1) Metal METAL-PACKAGE(1)

metal-package - Metal binaries packaging tool

metal-package [options]

metal-package support different actions related to packaging Metal binaries. Each action is triggered by a different option.

The --thin option allows to thin an universal binary. The architecture to thin for is selected using the --main-arch option. That architecture is identified as the main architecture.

Unlike metal-lipo, more than one architectural slices are kept around by the thinning process. All the AIR slices are preserved in the thinned output. If the input binary contains the architecture to thin for, it is preserved in the output binary. Additional architecture could be preserved, depending on target specific rules. Such architectures are identified as fallback architectures.

An output binary contains the main architecture and/or any fallback architecture. An explicit fallback architecture can be specified using the --fallback-arch option.

The --default-fallback option allows to print the preferred fallback architecture for the given architecture. --all-fallbacks prints the preferred fallback architecture for each architecture.

The --dot-fallback option allows to generate a dot file representing the fallbacks of all architectures. That graph can be viewed directly using the --view-fallback option.

Display usage information and exit.

Display the version of this program.

Set the output file name.

Print the preferred fallback architecture for each architecture.

Print the preferred fallback architecture for arch.

Thin filename for the architecture specified via --main-arch.

Generate a dot graph encoding the fallback relationship of all architectures.

View the dot graph encoding all the fallbacks of all architectures.

Force using arch as the only fallback architecture.

Use arch as the main architecture.

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

metal-lipo(1)

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

2014-2024, The Metal Team

April 30, 2024 32023