Support non-default sets of enabled LLVM CPU targets. (#13983)

A number of places in our bitcode build, tests and samples were still
relying on specific LLVM CPU targets, namely `X86` and `AArch64`, which
are part of what's enabled from our standard list for our bundled build:

https://github.com/openxla/iree/blob/815e84310740ba2bd181438f4fc8224406951ea9/build_tools/cmake/iree_llvm.cmake#L108

Since this is a `CACHE`'d CMake variable, it was always possible for a
user to disable some of these targets. Probably many people tried that,
in the hopes of getting faster builds. But lately, as we added bitcode
libraries and standalone plugins that unconditionally built a fixed set
of target architecture, that was no longer working.

The recent development motivating this now is bring-your-own-LLVM: the
`byo_llvm.sh` script is defaulting to enabling only the `X86` target:

https://github.com/openxla/iree/blob/815e84310740ba2bd181438f4fc8224406951ea9/build_tools/scripts/byo_llvm.sh#L72

Even if that's only an invitation to the user to adapt it to their
needs, that's a departure from the standard sets of targets that we were
relying on. In particular, x86 users who would run this script
unmodified would run into these build issues if they try to build all of
IREE with its compiler, tests and samples.

So this PR makes us mostly principled in this respect. The remaining
un-principled aspects that I know of are:

* When building the compiler with the `llvm-cpu` backend, we have an
implicit assumption that at least the LLVM target for the target
architecture is built.
* We are relying on the `WebAssembly` target always being built, as it
is what we use in non-architecture-specific `iree_bitcode_library`'s as
a proxy for "a reasonable 32-bit / 64-bit architecture" where we are
going to be stripping away target information from the IR.
* This reliance should not be a problem in the near term as we are
enabling `WebAssembly` by default, in a way that is orthogonal to
`byo-llvm.sh`. In order to run into trouble, a user would have to
explicitly turn off `IREE_TARGET_BACKEND_LLVM_CPU_WASM`.

---------

Co-authored-by: Scott Todd <scotttodd@google.com>
11 files changed
tree: fd0162382a3869842019d211414ff201d1caa15c
  1. .devcontainer/
  2. .github/
  3. build_tools/
  4. compiler/
  5. docs/
  6. experimental/
  7. integrations/
  8. lib/
  9. llvm-external-projects/
  10. runtime/
  11. samples/
  12. tests/
  13. third_party/
  14. tools/
  15. .bazel_to_cmake.cfg.py
  16. .bazelignore
  17. .bazelrc
  18. .bazelversion
  19. .clang-format
  20. .dockerignore
  21. .gitignore
  22. .gitmodules
  23. .pylintrc
  24. .style.yapf
  25. .yamllint.yml
  26. AUTHORS
  27. BUILD.bazel
  28. CITATION.cff
  29. CMakeLists.txt
  30. configure_bazel.py
  31. CONTRIBUTING.md
  32. LICENSE
  33. README.md
  34. WORKSPACE
README.md

IREE: Intermediate Representation Execution Environment

IREE (Intermediate Representation Execution Environment, pronounced as “eerie”) is an MLIR-based end-to-end compiler and runtime that lowers Machine Learning (ML) models to a unified IR that scales up to meet the needs of the datacenter and down to satisfy the constraints and special considerations of mobile and edge deployments.

See our website for project details, user guides, and instructions on building from source.

CI Status

Project Status

IREE is still in its early phase. We have settled down on the overarching infrastructure and are actively improving various software components as well as project logistics. It is still quite far from ready for everyday use and is made available without any support at the moment. With that said, we welcome any kind of feedback on any communication channels!

Communication Channels

Related Project Channels

  • MLIR topic within LLVM Discourse: IREE is enabled by and heavily relies on MLIR. IREE sometimes is referred to in certain MLIR discussions. Useful if you are also interested in MLIR evolution.

Architecture Overview

IREE Architecture IREE Architecture

See our website for more information.

Presentations and Talks

  • 2021-06-09: IREE Runtime Design Tech Talk (recording and slides)
  • 2020-08-20: IREE CodeGen: MLIR Open Design Meeting Presentation (recording and slides)
  • 2020-03-18: Interactive HAL IR Walkthrough (recording)
  • 2020-01-31: End-to-end MLIR Workflow in IREE: MLIR Open Design Meeting Presentation (recording and slides)

License

IREE is licensed under the terms of the Apache 2.0 License with LLVM Exceptions. See LICENSE for more information.