Skip to content

Add toolchain instructions for Fedora #104859

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 5 commits into from
Jul 13, 2024
Merged

Add toolchain instructions for Fedora #104859

Changes from 2 commits
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
6714d76
Add toolchain instructions for Fedora
vcsjones Jul 13, 2024
c412854
Put Ubuntu / Debian first
vcsjones Jul 13, 2024
23d0fc2
Update docs/workflow/requirements/linux-requirements.md
vcsjones Jul 13, 2024
79e53f4
Decrease indentation
vcsjones Jul 13, 2024
47a6f93
Fix table of contents
vcsjones Jul 13, 2024
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
34 changes: 32 additions & 2 deletions docs/workflow/requirements/linux-requirements.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -16,12 +16,16 @@ Install Docker. For further installation instructions, see [here](https://docs.d

## Environment

These instructions are written assuming the current Ubuntu LTS. Pull Requests are welcome to address other environments.
Below are the requirements for toolchain setup, depending on your environment. Pull Requests are welcome to address other environments.

Minimum RAM required to build is 1GB. The build is known to fail on 512 MB VMs ([dotnet/runtime#4069](https://github.com/dotnet/runtime/issues/4069)).

### Toolchain Setup

#### Debian-based / Ubuntu

These instructions are written assuming the current Ubuntu LTS.

Install the following packages for the toolchain:

* CMake 3.20 or newer
Expand Down Expand Up @@ -60,7 +64,7 @@ For the _Kitware APT feed_, follow its [instructions here](https://apt.kitware.c

You now have all the required components.

#### Additional Requirements for Cross-Building
##### Additional Requirements for Cross-Building

If you are planning to use your Linux environment to do cross-building for other architectures (e.g. Arm32, Arm64) and/or other operating systems (e.g. Alpine, FreeBSD), you need to install these additional dependencies:

Expand All @@ -71,6 +75,32 @@ If you are planning to use your Linux environment to do cross-building for other

**NOTE**: These dependencies are used to build the `crossrootfs`, not the runtime itself.

#### Fedora

These instructions are written assuming Fedora 40.

Install the following packages for the toolchain:

* cmake
* llvm
* lld
* lldb
* clang
* python
* curl
* git
* libicu-devel
* openssl-devel
* krb5-devel
* zlib-devel
* lttng-ust-devel
* ninja-build (optional, enables building native code with ninja instead of make)

```bash
sudo dnf install -y cmake llvm lld lldb clang python curl git libicu-devel openssl-devel \
Copy link
Member

@am11 am11 Jul 13, 2024 •
edited
Loading

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We can add it in install script as well while at it: am11@500300e (in the script, we assume git was already installed, since user cloned the repo, and ninja is optional; least required deps doesn't hurt to add them as you see fit 🙂)

Copy link
Member

@jkotas jkotas Jul 13, 2024

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Sounds good to me. @am11 Would you like to submit a PR?

(Also, zlib-devel should not be needed anymore - for both Debian and Fedora.)

krb5-devel zlib-devel lttng-ust-devel ninja-build
```

### Gentoo Special Case

In case you have Gentoo you can run following command:
Expand Down