ALHP.GO/README.md
2023-06-29 17:42:20 +02:00

7.1 KiB

ALHP

Buildbot for Archlinux-based repos build with different x86-64 feature levels, -O3 and LTO.

⚠️ NVIDIA graphic users using the proprietary driver is highly recommended reading the FAQ about Linux kernel modules ⚠️



Quickstart

1. Check your system for support

Important

: Before you enable any of these repos, check if your system supports the feature level you want to enable (e.g. x86-64-v3). If you don't check beforehand, you might be unable to boot your system anymore and need to downgrade any package that you may have upgraded.

Check which feature-levels your CPU supports with

/lib/ld-linux-x86-64.so.2 --help

Example output snippet for a system supporting up to x86-64-v3:

Subdirectories of glibc-hwcaps directories, in priority order:
  x86-64-v4
  x86-64-v3 (supported, searched)
  x86-64-v2 (supported, searched)

2. Install keyring & mirrorlist

Install alhp-keyring and alhp-mirrorlist from AUR.

Example with yay:

yay -S alhp-keyring alhp-mirrorlist

alhp-keyring provides the current signing keys used by ALHP, alhp-mirrorlist a selection of mirrors.

3. Choose a mirror (optional)

Edit /etc/pacman.d/alhp-mirrorlist and comment out/in mirrors you want to have enabled/disabled. Per default selected is a cloudflare-based mirror which should provide decent speed worldwide.

Note: Only alhp.dev is hosted by ALHP directly. If you have problems with a mirror, open an issue at the mirrorlist repo.

4. Modify /etc/pacman.conf

Add the appropriate repos above your regular Archlinux repos.

Example for x86-64-v3:

[core-x86-64-v3]
Include = /etc/pacman.d/alhp-mirrorlist

[extra-x86-64-v3]
Include = /etc/pacman.d/alhp-mirrorlist

[core]
Include = /etc/pacman.d/mirrorlist

[extra]
Include = /etc/pacman.d/mirrorlist

# if you need [multilib] support
[multilib-x86-64-v3]
Include = /etc/pacman.d/alhp-mirrorlist

[multilib]
Include = /etc/pacman.d/mirrorlist

Replace x86-64-v3 with the x86-64 feature level you want to enable.

ALHP only builds for x86-64-v3 and x86-64-v2 at the moment (list is subject to change). You can see all available repositories here.

5. Update package database and upgrade:

pacman -Suy

FAQ

Remove ALHP packages

To disable ALHP remove all x86-64-vX entries in /etc/pacman.conf and remove alhp-keyring and alhp-mirrorlist.

After that you can refresh pacmans databases and downgrade all packages like:

pacman -Suuy

LTO

Enabled for all packages build after 04 Nov 2021 12:07:00 UTC. More details. LTO status is visible per package on the package status page.

Linux Kernel packages

KCFLAGS/KCPPFLAGS are used to build the kernel packages with our additional flags.

Directly linked kernel modules

Due to our increase in pkgrel, building the kernel packages breaks all directly linked modules like nvidia (not nvidia-dkms) or virtualbox-host-modules-arch (not virtualbox-host-dkms). Their respective dkms-variant is not affected. This issue is being tracked in #68, a solution is being worked on.

Mirrors

You want to mirror ALHP? You are welcome to do so, see alhp-mirrorlist for how to become one.

What packages are built

Packages excluded from building (besides all 'any' architecture packages) are being listed in issue #16. Also package status page (search for blacklisted).

Why is package X not up-to-date

Also relevant for: I can't find package X / Application X fails to start because it links to an old/newer lib

ALHP build packages after they are released in the official Archlinux Repos (not including [*-testing]). This leads to packages being delayed if the current batch contains many packages or packages which take a while to build (e.g. chromium).

You can always check on the progress of the current build-cycle on the package status page. Please refrain from opening issues caused by packages currently in queue/not yet build/not yet moved to the repo. Please keep in mind that large rebuilds such as openssl or python can take days to complete on our current build hardware.

Debug symbols

ALHP provides a debuginfod instance under debuginfod.alhp.dev.

To use it, have debuginfod installed on your system and add it to your DEBUGINFOD_URLS with:

echo "https://debuginfod.alhp.dev" > /etc/debuginfod/alhp.urls

Matrix

For any non-issue questions or if you just want to chat, ALHP has a matrix room here (#alhp@ofsg.eu). You can also find me (@idlegandalf) in #archlinux:archlinux.org.

Donations

I appreciate any money you want to throw my way, but donations are strictly optional. Donations are primarily used to pay for server costs. Also consider donating to the Archlinux Team, without their work ALHP would not be possible.

Donate using Liberapay

This project including all of its source files is released under the terms of the GNU General Public License version 2 (or any later version). See LICENSE for details.