From a32a4df6a6ee7f32a385be7340021151dcb443ad Mon Sep 17 00:00:00 2001 From: hygienic-books Date: Sat, 6 May 2023 19:52:53 +0200 Subject: [PATCH] docs(script): Expand on trivial and important packages distinction (#1) --- README.md | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/README.md b/README.md index 1d4e06a..08b211c 100644 --- a/README.md +++ b/README.md @@ -44,6 +44,16 @@ zpool/root/archlinux ``` If exactly one source returns that is the exact name of a ZFS dataset in an imported zpool we create a snapshot on it. If no source returns we silently exit. If more than one source returns we raise an error and halt the `pacman` transaction. +We retain two different snapshot chains, one for `pacman` transactions that only affect what we are calling _trivial_ packages and a separate chain for _important_ packages. By default only the exact regular expression package name match `^(linux|systemd|zfs-(dkms|utils))$` is considered important so in plain English any one of: + +- `linux` +- `systemd` +- `zfs-dkms` +- `zfs-utils` + +Whenever an important package is affected by a transaction a snapshot goes into the corresponding chain. In all other cases - when an important package is not affected - snapshots go into the trivial chain. + +The _trivial_ snapshot chain by default keeps 25 snapshots, the _important_ chain keeps 5. The thought process here is that you will likely not futz around with a kernel every day whereas you may very well install arbitrary packages multiple times a day. Snapshots should keep you safe for a couple of days hence the defaults of 5 and 15 snapshots, respectively. Snapshots may look like so: ```