Fix minor grammatical typos in the git-gc man page
[alt-git.git] / builtin-checkout-index.c
blob8460f97b6637127d78b58caf2e29d25f3ad0b5a0
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 "cache.h"
40 #include "strbuf.h"
41 #include "quote.h"
42 #include "cache-tree.h"
44 #define CHECKOUT_ALL 4
45 static int line_termination = '\n';
46 static int checkout_stage; /* default to checkout stage0 */
47 static int to_tempfile;
48 static char topath[4][PATH_MAX + 1];
50 static struct checkout state;
52 static void write_tempfile_record(const char *name, int prefix_length)
54 int i;
56 if (CHECKOUT_ALL == checkout_stage) {
57 for (i = 1; i < 4; i++) {
58 if (i > 1)
59 putchar(' ');
60 if (topath[i][0])
61 fputs(topath[i], stdout);
62 else
63 putchar('.');
65 } else
66 fputs(topath[checkout_stage], stdout);
68 putchar('\t');
69 write_name_quoted("", 0, name + prefix_length,
70 line_termination, stdout);
71 putchar(line_termination);
73 for (i = 0; i < 4; i++) {
74 topath[i][0] = 0;
78 static int checkout_file(const char *name, int prefix_length)
80 int namelen = strlen(name);
81 int pos = cache_name_pos(name, namelen);
82 int has_same_name = 0;
83 int did_checkout = 0;
84 int errs = 0;
86 if (pos < 0)
87 pos = -pos - 1;
89 while (pos < active_nr) {
90 struct cache_entry *ce = active_cache[pos];
91 if (ce_namelen(ce) != namelen ||
92 memcmp(ce->name, name, namelen))
93 break;
94 has_same_name = 1;
95 pos++;
96 if (ce_stage(ce) != checkout_stage
97 && (CHECKOUT_ALL != checkout_stage || !ce_stage(ce)))
98 continue;
99 did_checkout = 1;
100 if (checkout_entry(ce, &state,
101 to_tempfile ? topath[ce_stage(ce)] : NULL) < 0)
102 errs++;
105 if (did_checkout) {
106 if (to_tempfile)
107 write_tempfile_record(name, prefix_length);
108 return errs > 0 ? -1 : 0;
111 if (!state.quiet) {
112 fprintf(stderr, "git-checkout-index: %s ", name);
113 if (!has_same_name)
114 fprintf(stderr, "is not in the cache");
115 else if (checkout_stage)
116 fprintf(stderr, "does not exist at stage %d",
117 checkout_stage);
118 else
119 fprintf(stderr, "is unmerged");
120 fputc('\n', stderr);
122 return -1;
125 static void checkout_all(const char *prefix, int prefix_length)
127 int i, errs = 0;
128 struct cache_entry* last_ce = NULL;
130 for (i = 0; i < active_nr ; i++) {
131 struct cache_entry *ce = active_cache[i];
132 if (ce_stage(ce) != checkout_stage
133 && (CHECKOUT_ALL != checkout_stage || !ce_stage(ce)))
134 continue;
135 if (prefix && *prefix &&
136 (ce_namelen(ce) <= prefix_length ||
137 memcmp(prefix, ce->name, prefix_length)))
138 continue;
139 if (last_ce && to_tempfile) {
140 if (ce_namelen(last_ce) != ce_namelen(ce)
141 || memcmp(last_ce->name, ce->name, ce_namelen(ce)))
142 write_tempfile_record(last_ce->name, prefix_length);
144 if (checkout_entry(ce, &state,
145 to_tempfile ? topath[ce_stage(ce)] : NULL) < 0)
146 errs++;
147 last_ce = ce;
149 if (last_ce && to_tempfile)
150 write_tempfile_record(last_ce->name, prefix_length);
151 if (errs)
152 /* we have already done our error reporting.
153 * exit with the same code as die().
155 exit(128);
158 static const char checkout_cache_usage[] =
159 "git-checkout-index [-u] [-q] [-a] [-f] [-n] [--stage=[123]|all] [--prefix=<string>] [--temp] [--] <file>...";
161 static struct lock_file lock_file;
163 int cmd_checkout_index(int argc, const char **argv, const char *prefix)
165 int i;
166 int newfd = -1;
167 int all = 0;
168 int read_from_stdin = 0;
169 int prefix_length;
171 git_config(git_default_config);
172 state.base_dir = "";
173 prefix_length = prefix ? strlen(prefix) : 0;
175 if (read_cache() < 0) {
176 die("invalid cache");
179 for (i = 1; i < argc; i++) {
180 const char *arg = argv[i];
182 if (!strcmp(arg, "--")) {
183 i++;
184 break;
186 if (!strcmp(arg, "-a") || !strcmp(arg, "--all")) {
187 all = 1;
188 continue;
190 if (!strcmp(arg, "-f") || !strcmp(arg, "--force")) {
191 state.force = 1;
192 continue;
194 if (!strcmp(arg, "-q") || !strcmp(arg, "--quiet")) {
195 state.quiet = 1;
196 continue;
198 if (!strcmp(arg, "-n") || !strcmp(arg, "--no-create")) {
199 state.not_new = 1;
200 continue;
202 if (!strcmp(arg, "-u") || !strcmp(arg, "--index")) {
203 state.refresh_cache = 1;
204 if (newfd < 0)
205 newfd = hold_locked_index(&lock_file, 1);
206 continue;
208 if (!strcmp(arg, "-z")) {
209 line_termination = 0;
210 continue;
212 if (!strcmp(arg, "--stdin")) {
213 if (i != argc - 1)
214 die("--stdin must be at the end");
215 read_from_stdin = 1;
216 i++; /* do not consider arg as a file name */
217 break;
219 if (!strcmp(arg, "--temp")) {
220 to_tempfile = 1;
221 continue;
223 if (!prefixcmp(arg, "--prefix=")) {
224 state.base_dir = arg+9;
225 state.base_dir_len = strlen(state.base_dir);
226 continue;
228 if (!prefixcmp(arg, "--stage=")) {
229 if (!strcmp(arg + 8, "all")) {
230 to_tempfile = 1;
231 checkout_stage = CHECKOUT_ALL;
232 } else {
233 int ch = arg[8];
234 if ('1' <= ch && ch <= '3')
235 checkout_stage = arg[8] - '0';
236 else
237 die("stage should be between 1 and 3 or all");
239 continue;
241 if (arg[0] == '-')
242 usage(checkout_cache_usage);
243 break;
246 if (state.base_dir_len || to_tempfile) {
247 /* when --prefix is specified we do not
248 * want to update cache.
250 if (state.refresh_cache) {
251 close(newfd); newfd = -1;
252 rollback_lock_file(&lock_file);
254 state.refresh_cache = 0;
257 /* Check out named files first */
258 for ( ; i < argc; i++) {
259 const char *arg = argv[i];
260 const char *p;
262 if (all)
263 die("git-checkout-index: don't mix '--all' and explicit filenames");
264 if (read_from_stdin)
265 die("git-checkout-index: don't mix '--stdin' and explicit filenames");
266 p = prefix_path(prefix, prefix_length, arg);
267 checkout_file(p, prefix_length);
268 if (p < arg || p > arg + strlen(arg))
269 free((char*)p);
272 if (read_from_stdin) {
273 struct strbuf buf;
274 if (all)
275 die("git-checkout-index: don't mix '--all' and '--stdin'");
276 strbuf_init(&buf);
277 while (1) {
278 char *path_name;
279 const char *p;
281 read_line(&buf, stdin, line_termination);
282 if (buf.eof)
283 break;
284 if (line_termination && buf.buf[0] == '"')
285 path_name = unquote_c_style(buf.buf, NULL);
286 else
287 path_name = buf.buf;
288 p = prefix_path(prefix, prefix_length, path_name);
289 checkout_file(p, prefix_length);
290 if (p < path_name || p > path_name + strlen(path_name))
291 free((char *)p);
292 if (path_name != buf.buf)
293 free(path_name);
297 if (all)
298 checkout_all(prefix, prefix_length);
300 if (0 <= newfd &&
301 (write_cache(newfd, active_cache, active_nr) ||
302 close(newfd) || commit_locked_index(&lock_file)))
303 die("Unable to write new index file");
304 return 0;