1/* Error handler for noninteractive utilities
2 Copyright (C) 1990-2019 Free Software Foundation, Inc.
3 This file is part of the GNU C Library.
4
5 The GNU C Library is free software; you can redistribute it and/or
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.
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
13 Lesser General Public License for more details.
14
15 You should have received a copy of the GNU Lesser General Public
16 License along with the GNU C Library; if not, see
17 <http://www.gnu.org/licenses/>. */
18
19/* Written by David MacKenzie <djm@gnu.ai.mit.edu>. */
20
21#if !_LIBC
22# include <config.h>
23#endif
24
25#include "error.h"
26
27#include <stdarg.h>
28#include <stdio.h>
29#include <stdlib.h>
30#include <string.h>
31
32#if !_LIBC && ENABLE_NLS
33# include "gettext.h"
34# define _(msgid) gettext (msgid)
35#endif
36
37#ifdef _LIBC
38# include <libintl.h>
39# include <stdbool.h>
40# include <stdint.h>
41# include <wchar.h>
42# define mbsrtowcs __mbsrtowcs
43# define USE_UNLOCKED_IO 0
44# define _GL_ATTRIBUTE_FORMAT_PRINTF(a, b)
45# define _GL_ARG_NONNULL(a)
46#endif
47
48#if USE_UNLOCKED_IO
49# include "unlocked-io.h"
50#endif
51
52#ifndef _
53# define _(String) String
54#endif
55
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. */
59void (*error_print_progname) (void);
60
61/* This variable is incremented each time 'error' is called. */
62unsigned int error_message_count;
63
64#ifdef _LIBC
65/* In the GNU C library, there is a predefined variable for this. */
66
67# define program_name program_invocation_name
68# include <errno.h>
69# include <limits.h>
70# include <libio/libioP.h>
71
72/* In GNU libc we want do not want to use the common name 'error' directly.
73 Instead make it a weak alias. */
74extern void __error (int status, int errnum, const char *message, ...)
75 __attribute__ ((__format__ (__printf__, 3, 4)));
76extern void __error_at_line (int status, int errnum, const char *file_name,
77 unsigned int line_number, const char *message,
78 ...)
79 __attribute__ ((__format__ (__printf__, 5, 6)));;
80# define error __error
81# define error_at_line __error_at_line
82
83# include <libio/iolibio.h>
84# define fflush(s) _IO_fflush (s)
85# undef putc
86# define putc(c, fp) _IO_putc (c, fp)
87
88# include <libc-lock.h>
89
90#else /* not _LIBC */
91
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
107# ifndef HAVE_DECL_STRERROR_R
108"this configure-time declaration test was not run"
109# endif
110# if STRERROR_R_CHAR_P
111char *strerror_r ();
112# else
113int strerror_r ();
114# endif
115# endif
116
117/* The calling program should define program_name and set it to the
118 name of the executing program. */
119extern char *program_name;
120
121# if HAVE_STRERROR_R || defined strerror_r
122# define __strerror_r strerror_r
123# endif /* HAVE_STRERROR_R || defined strerror_r */
124#endif /* not _LIBC */
125
126#if !_LIBC
127/* Return non-zero if FD is open. */
128static int
129is_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
146static void
147flush_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
171static void
172print_errno_message (int errnum)
173{
174 char const *s;
175
176#if defined HAVE_STRERROR_R || _LIBC
177 char errbuf[1024];
178# if _LIBC || STRERROR_R_CHAR_P
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
195#if _LIBC
196 __fxprintf (NULL, ": %s", s);
197#else
198 fprintf (stderr, ": %s", s);
199#endif
200}
201
202static void _GL_ATTRIBUTE_FORMAT_PRINTF (3, 0) _GL_ARG_NONNULL ((3))
203error_tail (int status, int errnum, const char *message, va_list args)
204{
205#if _LIBC
206 int ret = __vfxprintf (stderr, message, args);
207 if (ret < 0 && errno == ENOMEM && _IO_fwide (stderr, 0) > 0)
208 /* Leave a trace in case the heap allocation of the message string
209 failed. */
210 fputws_unlocked (L"out of memory\n", stderr);
211#else
212 vfprintf (stderr, message, args);
213#endif
214 va_end (args);
215
216 ++error_message_count;
217 if (errnum)
218 print_errno_message (errnum);
219#if _LIBC
220 __fxprintf (NULL, "\n");
221#else
222 putc ('\n', stderr);
223#endif
224 fflush (stderr);
225 if (status)
226 exit (status);
227}
228
229
230/* Print the program name and error message MESSAGE, which is a printf-style
231 format string with optional args.
232 If ERRNUM is nonzero, print its corresponding system error message.
233 Exit with status STATUS if it is nonzero. */
234void
235error (int status, int errnum, const char *message, ...)
236{
237 va_list args;
238
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;
243 __libc_ptf_call (__pthread_setcancelstate,
244 (PTHREAD_CANCEL_DISABLE, &state), 0);
245#endif
246
247 flush_stdout ();
248#ifdef _LIBC
249 _IO_flockfile (stderr);
250#endif
251 if (error_print_progname)
252 (*error_print_progname) ();
253 else
254 {
255#if _LIBC
256 __fxprintf (NULL, "%s: ", program_name);
257#else
258 fprintf (stderr, "%s: ", program_name);
259#endif
260 }
261
262 va_start (args, message);
263 error_tail (status, errnum, message, args);
264 va_end (args);
265
266#ifdef _LIBC
267 _IO_funlockfile (stderr);
268# ifdef __libc_ptf_call
269 __libc_ptf_call (__pthread_setcancelstate, (state, NULL), 0);
270# endif
271#endif
272}
273
274/* Sometimes we want to have at most one error per line. This
275 variable controls whether this mode is selected or not. */
276int error_one_per_line;
277
278void
279error_at_line (int status, int errnum, const char *file_name,
280 unsigned int line_number, const char *message, ...)
281{
282 va_list args;
283
284 if (error_one_per_line)
285 {
286 static const char *old_file_name;
287 static unsigned int old_line_number;
288
289 if (old_line_number == line_number
290 && (file_name == old_file_name
291 || (old_file_name != NULL
292 && file_name != NULL
293 && strcmp (old_file_name, file_name) == 0)))
294
295 /* Simply return and print nothing. */
296 return;
297
298 old_file_name = file_name;
299 old_line_number = line_number;
300 }
301
302#if defined _LIBC && defined __libc_ptf_call
303 /* We do not want this call to be cut short by a thread
304 cancellation. Therefore disable cancellation for now. */
305 int state = PTHREAD_CANCEL_ENABLE;
306 __libc_ptf_call (__pthread_setcancelstate,
307 (PTHREAD_CANCEL_DISABLE, &state),
308 0);
309#endif
310
311 flush_stdout ();
312#ifdef _LIBC
313 _IO_flockfile (stderr);
314#endif
315 if (error_print_progname)
316 (*error_print_progname) ();
317 else
318 {
319#if _LIBC
320 __fxprintf (NULL, "%s:", program_name);
321#else
322 fprintf (stderr, "%s:", program_name);
323#endif
324 }
325
326#if _LIBC
327 __fxprintf (NULL, file_name != NULL ? "%s:%d: " : " ",
328 file_name, line_number);
329#else
330 fprintf (stderr, file_name != NULL ? "%s:%d: " : " ",
331 file_name, line_number);
332#endif
333
334 va_start (args, message);
335 error_tail (status, errnum, message, args);
336 va_end (args);
337
338#ifdef _LIBC
339 _IO_funlockfile (stderr);
340# ifdef __libc_ptf_call
341 __libc_ptf_call (__pthread_setcancelstate, (state, NULL), 0);
342# endif
343#endif
344}
345
346#ifdef _LIBC
347/* Make the weak alias. */
348# undef error
349# undef error_at_line
350weak_alias (__error, error)
351weak_alias (__error_at_line, error_at_line)
352#endif
353