Andrew's git - gitweb.git/blob - builtin/checkout-index.c

   1/*
   2 * Check-out files from the "current cache directory"
   3 *
   4 * Copyright (C) 2005 Linus Torvalds
   5 *
   6 * Careful: order of argument flags does matter. For example,
   7 *
   8 *      git checkout-index -a -f file.c
   9 *
  10 * Will first check out all files listed in the cache (but not
  11 * overwrite any old ones), and then force-checkout "file.c" a
  12 * second time (ie that one _will_ overwrite any old contents
  13 * with the same filename).
  14 *
  15 * Also, just doing "git checkout-index" does nothing. You probably
  16 * meant "git checkout-index -a". And if you want to force it, you
  17 * want "git checkout-index -f -a".
  18 *
  19 * Intuitiveness is not the goal here. Repeatability is. The
  20 * reason for the "no arguments means no work" thing is that
  21 * from scripts you are supposed to be able to do things like
  22 *
  23 *      find . -name '*.h' -print0 | xargs -0 git checkout-index -f --
  24 *
  25 * or:
  26 *
  27 *      find . -name '*.h' -print0 | git checkout-index -f -z --stdin
  28 *
  29 * which will force all existing *.h files to be replaced with
  30 * their cached copies. If an empty command line implied "all",
  31 * then this would force-refresh everything in the cache, which
  32 * was not the point.
  33 *
  34 * Oh, and the "--" is just a good idea when you know the rest
  35 * will be filenames. Just so that you wouldn't have a filename
  36 * of "-a" causing problems (not possible in the above example,
  37 * but get used to it in scripting!).
  38 */
  39#include "builtin.h"
  40#include "cache.h"
  41#include "quote.h"
  42#include "cache-tree.h"
  43#include "parse-options.h"
  44
  45#define CHECKOUT_ALL 4
  46static int line_termination = '\n';
  47static int checkout_stage; /* default to checkout stage0 */
  48static int to_tempfile;
  49static char topath[4][PATH_MAX + 1];
  50
  51static struct checkout state;
  52
  53static void write_tempfile_record(const char *name, int prefix_length)
  54{
  55        int i;
  56
  57        if (CHECKOUT_ALL == checkout_stage) {
  58                for (i = 1; i < 4; i++) {
  59                        if (i > 1)
  60                                putchar(' ');
  61                        if (topath[i][0])
  62                                fputs(topath[i], stdout);
  63                        else
  64                                putchar('.');
  65                }
  66        } else
  67                fputs(topath[checkout_stage], stdout);
  68
  69        putchar('\t');
  70        write_name_quoted(name + prefix_length, stdout, line_termination);
  71
  72        for (i = 0; i < 4; i++) {
  73                topath[i][0] = 0;
  74        }
  75}
  76
  77static int checkout_file(const char *name, int prefix_length)
  78{
  79        int namelen = strlen(name);
  80        int pos = cache_name_pos(name, namelen);
  81        int has_same_name = 0;
  82        int did_checkout = 0;
  83        int errs = 0;
  84
  85        if (pos < 0)
  86                pos = -pos - 1;
  87
  88        while (pos < active_nr) {
  89                struct cache_entry *ce = active_cache[pos];
  90                if (ce_namelen(ce) != namelen ||
  91                    memcmp(ce->name, name, namelen))
  92                        break;
  93                has_same_name = 1;
  94                pos++;
  95                if (ce_stage(ce) != checkout_stage
  96                    && (CHECKOUT_ALL != checkout_stage || !ce_stage(ce)))
  97                        continue;
  98                did_checkout = 1;
  99                if (checkout_entry(ce, &state,
 100                    to_tempfile ? topath[ce_stage(ce)] : NULL) < 0)
 101                        errs++;
 102        }
 103
 104        if (did_checkout) {
 105                if (to_tempfile)
 106                        write_tempfile_record(name, prefix_length);
 107                return errs > 0 ? -1 : 0;
 108        }
 109
 110        if (!state.quiet) {
 111                fprintf(stderr, "git checkout-index: %s ", name);
 112                if (!has_same_name)
 113                        fprintf(stderr, "is not in the cache");
 114                else if (checkout_stage)
 115                        fprintf(stderr, "does not exist at stage %d",
 116                                checkout_stage);
 117                else
 118                        fprintf(stderr, "is unmerged");
 119                fputc('\n', stderr);
 120        }
 121        return -1;
 122}
 123
 124static void checkout_all(const char *prefix, int prefix_length)
 125{
 126        int i, errs = 0;
 127        struct cache_entry *last_ce = NULL;
 128
 129        for (i = 0; i < active_nr ; i++) {
 130                struct cache_entry *ce = active_cache[i];
 131                if (ce_stage(ce) != checkout_stage
 132                    && (CHECKOUT_ALL != checkout_stage || !ce_stage(ce)))
 133                        continue;
 134                if (prefix && *prefix &&
 135                    (ce_namelen(ce) <= prefix_length ||
 136                     memcmp(prefix, ce->name, prefix_length)))
 137                        continue;
 138                if (last_ce && to_tempfile) {
 139                        if (ce_namelen(last_ce) != ce_namelen(ce)
 140                            || memcmp(last_ce->name, ce->name, ce_namelen(ce)))
 141                                write_tempfile_record(last_ce->name, prefix_length);
 142                }
 143                if (checkout_entry(ce, &state,
 144                    to_tempfile ? topath[ce_stage(ce)] : NULL) < 0)
 145                        errs++;
 146                last_ce = ce;
 147        }
 148        if (last_ce && to_tempfile)
 149                write_tempfile_record(last_ce->name, prefix_length);
 150        if (errs)
 151                /* we have already done our error reporting.
 152                 * exit with the same code as die().
 153                 */
 154                exit(128);
 155}
 156
 157static const char * const builtin_checkout_index_usage[] = {
 158        "git checkout-index [options] [--] [<file>...]",
 159        NULL
 160};
 161
 162static struct lock_file lock_file;
 163
 164static int option_parse_u(const struct option *opt,
 165                              const char *arg, int unset)
 166{
 167        int *newfd = opt->value;
 168
 169        state.refresh_cache = 1;
 170        if (*newfd < 0)
 171                *newfd = hold_locked_index(&lock_file, 1);
 172        return 0;
 173}
 174
 175static int option_parse_z(const struct option *opt,
 176                          const char *arg, int unset)
 177{
 178        if (unset)
 179                line_termination = '\n';
 180        else
 181                line_termination = 0;
 182        return 0;
 183}
 184
 185static int option_parse_prefix(const struct option *opt,
 186                               const char *arg, int unset)
 187{
 188        state.base_dir = arg;
 189        state.base_dir_len = strlen(arg);
 190        return 0;
 191}
 192
 193static int option_parse_stage(const struct option *opt,
 194                              const char *arg, int unset)
 195{
 196        if (!strcmp(arg, "all")) {
 197                to_tempfile = 1;
 198                checkout_stage = CHECKOUT_ALL;
 199        } else {
 200                int ch = arg[0];
 201                if ('1' <= ch && ch <= '3')
 202                        checkout_stage = arg[0] - '0';
 203                else
 204                        die("stage should be between 1 and 3 or all");
 205        }
 206        return 0;
 207}
 208
 209int cmd_checkout_index(int argc, const char **argv, const char *prefix)
 210{
 211        int i;
 212        int newfd = -1;
 213        int all = 0;
 214        int read_from_stdin = 0;
 215        int prefix_length;
 216        int force = 0, quiet = 0, not_new = 0;
 217        struct option builtin_checkout_index_options[] = {
 218                OPT_BOOLEAN('a', "all", &all,
 219                        "checks out all files in the index"),
 220                OPT__FORCE(&force, "forces overwrite of existing files"),
 221                OPT__QUIET(&quiet,
 222                        "no warning for existing files and files not in index"),
 223                OPT_BOOLEAN('n', "no-create", &not_new,
 224                        "don't checkout new files"),
 225                { OPTION_CALLBACK, 'u', "index", &newfd, NULL,
 226                        "update stat information in the index file",
 227                        PARSE_OPT_NOARG, option_parse_u },
 228                { OPTION_CALLBACK, 'z', NULL, NULL, NULL,
 229                        "paths are separated with NUL character",
 230                        PARSE_OPT_NOARG, option_parse_z },
 231                OPT_BOOLEAN(0, "stdin", &read_from_stdin,
 232                        "read list of paths from the standard input"),
 233                OPT_BOOLEAN(0, "temp", &to_tempfile,
 234                        "write the content to temporary files"),
 235                OPT_CALLBACK(0, "prefix", NULL, "string",
 236                        "when creating files, prepend <string>",
 237                        option_parse_prefix),
 238                OPT_CALLBACK(0, "stage", NULL, NULL,
 239                        "copy out the files from named stage",
 240                        option_parse_stage),
 241                OPT_END()
 242        };
 243
 244        if (argc == 2 && !strcmp(argv[1], "-h"))
 245                usage_with_options(builtin_checkout_index_usage,
 246                                   builtin_checkout_index_options);
 247        git_config(git_default_config, NULL);
 248        state.base_dir = "";
 249        prefix_length = prefix ? strlen(prefix) : 0;
 250
 251        if (read_cache() < 0) {
 252                die("invalid cache");
 253        }
 254
 255        argc = parse_options(argc, argv, prefix, builtin_checkout_index_options,
 256                        builtin_checkout_index_usage, 0);
 257        state.force = force;
 258        state.quiet = quiet;
 259        state.not_new = not_new;
 260
 261        if (state.base_dir_len || to_tempfile) {
 262                /* when --prefix is specified we do not
 263                 * want to update cache.
 264                 */
 265                if (state.refresh_cache) {
 266                        rollback_lock_file(&lock_file);
 267                        newfd = -1;
 268                }
 269                state.refresh_cache = 0;
 270        }
 271
 272        /* Check out named files first */
 273        for (i = 0; i < argc; i++) {
 274                const char *arg = argv[i];
 275                const char *p;
 276
 277                if (all)
 278                        die("git checkout-index: don't mix '--all' and explicit filenames");
 279                if (read_from_stdin)
 280                        die("git checkout-index: don't mix '--stdin' and explicit filenames");
 281                p = prefix_path(prefix, prefix_length, arg);
 282                checkout_file(p, prefix_length);
 283                if (p < arg || p > arg + strlen(arg))
 284                        free((char *)p);
 285        }
 286
 287        if (read_from_stdin) {
 288                struct strbuf buf = STRBUF_INIT, nbuf = STRBUF_INIT;
 289
 290                if (all)
 291                        die("git checkout-index: don't mix '--all' and '--stdin'");
 292
 293                while (strbuf_getline(&buf, stdin, line_termination) != EOF) {
 294                        const char *p;
 295                        if (line_termination && buf.buf[0] == '"') {
 296                                strbuf_reset(&nbuf);
 297                                if (unquote_c_style(&nbuf, buf.buf, NULL))
 298                                        die("line is badly quoted");
 299                                strbuf_swap(&buf, &nbuf);
 300                        }
 301                        p = prefix_path(prefix, prefix_length, buf.buf);
 302                        checkout_file(p, prefix_length);
 303                        if (p < buf.buf || p > buf.buf + buf.len)
 304                                free((char *)p);
 305                }
 306                strbuf_release(&nbuf);
 307                strbuf_release(&buf);
 308        }
 309
 310        if (all)
 311                checkout_all(prefix, prefix_length);
 312
 313        if (0 <= newfd &&
 314            (write_cache(newfd, active_cache, active_nr) ||
 315             commit_locked_index(&lock_file)))
 316                die("Unable to write new index file");
 317        return 0;
 318}