4 # Copyright 2004-2022 Free Software Foundation, Inc.
6 # This file is part of GNU tar.
8 # GNU tar is free software; you can redistribute it and/or modify
9 # it under the terms of the GNU General Public License as published by
10 # the Free Software Foundation; either version 3 of the License, or
11 # (at your option) any later version.
13 # GNU tar is distributed in the hope that it will be useful,
14 # but WITHOUT ANY WARRANTY; without even the implied warranty of
15 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 # GNU General Public License for more details.
18 # You should have received a copy of the GNU General Public License
19 # along with this program. If not, see <http://www.gnu.org/licenses/>.
21 PROGNAME
=`basename $0`
22 CONFIGPATH
="$SYSCONFDIR/backup"
23 REMOTEBACKUPDIR
="$SYSCONFDIR/tar-backup"
24 CONFIGFILE
=${CONFIGPATH}/backup-specs
25 DIRLIST
=${CONFIGPATH}/dirs
26 FILELIST
=${CONFIGPATH}/files
27 LOGPATH
=${CONFIGPATH}/log
29 # Default functions for running various magnetic tape commands
46 # The main configuration file may override any of these variables
52 # Insure 'mail' is in PATH.
53 PATH
="/usr/ucb:${PATH}"
55 # Put startdate in the subject line of mailed report, since if it happens
56 # to run longer than 24 hours (as may be the case if someone forgets to put
57 # in the next volume of the tape in adequate time), the backup date won't
58 # appear too misleading.
62 localhost
="`hostname | sed -e 's/\..*//' | tr A-Z a-z`"
64 # Produce a diagnostic output
66 if [ "$VERBOSE" != "" ]; then
67 if [ $VERBOSE -ge $1 ]; then
76 echo "$PROGNAME: $*" >&2
86 sed 's/[^ ]* *\([^ ]*\) *\([^ ]*\).* \([^ ]*\)$/\3-\1-\2/
87 /-[0-9]$/s/\([0-9]\)$/0\1/
100 #ENDIF_DATE_FORMAT_OK
103 # Bail out if we don't have root privileges.
105 if [ ! -w ${ROOT_FS-/} ]; then
106 bailout
"The backup must be run as root or else some files will fail to be dumped."
111 echo "${ROOT_FS}$1" |
tr -s /
115 echo "Directory $1 is not found." >&2
117 The following directories and files are needed for the backup to function:
119 1. Directory with configuration files and file lists:
121 2. Directory for backup log files
123 3. Main configuration file
126 Please, create these and invoke the script again.
131 # Check if the necessary directories exist
132 if [ ! -d $CONFIGPATH ]; then
136 if [ ! -d $LOGPATH ]; then
137 if mkdir
$LOGPATH; then
144 # Get the values of BACKUP_DIRS, BACKUP_FILES, and other variables.
145 if [ ! -r $CONFIGFILE ]; then
146 echo "$PROGNAME: cannot read $CONFIGFILE. Stop." >&2
151 # Environment sanity check
155 if [ x
"${ADMINISTRATOR}" = x
]; then
156 bailout
"ADMINISTRATOR not defined"
159 [ x
"$TAR" = x
] && TAR
=tar
160 [ x
"$SLEEP_TIME" = x
] && SLEEP_TIME
=60
162 if [ x
$VOLNO_FILE = x
]; then
163 bailout
"VOLNO_FILE not specified"
166 if [ -r $DIRLIST ]; then
167 BACKUP_DIRS
="$BACKUP_DIRS `cat $DIRLIST`"
169 if [ -r $FILELIST ]; then
170 BACKUP_FILES
="$BACKUP_FILES `cat $FILELIST`"
173 if [ \
( x
"$BACKUP_DIRS" = x \
) -a \
( x
"$BACKUP_FILES" = x \
) ]; then
174 bailout
"Neither BACKUP_DIRS nor BACKUP_FILES specified"
176 if [ -z "$RSH" ]; then
180 MT_RSH_OPTION
="--rsh-command=$RSH"
182 if [ -z "$TAPE_FILE" ]; then
186 # If TAPE_FILE is a remote device, update mt invocation accordingly
189 *:*) MT
="$MT $MT_RSH_OPTION";;
194 export POSIXLY_CORRECT
199 TAR_PART1
="${TAR} -c --format=gnu --multi-volume --one-file-system --sparse --volno-file=${VOLNO_FILE}"
200 if [ "x$XLIST" != x
]; then
201 TAR_PART1
="${TAR_PART1} \`test -r $REMOTEBACKUPDIR/$XLIST && echo \"--exclude-from $REMOTEBACKUPDIR/$XLIST\"\`"
203 if [ "$RSH_COMMAND" != "" ]; then
204 TAR_PART1
="${TAR_PART1} --rsh-command=$RSH_COMMAND"
206 if [ x
$BLOCKING != x
]; then
207 TAR_PART1
="${TAR_PART1} --blocking=${BLOCKING}"
210 # Only use --info-script if DUMP_REMIND_SCRIPT was defined in backup-specs
211 if [ "x${DUMP_REMIND_SCRIPT}" != "x" ]; then
212 TAR_PART1
="${TAR_PART1} --info-script='${DUMP_REMIND_SCRIPT}'"
215 # Logfile name should be in the form 'log-1993-03-18-level-0'
216 # They go in the directory '@sysconfdir@/log'.
217 # i.e. year-month-date. This format is useful for sorting by name, since
218 # logfiles are intentionally kept online for future reference.
219 LOGFILE
="${LOGPATH}/log-`now`-level-${DUMP_LEVEL}"
224 # FIXME: Replace --list with --extract
225 TAR_PART1
="${TAR} --extract --multi-volume"
226 if [ "$RSH_COMMAND" != "" ]; then
227 TAR_PART1
="${TAR_PART1} --rsh-command=$RSH_COMMAND"
229 if [ x
$BLOCKING != x
]; then
230 TAR_PART1
="${TAR_PART1} --blocking=${BLOCKING}"
233 # Only use --info-script if DUMP_REMIND_SCRIPT was defined in backup-specs
234 if [ "x${DUMP_REMIND_SCRIPT}" != "x" ]; then
235 TAR_PART1
="${TAR_PART1} --info-script='${DUMP_REMIND_SCRIPT}'"
237 LOGFILE
="${LOGPATH}/restore-`now`"
241 if [ "${1}" != "now" ]; then
242 if [ "${1}x" != "x" ]; then
245 spec
="${BACKUP_HOUR}"
248 pausetime
="`date | awk -v spec=\"${spec}\" '
250 split(spec, time, ":")
254 diff = 3600 * (time[1] - now[1]) + 60 * (time[2] - now[2]);
260 echo "${SLEEP_MESSAGE}"
266 echo "$REMOTEBACKUPDIR/${1}.level-${2-$DUMP_LEVEL}"
269 # Prepare a temporary level logfile
270 # usage: make_level_log HOSTNAME
272 if [ "z${localhost}" != "z$1" ] ; then
273 $RSH "$1" mkdir
$REMOTEBACKUPDIR > /dev
/null
2>&1
274 $RSH "$1" rm -f `level_log_name temp`
276 mkdir
$REMOTEBACKUPDIR > /dev
/null
2>&1
277 rm -f `level_log_name temp`
281 # Rename temporary log
282 # usage: flush_level_log HOSTNAME FSNAME
284 message
10 "RENAME: `level_log_name temp` --> `level_log_name $2`"
285 if [ "z${localhost}" != "z$1" ] ; then
286 $RSH "$1" mv -f `level_log_name temp` "`level_log_name $2`"
288 mv -f `level_log_name temp` "`level_log_name $2`"
292 # Return the timestamp of the last backup.
293 # usage: get_dump_time LEVEL
295 ls -r ${LOGPATH}/log-
*-level-$1 \
297 |
sed "s,.*log-\(.*\)-level-$1,\1,"
300 # Do actual backup on a host
301 # usage: backup_host HOSTNAME [TAR_ARGUMENTS]
303 message
10 "ARGS: $@"
306 if [ "z${localhost}" != "z$rhost" ] ; then
307 $RSH "$rhost" ${TAR_PART1} -f "${localhost}:${TAPE_FILE}" $@
309 # Using 'sh -c exec' causes nested quoting and shell substitution
310 # to be handled here in the same way rsh handles it.
311 CMD="exec ${TAR_PART1} -f \"${TAPE_FILE}\" $@
"
312 message 10 "CMD
: $CMD"
321 if [ ${1-$DUMP_LEVEL} -eq 0 ]; then
324 echo "Level
${1-$DUMP_LEVEL}"
329 print_level `expr $DUMP_LEVEL - 1` | tr A-Z a-z
335 message 10 "REMOTE
$rhost: $@
"
336 if [ "x
$rhost" != "x
${localhost}" ] ; then
345 Copyright (C) 2013 Free Software Foundation, Inc.
346 License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>.
347 This is free software: you are free to change and redistribute it.
348 There is NO WARRANTY, to the extent permitted by law.