Compare commits
No commits in common. "69df4744c7ba4dc0f4553faf1ff24387f524c0a9" and "52c785e844ae2c861205130fed102f1cb3346f00" have entirely different histories.
69df4744c7
...
52c785e844
104
README.md
104
README.md
@ -1,105 +1 @@
|
|||||||
# snap-pac-uki
|
# snap-pac-uki
|
||||||
|
|
||||||
## What is this?
|
|
||||||
|
|
||||||
This is a collection of scripts, pacman hooks and and systemd units for creating
|
|
||||||
and managing unified kernel images (UKIs) based on snapper. It originally
|
|
||||||
expected to be executed as a pacman hook after `snap-pac`, but this is no longer
|
|
||||||
required (though the name remains).
|
|
||||||
|
|
||||||
## Installation
|
|
||||||
|
|
||||||
### Prerequisites
|
|
||||||
|
|
||||||
This tool expects that you already set up snapper. It also expects that each
|
|
||||||
snapshots linux and initramfs files (`/boot/vmlinuz-linux` and
|
|
||||||
`/boot/initramfs-linux.img`) as well as a kernel command line file
|
|
||||||
(`/etc/snap-pac-uki/kernel-cmd`) are available within each snapshot.
|
|
||||||
|
|
||||||
The fallback initramfs (`/boot/initramfs-linux-fallback.img`) and fallback
|
|
||||||
command line file (`/etc/snap-pac-uki/kernel-cmd-fallback`) are only required
|
|
||||||
on the current system.
|
|
||||||
|
|
||||||
EFI boot options are only created for each snapshot. If you want the UKIs
|
|
||||||
created for the current system, you'll need to add boot entries yourself:
|
|
||||||
|
|
||||||
```bash
|
|
||||||
# template
|
|
||||||
efibootmgr -c \
|
|
||||||
-d <EFI DEVICE> \
|
|
||||||
-p <EFI PARTITION NUMBER> \
|
|
||||||
-l <EFI PATH> \
|
|
||||||
-L <LABEL>
|
|
||||||
|
|
||||||
# example
|
|
||||||
efibootmgr -c \
|
|
||||||
-d /dev/nvme0n1 \
|
|
||||||
-p 1 \
|
|
||||||
-l "\EFI\Linux\arch-linux.efi" \
|
|
||||||
-L "Arch Linux"
|
|
||||||
|
|
||||||
# example for fallback
|
|
||||||
efibootmgr -c \
|
|
||||||
-d /dev/nvme0n1 \
|
|
||||||
-p 1 \
|
|
||||||
-l "\EFI\Linux\arch-linux-fallback.efi" \
|
|
||||||
-L "Arch Linux (Fallback)"
|
|
||||||
```
|
|
||||||
|
|
||||||
### Using the install script
|
|
||||||
|
|
||||||
1. You can install the dependencies of this program with the following command:
|
|
||||||
|
|
||||||
```bash
|
|
||||||
pacman -S fish efibootmgr jq ripgrep sbsigntools sed snapper
|
|
||||||
```
|
|
||||||
|
|
||||||
2. Download the latest release from [here][releases] and unpack it.
|
|
||||||
|
|
||||||
3. Then run the install script (you need to be in the same directory):
|
|
||||||
|
|
||||||
```bash
|
|
||||||
./install.fish
|
|
||||||
```
|
|
||||||
|
|
||||||
## Usage
|
|
||||||
|
|
||||||
### Creating snapshot UKIs
|
|
||||||
|
|
||||||
This creates a new UKI for all snapshots where none is found:
|
|
||||||
|
|
||||||
```bash
|
|
||||||
snap-pac-uki snapshots
|
|
||||||
```
|
|
||||||
|
|
||||||
### Create current UKIs
|
|
||||||
|
|
||||||
This creates a new UKI for the current system (including a fallback variant):
|
|
||||||
|
|
||||||
```bash
|
|
||||||
snap-pac-uki current
|
|
||||||
```
|
|
||||||
|
|
||||||
### Clean up UKIs
|
|
||||||
|
|
||||||
This removes all UKIs without corresponding snapshot (solely based on number):
|
|
||||||
|
|
||||||
```bash
|
|
||||||
snap-pac-uki clean
|
|
||||||
```
|
|
||||||
|
|
||||||
### Enable periodic cleanups using systemd timer
|
|
||||||
|
|
||||||
```
|
|
||||||
systemctl enable --now snap-pac-uki-cleanup.timer
|
|
||||||
```
|
|
||||||
|
|
||||||
## Uninstall
|
|
||||||
|
|
||||||
Simply run the following command in this directory:
|
|
||||||
|
|
||||||
```bash
|
|
||||||
./uninstall.fish
|
|
||||||
```
|
|
||||||
|
|
||||||
[releases]: https://git.tfld.dev/tfld/snap-pac-uki/releases
|
|
||||||
|
@ -1,12 +1,6 @@
|
|||||||
#!/bin/fish
|
#!/bin/fish
|
||||||
|
|
||||||
cp ./src/snap-pac-uki.fish /usr/local/bin/snap-pac-uki
|
cp ./src/snap-pac-uki.fish /usr/local/bin/snap-pac-uki
|
||||||
echo "installed script."
|
echo "installed creation script."
|
||||||
|
|
||||||
if not test -d "/etc/snap-pac-uki"
|
|
||||||
mkdir -p "/etc/snap-pac-uki"
|
|
||||||
echo "created config dir."
|
|
||||||
end
|
|
||||||
|
|
||||||
cp ./src/config.fish /etc/snap-pac-uki/config.fish
|
cp ./src/config.fish /etc/snap-pac-uki/config.fish
|
||||||
echo "installed config script."
|
echo "installed config script."
|
||||||
|
@ -1,17 +0,0 @@
|
|||||||
#!/bin/fish
|
|
||||||
|
|
||||||
rm /usr/local/bin/snap-pac-uki
|
|
||||||
echo "removed script."
|
|
||||||
|
|
||||||
rm /etc/snap-pac-uki/config.fish
|
|
||||||
echo "removed config script."
|
|
||||||
|
|
||||||
for name in (ls ./pacman)
|
|
||||||
rm /usr/share/libalpm/hooks/$name
|
|
||||||
end
|
|
||||||
echo "removed pacman hooks."
|
|
||||||
|
|
||||||
for name in (ls ./systemd)
|
|
||||||
rm /etc/systemd/system/$name
|
|
||||||
end
|
|
||||||
echo "removed systemd unit files"
|
|
Loading…
Reference in New Issue
Block a user