diff --git a/README.md b/README.md index 5c938ab..07420b4 100644 --- a/README.md +++ b/README.md @@ -69,6 +69,7 @@ zpool/root ▼ | important packag zpool/root/archlinux ┌─────────────┐ ▼▼▼ zpool/root/archlinux@pacman_2023-03-07-0113_op:upgr_sev:imp_pkgs:systemd:bind:enchant:grep zpool/root/archlinux@pacman_2023-03-07-0113_op:upgr_sev:trv_pkgs:jdk17-temurin +zpool/root/archlinux@pacman_2023-03-07-0114_op:inst_sev:trv_pkgs:docker-credential-secretser... zpool/root/archlinux@pacman_2023-03-07-0115_op:upgr_sev:trv_pkgs:proton-ge-custom-bin ▲▲▲▲ ▲▲▲ └────────────────────────────┘ | | Max. 30 characters per our @@ -77,6 +78,29 @@ Pacman operation that triggered this snapshot ───┘ | pacm Severity based on affected packages, here trivial ───────┘ ``` +Notice how snapshot line 3 ends in `docker-credential-secretser...`. This snapshot was triggered on installation of the Arch User Repository package [docker-credential-secretservice-bin](https://aur.archlinux.org/packages/docker-credential-secretservice-bin) whose package name is 35 characters long. In this example our `pkgs_list_max_length` setting limits maximum name of the packages string to `30` characters. If we can't naturally fit package names into this limit by removing packages from the list we instead cut off part of the package name and add an ellipsis (three dots `...`). The default setting is `pkgs_list_max_length='30'`. In case the user wants three characters or fewer thus making an ellipsis impractical we simply trim the package name to that many characters: +``` +pkgs_list_max_length='7': dock... +pkgs_list_max_length='6': doc... +pkgs_list_max_length='5': do... +pkgs_list_max_length='4': d... +pkgs_list_max_length='3': doc +pkgs_list_max_length='2': do +pkgs_list_max_length='1': d +``` +With a package list allowance of 0 characters the entire `pkgs` field is removed. Above example will then look like so: +``` +$ zfs list -o name -t all +NAME +zpool +zpool/root +zpool/root/archlinux +zpool/root/archlinux@pacman_2023-03-07-0113_op:upgr_sev:imp +zpool/root/archlinux@pacman_2023-03-07-0113_op:upgr_sev:trv +zpool/root/archlinux@pacman_2023-03-07-0114_op:inst_sev:trv +zpool/root/archlinux@pacman_2023-03-07-0115_op:upgr_sev:trv +``` + Have a look at `pacman-zfs-snapshot.conf` as well, its comments should be clear enough to get you going. # Rollback