* Changes for 3.0.0 release
[BackupPC.git] / bin / BackupPC_archiveHost
1 #!/bin/perl
2 #=============================================================
3 #
4 # BackupPC_archiveHost: Archive files for a single host
5 #
6 # DESCRIPTION
7 #
8 #   Usage: BackupPC_archiveHost tarCreatePath splitPath parPath host bkupNum \
9 #               compPath fileExt splitSize outLoc parFile share
10 #
11 #   This script is run for each host to create an archive.
12 #
13 #   This script is executed by BackupPC_archive, based on the setting
14 #   of $Conf{ArchiveClientCmd}.  This script can be copied and modified
15 #   for site-specific behavior.  Update $Conf{ArchiveClientCmd} to point
16 #   at your customized archive script.
17 #
18 # AUTHOR
19 #   Craig Barratt  <cbarratt@users.sourceforge.net>
20 #   Josh Marshall
21 #
22 # COPYRIGHT
23 #   Copyright (C) 2001-2004  Craig Barratt
24 #
25 #   This program is free software; you can redistribute it and/or modify
26 #   it under the terms of the GNU General Public License as published by
27 #   the Free Software Foundation; either version 2 of the License, or
28 #   (at your option) any later version.
29 #
30 #   This program is distributed in the hope that it will be useful,
31 #   but WITHOUT ANY WARRANTY; without even the implied warranty of
32 #   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
33 #   GNU General Public License for more details.
34 #
35 #   You should have received a copy of the GNU General Public License
36 #   along with this program; if not, write to the Free Software
37 #   Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
38 #
39 #========================================================================
40 #
41 # Version 3.0.0, released 28 Jan 2007.
42 #
43 # See http://backuppc.sourceforge.net.
44 #
45 #========================================================================
46
47 use strict;
48 use File::Path;
49 use lib "/usr/local/BackupPC/lib";
50 use BackupPC::Lib;
51
52 #
53 # Pick up the command-line arguments
54 #
55 if ( @ARGV != 11 ) {
56     print <<EOF;
57 Usage: $0 tarCreatePath splitPath parPath host bkupNum \\
58           compPath fileExt splitSize outLoc parFile share
59 EOF
60     exit(1);
61 }
62 my $tarCreate    = $ARGV[0];
63 my $splitPath    = $ARGV[1];
64 my $parPath      = $ARGV[2];
65 my $host         = $ARGV[3];
66 my $bkupNum      = $ARGV[4];
67 my $compPath     = $ARGV[5];
68 my $fileExt      = $ARGV[6];
69 my $splitSize    = $ARGV[7];
70 my $outLoc       = $ARGV[8];
71 my $parfile      = $ARGV[9];
72 my $share        = $ARGV[10];
73
74 die("BackupPC::Lib->new failed\n") if ( !(my $bpc = BackupPC::Lib->new) );
75
76 #
77 # Make sure the specified programs are executable
78 #
79 foreach my $prog ( ($tarCreate, $compPath, $splitPath, $parPath) ) {
80     next if ( $prog eq "" || -x $prog );
81     print("Error: $prog is not an executable program\n");
82     exit(1);
83 }
84 my $mesg = "Writing tar archive for host $host, backup #$bkupNum";
85
86 #
87 # Build the command we will run
88 #
89 $share  = $bpc->shellEscape($share);
90 $host   = $bpc->shellEscape($host);
91
92 #
93 # We prefer to use /bin/csh because the exit status of a pipeline
94 # is non-zero if any command is non zero.  In contrast, /bin/sh
95 # and /bin/bash use the convention that the exit status is just
96 # the exit status of the last command of the pipeline.
97 #
98 my @shell;
99 if ( -x "/bin/csh" ) {
100     @shell = ("/bin/csh", "-cf");
101 } elsif ( -x "/bin/sh" ) {
102     @shell = ("/bin/sh", "-c");
103 } else {
104     print("Error: Can't find executable /bin/csh or /bin/sh\n");
105     exit(1);
106 }
107 my $cmd = "$tarCreate -t -h $host -n $bkupNum -s $share . ";
108 $cmd   .= "| $compPath " if ( $compPath ne "cat" && $compPath ne "" );
109 if ( -b $outLoc || -c $outLoc || -f $outLoc ) {
110     #
111     # Output file is a device or a regular file, so don't use split
112     #
113     $cmd  .= ">> $outLoc";
114     $mesg .= " to $outLoc";
115 } else {
116     mkpath($outLoc) if ( !-d $outLoc );
117     if ( !-d $outLoc ) {
118         print("Error: unable to create output directory $outLoc\n");
119         exit(1);
120     }
121     if ( $splitSize > 0 && -x $splitPath ) {
122         $cmd  .= "| $splitPath -b $splitSize - $outLoc/$host.$bkupNum.tar$fileExt.";
123         $mesg .= ", split to output files $outLoc/$host.$bkupNum.tar$fileExt.*";
124     } else {
125         $cmd  .= "> $outLoc/$host.$bkupNum.tar$fileExt";
126         $mesg .= " to output file $outLoc/$host.$bkupNum.tar$fileExt";
127     }
128 }
129 print("$mesg\n");
130
131 #
132 # Run the command
133 #
134 my $ret = system(@shell, $cmd);
135 if ( $ret ) {
136     print("Executing: @shell -cf $cmd\n");
137     print("Error: $tarCreate, compress or split failed\n");
138     exit(1);
139 }
140
141 #
142 # Run optional parity file generation (only if the output is a directory,
143 # ie: not a tape device).
144 #
145 if ( -d $outLoc && -x $parPath ) {
146     if ( $parfile != 0 ) {
147         print("Running $parPath to create parity files\n");
148         my $parCmd = "$parPath c -r$parfile $outLoc/$host.$bkupNum.tar$fileExt.par2 $outLoc/$host.$bkupNum.tar$fileExt*";
149         $ret = system($parCmd);
150         if ( $ret ) {
151             print("Executing: $parCmd\n");
152             print("Error: $parPath failed\n");
153             exit(1);
154         }
155     }
156 }