Blame gnu/error.c

Packit 1ef1a9
/* Error handler for noninteractive utilities
Packit 1ef1a9
   Copyright (C) 1990-1998, 2000-2007, 2009-2015 Free Software Foundation, Inc.
Packit 1ef1a9
   This file is part of the GNU C Library.
Packit 1ef1a9
Packit 1ef1a9
   This program is free software: you can redistribute it and/or modify
Packit 1ef1a9
   it under the terms of the GNU General Public License as published by
Packit 1ef1a9
   the Free Software Foundation; either version 3 of the License, or
Packit 1ef1a9
   (at your option) any later version.
Packit 1ef1a9
Packit 1ef1a9
   This program is distributed in the hope that it will be useful,
Packit 1ef1a9
   but WITHOUT ANY WARRANTY; without even the implied warranty of
Packit 1ef1a9
   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
Packit 1ef1a9
   GNU General Public License for more details.
Packit 1ef1a9
Packit 1ef1a9
   You should have received a copy of the GNU General Public License
Packit 1ef1a9
   along with this program.  If not, see <http://www.gnu.org/licenses/>.  */
Packit 1ef1a9
Packit 1ef1a9
/* Written by David MacKenzie <djm@gnu.ai.mit.edu>.  */
Packit 1ef1a9
Packit 1ef1a9
#if !_LIBC
Packit 1ef1a9
# include <config.h>
Packit 1ef1a9
#endif
Packit 1ef1a9
Packit 1ef1a9
#include "error.h"
Packit 1ef1a9
Packit 1ef1a9
#include <stdarg.h>
Packit 1ef1a9
#include <stdio.h>
Packit 1ef1a9
#include <stdlib.h>
Packit 1ef1a9
#include <string.h>
Packit 1ef1a9
Packit 1ef1a9
#if !_LIBC && ENABLE_NLS
Packit 1ef1a9
# include "gettext.h"
Packit 1ef1a9
# define _(msgid) gettext (msgid)
Packit 1ef1a9
#endif
Packit 1ef1a9
Packit 1ef1a9
#ifdef _LIBC
Packit 1ef1a9
# include <libintl.h>
Packit 1ef1a9
# include <stdbool.h>
Packit 1ef1a9
# include <stdint.h>
Packit 1ef1a9
# include <wchar.h>
Packit 1ef1a9
# define mbsrtowcs __mbsrtowcs
Packit 1ef1a9
# define USE_UNLOCKED_IO 0
Packit 1ef1a9
# define _GL_ATTRIBUTE_FORMAT_PRINTF(a, b)
Packit 1ef1a9
# define _GL_ARG_NONNULL(a)
Packit 1ef1a9
#endif
Packit 1ef1a9
Packit 1ef1a9
#if USE_UNLOCKED_IO
Packit 1ef1a9
# include "unlocked-io.h"
Packit 1ef1a9
#endif
Packit 1ef1a9
Packit 1ef1a9
#ifndef _
Packit 1ef1a9
# define _(String) String
Packit 1ef1a9
#endif
Packit 1ef1a9
Packit 1ef1a9
/* If NULL, error will flush stdout, then print on stderr the program
Packit 1ef1a9
   name, a colon and a space.  Otherwise, error will call this
Packit 1ef1a9
   function without parameters instead.  */
Packit 1ef1a9
void (*error_print_progname) (void);
Packit 1ef1a9
Packit 1ef1a9
/* This variable is incremented each time 'error' is called.  */
Packit 1ef1a9
unsigned int error_message_count;
Packit 1ef1a9
Packit 1ef1a9
#ifdef _LIBC
Packit 1ef1a9
/* In the GNU C library, there is a predefined variable for this.  */
Packit 1ef1a9
Packit 1ef1a9
# define program_name program_invocation_name
Packit 1ef1a9
# include <errno.h>
Packit 1ef1a9
# include <limits.h>
Packit 1ef1a9
# include <libio/libioP.h>
Packit 1ef1a9
Packit 1ef1a9
/* In GNU libc we want do not want to use the common name 'error' directly.
Packit 1ef1a9
   Instead make it a weak alias.  */
Packit 1ef1a9
extern void __error (int status, int errnum, const char *message, ...)
Packit 1ef1a9
     __attribute__ ((__format__ (__printf__, 3, 4)));
Packit 1ef1a9
extern void __error_at_line (int status, int errnum, const char *file_name,
Packit 1ef1a9
                             unsigned int line_number, const char *message,
Packit 1ef1a9
                             ...)
Packit 1ef1a9
     __attribute__ ((__format__ (__printf__, 5, 6)));
Packit 1ef1a9
# define error __error
Packit 1ef1a9
# define error_at_line __error_at_line
Packit 1ef1a9
Packit 1ef1a9
# include <libio/iolibio.h>
Packit 1ef1a9
# define fflush(s) _IO_fflush (s)
Packit 1ef1a9
# undef putc
Packit 1ef1a9
# define putc(c, fp) _IO_putc (c, fp)
Packit 1ef1a9
Packit 1ef1a9
# include <bits/libc-lock.h>
Packit 1ef1a9
Packit 1ef1a9
#else /* not _LIBC */
Packit 1ef1a9
Packit 1ef1a9
# include <fcntl.h>
Packit 1ef1a9
# include <unistd.h>
Packit 1ef1a9
Packit 1ef1a9
# if (defined _WIN32 || defined __WIN32__) && ! defined __CYGWIN__
Packit 1ef1a9
/* Get declarations of the native Windows API functions.  */
Packit 1ef1a9
#  define WIN32_LEAN_AND_MEAN
Packit 1ef1a9
#  include <windows.h>
Packit 1ef1a9
/* Get _get_osfhandle.  */
Packit 1ef1a9
#  include "msvc-nothrow.h"
Packit 1ef1a9
# endif
Packit 1ef1a9
Packit 1ef1a9
/* The gnulib override of fcntl is not needed in this file.  */
Packit 1ef1a9
# undef fcntl
Packit 1ef1a9
Packit 1ef1a9
# if !HAVE_DECL_STRERROR_R
Packit 1ef1a9
#  ifndef HAVE_DECL_STRERROR_R
Packit 1ef1a9
"this configure-time declaration test was not run"
Packit 1ef1a9
#  endif
Packit 1ef1a9
#  if STRERROR_R_CHAR_P
Packit 1ef1a9
char *strerror_r ();
Packit 1ef1a9
#  else
Packit 1ef1a9
int strerror_r ();
Packit 1ef1a9
#  endif
Packit 1ef1a9
# endif
Packit 1ef1a9
Packit 1ef1a9
/* The calling program should define program_name and set it to the
Packit 1ef1a9
   name of the executing program.  */
Packit 1ef1a9
extern char *program_name;
Packit 1ef1a9
Packit 1ef1a9
# if HAVE_STRERROR_R || defined strerror_r
Packit 1ef1a9
#  define __strerror_r strerror_r
Packit 1ef1a9
# endif /* HAVE_STRERROR_R || defined strerror_r */
Packit 1ef1a9
#endif  /* not _LIBC */
Packit 1ef1a9
Packit 1ef1a9
#if !_LIBC
Packit 1ef1a9
/* Return non-zero if FD is open.  */
Packit 1ef1a9
static int
Packit 1ef1a9
is_open (int fd)
Packit 1ef1a9
{
Packit 1ef1a9
# if (defined _WIN32 || defined __WIN32__) && ! defined __CYGWIN__
Packit 1ef1a9
  /* On native Windows: The initial state of unassigned standard file
Packit 1ef1a9
     descriptors is that they are open but point to an INVALID_HANDLE_VALUE.
Packit 1ef1a9
     There is no fcntl, and the gnulib replacement fcntl does not support
Packit 1ef1a9
     F_GETFL.  */
Packit 1ef1a9
  return (HANDLE) _get_osfhandle (fd) != INVALID_HANDLE_VALUE;
Packit 1ef1a9
# else
Packit 1ef1a9
#  ifndef F_GETFL
Packit 1ef1a9
#   error Please port fcntl to your platform
Packit 1ef1a9
#  endif
Packit 1ef1a9
  return 0 <= fcntl (fd, F_GETFL);
Packit 1ef1a9
# endif
Packit 1ef1a9
}
Packit 1ef1a9
#endif
Packit 1ef1a9
Packit 1ef1a9
static void
Packit 1ef1a9
flush_stdout (void)
Packit 1ef1a9
{
Packit 1ef1a9
#if !_LIBC
Packit 1ef1a9
  int stdout_fd;
Packit 1ef1a9
Packit 1ef1a9
# if GNULIB_FREOPEN_SAFER
Packit 1ef1a9
  /* Use of gnulib's freopen-safer module normally ensures that
Packit 1ef1a9
       fileno (stdout) == 1
Packit 1ef1a9
     whenever stdout is open.  */
Packit 1ef1a9
  stdout_fd = STDOUT_FILENO;
Packit 1ef1a9
# else
Packit 1ef1a9
  /* POSIX states that fileno (stdout) after fclose is unspecified.  But in
Packit 1ef1a9
     practice it is not a problem, because stdout is statically allocated and
Packit 1ef1a9
     the fd of a FILE stream is stored as a field in its allocated memory.  */
Packit 1ef1a9
  stdout_fd = fileno (stdout);
Packit 1ef1a9
# endif
Packit 1ef1a9
  /* POSIX states that fflush (stdout) after fclose is unspecified; it
Packit 1ef1a9
     is safe in glibc, but not on all other platforms.  fflush (NULL)
Packit 1ef1a9
     is always defined, but too draconian.  */
Packit 1ef1a9
  if (0 <= stdout_fd && is_open (stdout_fd))
Packit 1ef1a9
#endif
Packit 1ef1a9
    fflush (stdout);
Packit 1ef1a9
}
Packit 1ef1a9
Packit 1ef1a9
static void
Packit 1ef1a9
print_errno_message (int errnum)
Packit 1ef1a9
{
Packit 1ef1a9
  char const *s;
Packit 1ef1a9
Packit 1ef1a9
#if defined HAVE_STRERROR_R || _LIBC
Packit 1ef1a9
  char errbuf[1024];
Packit 1ef1a9
# if _LIBC || STRERROR_R_CHAR_P
Packit 1ef1a9
  s = __strerror_r (errnum, errbuf, sizeof errbuf);
Packit 1ef1a9
# else
Packit 1ef1a9
  if (__strerror_r (errnum, errbuf, sizeof errbuf) == 0)
Packit 1ef1a9
    s = errbuf;
Packit 1ef1a9
  else
Packit 1ef1a9
    s = 0;
Packit 1ef1a9
# endif
Packit 1ef1a9
#else
Packit 1ef1a9
  s = strerror (errnum);
Packit 1ef1a9
#endif
Packit 1ef1a9
Packit 1ef1a9
#if !_LIBC
Packit 1ef1a9
  if (! s)
Packit 1ef1a9
    s = _("Unknown system error");
Packit 1ef1a9
#endif
Packit 1ef1a9
Packit 1ef1a9
#if _LIBC
Packit 1ef1a9
  __fxprintf (NULL, ": %s", s);
Packit 1ef1a9
#else
Packit 1ef1a9
  fprintf (stderr, ": %s", s);
Packit 1ef1a9
#endif
Packit 1ef1a9
}
Packit 1ef1a9
Packit 1ef1a9
static void _GL_ATTRIBUTE_FORMAT_PRINTF (3, 0) _GL_ARG_NONNULL ((3))
Packit 1ef1a9
error_tail (int status, int errnum, const char *message, va_list args)
Packit 1ef1a9
{
Packit 1ef1a9
#if _LIBC
Packit 1ef1a9
  if (_IO_fwide (stderr, 0) > 0)
Packit 1ef1a9
    {
Packit 1ef1a9
      size_t len = strlen (message) + 1;
Packit 1ef1a9
      wchar_t *wmessage = NULL;
Packit 1ef1a9
      mbstate_t st;
Packit 1ef1a9
      size_t res;
Packit 1ef1a9
      const char *tmp;
Packit 1ef1a9
      bool use_malloc = false;
Packit 1ef1a9
Packit 1ef1a9
      while (1)
Packit 1ef1a9
        {
Packit 1ef1a9
          if (__libc_use_alloca (len * sizeof (wchar_t)))
Packit 1ef1a9
            wmessage = (wchar_t *) alloca (len * sizeof (wchar_t));
Packit 1ef1a9
          else
Packit 1ef1a9
            {
Packit 1ef1a9
              if (!use_malloc)
Packit 1ef1a9
                wmessage = NULL;
Packit 1ef1a9
Packit 1ef1a9
              wchar_t *p = (wchar_t *) realloc (wmessage,
Packit 1ef1a9
                                                len * sizeof (wchar_t));
Packit 1ef1a9
              if (p == NULL)
Packit 1ef1a9
                {
Packit 1ef1a9
                  free (wmessage);
Packit 1ef1a9
                  fputws_unlocked (L"out of memory\n", stderr);
Packit 1ef1a9
                  return;
Packit 1ef1a9
                }
Packit 1ef1a9
              wmessage = p;
Packit 1ef1a9
              use_malloc = true;
Packit 1ef1a9
            }
Packit 1ef1a9
Packit 1ef1a9
          memset (&st, '\0', sizeof (st));
Packit 1ef1a9
          tmp = message;
Packit 1ef1a9
Packit 1ef1a9
          res = mbsrtowcs (wmessage, &tmp, len, &st);
Packit 1ef1a9
          if (res != len)
Packit 1ef1a9
            break;
Packit 1ef1a9
Packit 1ef1a9
          if (__builtin_expect (len >= SIZE_MAX / sizeof (wchar_t) / 2, 0))
Packit 1ef1a9
            {
Packit 1ef1a9
              /* This really should not happen if everything is fine.  */
Packit 1ef1a9
              res = (size_t) -1;
Packit 1ef1a9
              break;
Packit 1ef1a9
            }
Packit 1ef1a9
Packit 1ef1a9
          len *= 2;
Packit 1ef1a9
        }
Packit 1ef1a9
Packit 1ef1a9
      if (res == (size_t) -1)
Packit 1ef1a9
        {
Packit 1ef1a9
          /* The string cannot be converted.  */
Packit 1ef1a9
          if (use_malloc)
Packit 1ef1a9
            {
Packit 1ef1a9
              free (wmessage);
Packit 1ef1a9
              use_malloc = false;
Packit 1ef1a9
            }
Packit 1ef1a9
          wmessage = (wchar_t *) L"???";
Packit 1ef1a9
        }
Packit 1ef1a9
Packit 1ef1a9
      __vfwprintf (stderr, wmessage, args);
Packit 1ef1a9
Packit 1ef1a9
      if (use_malloc)
Packit 1ef1a9
        free (wmessage);
Packit 1ef1a9
    }
Packit 1ef1a9
  else
Packit 1ef1a9
#endif
Packit 1ef1a9
    vfprintf (stderr, message, args);
Packit 1ef1a9
  va_end (args);
Packit 1ef1a9
Packit 1ef1a9
  ++error_message_count;
Packit 1ef1a9
  if (errnum)
Packit 1ef1a9
    print_errno_message (errnum);
Packit 1ef1a9
#if _LIBC
Packit 1ef1a9
  __fxprintf (NULL, "\n");
Packit 1ef1a9
#else
Packit 1ef1a9
  putc ('\n', stderr);
Packit 1ef1a9
#endif
Packit 1ef1a9
  fflush (stderr);
Packit 1ef1a9
  if (status)
Packit 1ef1a9
    exit (status);
Packit 1ef1a9
}
Packit 1ef1a9
Packit 1ef1a9
Packit 1ef1a9
/* Print the program name and error message MESSAGE, which is a printf-style
Packit 1ef1a9
   format string with optional args.
Packit 1ef1a9
   If ERRNUM is nonzero, print its corresponding system error message.
Packit 1ef1a9
   Exit with status STATUS if it is nonzero.  */
Packit 1ef1a9
void
Packit 1ef1a9
error (int status, int errnum, const char *message, ...)
Packit 1ef1a9
{
Packit 1ef1a9
  va_list args;
Packit 1ef1a9
Packit 1ef1a9
#if defined _LIBC && defined __libc_ptf_call
Packit 1ef1a9
  /* We do not want this call to be cut short by a thread
Packit 1ef1a9
     cancellation.  Therefore disable cancellation for now.  */
Packit 1ef1a9
  int state = PTHREAD_CANCEL_ENABLE;
Packit 1ef1a9
  __libc_ptf_call (pthread_setcancelstate, (PTHREAD_CANCEL_DISABLE, &state),
Packit 1ef1a9
                   0);
Packit 1ef1a9
#endif
Packit 1ef1a9
Packit 1ef1a9
  flush_stdout ();
Packit 1ef1a9
#ifdef _LIBC
Packit 1ef1a9
  _IO_flockfile (stderr);
Packit 1ef1a9
#endif
Packit 1ef1a9
  if (error_print_progname)
Packit 1ef1a9
    (*error_print_progname) ();
Packit 1ef1a9
  else
Packit 1ef1a9
    {
Packit 1ef1a9
#if _LIBC
Packit 1ef1a9
      __fxprintf (NULL, "%s: ", program_name);
Packit 1ef1a9
#else
Packit 1ef1a9
      fprintf (stderr, "%s: ", program_name);
Packit 1ef1a9
#endif
Packit 1ef1a9
    }
Packit 1ef1a9
Packit 1ef1a9
  va_start (args, message);
Packit 1ef1a9
  error_tail (status, errnum, message, args);
Packit 1ef1a9
Packit 1ef1a9
#ifdef _LIBC
Packit 1ef1a9
  _IO_funlockfile (stderr);
Packit 1ef1a9
# ifdef __libc_ptf_call
Packit 1ef1a9
  __libc_ptf_call (pthread_setcancelstate, (state, NULL), 0);
Packit 1ef1a9
# endif
Packit 1ef1a9
#endif
Packit 1ef1a9
}
Packit 1ef1a9

Packit 1ef1a9
/* Sometimes we want to have at most one error per line.  This
Packit 1ef1a9
   variable controls whether this mode is selected or not.  */
Packit 1ef1a9
int error_one_per_line;
Packit 1ef1a9
Packit 1ef1a9
void
Packit 1ef1a9
error_at_line (int status, int errnum, const char *file_name,
Packit 1ef1a9
               unsigned int line_number, const char *message, ...)
Packit 1ef1a9
{
Packit 1ef1a9
  va_list args;
Packit 1ef1a9
Packit 1ef1a9
  if (error_one_per_line)
Packit 1ef1a9
    {
Packit 1ef1a9
      static const char *old_file_name;
Packit 1ef1a9
      static unsigned int old_line_number;
Packit 1ef1a9
Packit 1ef1a9
      if (old_line_number == line_number
Packit 1ef1a9
          && (file_name == old_file_name
Packit 1ef1a9
              || (old_file_name != NULL
Packit 1ef1a9
                  && file_name != NULL
Packit 1ef1a9
                  && strcmp (old_file_name, file_name) == 0)))
Packit 1ef1a9
Packit 1ef1a9
        /* Simply return and print nothing.  */
Packit 1ef1a9
        return;
Packit 1ef1a9
Packit 1ef1a9
      old_file_name = file_name;
Packit 1ef1a9
      old_line_number = line_number;
Packit 1ef1a9
    }
Packit 1ef1a9
Packit 1ef1a9
#if defined _LIBC && defined __libc_ptf_call
Packit 1ef1a9
  /* We do not want this call to be cut short by a thread
Packit 1ef1a9
     cancellation.  Therefore disable cancellation for now.  */
Packit 1ef1a9
  int state = PTHREAD_CANCEL_ENABLE;
Packit 1ef1a9
  __libc_ptf_call (pthread_setcancelstate, (PTHREAD_CANCEL_DISABLE, &state),
Packit 1ef1a9
                   0);
Packit 1ef1a9
#endif
Packit 1ef1a9
Packit 1ef1a9
  flush_stdout ();
Packit 1ef1a9
#ifdef _LIBC
Packit 1ef1a9
  _IO_flockfile (stderr);
Packit 1ef1a9
#endif
Packit 1ef1a9
  if (error_print_progname)
Packit 1ef1a9
    (*error_print_progname) ();
Packit 1ef1a9
  else
Packit 1ef1a9
    {
Packit 1ef1a9
#if _LIBC
Packit 1ef1a9
      __fxprintf (NULL, "%s:", program_name);
Packit 1ef1a9
#else
Packit 1ef1a9
      fprintf (stderr, "%s:", program_name);
Packit 1ef1a9
#endif
Packit 1ef1a9
    }
Packit 1ef1a9
Packit 1ef1a9
#if _LIBC
Packit 1ef1a9
  __fxprintf (NULL, file_name != NULL ? "%s:%u: " : " ",
Packit 1ef1a9
              file_name, line_number);
Packit 1ef1a9
#else
Packit 1ef1a9
  fprintf (stderr, file_name != NULL ? "%s:%u: " : " ",
Packit 1ef1a9
           file_name, line_number);
Packit 1ef1a9
#endif
Packit 1ef1a9
Packit 1ef1a9
  va_start (args, message);
Packit 1ef1a9
  error_tail (status, errnum, message, args);
Packit 1ef1a9
Packit 1ef1a9
#ifdef _LIBC
Packit 1ef1a9
  _IO_funlockfile (stderr);
Packit 1ef1a9
# ifdef __libc_ptf_call
Packit 1ef1a9
  __libc_ptf_call (pthread_setcancelstate, (state, NULL), 0);
Packit 1ef1a9
# endif
Packit 1ef1a9
#endif
Packit 1ef1a9
}
Packit 1ef1a9
Packit 1ef1a9
#ifdef _LIBC
Packit 1ef1a9
/* Make the weak alias.  */
Packit 1ef1a9
# undef error
Packit 1ef1a9
# undef error_at_line
Packit 1ef1a9
weak_alias (__error, error)
Packit 1ef1a9
weak_alias (__error_at_line, error_at_line)
Packit 1ef1a9
#endif