1 /* Error handler for noninteractive utilities
2 Copyright (C) 1990-1998, 2000-2007, 2009-2024 Free Software Foundation, Inc.
3 This file is part of the GNU C Library.
5 This file is free software: you can redistribute it and/or modify
6 it under the terms of the GNU Lesser General Public License as
7 published by the Free Software Foundation; either version 2.1 of the
8 License, or (at your option) any later version.
10 This file 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
13 GNU Lesser General Public License for more details.
15 You should have received a copy of the GNU Lesser General Public License
16 along with this program. If not, see <https://www.gnu.org/licenses/>. */
18 /* Written by David MacKenzie <djm@gnu.ai.mit.edu>. */
22 # define _GL_NO_INLINE_ERROR
32 #if !_LIBC && ENABLE_NLS
34 # define _(msgid) gettext (msgid)
42 # define mbsrtowcs __mbsrtowcs
43 # define USE_UNLOCKED_IO 0
44 # define _GL_ATTRIBUTE_FORMAT_PRINTF_STANDARD(a, b)
45 # define _GL_ARG_NONNULL(a)
49 # include "unlocked-io.h"
53 # define _(String) String
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. */
59 void (*error_print_progname
) (void);
61 /* This variable is incremented each time 'error' is called. */
62 unsigned int error_message_count
;
65 /* In the GNU C library, there is a predefined variable for this. */
67 # define program_name program_invocation_name
70 # include <libio/libioP.h>
72 /* In GNU libc we want do not want to use the common name 'error' directly.
73 Instead make it a weak alias. */
74 extern void __error (int status
, int errnum
, const char *message
, ...)
75 __attribute__ ((__format__ (__printf__
, 3, 4)));
76 extern void __error_at_line (int status
, int errnum
, const char *file_name
,
77 unsigned int line_number
, const char *message
,
79 __attribute__ ((__format__ (__printf__
, 5, 6)));
80 # define error __error
81 # define error_at_line __error_at_line
83 # include <libio/iolibio.h>
84 # define fflush(s) _IO_fflush (s)
86 # define putc(c, fp) _IO_putc (c, fp)
88 # include <bits/libc-lock.h>
95 # if defined _WIN32 && ! defined __CYGWIN__
96 /* Get declarations of the native Windows API functions. */
97 # define WIN32_LEAN_AND_MEAN
99 /* Get _get_osfhandle. */
100 # if GNULIB_MSVC_NOTHROW
101 # include "msvc-nothrow.h"
107 /* The gnulib override of fcntl is not needed in this file. */
110 # if !(GNULIB_STRERROR_R_POSIX || HAVE_DECL_STRERROR_R)
111 # ifndef HAVE_DECL_STRERROR_R
112 "this configure-time declaration test was not run"
114 # if STRERROR_R_CHAR_P
115 char *strerror_r (int errnum
, char *buf
, size_t buflen
);
117 int strerror_r (int errnum
, char *buf
, size_t buflen
);
121 # define program_name getprogname ()
123 # if GNULIB_STRERROR_R_POSIX || HAVE_STRERROR_R || defined strerror_r
124 # define __strerror_r strerror_r
125 # endif /* GNULIB_STRERROR_R_POSIX || HAVE_STRERROR_R || defined strerror_r */
126 #endif /* not _LIBC */
129 /* Return non-zero if FD is open. */
133 # if defined _WIN32 && ! defined __CYGWIN__
134 /* On native Windows: The initial state of unassigned standard file
135 descriptors is that they are open but point to an INVALID_HANDLE_VALUE.
136 There is no fcntl, and the gnulib replacement fcntl does not support
138 return (HANDLE
) _get_osfhandle (fd
) != INVALID_HANDLE_VALUE
;
141 # error Please port fcntl to your platform
143 return 0 <= fcntl (fd
, F_GETFL
);
154 # if GNULIB_FREOPEN_SAFER
155 /* Use of gnulib's freopen-safer module normally ensures that
157 whenever stdout is open. */
158 stdout_fd
= STDOUT_FILENO
;
160 /* POSIX states that fileno (stdout) after fclose is unspecified. But in
161 practice it is not a problem, because stdout is statically allocated and
162 the fd of a FILE stream is stored as a field in its allocated memory. */
163 stdout_fd
= fileno (stdout
);
165 /* POSIX states that fflush (stdout) after fclose is unspecified; it
166 is safe in glibc, but not on all other platforms. fflush (NULL)
167 is always defined, but too draconian. */
168 if (0 <= stdout_fd
&& is_open (stdout_fd
))
174 print_errno_message (int errnum
)
178 #if _LIBC || GNULIB_STRERROR_R_POSIX || defined HAVE_STRERROR_R
180 # if _LIBC || (!GNULIB_STRERROR_R_POSIX && STRERROR_R_CHAR_P)
181 s
= __strerror_r (errnum
, errbuf
, sizeof errbuf
);
183 if (__strerror_r (errnum
, errbuf
, sizeof errbuf
) == 0)
189 s
= strerror (errnum
);
194 s
= _("Unknown system error");
198 __fxprintf (NULL
, ": %s", s
);
200 fprintf (stderr
, ": %s", s
);
204 static void _GL_ATTRIBUTE_FORMAT_PRINTF_STANDARD (3, 0) _GL_ARG_NONNULL ((3))
205 error_tail (int status
, int errnum
, const char *message
, va_list args
)
208 if (_IO_fwide (stderr
, 0) > 0)
210 size_t len
= strlen (message
) + 1;
211 wchar_t *wmessage
= NULL
;
215 bool use_malloc
= false;
219 if (__libc_use_alloca (len
* sizeof (wchar_t)))
220 wmessage
= (wchar_t *) alloca (len
* sizeof (wchar_t));
226 wchar_t *p
= (wchar_t *) realloc (wmessage
,
227 len
* sizeof (wchar_t));
231 fputws_unlocked (L
"out of memory\n", stderr
);
238 memset (&st
, '\0', sizeof (st
));
241 res
= mbsrtowcs (wmessage
, &tmp
, len
, &st
);
245 if (__builtin_expect (len
>= SIZE_MAX
/ sizeof (wchar_t) / 2, 0))
247 /* This really should not happen if everything is fine. */
255 if (res
== (size_t) -1)
257 /* The string cannot be converted. */
263 wmessage
= (wchar_t *) L
"???";
266 __vfwprintf (stderr
, wmessage
, args
);
273 vfprintf (stderr
, message
, args
);
275 ++error_message_count
;
277 print_errno_message (errnum
);
279 __fxprintf (NULL
, "\n");
289 /* Print the program name and error message MESSAGE, which is a printf-style
290 format string with optional args.
291 If ERRNUM is nonzero, print its corresponding system error message.
292 Exit with status STATUS if it is nonzero. */
294 error (int status
, int errnum
, const char *message
, ...)
298 #if defined _LIBC && defined __libc_ptf_call
299 /* We do not want this call to be cut short by a thread
300 cancellation. Therefore disable cancellation for now. */
301 int state
= PTHREAD_CANCEL_ENABLE
;
302 __libc_ptf_call (pthread_setcancelstate
, (PTHREAD_CANCEL_DISABLE
, &state
),
308 _IO_flockfile (stderr
);
310 if (error_print_progname
)
311 (*error_print_progname
) ();
315 __fxprintf (NULL
, "%s: ", program_name
);
317 fprintf (stderr
, "%s: ", program_name
);
321 va_start (args
, message
);
322 error_tail (status
, errnum
, message
, args
);
326 _IO_funlockfile (stderr
);
327 # ifdef __libc_ptf_call
328 __libc_ptf_call (pthread_setcancelstate
, (state
, NULL
), 0);
333 /* Sometimes we want to have at most one error per line. This
334 variable controls whether this mode is selected or not. */
335 int error_one_per_line
;
338 error_at_line (int status
, int errnum
, const char *file_name
,
339 unsigned int line_number
, const char *message
, ...)
343 if (error_one_per_line
)
345 static const char *old_file_name
;
346 static unsigned int old_line_number
;
348 if (old_line_number
== line_number
349 && (file_name
== old_file_name
350 || (old_file_name
!= NULL
352 && strcmp (old_file_name
, file_name
) == 0)))
354 /* Simply return and print nothing. */
357 old_file_name
= file_name
;
358 old_line_number
= line_number
;
361 #if defined _LIBC && defined __libc_ptf_call
362 /* We do not want this call to be cut short by a thread
363 cancellation. Therefore disable cancellation for now. */
364 int state
= PTHREAD_CANCEL_ENABLE
;
365 __libc_ptf_call (pthread_setcancelstate
, (PTHREAD_CANCEL_DISABLE
, &state
),
371 _IO_flockfile (stderr
);
373 if (error_print_progname
)
374 (*error_print_progname
) ();
378 __fxprintf (NULL
, "%s:", program_name
);
380 fprintf (stderr
, "%s:", program_name
);
385 __fxprintf (NULL
, file_name
!= NULL
? "%s:%u: " : " ",
386 file_name
, line_number
);
388 fprintf (stderr
, file_name
!= NULL
? "%s:%u: " : " ",
389 file_name
, line_number
);
392 va_start (args
, message
);
393 error_tail (status
, errnum
, message
, args
);
397 _IO_funlockfile (stderr
);
398 # ifdef __libc_ptf_call
399 __libc_ptf_call (pthread_setcancelstate
, (state
, NULL
), 0);
405 /* Make the weak alias. */
407 # undef error_at_line
408 weak_alias (__error
, error
)
409 weak_alias (__error_at_line
, error_at_line
)