git-add/rm doc: Consistently back-quote
[git/dscho.git] / builtin-checkout-index.c
bloba7a5ee10f32d52c7555f85f2dcf6c567425488dd
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 * or:
27 * find . -name '*.h' -print0 | git checkout-index -f -z --stdin
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.
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!).
39 #include "builtin.h"
40 #include "cache.h"
41 #include "quote.h"
42 #include "cache-tree.h"
43 #include "parse-options.h"
45 #define CHECKOUT_ALL 4
46 static int line_termination = '\n';
47 static int checkout_stage; /* default to checkout stage0 */
48 static int to_tempfile;
49 static char topath[4][PATH_MAX + 1];
51 static struct checkout state;
53 static void write_tempfile_record(const char *name, int prefix_length)
55 int i;
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('.');
66 } else
67 fputs(topath[checkout_stage], stdout);
69 putchar('\t');
70 write_name_quoted(name + prefix_length, stdout, line_termination);
72 for (i = 0; i < 4; i++) {
73 topath[i][0] = 0;
77 static int checkout_file(const char *name, int prefix_length)
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;
85 if (pos < 0)
86 pos = -pos - 1;
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++;
104 if (did_checkout) {
105 if (to_tempfile)
106 write_tempfile_record(name, prefix_length);
107 return errs > 0 ? -1 : 0;
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);
121 return -1;
124 static void checkout_all(const char *prefix, int prefix_length)
126 int i, errs = 0;
127 struct cache_entry *last_ce = NULL;
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);
143 if (checkout_entry(ce, &state,
144 to_tempfile ? topath[ce_stage(ce)] : NULL) < 0)
145 errs++;
146 last_ce = ce;
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().
154 exit(128);
157 static const char * const builtin_checkout_index_usage[] = {
158 "git checkout-index [options] [--] <file>...",
159 NULL
162 static struct lock_file lock_file;
164 static int option_parse_u(const struct option *opt,
165 const char *arg, int unset)
167 int *newfd = opt->value;
169 state.refresh_cache = 1;
170 if (*newfd < 0)
171 *newfd = hold_locked_index(&lock_file, 1);
172 return 0;
175 static int option_parse_z(const struct option *opt,
176 const char *arg, int unset)
178 if (unset)
179 line_termination = '\n';
180 else
181 line_termination = 0;
182 return 0;
185 static int option_parse_prefix(const struct option *opt,
186 const char *arg, int unset)
188 state.base_dir = arg;
189 state.base_dir_len = strlen(arg);
190 return 0;
193 static int option_parse_stage(const struct option *opt,
194 const char *arg, int unset)
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");
206 return 0;
209 int cmd_checkout_index(int argc, const char **argv, const char *prefix)
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_BOOLEAN('f', "force", &force,
221 "forces overwrite of existing files"),
222 OPT__QUIET(&quiet),
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()
244 git_config(git_default_config, NULL);
245 state.base_dir = "";
246 prefix_length = prefix ? strlen(prefix) : 0;
248 if (read_cache() < 0) {
249 die("invalid cache");
252 argc = parse_options(argc, argv, prefix, builtin_checkout_index_options,
253 builtin_checkout_index_usage, 0);
254 state.force = force;
255 state.quiet = quiet;
256 state.not_new = not_new;
258 if (state.base_dir_len || to_tempfile) {
259 /* when --prefix is specified we do not
260 * want to update cache.
262 if (state.refresh_cache) {
263 rollback_lock_file(&lock_file);
264 newfd = -1;
266 state.refresh_cache = 0;
269 /* Check out named files first */
270 for (i = 0; i < argc; i++) {
271 const char *arg = argv[i];
272 const char *p;
274 if (all)
275 die("git checkout-index: don't mix '--all' and explicit filenames");
276 if (read_from_stdin)
277 die("git checkout-index: don't mix '--stdin' and explicit filenames");
278 p = prefix_path(prefix, prefix_length, arg);
279 checkout_file(p, prefix_length);
280 if (p < arg || p > arg + strlen(arg))
281 free((char *)p);
284 if (read_from_stdin) {
285 struct strbuf buf = STRBUF_INIT, nbuf = STRBUF_INIT;
287 if (all)
288 die("git checkout-index: don't mix '--all' and '--stdin'");
290 while (strbuf_getline(&buf, stdin, line_termination) != EOF) {
291 const char *p;
292 if (line_termination && buf.buf[0] == '"') {
293 strbuf_reset(&nbuf);
294 if (unquote_c_style(&nbuf, buf.buf, NULL))
295 die("line is badly quoted");
296 strbuf_swap(&buf, &nbuf);
298 p = prefix_path(prefix, prefix_length, buf.buf);
299 checkout_file(p, prefix_length);
300 if (p < buf.buf || p > buf.buf + buf.len)
301 free((char *)p);
303 strbuf_release(&nbuf);
304 strbuf_release(&buf);
307 if (all)
308 checkout_all(prefix, prefix_length);
310 if (0 <= newfd &&
311 (write_cache(newfd, active_cache, active_nr) ||
312 commit_locked_index(&lock_file)))
313 die("Unable to write new index file");
314 return 0;