1 /* Cumulus: Smart Filesystem Backup to Dumb Servers
3 * Copyright (C) 2008 The Regents of the University of California
4 * Written by Michael Vrable <mvrable@cs.ucsd.edu>
6 * This program is free software; you can redistribute it and/or modify
7 * it under the terms of the GNU General Public License as published by
8 * the Free Software Foundation; either version 2 of the License, or
9 * (at your option) any later version.
11 * This program is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 * GNU General Public License for more details.
16 * You should have received a copy of the GNU General Public License along
17 * with this program; if not, write to the Free Software Foundation, Inc.,
18 * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
21 /* Backup data is stored in a collection of objects, which are grouped together
22 * into segments for storage purposes. This implementation of the object store
23 * represents segments as TAR files and objects as files within them. */
28 #include <sys/types.h>
30 #include <sys/resource.h>
53 /* Default filter program is bzip2 */
54 const char *filter_program = "bzip2 -c";
55 const char *filter_extension = ".bz2";
57 static void cloexec(int fd)
59 long flags = fcntl(fd, F_GETFD);
64 fcntl(fd, F_SETFD, flags | FD_CLOEXEC);
67 Tarfile::Tarfile(RemoteFile *file, const string &segment)
71 assert(sizeof(struct tar_header) == TAR_BLOCK_SIZE);
74 real_fd = file->get_fd();
75 filter_fd = spawn_filter(real_fd, filter_program, &filter_pid);
80 char buf[TAR_BLOCK_SIZE];
82 /* Append the EOF marker: two blocks filled with nulls. */
83 memset(buf, 0, sizeof(buf));
84 tar_write(buf, TAR_BLOCK_SIZE);
85 tar_write(buf, TAR_BLOCK_SIZE);
87 if (close(filter_fd) != 0)
88 throw IOException("Error closing Tarfile");
90 /* ...and wait for filter process to finish. */
92 waitpid(filter_pid, &status, 0);
94 if (!WIFEXITED(status) || WEXITSTATUS(status) != 0) {
95 throw IOException("Filter process error");
101 /* Launch a child process which can act as a filter (compress, encrypt, etc.)
102 * on the TAR output. The file descriptor to which output should be written
103 * must be specified; the return value is the file descriptor which will be
104 * attached to the standard input of the filter program. */
105 int spawn_filter(int fd_out, const char *program, pid_t *filter_pid)
110 /* Create a pipe for communicating with the filter process. */
112 throw IOException("Unable to create pipe for filter");
115 /* Create a child process which can exec() the filter program. */
118 throw IOException("Unable to fork filter process");
124 if (filter_pid != NULL)
127 /* Child process. Rearrange file descriptors. stdin is fds[0], stdout
128 * is fd_out, stderr is unchanged. */
131 if (dup2(fds[0], 0) < 0)
135 if (dup2(fd_out, 1) < 0)
139 /* Exec the filter program. */
140 execlp("/bin/sh", "/bin/sh", "-c", program, NULL);
142 /* Should not reach here except for error cases. */
143 fprintf(stderr, "Could not exec filter: %m\n");
150 void Tarfile::tar_write(const char *data, size_t len)
155 int res = write(filter_fd, data, len);
160 fprintf(stderr, "Write error: %m\n");
161 throw IOException("Write error");
169 void Tarfile::write_object(int id, const char *data, size_t len)
171 struct tar_header header;
172 memset(&header, 0, sizeof(header));
175 sprintf(buf, "%08x", id);
176 string path = segment_name + "/" + buf;
178 assert(path.size() < 100);
179 memcpy(header.name, path.data(), path.size());
180 sprintf(header.mode, "%07o", 0600);
181 sprintf(header.uid, "%07o", 0);
182 sprintf(header.gid, "%07o", 0);
183 sprintf(header.size, "%011o", len);
184 sprintf(header.mtime, "%011o", (int)time(NULL));
185 header.typeflag = '0';
186 strcpy(header.magic, "ustar ");
187 strcpy(header.uname, "root");
188 strcpy(header.gname, "root");
190 memset(header.chksum, ' ', sizeof(header.chksum));
192 for (int i = 0; i < TAR_BLOCK_SIZE; i++) {
193 checksum += ((uint8_t *)&header)[i];
195 sprintf(header.chksum, "%06o", checksum);
197 tar_write((const char *)&header, TAR_BLOCK_SIZE);
202 tar_write(data, len);
204 char padbuf[TAR_BLOCK_SIZE];
205 size_t blocks = (len + TAR_BLOCK_SIZE - 1) / TAR_BLOCK_SIZE;
206 size_t padding = blocks * TAR_BLOCK_SIZE - len;
207 memset(padbuf, 0, padding);
208 tar_write(padbuf, padding);
211 /* Estimate the size based on the size of the actual output file on disk.
212 * However, it might be the case that the filter program is buffering all its
213 * data, and might potentially not write a single byte until we have closed
214 * our end of the pipe. If we don't do so until we see data written, we have
215 * a problem. So, arbitrarily pick an upper bound on the compression ratio
216 * that the filter will achieve (128:1), and return a size estimate which is
217 * the larger of a) bytes actually seen written to disk, and b) input
219 size_t Tarfile::size_estimate()
223 if (fstat(real_fd, &statbuf) == 0)
224 return max((int64_t)statbuf.st_size, (int64_t)(size / 128));
226 /* Couldn't stat the file on disk, so just return the actual number of
227 * bytes, before compression. */
231 static const size_t SEGMENT_SIZE = 4 * 1024 * 1024;
233 /* Backup size summary: segment type -> (uncompressed size, compressed size) */
234 static map<string, pair<int64_t, int64_t> > group_sizes;
236 ObjectReference TarSegmentStore::write_object(const char *data, size_t len,
237 const std::string &group)
239 struct segment_info *segment;
241 // Find the segment into which the object should be written, looking up by
242 // group. If no segment exists yet, create one.
243 if (segments.find(group) == segments.end()) {
244 segment = new segment_info;
246 segment->name = generate_uuid();
247 segment->group = group;
248 segment->basename = segment->name + ".tar";
249 segment->basename += filter_extension;
252 segment->rf = remote->alloc_file(segment->basename, "segments");
253 segment->file = new Tarfile(segment->rf, segment->name);
255 segments[group] = segment;
257 segment = segments[group];
260 int id = segment->count;
262 sprintf(id_buf, "%08x", id);
264 segment->file->write_object(id, data, len);
266 segment->size += len;
268 group_sizes[group].first += len;
270 ObjectReference ref(segment->name, id_buf);
272 // If this segment meets or exceeds the size target, close it so that
273 // future objects will go into a new segment.
274 if (segment->file->size_estimate() >= SEGMENT_SIZE)
275 close_segment(group);
280 void TarSegmentStore::sync()
282 while (!segments.empty())
283 close_segment(segments.begin()->first);
286 void TarSegmentStore::dump_stats()
288 printf("Data written:\n");
289 for (map<string, pair<int64_t, int64_t> >::iterator i = group_sizes.begin();
290 i != group_sizes.end(); ++i) {
291 printf(" %s: %lld (%lld compressed)\n", i->first.c_str(),
292 i->second.first, i->second.second);
296 void TarSegmentStore::close_segment(const string &group)
298 struct segment_info *segment = segments[group];
300 delete segment->file;
303 SHA1Checksum segment_checksum;
304 if (segment_checksum.process_file(segment->rf->get_local_path().c_str())) {
305 string checksum = segment_checksum.checksum_str();
306 db->SetSegmentChecksum(segment->name, segment->basename, checksum,
310 struct stat stat_buf;
311 if (stat(segment->rf->get_local_path().c_str(), &stat_buf) == 0) {
312 group_sizes[segment->group].second += stat_buf.st_size;
318 segments.erase(segments.find(group));
322 string TarSegmentStore::object_reference_to_segment(const string &object)
327 LbsObject::LbsObject()
328 : group(""), data(NULL), data_len(0), written(false)
332 LbsObject::~LbsObject()
336 void LbsObject::write(TarSegmentStore *store)
338 assert(data != NULL);
341 ref = store->write_object(data, data_len, group);
345 void LbsObject::checksum()
350 hash.process(data, data_len);
351 ref.set_checksum(hash.checksum_str());