https://github.com/archlinux/mkinitcpio-archiso

Initcpio scripts used by archiso (read-only mirror)
https://github.com/archlinux/mkinitcpio-archiso

Last synced: 2 days ago
JSON representation

Initcpio scripts used by archiso (read-only mirror)

• Host: GitHub
• URL: https://github.com/archlinux/mkinitcpio-archiso
• Owner: archlinux
• License: gpl-3.0
• Created: 2021-08-01T12:47:44.000Z (almost 4 years ago)
• Default Branch: master
• Last Pushed: 2025-01-23T10:57:03.000Z (5 months ago)
• Last Synced: 2025-01-23T11:34:18.495Z (5 months ago)
• Language: Shell
• Homepage: https://gitlab.archlinux.org/mkinitcpio/mkinitcpio-archiso
• Size: 308 KB
• Stars: 8
• Watchers: 13
• Forks: 6
• Open Issues: 0
• Metadata Files:
  • Readme: README.rst
  • Changelog: CHANGELOG.rst
  • Contributing: CONTRIBUTING.rst
  • License: LICENSE
  • Authors: AUTHORS.rst

Awesome Lists containing this project

README

        
==================

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``).

.. code:: sh

   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:

.. code:: sh

   gpg --auto-key-locate wkd --search-keys [email protected]

or

.. code:: sh

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

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

.. code:: sh

   git verify-tag 

License

=======

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