Documentation: add hooks/update example.
[git/jrn.git] / config.c
blob697d79f53698d23503d076c7968c5dc72ea8d40a
1 /*
2 * GIT - The information manager from hell
4 * Copyright (C) Linus Torvalds, 2005
5 * Copyright (C) Johannes Schindelin, 2005
7 */
8 #include "cache.h"
9 #include <regex.h>
11 #define MAXNAME (256)
13 static FILE *config_file;
14 static int config_linenr;
15 static int get_next_char(void)
17 int c;
18 FILE *f;
20 c = '\n';
21 if ((f = config_file) != NULL) {
22 c = fgetc(f);
23 if (c == '\r') {
24 /* DOS like systems */
25 c = fgetc(f);
26 if (c != '\n') {
27 ungetc(c, f);
28 c = '\r';
31 if (c == '\n')
32 config_linenr++;
33 if (c == EOF) {
34 config_file = NULL;
35 c = '\n';
38 return c;
41 static char *parse_value(void)
43 static char value[1024];
44 int quote = 0, comment = 0, len = 0, space = 0;
46 for (;;) {
47 int c = get_next_char();
48 if (len >= sizeof(value))
49 return NULL;
50 if (c == '\n') {
51 if (quote)
52 return NULL;
53 value[len] = 0;
54 return value;
56 if (comment)
57 continue;
58 if (isspace(c) && !quote) {
59 space = 1;
60 continue;
62 if (space) {
63 if (len)
64 value[len++] = ' ';
65 space = 0;
67 if (c == '\\') {
68 c = get_next_char();
69 switch (c) {
70 case '\n':
71 continue;
72 case 't':
73 c = '\t';
74 break;
75 case 'b':
76 c = '\b';
77 break;
78 case 'n':
79 c = '\n';
80 break;
81 /* Some characters escape as themselves */
82 case '\\': case '"':
83 break;
84 /* Reject unknown escape sequences */
85 default:
86 return NULL;
88 value[len++] = c;
89 continue;
91 if (c == '"') {
92 quote = 1-quote;
93 continue;
95 if (!quote) {
96 if (c == ';' || c == '#') {
97 comment = 1;
98 continue;
101 value[len++] = c;
105 static int get_value(config_fn_t fn, char *name, unsigned int len)
107 int c;
108 char *value;
110 /* Get the full name */
111 for (;;) {
112 c = get_next_char();
113 if (c == EOF)
114 break;
115 if (!isalnum(c))
116 break;
117 name[len++] = tolower(c);
118 if (len >= MAXNAME)
119 return -1;
121 name[len] = 0;
122 while (c == ' ' || c == '\t')
123 c = get_next_char();
125 value = NULL;
126 if (c != '\n') {
127 if (c != '=')
128 return -1;
129 value = parse_value();
130 if (!value)
131 return -1;
133 return fn(name, value);
136 static int get_base_var(char *name)
138 int baselen = 0;
140 for (;;) {
141 int c = get_next_char();
142 if (c == EOF)
143 return -1;
144 if (c == ']')
145 return baselen;
146 if (!isalnum(c))
147 return -1;
148 if (baselen > MAXNAME / 2)
149 return -1;
150 name[baselen++] = tolower(c);
154 static int git_parse_file(config_fn_t fn)
156 int comment = 0;
157 int baselen = 0;
158 static char var[MAXNAME];
160 for (;;) {
161 int c = get_next_char();
162 if (c == '\n') {
163 /* EOF? */
164 if (!config_file)
165 return 0;
166 comment = 0;
167 continue;
169 if (comment || isspace(c))
170 continue;
171 if (c == '#' || c == ';') {
172 comment = 1;
173 continue;
175 if (c == '[') {
176 baselen = get_base_var(var);
177 if (baselen <= 0)
178 break;
179 var[baselen++] = '.';
180 var[baselen] = 0;
181 continue;
183 if (!isalpha(c))
184 break;
185 var[baselen] = tolower(c);
186 if (get_value(fn, var, baselen+1) < 0)
187 break;
189 die("bad config file line %d", config_linenr);
192 int git_config_int(const char *name, const char *value)
194 if (value && *value) {
195 char *end;
196 int val = strtol(value, &end, 0);
197 if (!*end)
198 return val;
200 die("bad config value for '%s'", name);
203 int git_config_bool(const char *name, const char *value)
205 if (!value)
206 return 1;
207 if (!*value)
208 return 0;
209 if (!strcasecmp(value, "true"))
210 return 1;
211 if (!strcasecmp(value, "false"))
212 return 0;
213 return git_config_int(name, value) != 0;
216 int git_default_config(const char *var, const char *value)
218 /* This needs a better name */
219 if (!strcmp(var, "core.filemode")) {
220 trust_executable_bit = git_config_bool(var, value);
221 return 0;
224 if (!strcmp(var, "core.symrefsonly")) {
225 only_use_symrefs = git_config_bool(var, value);
226 return 0;
229 if (!strcmp(var, "user.name")) {
230 strncpy(git_default_name, value, sizeof(git_default_name));
231 return 0;
234 if (!strcmp(var, "user.email")) {
235 strncpy(git_default_email, value, sizeof(git_default_email));
236 return 0;
239 if (!strcmp(var, "diff.renamelimit")) {
240 diff_rename_limit_default = git_config_int(var, value);
241 return 0;
244 /* Add other config variables here.. */
245 return 0;
248 int git_config(config_fn_t fn)
250 int ret;
251 FILE *f = fopen(git_path("config"), "r");
253 ret = -1;
254 if (f) {
255 config_file = f;
256 config_linenr = 1;
257 ret = git_parse_file(fn);
258 fclose(f);
260 return ret;
264 * Find all the stuff for git_config_set() below.
267 #define MAX_MATCHES 512
269 static struct {
270 int baselen;
271 char* key;
272 regex_t* value_regex;
273 int multi_replace;
274 off_t offset[MAX_MATCHES];
275 enum { START, SECTION_SEEN, SECTION_END_SEEN, KEY_SEEN } state;
276 int seen;
277 } store;
279 static int store_aux(const char* key, const char* value)
281 switch (store.state) {
282 case KEY_SEEN:
283 if (!strcmp(key, store.key) &&
284 (store.value_regex == NULL ||
285 !regexec(store.value_regex, value, 0, NULL, 0))) {
286 if (store.seen == 1 && store.multi_replace == 0) {
287 fprintf(stderr,
288 "Warning: %s has multiple values\n",
289 key);
290 } else if (store.seen >= MAX_MATCHES) {
291 fprintf(stderr, "Too many matches\n");
292 return 1;
295 store.offset[store.seen] = ftell(config_file);
296 store.seen++;
298 break;
299 case SECTION_SEEN:
300 if (strncmp(key, store.key, store.baselen+1)) {
301 store.state = SECTION_END_SEEN;
302 break;
303 } else
304 /* do not increment matches: this is no match */
305 store.offset[store.seen] = ftell(config_file);
306 /* fallthru */
307 case SECTION_END_SEEN:
308 case START:
309 if (!strcmp(key, store.key) &&
310 (store.value_regex == NULL ||
311 !regexec(store.value_regex, value, 0, NULL, 0))) {
312 store.offset[store.seen] = ftell(config_file);
313 store.state = KEY_SEEN;
314 store.seen++;
315 } else if(!strncmp(key, store.key, store.baselen))
316 store.state = SECTION_SEEN;
318 return 0;
321 static void store_write_section(int fd, const char* key)
323 write(fd, "[", 1);
324 write(fd, key, store.baselen);
325 write(fd, "]\n", 2);
328 static void store_write_pair(int fd, const char* key, const char* value)
330 int i;
332 write(fd, "\t", 1);
333 write(fd, key+store.baselen+1,
334 strlen(key+store.baselen+1));
335 write(fd, " = ", 3);
336 for (i = 0; value[i]; i++)
337 switch (value[i]) {
338 case '\n': write(fd, "\\n", 2); break;
339 case '\t': write(fd, "\\t", 2); break;
340 case '"': case '\\': write(fd, "\\", 1);
341 default: write(fd, value+i, 1);
343 write(fd, "\n", 1);
346 static int find_beginning_of_line(const char* contents, int size,
347 int offset_, int* found_bracket)
349 int equal_offset = size, bracket_offset = size;
350 int offset;
352 for (offset = offset_-2; offset > 0
353 && contents[offset] != '\n'; offset--)
354 switch (contents[offset]) {
355 case '=': equal_offset = offset; break;
356 case ']': bracket_offset = offset; break;
358 if (bracket_offset < equal_offset) {
359 *found_bracket = 1;
360 offset = bracket_offset+1;
361 } else
362 offset++;
364 return offset;
367 int git_config_set(const char* key, const char* value)
369 return git_config_set_multivar(key, value, NULL, 0);
373 * If value==NULL, unset in (remove from) config,
374 * if value_regex!=NULL, disregard key/value pairs where value does not match.
375 * if multi_replace==0, nothing, or only one matching key/value is replaced,
376 * else all matching key/values (regardless how many) are removed,
377 * before the new pair is written.
379 * Returns 0 on success.
381 * This function does this:
383 * - it locks the config file by creating ".git/config.lock"
385 * - it then parses the config using store_aux() as validator to find
386 * the position on the key/value pair to replace. If it is to be unset,
387 * it must be found exactly once.
389 * - the config file is mmap()ed and the part before the match (if any) is
390 * written to the lock file, then the changed part and the rest.
392 * - the config file is removed and the lock file rename()d to it.
395 int git_config_set_multivar(const char* key, const char* value,
396 const char* value_regex, int multi_replace)
398 int i;
399 struct stat st;
400 int fd;
401 char* config_file = strdup(git_path("config"));
402 char* lock_file = strdup(git_path("config.lock"));
404 store.multi_replace = multi_replace;
407 * Since "key" actually contains the section name and the real
408 * key name separated by a dot, we have to know where the dot is.
410 for (store.baselen = 0;
411 key[store.baselen] != '.' && key[store.baselen];
412 store.baselen++);
413 if (!key[store.baselen] || !key[store.baselen+1]) {
414 fprintf(stderr, "key does not contain a section: %s\n", key);
415 return 2;
419 * Validate the key and while at it, lower case it for matching.
421 store.key = (char*)malloc(strlen(key)+1);
422 for (i = 0; key[i]; i++)
423 if (i != store.baselen && (!isalnum(key[i]) ||
424 (i == store.baselen+1 && !isalpha(key[i])))) {
425 fprintf(stderr, "invalid key: %s\n", key);
426 free(store.key);
427 return 1;
428 } else
429 store.key[i] = tolower(key[i]);
432 * The lock_file serves a purpose in addition to locking: the new
433 * contents of .git/config will be written into it.
435 fd = open(lock_file, O_WRONLY | O_CREAT | O_EXCL, 0666);
436 if (fd < 0) {
437 fprintf(stderr, "could not lock config file\n");
438 free(store.key);
439 return -1;
443 * If .git/config does not exist yet, write a minimal version.
445 if (stat(config_file, &st)) {
446 static const char contents[] =
447 "#\n"
448 "# This is the config file\n"
449 "#\n"
450 "\n";
452 free(store.key);
454 /* if nothing to unset, error out */
455 if (value == NULL) {
456 close(fd);
457 unlink(lock_file);
458 return 5;
461 store.key = (char*)key;
463 write(fd, contents, sizeof(contents)-1);
464 store_write_section(fd, key);
465 store_write_pair(fd, key, value);
466 } else{
467 int in_fd;
468 char* contents;
469 int i, copy_begin, copy_end, new_line = 0;
471 if (value_regex == NULL)
472 store.value_regex = NULL;
473 else {
474 store.value_regex = (regex_t*)malloc(sizeof(regex_t));
475 if (regcomp(store.value_regex, value_regex,
476 REG_EXTENDED)) {
477 fprintf(stderr, "Invalid pattern: %s",
478 value_regex);
479 free(store.value_regex);
480 return 6;
484 store.offset[0] = 0;
485 store.state = START;
486 store.seen = 0;
489 * After this, store.offset will contain the *end* offset
490 * of the last match, or remain at 0 if no match was found.
491 * As a side effect, we make sure to transform only a valid
492 * existing config file.
494 if (git_config(store_aux)) {
495 fprintf(stderr, "invalid config file\n");
496 free(store.key);
497 if (store.value_regex != NULL) {
498 regfree(store.value_regex);
499 free(store.value_regex);
501 return 3;
504 free(store.key);
505 if (store.value_regex != NULL) {
506 regfree(store.value_regex);
507 free(store.value_regex);
510 /* if nothing to unset, or too many matches, error out */
511 if ((store.seen == 0 && value == NULL) ||
512 (store.seen > 1 && multi_replace == 0)) {
513 close(fd);
514 unlink(lock_file);
515 return 5;
518 in_fd = open(config_file, O_RDONLY, 0666);
519 contents = mmap(NULL, st.st_size, PROT_READ,
520 MAP_PRIVATE, in_fd, 0);
521 close(in_fd);
523 if (store.seen == 0)
524 store.seen = 1;
526 for (i = 0, copy_begin = 0; i < store.seen; i++) {
527 if (store.offset[i] == 0) {
528 store.offset[i] = copy_end = st.st_size;
529 } else if (store.state != KEY_SEEN) {
530 copy_end = store.offset[i];
531 } else
532 copy_end = find_beginning_of_line(
533 contents, st.st_size,
534 store.offset[i]-2, &new_line);
536 /* write the first part of the config */
537 if (copy_end > copy_begin) {
538 write(fd, contents + copy_begin,
539 copy_end - copy_begin);
540 if (new_line)
541 write(fd, "\n", 1);
543 copy_begin = store.offset[i];
546 /* write the pair (value == NULL means unset) */
547 if (value != NULL) {
548 if (store.state == START)
549 store_write_section(fd, key);
550 store_write_pair(fd, key, value);
553 /* write the rest of the config */
554 if (copy_begin < st.st_size)
555 write(fd, contents + copy_begin,
556 st.st_size - copy_begin);
558 munmap(contents, st.st_size);
559 unlink(config_file);
562 close(fd);
564 if (rename(lock_file, config_file) < 0) {
565 fprintf(stderr, "Could not rename the lock file?\n");
566 return 4;
569 return 0;