archive-tar.con commit archive-tar: make write_extended_header() void (560b0e8)
   1/*
   2 * Copyright (c) 2005, 2006 Rene Scharfe
   3 */
   4#include "cache.h"
   5#include "tar.h"
   6#include "archive.h"
   7#include "streaming.h"
   8#include "run-command.h"
   9
  10#define RECORDSIZE      (512)
  11#define BLOCKSIZE       (RECORDSIZE * 20)
  12
  13static char block[BLOCKSIZE];
  14static unsigned long offset;
  15
  16static int tar_umask = 002;
  17
  18static int write_tar_filter_archive(const struct archiver *ar,
  19                                    struct archiver_args *args);
  20
  21/*
  22 * This is the max value that a ustar size header can specify, as it is fixed
  23 * at 11 octal digits. POSIX specifies that we switch to extended headers at
  24 * this size.
  25 *
  26 * Likewise for the mtime (which happens to use a buffer of the same size).
  27 */
  28#define USTAR_MAX_SIZE 077777777777UL
  29#define USTAR_MAX_MTIME 077777777777UL
  30
  31/* writes out the whole block, but only if it is full */
  32static void write_if_needed(void)
  33{
  34        if (offset == BLOCKSIZE) {
  35                write_or_die(1, block, BLOCKSIZE);
  36                offset = 0;
  37        }
  38}
  39
  40/*
  41 * queues up writes, so that all our write(2) calls write exactly one
  42 * full block; pads writes to RECORDSIZE
  43 */
  44static void do_write_blocked(const void *data, unsigned long size)
  45{
  46        const char *buf = data;
  47
  48        if (offset) {
  49                unsigned long chunk = BLOCKSIZE - offset;
  50                if (size < chunk)
  51                        chunk = size;
  52                memcpy(block + offset, buf, chunk);
  53                size -= chunk;
  54                offset += chunk;
  55                buf += chunk;
  56                write_if_needed();
  57        }
  58        while (size >= BLOCKSIZE) {
  59                write_or_die(1, buf, BLOCKSIZE);
  60                size -= BLOCKSIZE;
  61                buf += BLOCKSIZE;
  62        }
  63        if (size) {
  64                memcpy(block + offset, buf, size);
  65                offset += size;
  66        }
  67}
  68
  69static void finish_record(void)
  70{
  71        unsigned long tail;
  72        tail = offset % RECORDSIZE;
  73        if (tail)  {
  74                memset(block + offset, 0, RECORDSIZE - tail);
  75                offset += RECORDSIZE - tail;
  76        }
  77        write_if_needed();
  78}
  79
  80static void write_blocked(const void *data, unsigned long size)
  81{
  82        do_write_blocked(data, size);
  83        finish_record();
  84}
  85
  86/*
  87 * The end of tar archives is marked by 2*512 nul bytes and after that
  88 * follows the rest of the block (if any).
  89 */
  90static void write_trailer(void)
  91{
  92        int tail = BLOCKSIZE - offset;
  93        memset(block + offset, 0, tail);
  94        write_or_die(1, block, BLOCKSIZE);
  95        if (tail < 2 * RECORDSIZE) {
  96                memset(block, 0, offset);
  97                write_or_die(1, block, BLOCKSIZE);
  98        }
  99}
 100
 101/*
 102 * queues up writes, so that all our write(2) calls write exactly one
 103 * full block; pads writes to RECORDSIZE
 104 */
 105static int stream_blocked(const unsigned char *sha1)
 106{
 107        struct git_istream *st;
 108        enum object_type type;
 109        unsigned long sz;
 110        char buf[BLOCKSIZE];
 111        ssize_t readlen;
 112
 113        st = open_istream(sha1, &type, &sz, NULL);
 114        if (!st)
 115                return error("cannot stream blob %s", sha1_to_hex(sha1));
 116        for (;;) {
 117                readlen = read_istream(st, buf, sizeof(buf));
 118                if (readlen <= 0)
 119                        break;
 120                do_write_blocked(buf, readlen);
 121        }
 122        close_istream(st);
 123        if (!readlen)
 124                finish_record();
 125        return readlen;
 126}
 127
 128/*
 129 * pax extended header records have the format "%u %s=%s\n".  %u contains
 130 * the size of the whole string (including the %u), the first %s is the
 131 * keyword, the second one is the value.  This function constructs such a
 132 * string and appends it to a struct strbuf.
 133 */
 134static void strbuf_append_ext_header(struct strbuf *sb, const char *keyword,
 135                                     const char *value, unsigned int valuelen)
 136{
 137        int len, tmp;
 138
 139        /* "%u %s=%s\n" */
 140        len = 1 + 1 + strlen(keyword) + 1 + valuelen + 1;
 141        for (tmp = len; tmp > 9; tmp /= 10)
 142                len++;
 143
 144        strbuf_grow(sb, len);
 145        strbuf_addf(sb, "%u %s=", len, keyword);
 146        strbuf_add(sb, value, valuelen);
 147        strbuf_addch(sb, '\n');
 148}
 149
 150/*
 151 * Like strbuf_append_ext_header, but for numeric values.
 152 */
 153static void strbuf_append_ext_header_uint(struct strbuf *sb,
 154                                          const char *keyword,
 155                                          uintmax_t value)
 156{
 157        char buf[40]; /* big enough for 2^128 in decimal, plus NUL */
 158        int len;
 159
 160        len = xsnprintf(buf, sizeof(buf), "%"PRIuMAX, value);
 161        strbuf_append_ext_header(sb, keyword, buf, len);
 162}
 163
 164static unsigned int ustar_header_chksum(const struct ustar_header *header)
 165{
 166        const unsigned char *p = (const unsigned char *)header;
 167        unsigned int chksum = 0;
 168        while (p < (const unsigned char *)header->chksum)
 169                chksum += *p++;
 170        chksum += sizeof(header->chksum) * ' ';
 171        p += sizeof(header->chksum);
 172        while (p < (const unsigned char *)header + sizeof(struct ustar_header))
 173                chksum += *p++;
 174        return chksum;
 175}
 176
 177static size_t get_path_prefix(const char *path, size_t pathlen, size_t maxlen)
 178{
 179        size_t i = pathlen;
 180        if (i > 1 && path[i - 1] == '/')
 181                i--;
 182        if (i > maxlen)
 183                i = maxlen;
 184        do {
 185                i--;
 186        } while (i > 0 && path[i] != '/');
 187        return i;
 188}
 189
 190static void prepare_header(struct archiver_args *args,
 191                           struct ustar_header *header,
 192                           unsigned int mode, unsigned long size)
 193{
 194        xsnprintf(header->mode, sizeof(header->mode), "%07o", mode & 07777);
 195        xsnprintf(header->size, sizeof(header->size), "%011lo", S_ISREG(mode) ? size : 0);
 196        xsnprintf(header->mtime, sizeof(header->mtime), "%011lo", (unsigned long) args->time);
 197
 198        xsnprintf(header->uid, sizeof(header->uid), "%07o", 0);
 199        xsnprintf(header->gid, sizeof(header->gid), "%07o", 0);
 200        strlcpy(header->uname, "root", sizeof(header->uname));
 201        strlcpy(header->gname, "root", sizeof(header->gname));
 202        xsnprintf(header->devmajor, sizeof(header->devmajor), "%07o", 0);
 203        xsnprintf(header->devminor, sizeof(header->devminor), "%07o", 0);
 204
 205        memcpy(header->magic, "ustar", 6);
 206        memcpy(header->version, "00", 2);
 207
 208        xsnprintf(header->chksum, sizeof(header->chksum), "%07o", ustar_header_chksum(header));
 209}
 210
 211static void write_extended_header(struct archiver_args *args,
 212                                  const unsigned char *sha1,
 213                                  const void *buffer, unsigned long size)
 214{
 215        struct ustar_header header;
 216        unsigned int mode;
 217        memset(&header, 0, sizeof(header));
 218        *header.typeflag = TYPEFLAG_EXT_HEADER;
 219        mode = 0100666;
 220        xsnprintf(header.name, sizeof(header.name), "%s.paxheader", sha1_to_hex(sha1));
 221        prepare_header(args, &header, mode, size);
 222        write_blocked(&header, sizeof(header));
 223        write_blocked(buffer, size);
 224}
 225
 226static int write_tar_entry(struct archiver_args *args,
 227                           const unsigned char *sha1,
 228                           const char *path, size_t pathlen,
 229                           unsigned int mode)
 230{
 231        struct ustar_header header;
 232        struct strbuf ext_header = STRBUF_INIT;
 233        unsigned int old_mode = mode;
 234        unsigned long size, size_in_header;
 235        void *buffer;
 236        int err = 0;
 237
 238        memset(&header, 0, sizeof(header));
 239
 240        if (S_ISDIR(mode) || S_ISGITLINK(mode)) {
 241                *header.typeflag = TYPEFLAG_DIR;
 242                mode = (mode | 0777) & ~tar_umask;
 243        } else if (S_ISLNK(mode)) {
 244                *header.typeflag = TYPEFLAG_LNK;
 245                mode |= 0777;
 246        } else if (S_ISREG(mode)) {
 247                *header.typeflag = TYPEFLAG_REG;
 248                mode = (mode | ((mode & 0100) ? 0777 : 0666)) & ~tar_umask;
 249        } else {
 250                return error("unsupported file mode: 0%o (SHA1: %s)",
 251                             mode, sha1_to_hex(sha1));
 252        }
 253        if (pathlen > sizeof(header.name)) {
 254                size_t plen = get_path_prefix(path, pathlen,
 255                                              sizeof(header.prefix));
 256                size_t rest = pathlen - plen - 1;
 257                if (plen > 0 && rest <= sizeof(header.name)) {
 258                        memcpy(header.prefix, path, plen);
 259                        memcpy(header.name, path + plen + 1, rest);
 260                } else {
 261                        xsnprintf(header.name, sizeof(header.name), "%s.data",
 262                                  sha1_to_hex(sha1));
 263                        strbuf_append_ext_header(&ext_header, "path",
 264                                                 path, pathlen);
 265                }
 266        } else
 267                memcpy(header.name, path, pathlen);
 268
 269        if (S_ISREG(mode) && !args->convert &&
 270            sha1_object_info(sha1, &size) == OBJ_BLOB &&
 271            size > big_file_threshold)
 272                buffer = NULL;
 273        else if (S_ISLNK(mode) || S_ISREG(mode)) {
 274                enum object_type type;
 275                buffer = sha1_file_to_archive(args, path, sha1, old_mode, &type, &size);
 276                if (!buffer)
 277                        return error("cannot read %s", sha1_to_hex(sha1));
 278        } else {
 279                buffer = NULL;
 280                size = 0;
 281        }
 282
 283        if (S_ISLNK(mode)) {
 284                if (size > sizeof(header.linkname)) {
 285                        xsnprintf(header.linkname, sizeof(header.linkname),
 286                                  "see %s.paxheader", sha1_to_hex(sha1));
 287                        strbuf_append_ext_header(&ext_header, "linkpath",
 288                                                 buffer, size);
 289                } else
 290                        memcpy(header.linkname, buffer, size);
 291        }
 292
 293        size_in_header = size;
 294        if (S_ISREG(mode) && size > USTAR_MAX_SIZE) {
 295                size_in_header = 0;
 296                strbuf_append_ext_header_uint(&ext_header, "size", size);
 297        }
 298
 299        prepare_header(args, &header, mode, size_in_header);
 300
 301        if (ext_header.len > 0) {
 302                write_extended_header(args, sha1, ext_header.buf,
 303                                      ext_header.len);
 304        }
 305        strbuf_release(&ext_header);
 306        write_blocked(&header, sizeof(header));
 307        if (S_ISREG(mode) && size > 0) {
 308                if (buffer)
 309                        write_blocked(buffer, size);
 310                else
 311                        err = stream_blocked(sha1);
 312        }
 313        free(buffer);
 314        return err;
 315}
 316
 317static void write_global_extended_header(struct archiver_args *args)
 318{
 319        const unsigned char *sha1 = args->commit_sha1;
 320        struct strbuf ext_header = STRBUF_INIT;
 321        struct ustar_header header;
 322        unsigned int mode;
 323
 324        if (sha1)
 325                strbuf_append_ext_header(&ext_header, "comment",
 326                                         sha1_to_hex(sha1), 40);
 327        if (args->time > USTAR_MAX_MTIME) {
 328                strbuf_append_ext_header_uint(&ext_header, "mtime",
 329                                              args->time);
 330                args->time = USTAR_MAX_MTIME;
 331        }
 332
 333        if (!ext_header.len)
 334                return;
 335
 336        memset(&header, 0, sizeof(header));
 337        *header.typeflag = TYPEFLAG_GLOBAL_HEADER;
 338        mode = 0100666;
 339        xsnprintf(header.name, sizeof(header.name), "pax_global_header");
 340        prepare_header(args, &header, mode, ext_header.len);
 341        write_blocked(&header, sizeof(header));
 342        write_blocked(ext_header.buf, ext_header.len);
 343        strbuf_release(&ext_header);
 344}
 345
 346static struct archiver **tar_filters;
 347static int nr_tar_filters;
 348static int alloc_tar_filters;
 349
 350static struct archiver *find_tar_filter(const char *name, int len)
 351{
 352        int i;
 353        for (i = 0; i < nr_tar_filters; i++) {
 354                struct archiver *ar = tar_filters[i];
 355                if (!strncmp(ar->name, name, len) && !ar->name[len])
 356                        return ar;
 357        }
 358        return NULL;
 359}
 360
 361static int tar_filter_config(const char *var, const char *value, void *data)
 362{
 363        struct archiver *ar;
 364        const char *name;
 365        const char *type;
 366        int namelen;
 367
 368        if (parse_config_key(var, "tar", &name, &namelen, &type) < 0 || !name)
 369                return 0;
 370
 371        ar = find_tar_filter(name, namelen);
 372        if (!ar) {
 373                ar = xcalloc(1, sizeof(*ar));
 374                ar->name = xmemdupz(name, namelen);
 375                ar->write_archive = write_tar_filter_archive;
 376                ar->flags = ARCHIVER_WANT_COMPRESSION_LEVELS;
 377                ALLOC_GROW(tar_filters, nr_tar_filters + 1, alloc_tar_filters);
 378                tar_filters[nr_tar_filters++] = ar;
 379        }
 380
 381        if (!strcmp(type, "command")) {
 382                if (!value)
 383                        return config_error_nonbool(var);
 384                free(ar->data);
 385                ar->data = xstrdup(value);
 386                return 0;
 387        }
 388        if (!strcmp(type, "remote")) {
 389                if (git_config_bool(var, value))
 390                        ar->flags |= ARCHIVER_REMOTE;
 391                else
 392                        ar->flags &= ~ARCHIVER_REMOTE;
 393                return 0;
 394        }
 395
 396        return 0;
 397}
 398
 399static int git_tar_config(const char *var, const char *value, void *cb)
 400{
 401        if (!strcmp(var, "tar.umask")) {
 402                if (value && !strcmp(value, "user")) {
 403                        tar_umask = umask(0);
 404                        umask(tar_umask);
 405                } else {
 406                        tar_umask = git_config_int(var, value);
 407                }
 408                return 0;
 409        }
 410
 411        return tar_filter_config(var, value, cb);
 412}
 413
 414static int write_tar_archive(const struct archiver *ar,
 415                             struct archiver_args *args)
 416{
 417        int err = 0;
 418
 419        write_global_extended_header(args);
 420        err = write_archive_entries(args, write_tar_entry);
 421        if (!err)
 422                write_trailer();
 423        return err;
 424}
 425
 426static int write_tar_filter_archive(const struct archiver *ar,
 427                                    struct archiver_args *args)
 428{
 429        struct strbuf cmd = STRBUF_INIT;
 430        struct child_process filter = CHILD_PROCESS_INIT;
 431        const char *argv[2];
 432        int r;
 433
 434        if (!ar->data)
 435                die("BUG: tar-filter archiver called with no filter defined");
 436
 437        strbuf_addstr(&cmd, ar->data);
 438        if (args->compression_level >= 0)
 439                strbuf_addf(&cmd, " -%d", args->compression_level);
 440
 441        argv[0] = cmd.buf;
 442        argv[1] = NULL;
 443        filter.argv = argv;
 444        filter.use_shell = 1;
 445        filter.in = -1;
 446
 447        if (start_command(&filter) < 0)
 448                die_errno("unable to start '%s' filter", argv[0]);
 449        close(1);
 450        if (dup2(filter.in, 1) < 0)
 451                die_errno("unable to redirect descriptor");
 452        close(filter.in);
 453
 454        r = write_tar_archive(ar, args);
 455
 456        close(1);
 457        if (finish_command(&filter) != 0)
 458                die("'%s' filter reported error", argv[0]);
 459
 460        strbuf_release(&cmd);
 461        return r;
 462}
 463
 464static struct archiver tar_archiver = {
 465        "tar",
 466        write_tar_archive,
 467        ARCHIVER_REMOTE
 468};
 469
 470void init_tar_archiver(void)
 471{
 472        int i;
 473        register_archiver(&tar_archiver);
 474
 475        tar_filter_config("tar.tgz.command", "gzip -cn", NULL);
 476        tar_filter_config("tar.tgz.remote", "true", NULL);
 477        tar_filter_config("tar.tar.gz.command", "gzip -cn", NULL);
 478        tar_filter_config("tar.tar.gz.remote", "true", NULL);
 479        git_config(git_tar_config, NULL);
 480        for (i = 0; i < nr_tar_filters; i++) {
 481                /* omit any filters that never had a command configured */
 482                if (tar_filters[i]->data)
 483                        register_archiver(tar_filters[i]);
 484        }
 485}