Send patches - preferably formatted by git format-patch - to patches at archlinux32 dot org.
summaryrefslogtreecommitdiff
path: root/README.rst
blob: 87709d3481df24dbd2a4c5347b0513a6ef73f932 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
==================
mkinitcpio-archiso
==================

The mkinitcpio-archiso project provides `initcpio <https://gitlab.archlinux.org/mkinitcpio/mkinitcpio>`_ integration for
`archiso <https://gitlab.archlinux.org/archlinux/archiso>`_.
The scripts offer functionality for an environment, that is running in `early user space
<https://en.wikipedia.org/wiki/Linux_startup_process#Early_user_space>`_ by modifying an `initrd
<https://man.archlinux.org/man/initrd.4>`_.

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
* 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 <docs/>`_.

Contribute
==========

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

Please read our distribution-wide `Code of Conduct <https://wiki.archlinux.org/title/Code_of_conduct>`_ before
contributing, to understand what actions will and will not be tolerated.

Read our `contributing guide <CONTRIBUTING.rst>`_ 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
<https://lists.archlinux.org/listinfo/arch-releng>`_ and in `#archlinux-releng
<ircs://irc.libera.chat/archlinux-releng>`_ on `Libera Chat <https://libera.chat/>`_.

All past and present authors of mkinitcpio-archiso are listed in `AUTHORS <AUTHORS.rst>`_.

Releases
========

`Releases of mkinitcpio-archiso <https://gitlab.archlinux.org/archlinux/mkinitcpio-archiso/-/tags>`_ are created by its
current maintainer `David Runge <https://gitlab.archlinux.org/dvzrv>`_. Tags are signed using the PGP key with the ID
``C7E7849466FE2358343588377258734B41C31549``.

  .. note::

     Releases before v58 have been done as part of `archiso <https://gitlab.archlinux.org/archlinux/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 dvzrv@archlinux.org


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

.. code:: sh

   git verify-tag <tag>

License
=======

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