Add prototypes for __error and __error_at_line.
[kopensolaris-gnu/glibc.git] / misc / error.c
1 /* Error handler for noninteractive utilities
2    Copyright (C) 1990-1998, 2000 Free Software Foundation, Inc.
3
4    This file is part of the GNU C Library.  Its master source is NOT part of
5    the C library, however.  The master source lives in /gd/gnu/lib.
6
7    The GNU C Library is free software; you can redistribute it and/or
8    modify it under the terms of the GNU Library General Public License as
9    published by the Free Software Foundation; either version 2 of the
10    License, or (at your option) any later version.
11
12    The GNU C Library is distributed in the hope that it will be useful,
13    but WITHOUT ANY WARRANTY; without even the implied warranty of
14    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
15    Library General Public License for more details.
16
17    You should have received a copy of the GNU Library General Public
18    License along with the GNU C Library; see the file COPYING.LIB.  If not,
19    write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
20    Boston, MA 02111-1307, USA.  */
21
22 /* Written by David MacKenzie <djm@gnu.ai.mit.edu>.  */
23
24 #ifdef HAVE_CONFIG_H
25 # include <config.h>
26 #endif
27
28 #include <stdio.h>
29 #include <libintl.h>
30
31 #if HAVE_VPRINTF || HAVE_DOPRNT || _LIBC
32 # if __STDC__
33 #  include <stdarg.h>
34 #  define VA_START(args, lastarg) va_start(args, lastarg)
35 # else
36 #  include <varargs.h>
37 #  define VA_START(args, lastarg) va_start(args)
38 # endif
39 #else
40 # define va_alist a1, a2, a3, a4, a5, a6, a7, a8
41 # define va_dcl char *a1, *a2, *a3, *a4, *a5, *a6, *a7, *a8;
42 #endif
43
44 #if STDC_HEADERS || _LIBC
45 # include <stdlib.h>
46 # include <string.h>
47 #else
48 void exit ();
49 #endif
50
51 #include "error.h"
52
53 #ifndef _
54 # define _(String) String
55 #endif
56
57 /* If NULL, error will flush stdout, then print on stderr the program
58    name, a colon and a space.  Otherwise, error will call this
59    function without parameters instead.  */
60 void (*error_print_progname) (
61 #if __STDC__ - 0
62                               void
63 #endif
64                               );
65
66 /* This variable is incremented each time `error' is called.  */
67 unsigned int error_message_count;
68
69 #ifdef _LIBC
70 /* In the GNU C library, there is a predefined variable for this.  */
71
72 # define program_name program_invocation_name
73 # include <errno.h>
74
75 /* In GNU libc we want do not want to use the common name `error' directly.
76    Instead make it a weak alias.  */
77 extern void __error (int status, int errnum, const char *message, ...);
78 extern void __error_at_line (int status, int errnum, const char *file_name,
79                              unsigned int line_number, const char *message,
80                              ...);
81 # define error __error
82 # define error_at_line __error_at_line
83
84 # ifdef USE_IN_LIBIO
85 # include <libio/iolibio.h>
86 #  define fflush(s) _IO_fflush (s)
87 # endif
88
89 #else /* not _LIBC */
90
91 /* The calling program should define program_name and set it to the
92    name of the executing program.  */
93 extern char *program_name;
94
95 # ifdef HAVE_STRERROR_R
96 #  define __strerror_r strerror_r
97 # else
98 #  if HAVE_STRERROR
99 #   ifndef strerror             /* On some systems, strerror is a macro */
100 char *strerror ();
101 #   endif
102 #  else
103 static char *
104 private_strerror (errnum)
105      int errnum;
106 {
107   extern char *sys_errlist[];
108   extern int sys_nerr;
109
110   if (errnum > 0 && errnum <= sys_nerr)
111     return _(sys_errlist[errnum]);
112   return _("Unknown system error");
113 }
114 #   define strerror private_strerror
115 #  endif /* HAVE_STRERROR */
116 # endif /* HAVE_STRERROR_R */
117 #endif  /* not _LIBC */
118
119 /* Print the program name and error message MESSAGE, which is a printf-style
120    format string with optional args.
121    If ERRNUM is nonzero, print its corresponding system error message.
122    Exit with status STATUS if it is nonzero.  */
123 /* VARARGS */
124
125 void
126 #if defined VA_START && __STDC__
127 error (int status, int errnum, const char *message, ...)
128 #else
129 error (status, errnum, message, va_alist)
130      int status;
131      int errnum;
132      char *message;
133      va_dcl
134 #endif
135 {
136 #ifdef VA_START
137   va_list args;
138 #endif
139
140   if (error_print_progname)
141     (*error_print_progname) ();
142   else
143     {
144       fflush (stdout);
145       fprintf (stderr, "%s: ", program_name);
146     }
147
148 #ifdef VA_START
149   VA_START (args, message);
150 # if HAVE_VPRINTF || _LIBC
151   vfprintf (stderr, message, args);
152 # else
153   _doprnt (message, args, stderr);
154 # endif
155   va_end (args);
156 #else
157   fprintf (stderr, message, a1, a2, a3, a4, a5, a6, a7, a8);
158 #endif
159
160   ++error_message_count;
161   if (errnum)
162     {
163 #if defined HAVE_STRERROR_R || _LIBC
164       char errbuf[1024];
165       fprintf (stderr, ": %s", __strerror_r (errnum, errbuf, sizeof errbuf));
166 #else
167       fprintf (stderr, ": %s", strerror (errnum));
168 #endif
169     }
170   putc ('\n', stderr);
171   fflush (stderr);
172   if (status)
173     exit (status);
174 }
175 \f
176 /* Sometimes we want to have at most one error per line.  This
177    variable controls whether this mode is selected or not.  */
178 int error_one_per_line;
179
180 void
181 #if defined VA_START && __STDC__
182 error_at_line (int status, int errnum, const char *file_name,
183                unsigned int line_number, const char *message, ...)
184 #else
185 error_at_line (status, errnum, file_name, line_number, message, va_alist)
186      int status;
187      int errnum;
188      const char *file_name;
189      unsigned int line_number;
190      char *message;
191      va_dcl
192 #endif
193 {
194 #ifdef VA_START
195   va_list args;
196 #endif
197
198   if (error_one_per_line)
199     {
200       static const char *old_file_name;
201       static unsigned int old_line_number;
202
203       if (old_line_number == line_number &&
204           (file_name == old_file_name || !strcmp (old_file_name, file_name)))
205         /* Simply return and print nothing.  */
206         return;
207
208       old_file_name = file_name;
209       old_line_number = line_number;
210     }
211
212   if (error_print_progname)
213     (*error_print_progname) ();
214   else
215     {
216       fflush (stdout);
217       fprintf (stderr, "%s:", program_name);
218     }
219
220   if (file_name != NULL)
221     fprintf (stderr, "%s:%d: ", file_name, line_number);
222
223 #ifdef VA_START
224   VA_START (args, message);
225 # if HAVE_VPRINTF || _LIBC
226   vfprintf (stderr, message, args);
227 # else
228   _doprnt (message, args, stderr);
229 # endif
230   va_end (args);
231 #else
232   fprintf (stderr, message, a1, a2, a3, a4, a5, a6, a7, a8);
233 #endif
234
235   ++error_message_count;
236   if (errnum)
237     {
238 #if defined HAVE_STRERROR_R || _LIBC
239       char errbuf[1024];
240       fprintf (stderr, ": %s", __strerror_r (errnum, errbuf, sizeof errbuf));
241 #else
242       fprintf (stderr, ": %s", strerror (errnum));
243 #endif
244     }
245   putc ('\n', stderr);
246   fflush (stderr);
247   if (status)
248     exit (status);
249 }
250
251 #ifdef _LIBC
252 /* Make the weak alias.  */
253 # undef error
254 # undef error_at_line
255 weak_alias (__error, error)
256 weak_alias (__error_at_line, error_at_line)
257 #endif