me/snap-pac
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

update readme

Browse source
This commit is contained in:
James Barnett 2016-09-01 07:30:22 -05:00
parent 5417160503
commit 9625951a11
2 changed files with 26 additions and 28 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

18
README.md
View file

@ -37,9 +37,11 @@ The key's fingerprint is `8535CEF3F3C38EE69555BF67E4B5E45AA3B8C5C3`.
## Configuration
Configuration is done via the snapper configuration files, with extra variables
specific to these pacman hooks. The defaults should be suitable for most users.
specific to these pacman hooks. The defaults should be suitable for most users,
so you shouldn't need to change anything.
The following are possible settings you can place in each snapper configuration
file:
file (*e.g.*, `/etc/snapper/configs/root`, etc.):
* `PACMAN_PRE_POST` - perform pacman pre/post snapshots for this configuration.
Default is `"no"` for all configurations, except for the `root` configuration
@ -54,14 +56,10 @@ which is `"yes"`.
The following setting can be changed in the snapper configuration file
`/etc/conf.d/snapper`:
* `PACMAN_ABORT_ON_FAIL` - If for some reason there is an error taking the pre
snapshot, abort the pacman transaction if this is set to `"yes"`. Default is
`"no"`, meaning if there is an error taking the pre snapshot then continue with
the pacman transaction as normal. Any other value than `"no"` is treated the
same as `"yes"`.
These settings only need to be added to the snapper configuration files if you
want to change the default.
* `PACMAN_ABORT_ON_FAIL` - By default this is set to `"no"`. When set to `"yes"`
this causes pacman to abort a transaction if the snap-pac pre hook fails. This
prevents an upgrade/installation/removal from occurring if a pre snapshot cannot be
performed.
## Usage

36
scripts/snap-pac
View file

@ -38,46 +38,46 @@ fi
if [[ $EUID -ne 0 ]]; then
echo -e "$ERRORMSG Script must be run as root."
if [[ $PACMAN_ABORT_ON_FAIL == "no" ]]; then
exit 0
else
if [[ $PACMAN_ABORT_ON_FAIL == "yes" ]]; then
exit 1
else
exit 0
fi
fi
if [[ ! -d /var/run/dbus ]]; then
echo -e "$ERRORMSG Unable to use snapper without dbus. Are you in a chroot environment?"
if [[ $PACMAN_ABORT_ON_FAIL == "no" ]]; then
exit 0
else
if [[ $PACMAN_ABORT_ON_FAIL == "yes" ]]; then
exit 1
else
exit 0
fi
fi
if [[ $# -ne 1 ]]; then
echo -e "$ERRORMSG Only one argument should be passed to this script."
if [[ $PACMAN_ABORT_ON_FAIL == "no" ]]; then
exit 0
else
if [[ $PACMAN_ABORT_ON_FAIL == "yes" ]]; then
exit 1
else
exit 0
fi
fi
if [[ $1 != "pre" ]] && [[ $1 != "post" ]]; then
echo -e "$ERRORMSG First argument should either be 'pre' or 'post'."
if [[ $PACMAN_ABORT_ON_FAIL == "no" ]]; then
exit 0
else
if [[ $PACMAN_ABORT_ON_FAIL == "yes" ]]; then
exit 1
else
exit 0
fi
fi
if [[ -z "$SNAPPER_CONFIGS" ]]; then
echo -e "$WARNINGMSG No snapper configurations found, so not taking any snapshots!"
if [[ $PACMAN_ABORT_ON_FAIL == "no" ]]; then
exit 0
else
if [[ $PACMAN_ABORT_ON_FAIL == "yes" ]]; then
exit 1
else
exit 0
fi
fi
@ -132,10 +132,10 @@ done
if [[ $x -eq 0 ]]; then
echo -e "$WARNINGMSG No snapper configurations are set up for snapshots to be taken!"
if [[ $PACMAN_ABORT_ON_FAIL == "no" ]]; then
exit 0
else
if [[ $PACMAN_ABORT_ON_FAIL == "yes" ]]; then
exit 1
else
exit 0
fi
fi