The xPack LLVM clang

A standalone cross-platform (Windows/macOS/Linux) LLVM clang binary distribution, intended for reproducible builds.

In addition to the the binary archives and the package meta data, this project also includes the build scripts.

Overview

This open source project is hosted on GitHub as xpack-dev-tools/clang-xpack and provides the platform specific binaries for the xPack LLVM clang; it includes, in addition to project metadata, the full build scripts.

This distribution follows the official LLVM clang.

The binaries can be installed automatically as binary xPacks or manually as portable archives.

Release schedule

This distribution follows the official LLVM clang releases, but only the final patch of each version is released (like *.0.6).

User info

This section is intended as a shortcut for those who plan to use the LLVM clang binaries. For full details please read the xPack LLVM clang pages.

Supported languages

The xPack LLVM clang binaries include support for C/C++ and the LLVM utilities.

Easy install

The easiest way to install LLVM clang is using the binary xPack, available as @xpack-dev-tools/clang from the npmjs.com registry.

Prerequisites

A recent xpm, which is a portable Node.js command line application that complements npm with several extra features specific to C/C++ projects.

It is recommended to install/update to the latest version with:

npm install --location=global xpm@latest

For details please follow the instructions in the xPack install page.

Install

With the xpm tool available, installing the latest version of the package and adding it as a development dependency for a project is quite easy:

cd my-project
xpm init # Add a package.json if not already present

xpm install @xpack-dev-tools/clang@latest --verbose

ls -l xpacks/.bin

This command will:

• install the latest available version, into the central xPacks store, if not already there
• add symbolic links (.cmd forwarders on Windows) into the local xpacks/.bin folder to the central store

The central xPacks store is a platform dependent location in the home folder; check the output of the xpm command for the actual folder used on your platform. This location is configurable via the environment variable XPACKS_STORE_FOLDER; for more details please check the xpm folders page.

It is also possible to install LLVM clang globally, in the user home folder:

xpm install --global @xpack-dev-tools/clang@latest --verbose

After install, the package should create a structure like this (macOS files; only the first two depth levels are shown):

$ tree -L 2 /Users/ilg/Library/xPacks/\@xpack-dev-tools/clang/18.1.8-1.1/.content/
/Users/ilg/Library/xPacks/@xpack-dev-tools/clang/18.1.8-1.1/.content/
├── README.md
├── bin
│   ├── analyze-build
│   ├── clang -> clang-18
│   ├── clang++ -> clang
│   ├── clang-18
│   ├── clang-check
│   ├── clang-cl -> clang
│   ├── clang-cpp -> clang
│   ├── clang-doc
│   ├── clang-format
│   ├── clang-include-cleaner
│   ├── clang-linker-wrapper
│   ├── clang-refactor
│   ├── clang-rename
│   ├── clang-repl
│   ├── clang-scan-deps
│   ├── clang-tblgen
│   ├── clang-tidy
│   ├── clangd
│   ├── darwin-debug
│   ├── diagtool
│   ├── git-clang-format
│   ├── hmaptool
│   ├── ld.lld -> lld
│   ├── ld64.lld -> lld
│   ├── llc
│   ├── lld
│   ├── lld-link -> lld
│   ├── lldb
│   ├── lldb-argdumper
│   ├── lldb-dap
│   ├── lldb-instr
│   ├── lldb-server
│   ├── lli
│   ├── llvm-addr2line -> llvm-symbolizer
│   ├── llvm-ar
│   ├── llvm-as
│   ├── llvm-bitcode-strip -> llvm-objcopy
│   ├── llvm-config
│   ├── llvm-cov
│   ├── llvm-cxxdump
│   ├── llvm-cxxfilt
│   ├── llvm-cxxmap
│   ├── llvm-debuginfo-analyzer
│   ├── llvm-debuginfod
│   ├── llvm-debuginfod-find
│   ├── llvm-diff
│   ├── llvm-dis
│   ├── llvm-dlltool -> llvm-ar
│   ├── llvm-dwarfutil
│   ├── llvm-lib -> llvm-ar
│   ├── llvm-libtool-darwin
│   ├── llvm-nm
│   ├── llvm-objcopy
│   ├── llvm-objdump
│   ├── llvm-otool -> llvm-objdump
│   ├── llvm-profdata
│   ├── llvm-ranlib -> llvm-ar
│   ├── llvm-rc
│   ├── llvm-readelf -> llvm-readobj
│   ├── llvm-readobj
│   ├── llvm-readtapi
│   ├── llvm-remarkutil
│   ├── llvm-sim
│   ├── llvm-size
│   ├── llvm-strings
│   ├── llvm-strip -> llvm-objcopy
│   ├── llvm-symbolizer
│   ├── llvm-tblgen
│   ├── llvm-tli-checker
│   ├── llvm-windres -> llvm-rc
│   ├── run-clang-tidy
│   ├── scan-build-py
│   ├── set-xcode-analyzer
│   ├── split-file
│   └── wasm-ld -> lld
├── distro-info
│   └── licenses
├── include
│   ├── __libunwind_config.h
│   ├── c++
│   ├── libunwind.h
│   ├── libunwind.modulemap
│   ├── mach-o
│   ├── unwind.h
│   ├── unwind_arm_ehabi.h
│   └── unwind_itanium.h
├── lib
│   ├── LLVMPolly.so
│   ├── clang
│   ├── cmake
│   ├── libLLVM-18.dylib -> libLLVM.dylib
│   ├── libLLVM-C.dylib
│   ├── libLLVM.dylib
│   ├── libLTO.dylib
│   ├── libPolly.a
│   ├── libPollyISL.a
│   ├── libRemarks.dylib
│   ├── libc++.1.0.dylib
│   ├── libc++.1.dylib -> libc++.1.0.dylib
│   ├── libc++.a
│   ├── libc++.dylib -> libc++.1.dylib
│   ├── libc++abi.1.0.dylib
│   ├── libc++abi.1.dylib -> libc++abi.1.0.dylib
│   ├── libc++abi.a
│   ├── libc++abi.dylib -> libc++abi.1.dylib
│   ├── libc++experimental.a
│   ├── libclang-cpp.dylib
│   ├── libclang.dylib
│   ├── libear
│   ├── liblldb.18.1.8.dylib
│   ├── liblldb.dylib -> liblldb.18.1.8.dylib
│   ├── libscanbuild
│   ├── libunwind.1.0.dylib
│   ├── libunwind.1.dylib -> libunwind.1.0.dylib
│   ├── libunwind.a
│   └── libunwind.dylib -> libunwind.1.dylib
├── libexec
│   ├── analyze-c++
│   ├── analyze-cc
│   ├── c++-analyzer
│   ├── ccc-analyzer
│   ├── intercept-c++
│   ├── intercept-cc
│   ├── libedit.0.dylib
│   ├── libffi.8.dylib
│   ├── libform.6.dylib
│   ├── libiconv.2.dylib
│   ├── liblzma.5.dylib
│   ├── libncurses.6.dylib
│   ├── libpanel.6.dylib
│   ├── libxml2.2.dylib
│   ├── libz.1.3.1.dylib
│   └── libz.1.dylib -> libz.1.3.1.dylib
└── share
    ├── clang
    ├── opt-viewer
    ├── scan-build
    └── scan-view

18 directories, 123 files

No other files are installed in any system folders or other locations.

Uninstall

To remove the links created by xpm in the current project:

cd my-project

xpm uninstall @xpack-dev-tools/clang

To completely remove the package from the central xPack store:

xpm uninstall --global @xpack-dev-tools/clang

Manual install

For all platforms, the xPack LLVM clang binaries are released as portable archives that can be installed in any location.

The archives can be downloaded from the GitHub Releases page.

For more details please read the Install page.

Versioning

The version strings used by the LLVM project are three number strings like 18.1.8; to this string the xPack distribution adds a four number, but since semver allows only three numbers, all additional ones can be added only as pre-release strings, separated by a dash, like 18.1.8-1. When published as a npm package, the version gets a fifth number, like 18.1.8-1.1.

Since adherence of third party packages to semver is not guaranteed, it is recommended to use semver expressions like ^18.1.8 and ~18.1.8 with caution, and prefer exact matches, like 18.1.8-1.1.

Maintainer info

For maintainer info, please see the README-MAINTAINER.

Support

The quick advice for getting support is to use the GitHub Discussions.

For more details please read the Support page.

License

Unless otherwise stated, the content is released under the terms of the MIT License, with all rights reserved to Liviu Ionescu.

The binary distributions include several open-source components; the corresponding licenses are available in the installed distro-info/licenses folder.

Download analytics

• GitHub xpack-dev-tools/clang-xpack repo
  • latest xPack release
  • all xPack releases
  • individual file counters (grouped per release)
• npmjs.com @xpack-dev-tools/clang xPack
  • latest release, per month
  • all releases

Credit to Shields IO for the badges and to Somsubhra/github-release-stats for the individual file counters.