rebase docs: drop stray word in merge command description
[git/debian.git] / usage.c
blobcc803336bd5e6761b7fd50c33dba5aa9f734c4ba
1 /*
2 * GIT - The information manager from hell
4 * Copyright (C) Linus Torvalds, 2005
5 */
6 #include "git-compat-util.h"
7 #include "cache.h"
9 void vreportf(const char *prefix, const char *err, va_list params)
11 char msg[4096];
12 char *p;
14 vsnprintf(msg, sizeof(msg), err, params);
15 for (p = msg; *p; p++) {
16 if (iscntrl(*p) && *p != '\t' && *p != '\n')
17 *p = '?';
19 fprintf(stderr, "%s%s\n", prefix, msg);
22 static NORETURN void usage_builtin(const char *err, va_list params)
24 vreportf("usage: ", err, params);
25 exit(129);
28 static NORETURN void die_builtin(const char *err, va_list params)
30 vreportf("fatal: ", err, params);
31 exit(128);
34 static void error_builtin(const char *err, va_list params)
36 vreportf("error: ", err, params);
39 static void warn_builtin(const char *warn, va_list params)
41 vreportf("warning: ", warn, params);
44 static int die_is_recursing_builtin(void)
46 static int dying;
48 * Just an arbitrary number X where "a < x < b" where "a" is
49 * "maximum number of pthreads we'll ever plausibly spawn" and
50 * "b" is "something less than Inf", since the point is to
51 * prevent infinite recursion.
53 static const int recursion_limit = 1024;
55 dying++;
56 if (dying > recursion_limit) {
57 return 1;
58 } else if (dying == 2) {
59 warning("die() called many times. Recursion error or racy threaded death!");
60 return 0;
61 } else {
62 return 0;
66 /* If we are in a dlopen()ed .so write to a global variable would segfault
67 * (ugh), so keep things static. */
68 static NORETURN_PTR void (*usage_routine)(const char *err, va_list params) = usage_builtin;
69 static NORETURN_PTR void (*die_routine)(const char *err, va_list params) = die_builtin;
70 static void (*error_routine)(const char *err, va_list params) = error_builtin;
71 static void (*warn_routine)(const char *err, va_list params) = warn_builtin;
72 static int (*die_is_recursing)(void) = die_is_recursing_builtin;
74 void set_die_routine(NORETURN_PTR void (*routine)(const char *err, va_list params))
76 die_routine = routine;
79 void set_error_routine(void (*routine)(const char *err, va_list params))
81 error_routine = routine;
84 void (*get_error_routine(void))(const char *err, va_list params)
86 return error_routine;
89 void set_warn_routine(void (*routine)(const char *warn, va_list params))
91 warn_routine = routine;
94 void (*get_warn_routine(void))(const char *warn, va_list params)
96 return warn_routine;
99 void set_die_is_recursing_routine(int (*routine)(void))
101 die_is_recursing = routine;
104 void NORETURN usagef(const char *err, ...)
106 va_list params;
108 va_start(params, err);
109 usage_routine(err, params);
110 va_end(params);
113 void NORETURN usage(const char *err)
115 usagef("%s", err);
118 void NORETURN die(const char *err, ...)
120 va_list params;
122 if (die_is_recursing()) {
123 fputs("fatal: recursion detected in die handler\n", stderr);
124 exit(128);
127 va_start(params, err);
128 die_routine(err, params);
129 va_end(params);
132 static const char *fmt_with_err(char *buf, int n, const char *fmt)
134 char str_error[256], *err;
135 int i, j;
137 err = strerror(errno);
138 for (i = j = 0; err[i] && j < sizeof(str_error) - 1; ) {
139 if ((str_error[j++] = err[i++]) != '%')
140 continue;
141 if (j < sizeof(str_error) - 1) {
142 str_error[j++] = '%';
143 } else {
144 /* No room to double the '%', so we overwrite it with
145 * '\0' below */
146 j--;
147 break;
150 str_error[j] = 0;
151 /* Truncation is acceptable here */
152 snprintf(buf, n, "%s: %s", fmt, str_error);
153 return buf;
156 void NORETURN die_errno(const char *fmt, ...)
158 char buf[1024];
159 va_list params;
161 if (die_is_recursing()) {
162 fputs("fatal: recursion detected in die_errno handler\n",
163 stderr);
164 exit(128);
167 va_start(params, fmt);
168 die_routine(fmt_with_err(buf, sizeof(buf), fmt), params);
169 va_end(params);
172 #undef error_errno
173 int error_errno(const char *fmt, ...)
175 char buf[1024];
176 va_list params;
178 va_start(params, fmt);
179 error_routine(fmt_with_err(buf, sizeof(buf), fmt), params);
180 va_end(params);
181 return -1;
184 #undef error
185 int error(const char *err, ...)
187 va_list params;
189 va_start(params, err);
190 error_routine(err, params);
191 va_end(params);
192 return -1;
195 void warning_errno(const char *warn, ...)
197 char buf[1024];
198 va_list params;
200 va_start(params, warn);
201 warn_routine(fmt_with_err(buf, sizeof(buf), warn), params);
202 va_end(params);
205 void warning(const char *warn, ...)
207 va_list params;
209 va_start(params, warn);
210 warn_routine(warn, params);
211 va_end(params);
214 /* Only set this, ever, from t/helper/, when verifying that bugs are caught. */
215 int BUG_exit_code;
217 static NORETURN void BUG_vfl(const char *file, int line, const char *fmt, va_list params)
219 char prefix[256];
221 /* truncation via snprintf is OK here */
222 if (file)
223 snprintf(prefix, sizeof(prefix), "BUG: %s:%d: ", file, line);
224 else
225 snprintf(prefix, sizeof(prefix), "BUG: ");
227 vreportf(prefix, fmt, params);
228 if (BUG_exit_code)
229 exit(BUG_exit_code);
230 abort();
233 #ifdef HAVE_VARIADIC_MACROS
234 NORETURN void BUG_fl(const char *file, int line, const char *fmt, ...)
236 va_list ap;
237 va_start(ap, fmt);
238 BUG_vfl(file, line, fmt, ap);
239 va_end(ap);
241 #else
242 NORETURN void BUG(const char *fmt, ...)
244 va_list ap;
245 va_start(ap, fmt);
246 BUG_vfl(NULL, 0, fmt, ap);
247 va_end(ap);
249 #endif
251 #ifdef SUPPRESS_ANNOTATED_LEAKS
252 void unleak_memory(const void *ptr, size_t len)
254 static struct suppressed_leak_root {
255 struct suppressed_leak_root *next;
256 char data[FLEX_ARRAY];
257 } *suppressed_leaks;
258 struct suppressed_leak_root *root;
260 FLEX_ALLOC_MEM(root, data, ptr, len);
261 root->next = suppressed_leaks;
262 suppressed_leaks = root;
264 #endif