me/snap-pac
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
Pacman hook that creates a btrfs snapshot with snapper prior to the operation as a system restore point
34 commits 2 branches 38 tags 831 KiB
Find a file
James Barnett ff74d7cb68 update README
2016-04-22 20:11:06 -05:00
10_snapper-post.hook update hook names so that snapshots are the first things done 2016-03-17 19:49:27 -05:00
10_snapper-pre.hook update hook names so that snapshots are the first things done 2016-03-17 19:49:27 -05:00
99_grub-config.hook update README 2016-04-22 20:11:06 -05:00
LICENSE Initial commit 2016-03-11 13:56:09 +00:00
README.md update README 2016-04-22 20:11:06 -05:00
snapper-pac-grub make config generation redirect stderr to /dev/null 2016-03-17 20:15:28 -05:00
snapper-pac-post update descriptions to show just pacman command 2016-04-22 13:52:35 -05:00
snapper-pac-pre update descriptions to show just pacman command 2016-04-22 13:52:35 -05:00

README.md

snap-pac

This makes Arch Linux's pacman use snapper to automatically take a pre and post snapshot before and after pacman transactions, similar to how YaST does with OpenSuse.

Note: The scripts only take snapshots of the subvolume mounted at /; other subvolumes are not included. You must modify the scripts to include other subvolumes. It's recommended that you create subvolumes of directories you do not want included (e.g. /var/cache/pacman/pkg).

The scripts are set up to use the number algorithm. That is, snapper will periodically clean up snapshots tagged with number after reaching a set threshold in the snapper configuration file.

Additionally the package provides a hook to regenerate your GRUB configuration file after every pacman transaction. This is useful when using grub-btrfs. If you don't use grub-btrfs, then you should remove 99_grub-config.hook after installation.

Installation

Install the package from the AUR.

Optionally, install grub-btrfs to populate your GRUB menu with the ability to boot into snapshots.

Usage

Use pacman (and AUR helpers) as normal and watch snapper do its thing. No bash scripts for you to call. No bash aliases to setup.

Because these are pacman hooks, it doesn't matter how you call pacman—whether directly, through an AUR helper, or an alias, snapper will create the snapshots whenever pacman is asked to install, upgrade, or remove a package. The specific pacman command used is noted in the snapper description for the snapshots.

Example

Installing the nano package as normal:

# pacman -S nano
resolving dependencies...
looking for conflicting packages...

Packages (1) nano-2.5.3-1

Total Installed Size:  2.14 MiB

:: Proceed with installation? [Y/n] Y
(1/1) checking keys in keyring                                      [######################################] 100%
(1/1) checking package integrity                                    [######################################] 100%
(1/1) loading package files                                         [######################################] 100%
(1/1) checking for file conflicts                                   [######################################] 100%
(1/1) checking available disk space                                 [######################################] 100%
:: Running pre-transaction hooks...
(1/1) snapper pre snapshot
:: Processing package changes...
(1/1) installing nano                                               [######################################] 100%
:: Running post-transaction hooks...
(1/2) snapper post snapshot
(2/2) generate GRUB configuration file

And here are the snapshots:

# snapper -c root list -t pre-post | tail -n 1
1033  | 1034   | Fri 22 Apr 2016 01:54:13 PM CDT | Fri 22 Apr 2016 01:54:14 PM CDT | pacman -S nano                                  |

What changed?

# snapper -c root status 1033..1034
+..... /etc/nanorc
c..... /etc/snapper/.snap-pac-pre
+..... /usr/bin/nano
+..... /usr/bin/rnano
+..... /usr/share/doc/nano
+..... /usr/share/doc/nano/faq.html
+..... /usr/share/doc/nano/fr
+..... /usr/share/doc/nano/fr/nano.1.html
+..... /usr/share/doc/nano/fr/nanorc.5.html
+..... /usr/share/doc/nano/fr/rnano.1.html

I truncated the above output, but it continues. See the manpage for snapper to see what each symbol means. You can also do snapper diff in the same way—I'll spare you that one.

To undo the upgrade:

# snapper -c root undochange 1033..1034
create:0 modify:3 delete:100

And nano is now gone, along with all the files it changed:

$ pacman -Qi nano
error: package 'nano' was not found

References