]>
Commit | Line | Data |
---|---|---|
19361cb7 | 1 | /* Error handler for noninteractive utilities |
2b778ceb | 2 | Copyright (C) 1990-2021 Free Software Foundation, Inc. |
10ffcd52 | 3 | This file is part of the GNU C Library. |
19361cb7 UD |
4 | |
5 | The GNU C Library is free software; you can redistribute it and/or | |
41bdb6e2 AJ |
6 | modify it under the terms of the GNU Lesser General Public |
7 | License as published by the Free Software Foundation; either | |
8 | version 2.1 of the License, or (at your option) any later version. | |
19361cb7 UD |
9 | |
10 | The GNU C Library is distributed in the hope that it will be useful, | |
11 | but WITHOUT ANY WARRANTY; without even the implied warranty of | |
12 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU | |
41bdb6e2 | 13 | Lesser General Public License for more details. |
19361cb7 | 14 | |
41bdb6e2 | 15 | You should have received a copy of the GNU Lesser General Public |
59ba27a6 | 16 | License along with the GNU C Library; if not, see |
5a82c748 | 17 | <https://www.gnu.org/licenses/>. */ |
196980f5 RM |
18 | |
19 | /* Written by David MacKenzie <djm@gnu.ai.mit.edu>. */ | |
20 | ||
888c679b | 21 | #if !_LIBC |
a44d2393 | 22 | # include <config.h> |
196980f5 RM |
23 | #endif |
24 | ||
888c679b SP |
25 | #include "error.h" |
26 | ||
240c62a7 | 27 | #include <stdarg.h> |
196980f5 | 28 | #include <stdio.h> |
240c62a7 UD |
29 | #include <stdlib.h> |
30 | #include <string.h> | |
31 | ||
888c679b SP |
32 | #if !_LIBC && ENABLE_NLS |
33 | # include "gettext.h" | |
34 | # define _(msgid) gettext (msgid) | |
35 | #endif | |
36 | ||
1fc0e331 | 37 | #ifdef _LIBC |
240c62a7 | 38 | # include <libintl.h> |
ce14a814 RM |
39 | # include <stdbool.h> |
40 | # include <stdint.h> | |
1fc0e331 | 41 | # include <wchar.h> |
6293b803 | 42 | # define mbsrtowcs __mbsrtowcs |
888c679b SP |
43 | # define USE_UNLOCKED_IO 0 |
44 | # define _GL_ATTRIBUTE_FORMAT_PRINTF(a, b) | |
45 | # define _GL_ARG_NONNULL(a) | |
1fc0e331 | 46 | #endif |
196980f5 | 47 | |
888c679b SP |
48 | #if USE_UNLOCKED_IO |
49 | # include "unlocked-io.h" | |
50 | #endif | |
0d204b0a | 51 | |
19bc17a9 | 52 | #ifndef _ |
a44d2393 | 53 | # define _(String) String |
19bc17a9 RM |
54 | #endif |
55 | ||
196980f5 RM |
56 | /* If NULL, error will flush stdout, then print on stderr the program |
57 | name, a colon and a space. Otherwise, error will call this | |
58 | function without parameters instead. */ | |
240c62a7 | 59 | void (*error_print_progname) (void); |
bbed653c | 60 | |
888c679b | 61 | /* This variable is incremented each time 'error' is called. */ |
bbed653c | 62 | unsigned int error_message_count; |
196980f5 RM |
63 | |
64 | #ifdef _LIBC | |
bbed653c RM |
65 | /* In the GNU C library, there is a predefined variable for this. */ |
66 | ||
a44d2393 UD |
67 | # define program_name program_invocation_name |
68 | # include <errno.h> | |
10ffcd52 | 69 | # include <limits.h> |
37de950b | 70 | # include <libio/libioP.h> |
bbed653c | 71 | |
888c679b | 72 | /* In GNU libc we want do not want to use the common name 'error' directly. |
2f6d1f1b | 73 | Instead make it a weak alias. */ |
104d0bd3 UD |
74 | extern void __error (int status, int errnum, const char *message, ...) |
75 | __attribute__ ((__format__ (__printf__, 3, 4))); | |
49f3a758 UD |
76 | extern void __error_at_line (int status, int errnum, const char *file_name, |
77 | unsigned int line_number, const char *message, | |
104d0bd3 UD |
78 | ...) |
79 | __attribute__ ((__format__ (__printf__, 5, 6)));; | |
a44d2393 UD |
80 | # define error __error |
81 | # define error_at_line __error_at_line | |
2f6d1f1b | 82 | |
e5e45b53 | 83 | # include <libio/iolibio.h> |
d18ea0c5 | 84 | # define fflush(s) _IO_fflush (s) |
e5e45b53 | 85 | # undef putc |
d18ea0c5 | 86 | # define putc(c, fp) _IO_putc (c, fp) |
50304ef0 | 87 | |
ec999b8e | 88 | # include <libc-lock.h> |
8c620ae0 | 89 | |
a44d2393 | 90 | #else /* not _LIBC */ |
196980f5 | 91 | |
888c679b SP |
92 | # include <fcntl.h> |
93 | # include <unistd.h> | |
94 | ||
95 | # if (defined _WIN32 || defined __WIN32__) && ! defined __CYGWIN__ | |
96 | /* Get declarations of the native Windows API functions. */ | |
97 | # define WIN32_LEAN_AND_MEAN | |
98 | # include <windows.h> | |
99 | /* Get _get_osfhandle. */ | |
100 | # include "msvc-nothrow.h" | |
101 | # endif | |
102 | ||
103 | /* The gnulib override of fcntl is not needed in this file. */ | |
104 | # undef fcntl | |
105 | ||
106 | # if !HAVE_DECL_STRERROR_R | |
a5d1e89b RM |
107 | # ifndef HAVE_DECL_STRERROR_R |
108 | "this configure-time declaration test was not run" | |
109 | # endif | |
888c679b | 110 | # if STRERROR_R_CHAR_P |
a5d1e89b | 111 | char *strerror_r (); |
888c679b SP |
112 | # else |
113 | int strerror_r (); | |
114 | # endif | |
a5d1e89b RM |
115 | # endif |
116 | ||
196980f5 RM |
117 | /* The calling program should define program_name and set it to the |
118 | name of the executing program. */ | |
119 | extern char *program_name; | |
120 | ||
a5d1e89b | 121 | # if HAVE_STRERROR_R || defined strerror_r |
a44d2393 | 122 | # define __strerror_r strerror_r |
a5d1e89b | 123 | # endif /* HAVE_STRERROR_R || defined strerror_r */ |
a44d2393 | 124 | #endif /* not _LIBC */ |
196980f5 | 125 | |
888c679b SP |
126 | #if !_LIBC |
127 | /* Return non-zero if FD is open. */ | |
128 | static int | |
129 | is_open (int fd) | |
130 | { | |
131 | # if (defined _WIN32 || defined __WIN32__) && ! defined __CYGWIN__ | |
132 | /* On native Windows: The initial state of unassigned standard file | |
133 | descriptors is that they are open but point to an INVALID_HANDLE_VALUE. | |
134 | There is no fcntl, and the gnulib replacement fcntl does not support | |
135 | F_GETFL. */ | |
136 | return (HANDLE) _get_osfhandle (fd) != INVALID_HANDLE_VALUE; | |
137 | # else | |
138 | # ifndef F_GETFL | |
139 | # error Please port fcntl to your platform | |
140 | # endif | |
141 | return 0 <= fcntl (fd, F_GETFL); | |
142 | # endif | |
143 | } | |
144 | #endif | |
145 | ||
146 | static void | |
147 | flush_stdout (void) | |
148 | { | |
149 | #if !_LIBC | |
150 | int stdout_fd; | |
151 | ||
152 | # if GNULIB_FREOPEN_SAFER | |
153 | /* Use of gnulib's freopen-safer module normally ensures that | |
154 | fileno (stdout) == 1 | |
155 | whenever stdout is open. */ | |
156 | stdout_fd = STDOUT_FILENO; | |
157 | # else | |
158 | /* POSIX states that fileno (stdout) after fclose is unspecified. But in | |
159 | practice it is not a problem, because stdout is statically allocated and | |
160 | the fd of a FILE stream is stored as a field in its allocated memory. */ | |
161 | stdout_fd = fileno (stdout); | |
162 | # endif | |
163 | /* POSIX states that fflush (stdout) after fclose is unspecified; it | |
164 | is safe in glibc, but not on all other platforms. fflush (NULL) | |
165 | is always defined, but too draconian. */ | |
166 | if (0 <= stdout_fd && is_open (stdout_fd)) | |
167 | #endif | |
168 | fflush (stdout); | |
169 | } | |
170 | ||
a5d1e89b RM |
171 | static void |
172 | print_errno_message (int errnum) | |
173 | { | |
174 | char const *s; | |
175 | ||
176 | #if defined HAVE_STRERROR_R || _LIBC | |
177 | char errbuf[1024]; | |
888c679b | 178 | # if _LIBC || STRERROR_R_CHAR_P |
a5d1e89b RM |
179 | s = __strerror_r (errnum, errbuf, sizeof errbuf); |
180 | # else | |
181 | if (__strerror_r (errnum, errbuf, sizeof errbuf) == 0) | |
182 | s = errbuf; | |
183 | else | |
184 | s = 0; | |
185 | # endif | |
186 | #else | |
187 | s = strerror (errnum); | |
188 | #endif | |
189 | ||
190 | #if !_LIBC | |
191 | if (! s) | |
192 | s = _("Unknown system error"); | |
193 | #endif | |
194 | ||
e5e45b53 | 195 | #if _LIBC |
8a259a23 | 196 | __fxprintf (NULL, ": %s", s); |
10ffcd52 | 197 | #else |
a334319f | 198 | fprintf (stderr, ": %s", s); |
10ffcd52 | 199 | #endif |
a5d1e89b | 200 | } |
1fc0e331 | 201 | |
888c679b | 202 | static void _GL_ATTRIBUTE_FORMAT_PRINTF (3, 0) _GL_ARG_NONNULL ((3)) |
f43b8dd5 GG |
203 | error_tail (int status, int errnum, const char *message, va_list args, |
204 | unsigned int mode_flags) | |
1fc0e331 | 205 | { |
240c62a7 | 206 | #if _LIBC |
f43b8dd5 | 207 | int ret = __vfxprintf (stderr, message, args, mode_flags); |
fdb16de3 FW |
208 | if (ret < 0 && errno == ENOMEM && _IO_fwide (stderr, 0) > 0) |
209 | /* Leave a trace in case the heap allocation of the message string | |
210 | failed. */ | |
211 | fputws_unlocked (L"out of memory\n", stderr); | |
212 | #else | |
213 | vfprintf (stderr, message, args); | |
240c62a7 | 214 | #endif |
1fc0e331 UD |
215 | va_end (args); |
216 | ||
217 | ++error_message_count; | |
218 | if (errnum) | |
a5d1e89b | 219 | print_errno_message (errnum); |
240c62a7 | 220 | #if _LIBC |
8a259a23 | 221 | __fxprintf (NULL, "\n"); |
240c62a7 | 222 | #else |
10ffcd52 | 223 | putc ('\n', stderr); |
240c62a7 | 224 | #endif |
1fc0e331 UD |
225 | fflush (stderr); |
226 | if (status) | |
227 | exit (status); | |
228 | } | |
1fc0e331 UD |
229 | |
230 | ||
196980f5 RM |
231 | /* Print the program name and error message MESSAGE, which is a printf-style |
232 | format string with optional args. | |
233 | If ERRNUM is nonzero, print its corresponding system error message. | |
234 | Exit with status STATUS if it is nonzero. */ | |
196980f5 | 235 | void |
f43b8dd5 GG |
236 | __error_internal (int status, int errnum, const char *message, |
237 | va_list args, unsigned int mode_flags) | |
196980f5 | 238 | { |
8c620ae0 UD |
239 | #if defined _LIBC && defined __libc_ptf_call |
240 | /* We do not want this call to be cut short by a thread | |
241 | cancellation. Therefore disable cancellation for now. */ | |
242 | int state = PTHREAD_CANCEL_ENABLE; | |
e5d19c08 L |
243 | __libc_ptf_call (__pthread_setcancelstate, |
244 | (PTHREAD_CANCEL_DISABLE, &state), 0); | |
8c620ae0 UD |
245 | #endif |
246 | ||
888c679b | 247 | flush_stdout (); |
1fc0e331 | 248 | #ifdef _LIBC |
6293b803 | 249 | _IO_flockfile (stderr); |
1fc0e331 | 250 | #endif |
196980f5 RM |
251 | if (error_print_progname) |
252 | (*error_print_progname) (); | |
253 | else | |
1fc0e331 | 254 | { |
e5e45b53 | 255 | #if _LIBC |
8a259a23 | 256 | __fxprintf (NULL, "%s: ", program_name); |
10ffcd52 UD |
257 | #else |
258 | fprintf (stderr, "%s: ", program_name); | |
1fc0e331 | 259 | #endif |
1fc0e331 | 260 | } |
196980f5 | 261 | |
f43b8dd5 | 262 | error_tail (status, errnum, message, args, mode_flags); |
6293b803 UD |
263 | |
264 | #ifdef _LIBC | |
6293b803 | 265 | _IO_funlockfile (stderr); |
8c620ae0 | 266 | # ifdef __libc_ptf_call |
e5d19c08 | 267 | __libc_ptf_call (__pthread_setcancelstate, (state, NULL), 0); |
8c620ae0 | 268 | # endif |
6293b803 | 269 | #endif |
19bc17a9 | 270 | } |
f43b8dd5 GG |
271 | |
272 | void | |
273 | error (int status, int errnum, const char *message, ...) | |
274 | { | |
275 | va_list ap; | |
276 | va_start (ap, message); | |
277 | __error_internal (status, errnum, message, ap, 0); | |
278 | va_end (ap); | |
279 | } | |
19bc17a9 RM |
280 | \f |
281 | /* Sometimes we want to have at most one error per line. This | |
282 | variable controls whether this mode is selected or not. */ | |
283 | int error_one_per_line; | |
284 | ||
285 | void | |
f43b8dd5 GG |
286 | __error_at_line_internal (int status, int errnum, const char *file_name, |
287 | unsigned int line_number, const char *message, | |
288 | va_list args, unsigned int mode_flags) | |
19bc17a9 | 289 | { |
19bc17a9 RM |
290 | if (error_one_per_line) |
291 | { | |
292 | static const char *old_file_name; | |
293 | static unsigned int old_line_number; | |
196980f5 | 294 | |
1fc0e331 UD |
295 | if (old_line_number == line_number |
296 | && (file_name == old_file_name | |
15cc7dd1 UD |
297 | || (old_file_name != NULL |
298 | && file_name != NULL | |
299 | && strcmp (old_file_name, file_name) == 0))) | |
888c679b | 300 | |
19bc17a9 RM |
301 | /* Simply return and print nothing. */ |
302 | return; | |
303 | ||
304 | old_file_name = file_name; | |
305 | old_line_number = line_number; | |
306 | } | |
307 | ||
8c620ae0 UD |
308 | #if defined _LIBC && defined __libc_ptf_call |
309 | /* We do not want this call to be cut short by a thread | |
310 | cancellation. Therefore disable cancellation for now. */ | |
311 | int state = PTHREAD_CANCEL_ENABLE; | |
e5d19c08 L |
312 | __libc_ptf_call (__pthread_setcancelstate, |
313 | (PTHREAD_CANCEL_DISABLE, &state), | |
8c620ae0 UD |
314 | 0); |
315 | #endif | |
316 | ||
888c679b | 317 | flush_stdout (); |
1fc0e331 | 318 | #ifdef _LIBC |
6293b803 | 319 | _IO_flockfile (stderr); |
1fc0e331 | 320 | #endif |
19bc17a9 RM |
321 | if (error_print_progname) |
322 | (*error_print_progname) (); | |
323 | else | |
1fc0e331 | 324 | { |
e5e45b53 | 325 | #if _LIBC |
8a259a23 | 326 | __fxprintf (NULL, "%s:", program_name); |
10ffcd52 UD |
327 | #else |
328 | fprintf (stderr, "%s:", program_name); | |
1fc0e331 | 329 | #endif |
1fc0e331 | 330 | } |
19bc17a9 | 331 | |
e5e45b53 | 332 | #if _LIBC |
cd8e60ce UD |
333 | __fxprintf (NULL, file_name != NULL ? "%s:%d: " : " ", |
334 | file_name, line_number); | |
10ffcd52 | 335 | #else |
cd8e60ce UD |
336 | fprintf (stderr, file_name != NULL ? "%s:%d: " : " ", |
337 | file_name, line_number); | |
1fc0e331 | 338 | #endif |
19bc17a9 | 339 | |
f43b8dd5 | 340 | error_tail (status, errnum, message, args, mode_flags); |
6293b803 UD |
341 | |
342 | #ifdef _LIBC | |
6293b803 | 343 | _IO_funlockfile (stderr); |
8c620ae0 | 344 | # ifdef __libc_ptf_call |
e5d19c08 | 345 | __libc_ptf_call (__pthread_setcancelstate, (state, NULL), 0); |
8c620ae0 | 346 | # endif |
6293b803 | 347 | #endif |
196980f5 | 348 | } |
2f6d1f1b | 349 | |
f43b8dd5 GG |
350 | void |
351 | error_at_line (int status, int errnum, const char *file_name, | |
352 | unsigned int line_number, const char *message, ...) | |
353 | { | |
354 | va_list ap; | |
355 | va_start (ap, message); | |
356 | __error_at_line_internal (status, errnum, file_name, line_number, | |
357 | message, ap, 0); | |
358 | va_end (ap); | |
359 | } | |
360 | ||
2f6d1f1b UD |
361 | #ifdef _LIBC |
362 | /* Make the weak alias. */ | |
a44d2393 UD |
363 | # undef error |
364 | # undef error_at_line | |
2f6d1f1b UD |
365 | weak_alias (__error, error) |
366 | weak_alias (__error_at_line, error_at_line) | |
367 | #endif |