]>
Commit | Line | Data |
---|---|---|
10bea152 JS |
1 | /* |
2 | * GIT - The information manager from hell | |
3 | * | |
4 | * Copyright (C) Linus Torvalds, 2005 | |
5 | * Copyright (C) Johannes Schindelin, 2005 | |
6 | * | |
7 | */ | |
17712991 | 8 | #include "cache.h" |
7f0e39fa | 9 | #include "exec_cmd.h" |
17712991 LT |
10 | |
11 | #define MAXNAME (256) | |
12 | ||
13 | static FILE *config_file; | |
0dccc7dc | 14 | static const char *config_file_name; |
17712991 | 15 | static int config_linenr; |
02e5ba4a | 16 | static int config_file_eof; |
960ccca6 DH |
17 | static int zlib_compression_seen; |
18 | ||
17712991 LT |
19 | static int get_next_char(void) |
20 | { | |
21 | int c; | |
22 | FILE *f; | |
23 | ||
24 | c = '\n'; | |
25 | if ((f = config_file) != NULL) { | |
26 | c = fgetc(f); | |
db2c075d JH |
27 | if (c == '\r') { |
28 | /* DOS like systems */ | |
29 | c = fgetc(f); | |
30 | if (c != '\n') { | |
31 | ungetc(c, f); | |
32 | c = '\r'; | |
33 | } | |
34 | } | |
17712991 LT |
35 | if (c == '\n') |
36 | config_linenr++; | |
37 | if (c == EOF) { | |
02e5ba4a | 38 | config_file_eof = 1; |
17712991 LT |
39 | c = '\n'; |
40 | } | |
41 | } | |
42 | return c; | |
43 | } | |
44 | ||
45 | static char *parse_value(void) | |
46 | { | |
47 | static char value[1024]; | |
48 | int quote = 0, comment = 0, len = 0, space = 0; | |
49 | ||
50 | for (;;) { | |
51 | int c = get_next_char(); | |
52 | if (len >= sizeof(value)) | |
53 | return NULL; | |
54 | if (c == '\n') { | |
55 | if (quote) | |
56 | return NULL; | |
57 | value[len] = 0; | |
58 | return value; | |
59 | } | |
60 | if (comment) | |
61 | continue; | |
62 | if (isspace(c) && !quote) { | |
63 | space = 1; | |
64 | continue; | |
65 | } | |
7ebdba61 JS |
66 | if (!quote) { |
67 | if (c == ';' || c == '#') { | |
68 | comment = 1; | |
69 | continue; | |
70 | } | |
71 | } | |
17712991 LT |
72 | if (space) { |
73 | if (len) | |
74 | value[len++] = ' '; | |
75 | space = 0; | |
76 | } | |
77 | if (c == '\\') { | |
78 | c = get_next_char(); | |
79 | switch (c) { | |
80 | case '\n': | |
81 | continue; | |
82 | case 't': | |
83 | c = '\t'; | |
84 | break; | |
85 | case 'b': | |
86 | c = '\b'; | |
87 | break; | |
88 | case 'n': | |
89 | c = '\n'; | |
90 | break; | |
5cbb401d LT |
91 | /* Some characters escape as themselves */ |
92 | case '\\': case '"': | |
93 | break; | |
94 | /* Reject unknown escape sequences */ | |
95 | default: | |
96 | return NULL; | |
17712991 LT |
97 | } |
98 | value[len++] = c; | |
99 | continue; | |
100 | } | |
101 | if (c == '"') { | |
102 | quote = 1-quote; | |
103 | continue; | |
104 | } | |
17712991 LT |
105 | value[len++] = c; |
106 | } | |
107 | } | |
108 | ||
38c5afa8 LT |
109 | static inline int iskeychar(int c) |
110 | { | |
111 | return isalnum(c) || c == '-'; | |
112 | } | |
113 | ||
17712991 LT |
114 | static int get_value(config_fn_t fn, char *name, unsigned int len) |
115 | { | |
116 | int c; | |
117 | char *value; | |
118 | ||
119 | /* Get the full name */ | |
120 | for (;;) { | |
121 | c = get_next_char(); | |
02e5ba4a | 122 | if (config_file_eof) |
17712991 | 123 | break; |
38c5afa8 | 124 | if (!iskeychar(c)) |
17712991 LT |
125 | break; |
126 | name[len++] = tolower(c); | |
127 | if (len >= MAXNAME) | |
128 | return -1; | |
129 | } | |
130 | name[len] = 0; | |
131 | while (c == ' ' || c == '\t') | |
132 | c = get_next_char(); | |
133 | ||
134 | value = NULL; | |
135 | if (c != '\n') { | |
136 | if (c != '=') | |
137 | return -1; | |
138 | value = parse_value(); | |
139 | if (!value) | |
140 | return -1; | |
141 | } | |
142 | return fn(name, value); | |
143 | } | |
144 | ||
d14f7764 LT |
145 | static int get_extended_base_var(char *name, int baselen, int c) |
146 | { | |
147 | do { | |
148 | if (c == '\n') | |
149 | return -1; | |
150 | c = get_next_char(); | |
151 | } while (isspace(c)); | |
152 | ||
153 | /* We require the format to be '[base "extension"]' */ | |
154 | if (c != '"') | |
155 | return -1; | |
156 | name[baselen++] = '.'; | |
157 | ||
158 | for (;;) { | |
159 | int c = get_next_char(); | |
160 | if (c == '\n') | |
161 | return -1; | |
162 | if (c == '"') | |
163 | break; | |
164 | if (c == '\\') { | |
165 | c = get_next_char(); | |
166 | if (c == '\n') | |
167 | return -1; | |
168 | } | |
169 | name[baselen++] = c; | |
170 | if (baselen > MAXNAME / 2) | |
171 | return -1; | |
172 | } | |
173 | ||
174 | /* Final ']' */ | |
175 | if (get_next_char() != ']') | |
176 | return -1; | |
177 | return baselen; | |
178 | } | |
179 | ||
17712991 LT |
180 | static int get_base_var(char *name) |
181 | { | |
182 | int baselen = 0; | |
183 | ||
184 | for (;;) { | |
185 | int c = get_next_char(); | |
02e5ba4a | 186 | if (config_file_eof) |
17712991 LT |
187 | return -1; |
188 | if (c == ']') | |
189 | return baselen; | |
d14f7764 LT |
190 | if (isspace(c)) |
191 | return get_extended_base_var(name, baselen, c); | |
38c5afa8 | 192 | if (!iskeychar(c) && c != '.') |
17712991 LT |
193 | return -1; |
194 | if (baselen > MAXNAME / 2) | |
195 | return -1; | |
196 | name[baselen++] = tolower(c); | |
197 | } | |
198 | } | |
199 | ||
200 | static int git_parse_file(config_fn_t fn) | |
201 | { | |
202 | int comment = 0; | |
203 | int baselen = 0; | |
204 | static char var[MAXNAME]; | |
205 | ||
206 | for (;;) { | |
207 | int c = get_next_char(); | |
208 | if (c == '\n') { | |
02e5ba4a | 209 | if (config_file_eof) |
17712991 LT |
210 | return 0; |
211 | comment = 0; | |
212 | continue; | |
213 | } | |
214 | if (comment || isspace(c)) | |
215 | continue; | |
216 | if (c == '#' || c == ';') { | |
217 | comment = 1; | |
218 | continue; | |
219 | } | |
220 | if (c == '[') { | |
221 | baselen = get_base_var(var); | |
222 | if (baselen <= 0) | |
223 | break; | |
224 | var[baselen++] = '.'; | |
225 | var[baselen] = 0; | |
226 | continue; | |
227 | } | |
228 | if (!isalpha(c)) | |
229 | break; | |
128af9d1 | 230 | var[baselen] = tolower(c); |
17712991 LT |
231 | if (get_value(fn, var, baselen+1) < 0) |
232 | break; | |
233 | } | |
4f629539 | 234 | die("bad config file line %d in %s", config_linenr, config_file_name); |
17712991 LT |
235 | } |
236 | ||
c8deb5a1 | 237 | static int parse_unit_factor(const char *end, unsigned long *val) |
0b87b6e0 BD |
238 | { |
239 | if (!*end) | |
240 | return 1; | |
c8deb5a1 SP |
241 | else if (!strcasecmp(end, "k")) { |
242 | *val *= 1024; | |
243 | return 1; | |
244 | } | |
245 | else if (!strcasecmp(end, "m")) { | |
246 | *val *= 1024 * 1024; | |
247 | return 1; | |
248 | } | |
249 | else if (!strcasecmp(end, "g")) { | |
250 | *val *= 1024 * 1024 * 1024; | |
251 | return 1; | |
252 | } | |
253 | return 0; | |
0b87b6e0 BD |
254 | } |
255 | ||
256 | int git_parse_long(const char *value, long *ret) | |
257 | { | |
258 | if (value && *value) { | |
259 | char *end; | |
260 | long val = strtol(value, &end, 0); | |
c8deb5a1 SP |
261 | unsigned long factor = 1; |
262 | if (!parse_unit_factor(end, &factor)) | |
263 | return 0; | |
264 | *ret = val * factor; | |
0b87b6e0 BD |
265 | return 1; |
266 | } | |
267 | return 0; | |
268 | } | |
269 | ||
270 | int git_parse_ulong(const char *value, unsigned long *ret) | |
17712991 LT |
271 | { |
272 | if (value && *value) { | |
273 | char *end; | |
0b87b6e0 | 274 | unsigned long val = strtoul(value, &end, 0); |
c8deb5a1 SP |
275 | if (!parse_unit_factor(end, &val)) |
276 | return 0; | |
277 | *ret = val; | |
0b87b6e0 | 278 | return 1; |
17712991 | 279 | } |
0b87b6e0 BD |
280 | return 0; |
281 | } | |
282 | ||
c1867cea JK |
283 | static void die_bad_config(const char *name) |
284 | { | |
285 | if (config_file_name) | |
286 | die("bad config value for '%s' in %s", name, config_file_name); | |
287 | die("bad config value for '%s'", name); | |
288 | } | |
289 | ||
0b87b6e0 BD |
290 | int git_config_int(const char *name, const char *value) |
291 | { | |
292 | long ret; | |
293 | if (!git_parse_long(value, &ret)) | |
c1867cea | 294 | die_bad_config(name); |
0b87b6e0 BD |
295 | return ret; |
296 | } | |
297 | ||
298 | unsigned long git_config_ulong(const char *name, const char *value) | |
299 | { | |
300 | unsigned long ret; | |
301 | if (!git_parse_ulong(value, &ret)) | |
c1867cea | 302 | die_bad_config(name); |
0b87b6e0 | 303 | return ret; |
17712991 LT |
304 | } |
305 | ||
a53f2ec6 | 306 | int git_config_bool_or_int(const char *name, const char *value, int *is_bool) |
17712991 | 307 | { |
a53f2ec6 | 308 | *is_bool = 1; |
17712991 LT |
309 | if (!value) |
310 | return 1; | |
311 | if (!*value) | |
312 | return 0; | |
624314fd | 313 | if (!strcasecmp(value, "true") || !strcasecmp(value, "yes")) |
17712991 | 314 | return 1; |
624314fd | 315 | if (!strcasecmp(value, "false") || !strcasecmp(value, "no")) |
17712991 | 316 | return 0; |
a53f2ec6 | 317 | *is_bool = 0; |
c35b0b58 | 318 | return git_config_int(name, value); |
17712991 LT |
319 | } |
320 | ||
a53f2ec6 JH |
321 | int git_config_bool(const char *name, const char *value) |
322 | { | |
323 | int discard; | |
c35b0b58 | 324 | return !!git_config_bool_or_int(name, value, &discard); |
a53f2ec6 JH |
325 | } |
326 | ||
ea5105a5 CC |
327 | int git_config_string(const char **dest, const char *var, const char *value) |
328 | { | |
329 | if (!value) | |
330 | return config_error_nonbool(var); | |
331 | *dest = xstrdup(value); | |
332 | return 0; | |
333 | } | |
334 | ||
17712991 LT |
335 | int git_default_config(const char *var, const char *value) |
336 | { | |
337 | /* This needs a better name */ | |
338 | if (!strcmp(var, "core.filemode")) { | |
339 | trust_executable_bit = git_config_bool(var, value); | |
340 | return 0; | |
341 | } | |
342 | ||
9378c161 JH |
343 | if (!strcmp(var, "core.quotepath")) { |
344 | quote_path_fully = git_config_bool(var, value); | |
345 | return 0; | |
346 | } | |
347 | ||
78a8d641 JS |
348 | if (!strcmp(var, "core.symlinks")) { |
349 | has_symlinks = git_config_bool(var, value); | |
350 | return 0; | |
351 | } | |
352 | ||
7d1864ce JH |
353 | if (!strcmp(var, "core.bare")) { |
354 | is_bare_repository_cfg = git_config_bool(var, value); | |
355 | return 0; | |
356 | } | |
357 | ||
5f73076c JH |
358 | if (!strcmp(var, "core.ignorestat")) { |
359 | assume_unchanged = git_config_bool(var, value); | |
360 | return 0; | |
361 | } | |
362 | ||
e388c738 JH |
363 | if (!strcmp(var, "core.prefersymlinkrefs")) { |
364 | prefer_symlink_refs = git_config_bool(var, value); | |
f8348be3 JS |
365 | return 0; |
366 | } | |
367 | ||
6de08ae6 SP |
368 | if (!strcmp(var, "core.logallrefupdates")) { |
369 | log_all_ref_updates = git_config_bool(var, value); | |
370 | return 0; | |
371 | } | |
372 | ||
2f8acdb3 JH |
373 | if (!strcmp(var, "core.warnambiguousrefs")) { |
374 | warn_ambiguous_refs = git_config_bool(var, value); | |
375 | return 0; | |
376 | } | |
377 | ||
960ccca6 | 378 | if (!strcmp(var, "core.loosecompression")) { |
12f6c308 JBH |
379 | int level = git_config_int(var, value); |
380 | if (level == -1) | |
381 | level = Z_DEFAULT_COMPRESSION; | |
382 | else if (level < 0 || level > Z_BEST_COMPRESSION) | |
383 | die("bad zlib compression level %d", level); | |
384 | zlib_compression_level = level; | |
960ccca6 DH |
385 | zlib_compression_seen = 1; |
386 | return 0; | |
387 | } | |
388 | ||
389 | if (!strcmp(var, "core.compression")) { | |
390 | int level = git_config_int(var, value); | |
391 | if (level == -1) | |
392 | level = Z_DEFAULT_COMPRESSION; | |
393 | else if (level < 0 || level > Z_BEST_COMPRESSION) | |
394 | die("bad zlib compression level %d", level); | |
395 | core_compression_level = level; | |
396 | core_compression_seen = 1; | |
397 | if (!zlib_compression_seen) | |
398 | zlib_compression_level = level; | |
12f6c308 JBH |
399 | return 0; |
400 | } | |
401 | ||
60bb8b14 | 402 | if (!strcmp(var, "core.packedgitwindowsize")) { |
5faaf246 | 403 | int pgsz_x2 = getpagesize() * 2; |
60bb8b14 | 404 | packed_git_window_size = git_config_int(var, value); |
5faaf246 JH |
405 | |
406 | /* This value must be multiple of (pagesize * 2) */ | |
407 | packed_git_window_size /= pgsz_x2; | |
408 | if (packed_git_window_size < 1) | |
409 | packed_git_window_size = 1; | |
410 | packed_git_window_size *= pgsz_x2; | |
60bb8b14 SP |
411 | return 0; |
412 | } | |
413 | ||
77ccc5bb SP |
414 | if (!strcmp(var, "core.packedgitlimit")) { |
415 | packed_git_limit = git_config_int(var, value); | |
416 | return 0; | |
417 | } | |
418 | ||
18bdec11 SP |
419 | if (!strcmp(var, "core.deltabasecachelimit")) { |
420 | delta_base_cache_limit = git_config_int(var, value); | |
421 | return 0; | |
422 | } | |
423 | ||
6c510bee | 424 | if (!strcmp(var, "core.autocrlf")) { |
d7f46334 LT |
425 | if (value && !strcasecmp(value, "input")) { |
426 | auto_crlf = -1; | |
427 | return 0; | |
428 | } | |
6c510bee LT |
429 | auto_crlf = git_config_bool(var, value); |
430 | return 0; | |
431 | } | |
432 | ||
21e5ad50 SP |
433 | if (!strcmp(var, "core.safecrlf")) { |
434 | if (value && !strcasecmp(value, "warn")) { | |
435 | safe_crlf = SAFE_CRLF_WARN; | |
436 | return 0; | |
437 | } | |
438 | safe_crlf = git_config_bool(var, value); | |
439 | return 0; | |
440 | } | |
441 | ||
e1b10391 | 442 | if (!strcmp(var, "user.name")) { |
6c47d0e8 JH |
443 | if (!value) |
444 | return config_error_nonbool(var); | |
817151e6 | 445 | strlcpy(git_default_name, value, sizeof(git_default_name)); |
e1b10391 LT |
446 | return 0; |
447 | } | |
448 | ||
449 | if (!strcmp(var, "user.email")) { | |
6c47d0e8 JH |
450 | if (!value) |
451 | return config_error_nonbool(var); | |
817151e6 | 452 | strlcpy(git_default_email, value, sizeof(git_default_email)); |
e1b10391 LT |
453 | return 0; |
454 | } | |
455 | ||
ea5105a5 CC |
456 | if (!strcmp(var, "i18n.commitencoding")) |
457 | return git_config_string(&git_commit_encoding, var, value); | |
d2c11a38 | 458 | |
ea5105a5 CC |
459 | if (!strcmp(var, "i18n.logoutputencoding")) |
460 | return git_config_string(&git_log_output_encoding, var, value); | |
d2c11a38 | 461 | |
a159ca0c | 462 | if (!strcmp(var, "pager.color") || !strcmp(var, "color.pager")) { |
aa086eb8 ML |
463 | pager_use_color = git_config_bool(var,value); |
464 | return 0; | |
465 | } | |
466 | ||
872da32d CC |
467 | if (!strcmp(var, "core.pager")) |
468 | return git_config_string(&pager_program, var, value); | |
54adf370 | 469 | |
ee9601e6 CC |
470 | if (!strcmp(var, "core.editor")) |
471 | return git_config_string(&editor_program, var, value); | |
4d87b9c5 | 472 | |
dfb068be CC |
473 | if (!strcmp(var, "core.excludesfile")) |
474 | return git_config_string(&excludes_file, var, value); | |
039bc64e | 475 | |
a9cc857a | 476 | if (!strcmp(var, "core.whitespace")) { |
6c47d0e8 JH |
477 | if (!value) |
478 | return config_error_nonbool(var); | |
cf1b7869 | 479 | whitespace_rule_cfg = parse_whitespace_rule(value); |
a9cc857a JH |
480 | return 0; |
481 | } | |
9ed36cfa JS |
482 | if (!strcmp(var, "branch.autosetupmerge")) { |
483 | if (value && !strcasecmp(value, "always")) { | |
484 | git_branch_track = BRANCH_TRACK_ALWAYS; | |
485 | return 0; | |
486 | } | |
487 | git_branch_track = git_config_bool(var, value); | |
488 | return 0; | |
489 | } | |
c998ae9b DS |
490 | if (!strcmp(var, "branch.autosetuprebase")) { |
491 | if (!value) | |
492 | return config_error_nonbool(var); | |
493 | else if (!strcmp(value, "never")) | |
494 | autorebase = AUTOREBASE_NEVER; | |
495 | else if (!strcmp(value, "local")) | |
496 | autorebase = AUTOREBASE_LOCAL; | |
497 | else if (!strcmp(value, "remote")) | |
498 | autorebase = AUTOREBASE_REMOTE; | |
499 | else if (!strcmp(value, "always")) | |
500 | autorebase = AUTOREBASE_ALWAYS; | |
501 | else | |
502 | return error("Malformed value for %s", var); | |
503 | return 0; | |
504 | } | |
a9cc857a | 505 | |
1ab661dd | 506 | /* Add other config variables here and to Documentation/config.txt. */ |
17712991 LT |
507 | return 0; |
508 | } | |
509 | ||
4f629539 | 510 | int git_config_from_file(config_fn_t fn, const char *filename) |
17712991 LT |
511 | { |
512 | int ret; | |
4f629539 | 513 | FILE *f = fopen(filename, "r"); |
17712991 LT |
514 | |
515 | ret = -1; | |
516 | if (f) { | |
517 | config_file = f; | |
4f629539 | 518 | config_file_name = filename; |
17712991 | 519 | config_linenr = 1; |
02e5ba4a | 520 | config_file_eof = 0; |
17712991 LT |
521 | ret = git_parse_file(fn); |
522 | fclose(f); | |
4f629539 | 523 | config_file_name = NULL; |
17712991 LT |
524 | } |
525 | return ret; | |
526 | } | |
10bea152 | 527 | |
506b17b1 JS |
528 | const char *git_etc_gitconfig(void) |
529 | { | |
7f0e39fa JS |
530 | static const char *system_wide; |
531 | if (!system_wide) { | |
532 | system_wide = ETC_GITCONFIG; | |
533 | if (!is_absolute_path(system_wide)) { | |
534 | /* interpret path relative to exec-dir */ | |
ef5b9d6e JS |
535 | struct strbuf d = STRBUF_INIT; |
536 | strbuf_addf(&d, "%s/%s", git_exec_path(), system_wide); | |
537 | system_wide = strbuf_detach(&d, NULL); | |
7f0e39fa JS |
538 | } |
539 | } | |
540 | return system_wide; | |
506b17b1 JS |
541 | } |
542 | ||
ab88c363 JK |
543 | int git_env_bool(const char *k, int def) |
544 | { | |
545 | const char *v = getenv(k); | |
546 | return v ? git_config_bool(k, v) : def; | |
547 | } | |
548 | ||
549 | int git_config_system(void) | |
550 | { | |
551 | return !git_env_bool("GIT_CONFIG_NOSYSTEM", 0); | |
552 | } | |
553 | ||
554 | int git_config_global(void) | |
555 | { | |
556 | return !git_env_bool("GIT_CONFIG_NOGLOBAL", 0); | |
557 | } | |
558 | ||
4f629539 JH |
559 | int git_config(config_fn_t fn) |
560 | { | |
5f1a63e0 JS |
561 | int ret = 0; |
562 | char *repo_config = NULL; | |
563 | const char *home = NULL, *filename; | |
564 | ||
565 | /* $GIT_CONFIG makes git read _only_ the given config file, | |
566 | * $GIT_CONFIG_LOCAL will make it process it in addition to the | |
567 | * global config file, the same way it would the per-repository | |
568 | * config file otherwise. */ | |
d4ebc36c | 569 | filename = getenv(CONFIG_ENVIRONMENT); |
5f1a63e0 | 570 | if (!filename) { |
ab88c363 | 571 | if (git_config_system() && !access(git_etc_gitconfig(), R_OK)) |
506b17b1 | 572 | ret += git_config_from_file(fn, git_etc_gitconfig()); |
5f1a63e0 | 573 | home = getenv("HOME"); |
d4ebc36c | 574 | filename = getenv(CONFIG_LOCAL_ENVIRONMENT); |
5f1a63e0 | 575 | if (!filename) |
9befac47 | 576 | filename = repo_config = xstrdup(git_path("config")); |
7f29f7a9 | 577 | } |
5f1a63e0 | 578 | |
ab88c363 | 579 | if (git_config_global() && home) { |
9befac47 | 580 | char *user_config = xstrdup(mkpath("%s/.gitconfig", home)); |
e33d0611 | 581 | if (!access(user_config, R_OK)) |
5f1a63e0 JS |
582 | ret = git_config_from_file(fn, user_config); |
583 | free(user_config); | |
584 | } | |
585 | ||
586 | ret += git_config_from_file(fn, filename); | |
4cac42b1 | 587 | free(repo_config); |
5f1a63e0 | 588 | return ret; |
4f629539 JH |
589 | } |
590 | ||
10bea152 JS |
591 | /* |
592 | * Find all the stuff for git_config_set() below. | |
593 | */ | |
4ddba79d JS |
594 | |
595 | #define MAX_MATCHES 512 | |
596 | ||
10bea152 JS |
597 | static struct { |
598 | int baselen; | |
599 | char* key; | |
f98d863d | 600 | int do_not_match; |
10bea152 | 601 | regex_t* value_regex; |
4ddba79d | 602 | int multi_replace; |
dc49cd76 | 603 | size_t offset[MAX_MATCHES]; |
10bea152 JS |
604 | enum { START, SECTION_SEEN, SECTION_END_SEEN, KEY_SEEN } state; |
605 | int seen; | |
606 | } store; | |
607 | ||
f98d863d JS |
608 | static int matches(const char* key, const char* value) |
609 | { | |
610 | return !strcmp(key, store.key) && | |
611 | (store.value_regex == NULL || | |
612 | (store.do_not_match ^ | |
613 | !regexec(store.value_regex, value, 0, NULL, 0))); | |
614 | } | |
615 | ||
10bea152 JS |
616 | static int store_aux(const char* key, const char* value) |
617 | { | |
ae9ee41d JH |
618 | const char *ep; |
619 | size_t section_len; | |
620 | ||
10bea152 JS |
621 | switch (store.state) { |
622 | case KEY_SEEN: | |
f98d863d | 623 | if (matches(key, value)) { |
4ddba79d | 624 | if (store.seen == 1 && store.multi_replace == 0) { |
10bea152 JS |
625 | fprintf(stderr, |
626 | "Warning: %s has multiple values\n", | |
627 | key); | |
4ddba79d JS |
628 | } else if (store.seen >= MAX_MATCHES) { |
629 | fprintf(stderr, "Too many matches\n"); | |
630 | return 1; | |
10bea152 | 631 | } |
4ddba79d JS |
632 | |
633 | store.offset[store.seen] = ftell(config_file); | |
10bea152 JS |
634 | store.seen++; |
635 | } | |
636 | break; | |
637 | case SECTION_SEEN: | |
ae9ee41d JH |
638 | /* |
639 | * What we are looking for is in store.key (both | |
640 | * section and var), and its section part is baselen | |
641 | * long. We found key (again, both section and var). | |
642 | * We would want to know if this key is in the same | |
643 | * section as what we are looking for. We already | |
644 | * know we are in the same section as what should | |
645 | * hold store.key. | |
646 | */ | |
647 | ep = strrchr(key, '.'); | |
648 | section_len = ep - key; | |
649 | ||
650 | if ((section_len != store.baselen) || | |
651 | memcmp(key, store.key, section_len+1)) { | |
10bea152 JS |
652 | store.state = SECTION_END_SEEN; |
653 | break; | |
ae9ee41d JH |
654 | } |
655 | ||
656 | /* | |
657 | * Do not increment matches: this is no match, but we | |
658 | * just made sure we are in the desired section. | |
659 | */ | |
660 | store.offset[store.seen] = ftell(config_file); | |
10bea152 JS |
661 | /* fallthru */ |
662 | case SECTION_END_SEEN: | |
663 | case START: | |
f98d863d | 664 | if (matches(key, value)) { |
4ddba79d | 665 | store.offset[store.seen] = ftell(config_file); |
10bea152 JS |
666 | store.state = KEY_SEEN; |
667 | store.seen++; | |
d14f7764 LT |
668 | } else { |
669 | if (strrchr(key, '.') - key == store.baselen && | |
bdf0ef08 | 670 | !strncmp(key, store.key, store.baselen)) { |
93ddef3e | 671 | store.state = SECTION_SEEN; |
bdf0ef08 | 672 | store.offset[store.seen] = ftell(config_file); |
d14f7764 | 673 | } |
bdf0ef08 | 674 | } |
10bea152 JS |
675 | } |
676 | return 0; | |
677 | } | |
678 | ||
b79d18c9 | 679 | static int write_error(void) |
480c9e52 AW |
680 | { |
681 | fprintf(stderr, "Failed to write new configuration file\n"); | |
682 | ||
683 | /* Same error code as "failed to rename". */ | |
684 | return 4; | |
685 | } | |
686 | ||
687 | static int store_write_section(int fd, const char* key) | |
10bea152 | 688 | { |
cb891a59 KH |
689 | const char *dot; |
690 | int i, success; | |
691 | struct strbuf sb; | |
d14f7764 | 692 | |
cb891a59 KH |
693 | strbuf_init(&sb, 0); |
694 | dot = memchr(key, '.', store.baselen); | |
d14f7764 | 695 | if (dot) { |
cb891a59 KH |
696 | strbuf_addf(&sb, "[%.*s \"", (int)(dot - key), key); |
697 | for (i = dot - key + 1; i < store.baselen; i++) { | |
698 | if (key[i] == '"') | |
699 | strbuf_addch(&sb, '\\'); | |
700 | strbuf_addch(&sb, key[i]); | |
d14f7764 | 701 | } |
cb891a59 KH |
702 | strbuf_addstr(&sb, "\"]\n"); |
703 | } else { | |
704 | strbuf_addf(&sb, "[%.*s]\n", store.baselen, key); | |
d14f7764 LT |
705 | } |
706 | ||
cb891a59 KH |
707 | success = write_in_full(fd, sb.buf, sb.len) == sb.len; |
708 | strbuf_release(&sb); | |
480c9e52 | 709 | |
cb891a59 | 710 | return success; |
10bea152 JS |
711 | } |
712 | ||
480c9e52 | 713 | static int store_write_pair(int fd, const char* key, const char* value) |
10bea152 | 714 | { |
cb891a59 KH |
715 | int i, success; |
716 | int length = strlen(key + store.baselen + 1); | |
717 | const char *quote = ""; | |
718 | struct strbuf sb; | |
cdd4fb15 | 719 | |
6281f394 JM |
720 | /* |
721 | * Check to see if the value needs to be surrounded with a dq pair. | |
722 | * Note that problematic characters are always backslash-quoted; this | |
723 | * check is about not losing leading or trailing SP and strings that | |
724 | * follow beginning-of-comment characters (i.e. ';' and '#') by the | |
725 | * configuration parser. | |
726 | */ | |
cdd4fb15 | 727 | if (value[0] == ' ') |
cb891a59 | 728 | quote = "\""; |
cdd4fb15 BG |
729 | for (i = 0; value[i]; i++) |
730 | if (value[i] == ';' || value[i] == '#') | |
cb891a59 KH |
731 | quote = "\""; |
732 | if (i && value[i - 1] == ' ') | |
733 | quote = "\""; | |
734 | ||
735 | strbuf_init(&sb, 0); | |
736 | strbuf_addf(&sb, "\t%.*s = %s", | |
737 | length, key + store.baselen + 1, quote); | |
10bea152 | 738 | |
10bea152 JS |
739 | for (i = 0; value[i]; i++) |
740 | switch (value[i]) { | |
480c9e52 | 741 | case '\n': |
cb891a59 | 742 | strbuf_addstr(&sb, "\\n"); |
480c9e52 AW |
743 | break; |
744 | case '\t': | |
cb891a59 | 745 | strbuf_addstr(&sb, "\\t"); |
480c9e52 AW |
746 | break; |
747 | case '"': | |
748 | case '\\': | |
cb891a59 | 749 | strbuf_addch(&sb, '\\'); |
480c9e52 | 750 | default: |
cb891a59 | 751 | strbuf_addch(&sb, value[i]); |
480c9e52 AW |
752 | break; |
753 | } | |
cb891a59 KH |
754 | strbuf_addf(&sb, "%s\n", quote); |
755 | ||
756 | success = write_in_full(fd, sb.buf, sb.len) == sb.len; | |
757 | strbuf_release(&sb); | |
758 | ||
759 | return success; | |
10bea152 JS |
760 | } |
761 | ||
dc49cd76 SP |
762 | static ssize_t find_beginning_of_line(const char* contents, size_t size, |
763 | size_t offset_, int* found_bracket) | |
4ddba79d | 764 | { |
dc49cd76 SP |
765 | size_t equal_offset = size, bracket_offset = size; |
766 | ssize_t offset; | |
4ddba79d | 767 | |
7a31cc0f | 768 | contline: |
a6080a0a | 769 | for (offset = offset_-2; offset > 0 |
4ddba79d JS |
770 | && contents[offset] != '\n'; offset--) |
771 | switch (contents[offset]) { | |
772 | case '=': equal_offset = offset; break; | |
773 | case ']': bracket_offset = offset; break; | |
774 | } | |
7a31cc0f FL |
775 | if (offset > 0 && contents[offset-1] == '\\') { |
776 | offset_ = offset; | |
777 | goto contline; | |
778 | } | |
4ddba79d JS |
779 | if (bracket_offset < equal_offset) { |
780 | *found_bracket = 1; | |
781 | offset = bracket_offset+1; | |
782 | } else | |
783 | offset++; | |
784 | ||
785 | return offset; | |
786 | } | |
787 | ||
10bea152 JS |
788 | int git_config_set(const char* key, const char* value) |
789 | { | |
4ddba79d | 790 | return git_config_set_multivar(key, value, NULL, 0); |
10bea152 JS |
791 | } |
792 | ||
793 | /* | |
794 | * If value==NULL, unset in (remove from) config, | |
795 | * if value_regex!=NULL, disregard key/value pairs where value does not match. | |
4ddba79d JS |
796 | * if multi_replace==0, nothing, or only one matching key/value is replaced, |
797 | * else all matching key/values (regardless how many) are removed, | |
798 | * before the new pair is written. | |
10bea152 JS |
799 | * |
800 | * Returns 0 on success. | |
801 | * | |
802 | * This function does this: | |
803 | * | |
804 | * - it locks the config file by creating ".git/config.lock" | |
805 | * | |
806 | * - it then parses the config using store_aux() as validator to find | |
807 | * the position on the key/value pair to replace. If it is to be unset, | |
808 | * it must be found exactly once. | |
809 | * | |
810 | * - the config file is mmap()ed and the part before the match (if any) is | |
811 | * written to the lock file, then the changed part and the rest. | |
812 | * | |
813 | * - the config file is removed and the lock file rename()d to it. | |
814 | * | |
815 | */ | |
816 | int git_config_set_multivar(const char* key, const char* value, | |
4ddba79d | 817 | const char* value_regex, int multi_replace) |
10bea152 | 818 | { |
d14f7764 | 819 | int i, dot; |
f8ba655e | 820 | int fd = -1, in_fd; |
dafc88b1 | 821 | int ret; |
9c3796fc | 822 | char* config_filename; |
6cbf973c | 823 | struct lock_file *lock = NULL; |
b17e659d | 824 | const char* last_dot = strrchr(key, '.'); |
4ddba79d | 825 | |
d4ebc36c | 826 | config_filename = getenv(CONFIG_ENVIRONMENT); |
9c3796fc | 827 | if (!config_filename) { |
d4ebc36c | 828 | config_filename = getenv(CONFIG_LOCAL_ENVIRONMENT); |
9c3796fc JS |
829 | if (!config_filename) |
830 | config_filename = git_path("config"); | |
831 | } | |
9befac47 | 832 | config_filename = xstrdup(config_filename); |
9c3796fc | 833 | |
10bea152 JS |
834 | /* |
835 | * Since "key" actually contains the section name and the real | |
836 | * key name separated by a dot, we have to know where the dot is. | |
837 | */ | |
b17e659d | 838 | |
dafc88b1 | 839 | if (last_dot == NULL) { |
10bea152 | 840 | fprintf(stderr, "key does not contain a section: %s\n", key); |
dafc88b1 SH |
841 | ret = 2; |
842 | goto out_free; | |
10bea152 | 843 | } |
b17e659d JS |
844 | store.baselen = last_dot - key; |
845 | ||
846 | store.multi_replace = multi_replace; | |
10bea152 JS |
847 | |
848 | /* | |
849 | * Validate the key and while at it, lower case it for matching. | |
850 | */ | |
2d7320d0 | 851 | store.key = xmalloc(strlen(key) + 1); |
d14f7764 LT |
852 | dot = 0; |
853 | for (i = 0; key[i]; i++) { | |
854 | unsigned char c = key[i]; | |
855 | if (c == '.') | |
856 | dot = 1; | |
857 | /* Leave the extended basename untouched.. */ | |
858 | if (!dot || i > store.baselen) { | |
38c5afa8 | 859 | if (!iskeychar(c) || (i == store.baselen+1 && !isalpha(c))) { |
d14f7764 LT |
860 | fprintf(stderr, "invalid key: %s\n", key); |
861 | free(store.key); | |
862 | ret = 1; | |
863 | goto out_free; | |
864 | } | |
865 | c = tolower(c); | |
6f71686e JS |
866 | } else if (c == '\n') { |
867 | fprintf(stderr, "invalid key (newline): %s\n", key); | |
868 | free(store.key); | |
869 | ret = 1; | |
870 | goto out_free; | |
d14f7764 LT |
871 | } |
872 | store.key[i] = c; | |
873 | } | |
3dd94e3b | 874 | store.key[i] = 0; |
10bea152 JS |
875 | |
876 | /* | |
6cbf973c | 877 | * The lock serves a purpose in addition to locking: the new |
10bea152 JS |
878 | * contents of .git/config will be written into it. |
879 | */ | |
6cbf973c BS |
880 | lock = xcalloc(sizeof(struct lock_file), 1); |
881 | fd = hold_lock_file_for_update(lock, config_filename, 0); | |
882 | if (fd < 0) { | |
10bea152 JS |
883 | fprintf(stderr, "could not lock config file\n"); |
884 | free(store.key); | |
dafc88b1 SH |
885 | ret = -1; |
886 | goto out_free; | |
10bea152 JS |
887 | } |
888 | ||
889 | /* | |
890 | * If .git/config does not exist yet, write a minimal version. | |
891 | */ | |
88fb958b AR |
892 | in_fd = open(config_filename, O_RDONLY); |
893 | if ( in_fd < 0 ) { | |
10bea152 JS |
894 | free(store.key); |
895 | ||
88fb958b AR |
896 | if ( ENOENT != errno ) { |
897 | error("opening %s: %s", config_filename, | |
898 | strerror(errno)); | |
dafc88b1 SH |
899 | ret = 3; /* same as "invalid config file" */ |
900 | goto out_free; | |
88fb958b | 901 | } |
10bea152 JS |
902 | /* if nothing to unset, error out */ |
903 | if (value == NULL) { | |
dafc88b1 SH |
904 | ret = 5; |
905 | goto out_free; | |
10bea152 JS |
906 | } |
907 | ||
908 | store.key = (char*)key; | |
480c9e52 | 909 | if (!store_write_section(fd, key) || |
93c1e079 JH |
910 | !store_write_pair(fd, key, value)) |
911 | goto write_err_out; | |
912 | } else { | |
88fb958b | 913 | struct stat st; |
10bea152 | 914 | char* contents; |
dc49cd76 SP |
915 | size_t contents_sz, copy_begin, copy_end; |
916 | int i, new_line = 0; | |
10bea152 JS |
917 | |
918 | if (value_regex == NULL) | |
919 | store.value_regex = NULL; | |
920 | else { | |
f98d863d JS |
921 | if (value_regex[0] == '!') { |
922 | store.do_not_match = 1; | |
923 | value_regex++; | |
924 | } else | |
925 | store.do_not_match = 0; | |
926 | ||
2d7320d0 | 927 | store.value_regex = (regex_t*)xmalloc(sizeof(regex_t)); |
10bea152 JS |
928 | if (regcomp(store.value_regex, value_regex, |
929 | REG_EXTENDED)) { | |
7246ed43 | 930 | fprintf(stderr, "Invalid pattern: %s\n", |
10bea152 JS |
931 | value_regex); |
932 | free(store.value_regex); | |
dafc88b1 SH |
933 | ret = 6; |
934 | goto out_free; | |
10bea152 JS |
935 | } |
936 | } | |
937 | ||
4ddba79d | 938 | store.offset[0] = 0; |
10bea152 JS |
939 | store.state = START; |
940 | store.seen = 0; | |
941 | ||
942 | /* | |
943 | * After this, store.offset will contain the *end* offset | |
944 | * of the last match, or remain at 0 if no match was found. | |
945 | * As a side effect, we make sure to transform only a valid | |
946 | * existing config file. | |
947 | */ | |
9c3796fc | 948 | if (git_config_from_file(store_aux, config_filename)) { |
10bea152 JS |
949 | fprintf(stderr, "invalid config file\n"); |
950 | free(store.key); | |
951 | if (store.value_regex != NULL) { | |
952 | regfree(store.value_regex); | |
953 | free(store.value_regex); | |
954 | } | |
dafc88b1 SH |
955 | ret = 3; |
956 | goto out_free; | |
10bea152 JS |
957 | } |
958 | ||
959 | free(store.key); | |
960 | if (store.value_regex != NULL) { | |
961 | regfree(store.value_regex); | |
962 | free(store.value_regex); | |
963 | } | |
964 | ||
4ddba79d JS |
965 | /* if nothing to unset, or too many matches, error out */ |
966 | if ((store.seen == 0 && value == NULL) || | |
967 | (store.seen > 1 && multi_replace == 0)) { | |
dafc88b1 SH |
968 | ret = 5; |
969 | goto out_free; | |
10bea152 JS |
970 | } |
971 | ||
88fb958b | 972 | fstat(in_fd, &st); |
dc49cd76 SP |
973 | contents_sz = xsize_t(st.st_size); |
974 | contents = xmmap(NULL, contents_sz, PROT_READ, | |
10bea152 JS |
975 | MAP_PRIVATE, in_fd, 0); |
976 | close(in_fd); | |
977 | ||
4ddba79d JS |
978 | if (store.seen == 0) |
979 | store.seen = 1; | |
980 | ||
981 | for (i = 0, copy_begin = 0; i < store.seen; i++) { | |
982 | if (store.offset[i] == 0) { | |
dc49cd76 | 983 | store.offset[i] = copy_end = contents_sz; |
4ddba79d JS |
984 | } else if (store.state != KEY_SEEN) { |
985 | copy_end = store.offset[i]; | |
10bea152 | 986 | } else |
4ddba79d | 987 | copy_end = find_beginning_of_line( |
dc49cd76 | 988 | contents, contents_sz, |
4ddba79d JS |
989 | store.offset[i]-2, &new_line); |
990 | ||
02e5ba4a JK |
991 | if (copy_end > 0 && contents[copy_end-1] != '\n') |
992 | new_line = 1; | |
993 | ||
4ddba79d JS |
994 | /* write the first part of the config */ |
995 | if (copy_end > copy_begin) { | |
93c1e079 JH |
996 | if (write_in_full(fd, contents + copy_begin, |
997 | copy_end - copy_begin) < | |
998 | copy_end - copy_begin) | |
999 | goto write_err_out; | |
1000 | if (new_line && | |
1001 | write_in_full(fd, "\n", 1) != 1) | |
1002 | goto write_err_out; | |
4ddba79d JS |
1003 | } |
1004 | copy_begin = store.offset[i]; | |
10bea152 JS |
1005 | } |
1006 | ||
10bea152 JS |
1007 | /* write the pair (value == NULL means unset) */ |
1008 | if (value != NULL) { | |
93c1e079 JH |
1009 | if (store.state == START) { |
1010 | if (!store_write_section(fd, key)) | |
1011 | goto write_err_out; | |
480c9e52 | 1012 | } |
93c1e079 JH |
1013 | if (!store_write_pair(fd, key, value)) |
1014 | goto write_err_out; | |
10bea152 JS |
1015 | } |
1016 | ||
1017 | /* write the rest of the config */ | |
dc49cd76 | 1018 | if (copy_begin < contents_sz) |
93c1e079 | 1019 | if (write_in_full(fd, contents + copy_begin, |
dc49cd76 SP |
1020 | contents_sz - copy_begin) < |
1021 | contents_sz - copy_begin) | |
93c1e079 | 1022 | goto write_err_out; |
10bea152 | 1023 | |
dc49cd76 | 1024 | munmap(contents, contents_sz); |
10bea152 JS |
1025 | } |
1026 | ||
4ed7cd3a | 1027 | if (commit_lock_file(lock) < 0) { |
6cbf973c | 1028 | fprintf(stderr, "Cannot commit config file!\n"); |
dafc88b1 SH |
1029 | ret = 4; |
1030 | goto out_free; | |
10bea152 JS |
1031 | } |
1032 | ||
6cbf973c BS |
1033 | /* |
1034 | * lock is committed, so don't try to roll it back below. | |
1035 | * NOTE: Since lockfile.c keeps a linked list of all created | |
1036 | * lock_file structures, it isn't safe to free(lock). It's | |
1037 | * better to just leave it hanging around. | |
1038 | */ | |
1039 | lock = NULL; | |
dafc88b1 SH |
1040 | ret = 0; |
1041 | ||
1042 | out_free: | |
6cbf973c BS |
1043 | if (lock) |
1044 | rollback_lock_file(lock); | |
4cac42b1 | 1045 | free(config_filename); |
dafc88b1 | 1046 | return ret; |
93c1e079 JH |
1047 | |
1048 | write_err_out: | |
1049 | ret = write_error(); | |
1050 | goto out_free; | |
1051 | ||
10bea152 JS |
1052 | } |
1053 | ||
118f8b24 PB |
1054 | static int section_name_match (const char *buf, const char *name) |
1055 | { | |
1056 | int i = 0, j = 0, dot = 0; | |
1057 | for (; buf[i] && buf[i] != ']'; i++) { | |
1058 | if (!dot && isspace(buf[i])) { | |
1059 | dot = 1; | |
1060 | if (name[j++] != '.') | |
1061 | break; | |
1062 | for (i++; isspace(buf[i]); i++) | |
1063 | ; /* do nothing */ | |
1064 | if (buf[i] != '"') | |
1065 | break; | |
1066 | continue; | |
1067 | } | |
1068 | if (buf[i] == '\\' && dot) | |
1069 | i++; | |
1070 | else if (buf[i] == '"' && dot) { | |
1071 | for (i++; isspace(buf[i]); i++) | |
1072 | ; /* do_nothing */ | |
1073 | break; | |
1074 | } | |
1075 | if (buf[i] != name[j++]) | |
1076 | break; | |
1077 | } | |
1078 | return (buf[i] == ']' && name[j] == 0); | |
1079 | } | |
1080 | ||
1081 | /* if new_name == NULL, the section is removed instead */ | |
0667fcfb JS |
1082 | int git_config_rename_section(const char *old_name, const char *new_name) |
1083 | { | |
118f8b24 | 1084 | int ret = 0, remove = 0; |
fc1905bb | 1085 | char *config_filename; |
0667fcfb JS |
1086 | struct lock_file *lock = xcalloc(sizeof(struct lock_file), 1); |
1087 | int out_fd; | |
1088 | char buf[1024]; | |
1089 | ||
d4ebc36c | 1090 | config_filename = getenv(CONFIG_ENVIRONMENT); |
0667fcfb | 1091 | if (!config_filename) { |
d4ebc36c | 1092 | config_filename = getenv(CONFIG_LOCAL_ENVIRONMENT); |
0667fcfb JS |
1093 | if (!config_filename) |
1094 | config_filename = git_path("config"); | |
1095 | } | |
1096 | config_filename = xstrdup(config_filename); | |
1097 | out_fd = hold_lock_file_for_update(lock, config_filename, 0); | |
fc1905bb JH |
1098 | if (out_fd < 0) { |
1099 | ret = error("Could not lock config file!"); | |
1100 | goto out; | |
1101 | } | |
0667fcfb | 1102 | |
fc1905bb | 1103 | if (!(config_file = fopen(config_filename, "rb"))) { |
01ebb9dc GB |
1104 | /* no config file means nothing to rename, no error */ |
1105 | goto unlock_and_out; | |
fc1905bb | 1106 | } |
0667fcfb JS |
1107 | |
1108 | while (fgets(buf, sizeof(buf), config_file)) { | |
1109 | int i; | |
480c9e52 | 1110 | int length; |
0667fcfb JS |
1111 | for (i = 0; buf[i] && isspace(buf[i]); i++) |
1112 | ; /* do nothing */ | |
1113 | if (buf[i] == '[') { | |
1114 | /* it's a section */ | |
118f8b24 PB |
1115 | if (section_name_match (&buf[i+1], old_name)) { |
1116 | ret++; | |
1117 | if (new_name == NULL) { | |
1118 | remove = 1; | |
0667fcfb JS |
1119 | continue; |
1120 | } | |
0667fcfb | 1121 | store.baselen = strlen(new_name); |
480c9e52 AW |
1122 | if (!store_write_section(out_fd, new_name)) { |
1123 | ret = write_error(); | |
1124 | goto out; | |
1125 | } | |
0667fcfb JS |
1126 | continue; |
1127 | } | |
118f8b24 | 1128 | remove = 0; |
0667fcfb | 1129 | } |
118f8b24 PB |
1130 | if (remove) |
1131 | continue; | |
480c9e52 AW |
1132 | length = strlen(buf); |
1133 | if (write_in_full(out_fd, buf, length) != length) { | |
1134 | ret = write_error(); | |
1135 | goto out; | |
1136 | } | |
0667fcfb | 1137 | } |
fc1905bb | 1138 | fclose(config_file); |
01ebb9dc | 1139 | unlock_and_out: |
4ed7cd3a | 1140 | if (commit_lock_file(lock) < 0) |
480c9e52 | 1141 | ret = error("Cannot commit config file!"); |
fc1905bb JH |
1142 | out: |
1143 | free(config_filename); | |
0667fcfb JS |
1144 | return ret; |
1145 | } | |
40ea4ed9 JH |
1146 | |
1147 | /* | |
1148 | * Call this to report error for your variable that should not | |
1149 | * get a boolean value (i.e. "[my] var" means "true"). | |
1150 | */ | |
1151 | int config_error_nonbool(const char *var) | |
1152 | { | |
1153 | return error("Missing value for '%s'", var); | |
1154 | } |