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 --
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
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!).
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
)
57 if (CHECKOUT_ALL
== checkout_stage
) {
58 for (i
= 1; i
< 4; i
++) {
62 fputs(topath
[i
], stdout
);
67 fputs(topath
[checkout_stage
], stdout
);
70 write_name_quoted(name
+ prefix_length
, stdout
, line_termination
);
72 for (i
= 0; i
< 4; i
++) {
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;
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
))
95 if (ce_stage(ce
) != checkout_stage
96 && (CHECKOUT_ALL
!= checkout_stage
|| !ce_stage(ce
)))
99 if (checkout_entry(ce
, &state
,
100 to_tempfile
? topath
[ce_stage(ce
)] : NULL
) < 0)
106 write_tempfile_record(name
, prefix_length
);
107 return errs
> 0 ? -1 : 0;
111 fprintf(stderr
, "git checkout-index: %s ", name
);
113 fprintf(stderr
, "is not in the cache");
114 else if (checkout_stage
)
115 fprintf(stderr
, "does not exist at stage %d",
118 fprintf(stderr
, "is unmerged");
124 static void checkout_all(const char *prefix
, int prefix_length
)
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
)))
134 if (prefix
&& *prefix
&&
135 (ce_namelen(ce
) <= prefix_length
||
136 memcmp(prefix
, ce
->name
, prefix_length
)))
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)
148 if (last_ce
&& to_tempfile
)
149 write_tempfile_record(last_ce
->name
, prefix_length
);
151 /* we have already done our error reporting.
152 * exit with the same code as die().
157 static const char * const builtin_checkout_index_usage
[] = {
158 "git checkout-index [options] [--] <file>...",
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;
171 *newfd
= hold_locked_index(&lock_file
, 1);
175 static int option_parse_z(const struct option
*opt
,
176 const char *arg
, int unset
)
179 line_termination
= '\n';
181 line_termination
= 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
);
193 static int option_parse_stage(const struct option
*opt
,
194 const char *arg
, int unset
)
196 if (!strcmp(arg
, "all")) {
198 checkout_stage
= CHECKOUT_ALL
;
201 if ('1' <= ch
&& ch
<= '3')
202 checkout_stage
= arg
[0] - '0';
204 die("stage should be between 1 and 3 or all");
209 int cmd_checkout_index(int argc
, const char **argv
, const char *prefix
)
214 int read_from_stdin
= 0;
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"),
223 OPT_BOOLEAN('n', "no-create", ¬_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",
244 git_config(git_default_config
, NULL
);
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);
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
);
266 state
.refresh_cache
= 0;
269 /* Check out named files first */
270 for (i
= 0; i
< argc
; i
++) {
271 const char *arg
= argv
[i
];
275 die("git checkout-index: don't mix '--all' and explicit filenames");
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
))
284 if (read_from_stdin
) {
285 struct strbuf buf
= STRBUF_INIT
, nbuf
= STRBUF_INIT
;
288 die("git checkout-index: don't mix '--all' and '--stdin'");
290 while (strbuf_getline(&buf
, stdin
, line_termination
) != EOF
) {
292 if (line_termination
&& buf
.buf
[0] == '"') {
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
)
303 strbuf_release(&nbuf
);
304 strbuf_release(&buf
);
308 checkout_all(prefix
, prefix_length
);
311 (write_cache(newfd
, active_cache
, active_nr
) ||
312 commit_locked_index(&lock_file
)))
313 die("Unable to write new index file");