22

✏️ Editing: 800_prune_old_backups.sh

# This file is part of Relax-and-Recover, licensed under the GNU General
# Public License. Refer to the included COPYING for full text of license.
#
# 800_prune_old_backups.sh

# User might specify some additional output options in Borg.
# Output shown by Borg is not controlled by `rear --verbose` nor `rear --debug`
# only, if BORGBACKUP_SHOW_PROGRESS is true.

# shellcheck disable=SC2168
local borg_additional_options=()

BORGBACKUP_PRUNE_SHOW_PROGRESS=${BORGBACKUP_PRUNE_SHOW_PROGRESS:-$BORGBACKUP_SHOW_PROGRESS}
BORGBACKUP_PRUNE_SHOW_STATS=${BORGBACKUP_PRUNE_SHOW_STATS:-$BORGBACKUP_SHOW_STATS}
BORGBACKUP_PRUNE_SHOW_LIST=${BORGBACKUP_PRUNE_SHOW_LIST:-$BORGBACKUP_SHOW_LIST}
BORGBACKUP_PRUNE_SHOW_RC=${BORGBACKUP_PRUNE_SHOW_RC:-$BORGBACKUP_SHOW_RC}

is_true "$BORGBACKUP_PRUNE_SHOW_PROGRESS" && borg_additional_options+=( --progress )
is_true "$BORGBACKUP_PRUNE_SHOW_STATS" && borg_additional_options+=( --stats )
is_true "$BORGBACKUP_PRUNE_SHOW_LIST" && borg_additional_options+=( --list )
is_true "$BORGBACKUP_PRUNE_SHOW_RC" && borg_additional_options+=( --show-rc )

# Borg writes all log output to stderr by default.
# See https://borgbackup.readthedocs.io/en/stable/usage/general.html#logging
#
# If we want to have the Borg log output appearing in the rear logfile, we
# don't have to do anything, since Borg writes all log output to stderr and
# that is what rear is saving in the rear logfile.
#
# If `--progress` is used for `borg prune` we don't want the Borg log output
# in the rear logfile, since it contains control sequences. If not used, we
# want the Borg output in the rear logfile. The amount of log output written by
# Borg is determined by other options above e.g. by `--stats` or `--list`.

# https://github.com/rear/rear/pull/2382#issuecomment-621707505
# Depending on BORGBACKUP_SHOW_PROGRESS and VERBOSE variables
# 3 cases are there for `borg_prune` to log to rear logfile or not.
#
# 1. BORGBACKUP_SHOW_PROGRESS true:
#    No logging to rear logfile because of control characters.
#
# 2. VERBOSE true:
#    stdout (1) is going to rear logfile and copied to real stdout (7).
#    stderr (2) is going to rear logfile and copied to real stderr (8).
#
# 3. Third case:
#    stdout (1) and stderr (2) are untouched, hence only going to rear logfile.

if [[ -n $BORGBACKUP_OPT_PRUNE ]]; then
    # Prune old backup archives according to user settings.
    if is_true "$BORGBACKUP_PRUNE_SHOW_PROGRESS"; then
        borg_prune 0<&6 1>&7 2>&8
    elif is_true "$VERBOSE"; then
        borg_prune 0<&6 1>> >( tee -a "$RUNTIME_LOGFILE" 1>&7 ) 2>> >( tee -a "$RUNTIME_LOGFILE" 1>&8 )
    else
        borg_prune 0<&6
    fi

StopIfError "Borg failed to prune old backup archives, borg rc $?!"
else
    # Pruning is not set.
    Log "Pruning of old backup archives is not set, skipping."
fi

MR SKB