Fix git(1) link to git-index-pack
[git/mjg.git] / checkout-index.c
blobdab3778a9585bcfde98be436255542df13aacddb
1 /*
2 * Check-out files from the "current cache directory"
4 * Copyright (C) 2005 Linus Torvalds
6 * Careful: order of argument flags does matter. For example,
8 * git-checkout-index -a -f file.c
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).
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".
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
23 * find . -name '*.h' -print0 | xargs -0 git-checkout-index -f --
25 * which will force all existing *.h files to be replaced with
26 * their cached copies. If an empty command line implied "all",
27 * then this would force-refresh everything in the cache, which
28 * was not the point.
30 * Oh, and the "--" is just a good idea when you know the rest
31 * will be filenames. Just so that you wouldn't have a filename
32 * of "-a" causing problems (not possible in the above example,
33 * but get used to it in scripting!).
35 #include "cache.h"
37 static struct checkout state = {
38 .base_dir = "",
39 .base_dir_len = 0,
40 .force = 0,
41 .quiet = 0,
42 .not_new = 0,
43 .refresh_cache = 0,
46 static int checkout_file(const char *name)
48 int pos = cache_name_pos(name, strlen(name));
49 if (pos < 0) {
50 if (!state.quiet) {
51 pos = -pos - 1;
52 fprintf(stderr,
53 "git-checkout-index: %s is %s.\n",
54 name,
55 (pos < active_nr &&
56 !strcmp(active_cache[pos]->name, name)) ?
57 "unmerged" : "not in the cache");
59 return -1;
61 return checkout_entry(active_cache[pos], &state);
64 static int checkout_all(void)
66 int i, errs = 0;
68 for (i = 0; i < active_nr ; i++) {
69 struct cache_entry *ce = active_cache[i];
70 if (ce_stage(ce))
71 continue;
72 if (checkout_entry(ce, &state) < 0)
73 errs++;
75 if (errs)
76 /* we have already done our error reporting.
77 * exit with the same code as die().
79 exit(128);
80 return 0;
83 static const char checkout_cache_usage[] =
84 "git-checkout-index [-u] [-q] [-a] [-f] [-n] [--prefix=<string>] [--] <file>...";
86 static struct cache_file cache_file;
88 int main(int argc, char **argv)
90 int i;
91 int newfd = -1;
92 int all = 0;
94 if (read_cache() < 0) {
95 die("invalid cache");
98 for (i = 1; i < argc; i++) {
99 const char *arg = argv[i];
101 if (!strcmp(arg, "--")) {
102 i++;
103 break;
105 if (!strcmp(arg, "-a") || !strcmp(arg, "--all")) {
106 all = 1;
107 continue;
109 if (!strcmp(arg, "-f") || !strcmp(arg, "--force")) {
110 state.force = 1;
111 continue;
113 if (!strcmp(arg, "-q") || !strcmp(arg, "--quiet")) {
114 state.quiet = 1;
115 continue;
117 if (!strcmp(arg, "-n") || !strcmp(arg, "--no-create")) {
118 state.not_new = 1;
119 continue;
121 if (!strcmp(arg, "-u") || !strcmp(arg, "--index")) {
122 state.refresh_cache = 1;
123 if (newfd < 0)
124 newfd = hold_index_file_for_update
125 (&cache_file,
126 get_index_file());
127 if (newfd < 0)
128 die("cannot open index.lock file.");
129 continue;
131 if (!memcmp(arg, "--prefix=", 9)) {
132 state.base_dir = arg+9;
133 state.base_dir_len = strlen(state.base_dir);
134 continue;
136 if (arg[0] == '-')
137 usage(checkout_cache_usage);
138 break;
141 if (state.base_dir_len) {
142 /* when --prefix is specified we do not
143 * want to update cache.
145 if (state.refresh_cache) {
146 close(newfd); newfd = -1;
147 rollback_index_file(&cache_file);
149 state.refresh_cache = 0;
152 /* Check out named files first */
153 for ( ; i < argc; i++) {
154 const char *arg = argv[i];
156 if (all)
157 die("git-checkout-index: don't mix '--all' and explicit filenames");
158 checkout_file(arg);
161 if (all)
162 checkout_all();
164 if (0 <= newfd &&
165 (write_cache(newfd, active_cache, active_nr) ||
166 commit_index_file(&cache_file)))
167 die("Unable to write new cachefile");
168 return 0;