archlinux / mkinitcpio-archiso

Initcpio scripts used by archiso (read-only mirror)

mkinitcpio-archiso

The mkinitcpio-archiso project provides initcpio integration for archiso. The scripts offer functionality for an environment, that is running in early user space by modifying an initrd.

Requirements

The following packages need to be installed to be able to use mkinitcpio-archiso on a target host:

• bash
• ca-certificates-utils (for PXE over HTTP)
• coreutils
• curl (for PXE over HTTP)
• device-mapper
• gnupg
• openssl (for verifying CMS signatures generated in archiso)
• mkinitcpio
• mkinitcpio-nfs-utils (for PXE over NFS)
• nbd (for PXE over NBD)
• pv (optional: for displaying status when copying the image to RAM)
• util-linux

The following packages need to be installed to be able to check the code of mkinitcpio-archiso (when running make check):

• shellcheck
• shfmt

Installation

To install this project, the make target install can be used. It honors both DESTDIR and PREFIX (defaults to /usr/local).

make install DESTDIR=/some/directory PREFIX=/usr

Documentation

Documentation on various aspects of mkinitcpio-archiso can be found in the docs directory.

Contribute

Development of mkinitcpio-archiso takes place on Arch Linux' Gitlab: https://gitlab.archlinux.org/archlinux/mkinitcpio/mkinitcpio-archiso.

Please read our distribution-wide Code of Conduct before contributing, to understand what actions will and will not be tolerated.

Read our contributing guide to learn more about how to provide fixes or improvements for the code base.

Discussion around mkinitcpio-archiso takes place on the arch-releng mailing list and in #archlinux-releng on Libera Chat.

All past and present authors of mkinitcpio-archiso are listed in AUTHORS.

Releases

Releases of mkinitcpio-archiso are created by their current maintainers

• David Runge (991F6E3F0765CF6295888586139B09DA5BF0D338)
• nl6720 (BB8E6F1B81CF0BB301D74D1CBF425A01E68B38EF)

Tags are signed using respective PGP keys.

Note

Releases before v58 have been done as part of archiso. After archiso v57 mkinitcpio-archiso became its own project.

To verify a tag, first import the relevant PGP key:

gpg --auto-key-locate wkd --search-keys [e-mail]

or

gpg --auto-key-locate keyserver --recv-keys BB8E6F1B81CF0BB301D74D1CBF425A01E68B38EF

Afterwards a tag can be verified from a clone of this repository:

git verify-tag <tag>

License

Mkinitcpio-archiso is licensed under the terms of the GPL-3.0-or-later (see LICENSE).