Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/archlinux/mkinitcpio

Arch Linux initramfs generation tools (read-only mirror)
https://github.com/archlinux/mkinitcpio

Last synced: 2 months ago
JSON representation

Arch Linux initramfs generation tools (read-only mirror)

Host: GitHub
URL: https://github.com/archlinux/mkinitcpio
Owner: archlinux
License: gpl-2.0
Created: 2019-01-21T13:18:03.000Z (almost 6 years ago)
Default Branch: master
Last Pushed: 2024-10-23T17:58:05.000Z (3 months ago)
Last Synced: 2024-10-24T02:08:15.263Z (3 months ago)
Language: Shell
Homepage: https://gitlab.archlinux.org/archlinux/mkinitcpio/mkinitcpio/
Size: 2.91 MB
Stars: 207
Watchers: 26
Forks: 63
Open Issues: 17
Metadata Files:
- Readme: README.adoc
- Changelog: CHANGELOG
- Contributing: CONTRIBUTING.adoc
- License: LICENSE
- Codeowners: CODEOWNERS
- Authors: AUTHORS

Awesome Lists containing this project

awesome-initramfs - mkinitcpio - default on Arch (Projects)

README

:toc: preamble
:sectnums:

= README

mkinitcpio is a modular initramfs image creation utility. 🐏

== Dependencies

mkinitcpio has the following dependencies.

.Dependencies:
* GNU awk
* A static build of busybox installed at `+/usr/lib/initcpio/busybox+`
* kmod
* util-linux
* bsdtar from libarchive
* GNU Coreutils
* Bash
* GNU Binutils
* GNU Diffutils
* GNU Findutils
* GNU Grep
* gzip (the default initramfs compressor for Linux < 5.9)
* zstd (the default initramfs compressor for Linux ≥ 5.9)

.Optional dependencies:
* systemd: for systemd-based initramfs
* xz: for `+lzma+` and `+xz+` initramfs compression/decompression
* bzip2: for initramfs compression/decompression
* lzop for `+lzo+` initramfs compression/decompression
* lz4 for initramfs compression/decompression
* systemd-ukify: build UKIs using ukify instead of objcopy

.Build time dependencies:
* Asciidoctor (or alternatively a2x from AsciiDoc.py) to create man pages
* Bash Automated Testing System (bats) and bats-assert for tests
* ShellCheck for tests

== Contributing

mkinitcpio development happens on the Arch Linux GitLab instance: https://gitlab.archlinux.org/archlinux/mkinitcpio/mkinitcpio. All issues and merge request should be submitted there.

Development discussion can be held in the link:ircs://irc.libera.chat/archlinux-projects[#archlinux-projects] IRC channel on https://libera.chat/[Libera Chat] and the https://lists.archlinux.org/mailman3/lists/arch-projects.lists.archlinux.org/[arch-projects mailing list].

Before contributing, make yourself familiar with the https://terms.archlinux.org/docs/code-of-conduct/[Arch Linux code of conduct] and xref:CONTRIBUTING.adoc[mkinitcpio coding style].

== User documentation

Primary usage documentation is available in the xref:man/mkinitcpio.8.adoc[mkinitcpio(8)], xref:man/lsinitcpio.1.adoc[lsinitcpio(1)] and xref:man/mkinitcpio.conf.5.adoc[mkinitcpio.conf(5)] man pages.

A comprehensible user guide is available in the https://wiki.archlinux.org/title/mkinitcpio[mkinitcpio article on ArchWiki].

== License

This project is licensed under the terms of the *GPL-2.0-only*. See `link:LICENSE[]`.