0
|
1 /* Extended support for using errno values.
|
|
2 Written by Fred Fish. fnf@cygnus.com
|
|
3 This file is in the public domain. --Per Bothner. */
|
|
4
|
|
5 #include "config.h"
|
|
6
|
|
7 #ifdef HAVE_SYS_ERRLIST
|
|
8 /* Note that errno.h (not sure what OS) or stdio.h (BSD 4.4, at least)
|
|
9 might declare sys_errlist in a way that the compiler might consider
|
|
10 incompatible with our later declaration, perhaps by using const
|
|
11 attributes. So we hide the declaration in errno.h (if any) using a
|
|
12 macro. */
|
|
13 #define sys_nerr sys_nerr__
|
|
14 #define sys_errlist sys_errlist__
|
|
15 #endif
|
|
16
|
|
17 #include "ansidecl.h"
|
|
18 #include "libiberty.h"
|
|
19
|
|
20 #include <stdio.h>
|
|
21 #include <errno.h>
|
|
22
|
|
23 #ifdef HAVE_SYS_ERRLIST
|
|
24 #undef sys_nerr
|
|
25 #undef sys_errlist
|
|
26 #endif
|
|
27
|
|
28 /* Routines imported from standard C runtime libraries. */
|
|
29
|
|
30 #ifdef HAVE_STDLIB_H
|
|
31 #include <stdlib.h>
|
|
32 #else
|
|
33 extern PTR malloc ();
|
|
34 #endif
|
|
35
|
|
36 #ifdef HAVE_STRING_H
|
|
37 #include <string.h>
|
|
38 #else
|
|
39 extern PTR memset ();
|
|
40 #endif
|
|
41
|
|
42 #ifndef MAX
|
|
43 # define MAX(a,b) ((a) > (b) ? (a) : (b))
|
|
44 #endif
|
|
45
|
|
46 static void init_error_tables (void);
|
|
47
|
|
48 /* Translation table for errno values. See intro(2) in most UNIX systems
|
|
49 Programmers Reference Manuals.
|
|
50
|
|
51 Note that this table is generally only accessed when it is used at runtime
|
|
52 to initialize errno name and message tables that are indexed by errno
|
|
53 value.
|
|
54
|
|
55 Not all of these errnos will exist on all systems. This table is the only
|
|
56 thing that should have to be updated as new error numbers are introduced.
|
|
57 It's sort of ugly, but at least its portable. */
|
|
58
|
|
59 struct error_info
|
|
60 {
|
|
61 const int value; /* The numeric value from <errno.h> */
|
|
62 const char *const name; /* The equivalent symbolic value */
|
|
63 #ifndef HAVE_SYS_ERRLIST
|
|
64 const char *const msg; /* Short message about this value */
|
|
65 #endif
|
|
66 };
|
|
67
|
|
68 #ifndef HAVE_SYS_ERRLIST
|
|
69 # define ENTRY(value, name, msg) {value, name, msg}
|
|
70 #else
|
|
71 # define ENTRY(value, name, msg) {value, name}
|
|
72 #endif
|
|
73
|
|
74 static const struct error_info error_table[] =
|
|
75 {
|
|
76 #if defined (EPERM)
|
|
77 ENTRY(EPERM, "EPERM", "Not owner"),
|
|
78 #endif
|
|
79 #if defined (ENOENT)
|
|
80 ENTRY(ENOENT, "ENOENT", "No such file or directory"),
|
|
81 #endif
|
|
82 #if defined (ESRCH)
|
|
83 ENTRY(ESRCH, "ESRCH", "No such process"),
|
|
84 #endif
|
|
85 #if defined (EINTR)
|
|
86 ENTRY(EINTR, "EINTR", "Interrupted system call"),
|
|
87 #endif
|
|
88 #if defined (EIO)
|
|
89 ENTRY(EIO, "EIO", "I/O error"),
|
|
90 #endif
|
|
91 #if defined (ENXIO)
|
|
92 ENTRY(ENXIO, "ENXIO", "No such device or address"),
|
|
93 #endif
|
|
94 #if defined (E2BIG)
|
|
95 ENTRY(E2BIG, "E2BIG", "Arg list too long"),
|
|
96 #endif
|
|
97 #if defined (ENOEXEC)
|
|
98 ENTRY(ENOEXEC, "ENOEXEC", "Exec format error"),
|
|
99 #endif
|
|
100 #if defined (EBADF)
|
|
101 ENTRY(EBADF, "EBADF", "Bad file number"),
|
|
102 #endif
|
|
103 #if defined (ECHILD)
|
|
104 ENTRY(ECHILD, "ECHILD", "No child processes"),
|
|
105 #endif
|
|
106 #if defined (EWOULDBLOCK) /* Put before EAGAIN, sometimes aliased */
|
|
107 ENTRY(EWOULDBLOCK, "EWOULDBLOCK", "Operation would block"),
|
|
108 #endif
|
|
109 #if defined (EAGAIN)
|
|
110 ENTRY(EAGAIN, "EAGAIN", "No more processes"),
|
|
111 #endif
|
|
112 #if defined (ENOMEM)
|
|
113 ENTRY(ENOMEM, "ENOMEM", "Not enough space"),
|
|
114 #endif
|
|
115 #if defined (EACCES)
|
|
116 ENTRY(EACCES, "EACCES", "Permission denied"),
|
|
117 #endif
|
|
118 #if defined (EFAULT)
|
|
119 ENTRY(EFAULT, "EFAULT", "Bad address"),
|
|
120 #endif
|
|
121 #if defined (ENOTBLK)
|
|
122 ENTRY(ENOTBLK, "ENOTBLK", "Block device required"),
|
|
123 #endif
|
|
124 #if defined (EBUSY)
|
|
125 ENTRY(EBUSY, "EBUSY", "Device busy"),
|
|
126 #endif
|
|
127 #if defined (EEXIST)
|
|
128 ENTRY(EEXIST, "EEXIST", "File exists"),
|
|
129 #endif
|
|
130 #if defined (EXDEV)
|
|
131 ENTRY(EXDEV, "EXDEV", "Cross-device link"),
|
|
132 #endif
|
|
133 #if defined (ENODEV)
|
|
134 ENTRY(ENODEV, "ENODEV", "No such device"),
|
|
135 #endif
|
|
136 #if defined (ENOTDIR)
|
|
137 ENTRY(ENOTDIR, "ENOTDIR", "Not a directory"),
|
|
138 #endif
|
|
139 #if defined (EISDIR)
|
|
140 ENTRY(EISDIR, "EISDIR", "Is a directory"),
|
|
141 #endif
|
|
142 #if defined (EINVAL)
|
|
143 ENTRY(EINVAL, "EINVAL", "Invalid argument"),
|
|
144 #endif
|
|
145 #if defined (ENFILE)
|
|
146 ENTRY(ENFILE, "ENFILE", "File table overflow"),
|
|
147 #endif
|
|
148 #if defined (EMFILE)
|
|
149 ENTRY(EMFILE, "EMFILE", "Too many open files"),
|
|
150 #endif
|
|
151 #if defined (ENOTTY)
|
|
152 ENTRY(ENOTTY, "ENOTTY", "Not a typewriter"),
|
|
153 #endif
|
|
154 #if defined (ETXTBSY)
|
|
155 ENTRY(ETXTBSY, "ETXTBSY", "Text file busy"),
|
|
156 #endif
|
|
157 #if defined (EFBIG)
|
|
158 ENTRY(EFBIG, "EFBIG", "File too large"),
|
|
159 #endif
|
|
160 #if defined (ENOSPC)
|
|
161 ENTRY(ENOSPC, "ENOSPC", "No space left on device"),
|
|
162 #endif
|
|
163 #if defined (ESPIPE)
|
|
164 ENTRY(ESPIPE, "ESPIPE", "Illegal seek"),
|
|
165 #endif
|
|
166 #if defined (EROFS)
|
|
167 ENTRY(EROFS, "EROFS", "Read-only file system"),
|
|
168 #endif
|
|
169 #if defined (EMLINK)
|
|
170 ENTRY(EMLINK, "EMLINK", "Too many links"),
|
|
171 #endif
|
|
172 #if defined (EPIPE)
|
|
173 ENTRY(EPIPE, "EPIPE", "Broken pipe"),
|
|
174 #endif
|
|
175 #if defined (EDOM)
|
|
176 ENTRY(EDOM, "EDOM", "Math argument out of domain of func"),
|
|
177 #endif
|
|
178 #if defined (ERANGE)
|
|
179 ENTRY(ERANGE, "ERANGE", "Math result not representable"),
|
|
180 #endif
|
|
181 #if defined (ENOMSG)
|
|
182 ENTRY(ENOMSG, "ENOMSG", "No message of desired type"),
|
|
183 #endif
|
|
184 #if defined (EIDRM)
|
|
185 ENTRY(EIDRM, "EIDRM", "Identifier removed"),
|
|
186 #endif
|
|
187 #if defined (ECHRNG)
|
|
188 ENTRY(ECHRNG, "ECHRNG", "Channel number out of range"),
|
|
189 #endif
|
|
190 #if defined (EL2NSYNC)
|
|
191 ENTRY(EL2NSYNC, "EL2NSYNC", "Level 2 not synchronized"),
|
|
192 #endif
|
|
193 #if defined (EL3HLT)
|
|
194 ENTRY(EL3HLT, "EL3HLT", "Level 3 halted"),
|
|
195 #endif
|
|
196 #if defined (EL3RST)
|
|
197 ENTRY(EL3RST, "EL3RST", "Level 3 reset"),
|
|
198 #endif
|
|
199 #if defined (ELNRNG)
|
|
200 ENTRY(ELNRNG, "ELNRNG", "Link number out of range"),
|
|
201 #endif
|
|
202 #if defined (EUNATCH)
|
|
203 ENTRY(EUNATCH, "EUNATCH", "Protocol driver not attached"),
|
|
204 #endif
|
|
205 #if defined (ENOCSI)
|
|
206 ENTRY(ENOCSI, "ENOCSI", "No CSI structure available"),
|
|
207 #endif
|
|
208 #if defined (EL2HLT)
|
|
209 ENTRY(EL2HLT, "EL2HLT", "Level 2 halted"),
|
|
210 #endif
|
|
211 #if defined (EDEADLK)
|
|
212 ENTRY(EDEADLK, "EDEADLK", "Deadlock condition"),
|
|
213 #endif
|
|
214 #if defined (ENOLCK)
|
|
215 ENTRY(ENOLCK, "ENOLCK", "No record locks available"),
|
|
216 #endif
|
|
217 #if defined (EBADE)
|
|
218 ENTRY(EBADE, "EBADE", "Invalid exchange"),
|
|
219 #endif
|
|
220 #if defined (EBADR)
|
|
221 ENTRY(EBADR, "EBADR", "Invalid request descriptor"),
|
|
222 #endif
|
|
223 #if defined (EXFULL)
|
|
224 ENTRY(EXFULL, "EXFULL", "Exchange full"),
|
|
225 #endif
|
|
226 #if defined (ENOANO)
|
|
227 ENTRY(ENOANO, "ENOANO", "No anode"),
|
|
228 #endif
|
|
229 #if defined (EBADRQC)
|
|
230 ENTRY(EBADRQC, "EBADRQC", "Invalid request code"),
|
|
231 #endif
|
|
232 #if defined (EBADSLT)
|
|
233 ENTRY(EBADSLT, "EBADSLT", "Invalid slot"),
|
|
234 #endif
|
|
235 #if defined (EDEADLOCK)
|
|
236 ENTRY(EDEADLOCK, "EDEADLOCK", "File locking deadlock error"),
|
|
237 #endif
|
|
238 #if defined (EBFONT)
|
|
239 ENTRY(EBFONT, "EBFONT", "Bad font file format"),
|
|
240 #endif
|
|
241 #if defined (ENOSTR)
|
|
242 ENTRY(ENOSTR, "ENOSTR", "Device not a stream"),
|
|
243 #endif
|
|
244 #if defined (ENODATA)
|
|
245 ENTRY(ENODATA, "ENODATA", "No data available"),
|
|
246 #endif
|
|
247 #if defined (ETIME)
|
|
248 ENTRY(ETIME, "ETIME", "Timer expired"),
|
|
249 #endif
|
|
250 #if defined (ENOSR)
|
|
251 ENTRY(ENOSR, "ENOSR", "Out of streams resources"),
|
|
252 #endif
|
|
253 #if defined (ENONET)
|
|
254 ENTRY(ENONET, "ENONET", "Machine is not on the network"),
|
|
255 #endif
|
|
256 #if defined (ENOPKG)
|
|
257 ENTRY(ENOPKG, "ENOPKG", "Package not installed"),
|
|
258 #endif
|
|
259 #if defined (EREMOTE)
|
|
260 ENTRY(EREMOTE, "EREMOTE", "Object is remote"),
|
|
261 #endif
|
|
262 #if defined (ENOLINK)
|
|
263 ENTRY(ENOLINK, "ENOLINK", "Link has been severed"),
|
|
264 #endif
|
|
265 #if defined (EADV)
|
|
266 ENTRY(EADV, "EADV", "Advertise error"),
|
|
267 #endif
|
|
268 #if defined (ESRMNT)
|
|
269 ENTRY(ESRMNT, "ESRMNT", "Srmount error"),
|
|
270 #endif
|
|
271 #if defined (ECOMM)
|
|
272 ENTRY(ECOMM, "ECOMM", "Communication error on send"),
|
|
273 #endif
|
|
274 #if defined (EPROTO)
|
|
275 ENTRY(EPROTO, "EPROTO", "Protocol error"),
|
|
276 #endif
|
|
277 #if defined (EMULTIHOP)
|
|
278 ENTRY(EMULTIHOP, "EMULTIHOP", "Multihop attempted"),
|
|
279 #endif
|
|
280 #if defined (EDOTDOT)
|
|
281 ENTRY(EDOTDOT, "EDOTDOT", "RFS specific error"),
|
|
282 #endif
|
|
283 #if defined (EBADMSG)
|
|
284 ENTRY(EBADMSG, "EBADMSG", "Not a data message"),
|
|
285 #endif
|
|
286 #if defined (ENAMETOOLONG)
|
|
287 ENTRY(ENAMETOOLONG, "ENAMETOOLONG", "File name too long"),
|
|
288 #endif
|
|
289 #if defined (EOVERFLOW)
|
|
290 ENTRY(EOVERFLOW, "EOVERFLOW", "Value too large for defined data type"),
|
|
291 #endif
|
|
292 #if defined (ENOTUNIQ)
|
|
293 ENTRY(ENOTUNIQ, "ENOTUNIQ", "Name not unique on network"),
|
|
294 #endif
|
|
295 #if defined (EBADFD)
|
|
296 ENTRY(EBADFD, "EBADFD", "File descriptor in bad state"),
|
|
297 #endif
|
|
298 #if defined (EREMCHG)
|
|
299 ENTRY(EREMCHG, "EREMCHG", "Remote address changed"),
|
|
300 #endif
|
|
301 #if defined (ELIBACC)
|
|
302 ENTRY(ELIBACC, "ELIBACC", "Can not access a needed shared library"),
|
|
303 #endif
|
|
304 #if defined (ELIBBAD)
|
|
305 ENTRY(ELIBBAD, "ELIBBAD", "Accessing a corrupted shared library"),
|
|
306 #endif
|
|
307 #if defined (ELIBSCN)
|
|
308 ENTRY(ELIBSCN, "ELIBSCN", ".lib section in a.out corrupted"),
|
|
309 #endif
|
|
310 #if defined (ELIBMAX)
|
|
311 ENTRY(ELIBMAX, "ELIBMAX", "Attempting to link in too many shared libraries"),
|
|
312 #endif
|
|
313 #if defined (ELIBEXEC)
|
|
314 ENTRY(ELIBEXEC, "ELIBEXEC", "Cannot exec a shared library directly"),
|
|
315 #endif
|
|
316 #if defined (EILSEQ)
|
|
317 ENTRY(EILSEQ, "EILSEQ", "Illegal byte sequence"),
|
|
318 #endif
|
|
319 #if defined (ENOSYS)
|
|
320 ENTRY(ENOSYS, "ENOSYS", "Operation not applicable"),
|
|
321 #endif
|
|
322 #if defined (ELOOP)
|
|
323 ENTRY(ELOOP, "ELOOP", "Too many symbolic links encountered"),
|
|
324 #endif
|
|
325 #if defined (ERESTART)
|
|
326 ENTRY(ERESTART, "ERESTART", "Interrupted system call should be restarted"),
|
|
327 #endif
|
|
328 #if defined (ESTRPIPE)
|
|
329 ENTRY(ESTRPIPE, "ESTRPIPE", "Streams pipe error"),
|
|
330 #endif
|
|
331 #if defined (ENOTEMPTY)
|
|
332 ENTRY(ENOTEMPTY, "ENOTEMPTY", "Directory not empty"),
|
|
333 #endif
|
|
334 #if defined (EUSERS)
|
|
335 ENTRY(EUSERS, "EUSERS", "Too many users"),
|
|
336 #endif
|
|
337 #if defined (ENOTSOCK)
|
|
338 ENTRY(ENOTSOCK, "ENOTSOCK", "Socket operation on non-socket"),
|
|
339 #endif
|
|
340 #if defined (EDESTADDRREQ)
|
|
341 ENTRY(EDESTADDRREQ, "EDESTADDRREQ", "Destination address required"),
|
|
342 #endif
|
|
343 #if defined (EMSGSIZE)
|
|
344 ENTRY(EMSGSIZE, "EMSGSIZE", "Message too long"),
|
|
345 #endif
|
|
346 #if defined (EPROTOTYPE)
|
|
347 ENTRY(EPROTOTYPE, "EPROTOTYPE", "Protocol wrong type for socket"),
|
|
348 #endif
|
|
349 #if defined (ENOPROTOOPT)
|
|
350 ENTRY(ENOPROTOOPT, "ENOPROTOOPT", "Protocol not available"),
|
|
351 #endif
|
|
352 #if defined (EPROTONOSUPPORT)
|
|
353 ENTRY(EPROTONOSUPPORT, "EPROTONOSUPPORT", "Protocol not supported"),
|
|
354 #endif
|
|
355 #if defined (ESOCKTNOSUPPORT)
|
|
356 ENTRY(ESOCKTNOSUPPORT, "ESOCKTNOSUPPORT", "Socket type not supported"),
|
|
357 #endif
|
|
358 #if defined (EOPNOTSUPP)
|
|
359 ENTRY(EOPNOTSUPP, "EOPNOTSUPP", "Operation not supported on transport endpoint"),
|
|
360 #endif
|
|
361 #if defined (EPFNOSUPPORT)
|
|
362 ENTRY(EPFNOSUPPORT, "EPFNOSUPPORT", "Protocol family not supported"),
|
|
363 #endif
|
|
364 #if defined (EAFNOSUPPORT)
|
|
365 ENTRY(EAFNOSUPPORT, "EAFNOSUPPORT", "Address family not supported by protocol"),
|
|
366 #endif
|
|
367 #if defined (EADDRINUSE)
|
|
368 ENTRY(EADDRINUSE, "EADDRINUSE", "Address already in use"),
|
|
369 #endif
|
|
370 #if defined (EADDRNOTAVAIL)
|
|
371 ENTRY(EADDRNOTAVAIL, "EADDRNOTAVAIL","Cannot assign requested address"),
|
|
372 #endif
|
|
373 #if defined (ENETDOWN)
|
|
374 ENTRY(ENETDOWN, "ENETDOWN", "Network is down"),
|
|
375 #endif
|
|
376 #if defined (ENETUNREACH)
|
|
377 ENTRY(ENETUNREACH, "ENETUNREACH", "Network is unreachable"),
|
|
378 #endif
|
|
379 #if defined (ENETRESET)
|
|
380 ENTRY(ENETRESET, "ENETRESET", "Network dropped connection because of reset"),
|
|
381 #endif
|
|
382 #if defined (ECONNABORTED)
|
|
383 ENTRY(ECONNABORTED, "ECONNABORTED", "Software caused connection abort"),
|
|
384 #endif
|
|
385 #if defined (ECONNRESET)
|
|
386 ENTRY(ECONNRESET, "ECONNRESET", "Connection reset by peer"),
|
|
387 #endif
|
|
388 #if defined (ENOBUFS)
|
|
389 ENTRY(ENOBUFS, "ENOBUFS", "No buffer space available"),
|
|
390 #endif
|
|
391 #if defined (EISCONN)
|
|
392 ENTRY(EISCONN, "EISCONN", "Transport endpoint is already connected"),
|
|
393 #endif
|
|
394 #if defined (ENOTCONN)
|
|
395 ENTRY(ENOTCONN, "ENOTCONN", "Transport endpoint is not connected"),
|
|
396 #endif
|
|
397 #if defined (ESHUTDOWN)
|
|
398 ENTRY(ESHUTDOWN, "ESHUTDOWN", "Cannot send after transport endpoint shutdown"),
|
|
399 #endif
|
|
400 #if defined (ETOOMANYREFS)
|
|
401 ENTRY(ETOOMANYREFS, "ETOOMANYREFS", "Too many references: cannot splice"),
|
|
402 #endif
|
|
403 #if defined (ETIMEDOUT)
|
|
404 ENTRY(ETIMEDOUT, "ETIMEDOUT", "Connection timed out"),
|
|
405 #endif
|
|
406 #if defined (ECONNREFUSED)
|
|
407 ENTRY(ECONNREFUSED, "ECONNREFUSED", "Connection refused"),
|
|
408 #endif
|
|
409 #if defined (EHOSTDOWN)
|
|
410 ENTRY(EHOSTDOWN, "EHOSTDOWN", "Host is down"),
|
|
411 #endif
|
|
412 #if defined (EHOSTUNREACH)
|
|
413 ENTRY(EHOSTUNREACH, "EHOSTUNREACH", "No route to host"),
|
|
414 #endif
|
|
415 #if defined (EALREADY)
|
|
416 ENTRY(EALREADY, "EALREADY", "Operation already in progress"),
|
|
417 #endif
|
|
418 #if defined (EINPROGRESS)
|
|
419 ENTRY(EINPROGRESS, "EINPROGRESS", "Operation now in progress"),
|
|
420 #endif
|
|
421 #if defined (ESTALE)
|
|
422 ENTRY(ESTALE, "ESTALE", "Stale NFS file handle"),
|
|
423 #endif
|
|
424 #if defined (EUCLEAN)
|
|
425 ENTRY(EUCLEAN, "EUCLEAN", "Structure needs cleaning"),
|
|
426 #endif
|
|
427 #if defined (ENOTNAM)
|
|
428 ENTRY(ENOTNAM, "ENOTNAM", "Not a XENIX named type file"),
|
|
429 #endif
|
|
430 #if defined (ENAVAIL)
|
|
431 ENTRY(ENAVAIL, "ENAVAIL", "No XENIX semaphores available"),
|
|
432 #endif
|
|
433 #if defined (EISNAM)
|
|
434 ENTRY(EISNAM, "EISNAM", "Is a named type file"),
|
|
435 #endif
|
|
436 #if defined (EREMOTEIO)
|
|
437 ENTRY(EREMOTEIO, "EREMOTEIO", "Remote I/O error"),
|
|
438 #endif
|
|
439 ENTRY(0, NULL, NULL)
|
|
440 };
|
|
441
|
|
442 #ifdef EVMSERR
|
|
443 /* This is not in the table, because the numeric value of EVMSERR (32767)
|
|
444 lies outside the range of sys_errlist[]. */
|
|
445 static struct { int value; const char *name, *msg; }
|
|
446 evmserr = { EVMSERR, "EVMSERR", "VMS-specific error" };
|
|
447 #endif
|
|
448
|
|
449 /* Translation table allocated and initialized at runtime. Indexed by the
|
|
450 errno value to find the equivalent symbolic value. */
|
|
451
|
|
452 static const char **error_names;
|
|
453 static int num_error_names = 0;
|
|
454
|
|
455 /* Translation table allocated and initialized at runtime, if it does not
|
|
456 already exist in the host environment. Indexed by the errno value to find
|
|
457 the descriptive string.
|
|
458
|
|
459 We don't export it for use in other modules because even though it has the
|
|
460 same name, it differs from other implementations in that it is dynamically
|
|
461 initialized rather than statically initialized. */
|
|
462
|
|
463 #ifndef HAVE_SYS_ERRLIST
|
|
464
|
|
465 #define sys_nerr sys_nerr__
|
|
466 #define sys_errlist sys_errlist__
|
|
467 static int sys_nerr;
|
|
468 static const char **sys_errlist;
|
|
469
|
|
470 #else
|
|
471
|
|
472 extern int sys_nerr;
|
|
473 extern char *sys_errlist[];
|
|
474
|
|
475 #endif
|
|
476
|
|
477 /*
|
|
478
|
|
479 NAME
|
|
480
|
|
481 init_error_tables -- initialize the name and message tables
|
|
482
|
|
483 SYNOPSIS
|
|
484
|
|
485 static void init_error_tables ();
|
|
486
|
|
487 DESCRIPTION
|
|
488
|
|
489 Using the error_table, which is initialized at compile time, generate
|
|
490 the error_names and the sys_errlist (if needed) tables, which are
|
|
491 indexed at runtime by a specific errno value.
|
|
492
|
|
493 BUGS
|
|
494
|
|
495 The initialization of the tables may fail under low memory conditions,
|
|
496 in which case we don't do anything particularly useful, but we don't
|
|
497 bomb either. Who knows, it might succeed at a later point if we free
|
|
498 some memory in the meantime. In any case, the other routines know
|
|
499 how to deal with lack of a table after trying to initialize it. This
|
|
500 may or may not be considered to be a bug, that we don't specifically
|
|
501 warn about this particular failure mode.
|
|
502
|
|
503 */
|
|
504
|
|
505 static void
|
|
506 init_error_tables (void)
|
|
507 {
|
|
508 const struct error_info *eip;
|
|
509 int nbytes;
|
|
510
|
|
511 /* If we haven't already scanned the error_table once to find the maximum
|
|
512 errno value, then go find it now. */
|
|
513
|
|
514 if (num_error_names == 0)
|
|
515 {
|
|
516 for (eip = error_table; eip -> name != NULL; eip++)
|
|
517 {
|
|
518 if (eip -> value >= num_error_names)
|
|
519 {
|
|
520 num_error_names = eip -> value + 1;
|
|
521 }
|
|
522 }
|
|
523 }
|
|
524
|
|
525 /* Now attempt to allocate the error_names table, zero it out, and then
|
|
526 initialize it from the statically initialized error_table. */
|
|
527
|
|
528 if (error_names == NULL)
|
|
529 {
|
|
530 nbytes = num_error_names * sizeof (char *);
|
|
531 if ((error_names = (const char **) malloc (nbytes)) != NULL)
|
|
532 {
|
|
533 memset (error_names, 0, nbytes);
|
|
534 for (eip = error_table; eip -> name != NULL; eip++)
|
|
535 {
|
|
536 error_names[eip -> value] = eip -> name;
|
|
537 }
|
|
538 }
|
|
539 }
|
|
540
|
|
541 #ifndef HAVE_SYS_ERRLIST
|
|
542
|
|
543 /* Now attempt to allocate the sys_errlist table, zero it out, and then
|
|
544 initialize it from the statically initialized error_table. */
|
|
545
|
|
546 if (sys_errlist == NULL)
|
|
547 {
|
|
548 nbytes = num_error_names * sizeof (char *);
|
|
549 if ((sys_errlist = (const char **) malloc (nbytes)) != NULL)
|
|
550 {
|
|
551 memset (sys_errlist, 0, nbytes);
|
|
552 sys_nerr = num_error_names;
|
|
553 for (eip = error_table; eip -> name != NULL; eip++)
|
|
554 {
|
|
555 sys_errlist[eip -> value] = eip -> msg;
|
|
556 }
|
|
557 }
|
|
558 }
|
|
559
|
|
560 #endif
|
|
561
|
|
562 }
|
|
563
|
|
564 /*
|
|
565
|
|
566
|
|
567 @deftypefn Extension int errno_max (void)
|
|
568
|
|
569 Returns the maximum @code{errno} value for which a corresponding
|
|
570 symbolic name or message is available. Note that in the case where we
|
|
571 use the @code{sys_errlist} supplied by the system, it is possible for
|
|
572 there to be more symbolic names than messages, or vice versa. In
|
|
573 fact, the manual page for @code{perror(3C)} explicitly warns that one
|
|
574 should check the size of the table (@code{sys_nerr}) before indexing
|
|
575 it, since new error codes may be added to the system before they are
|
|
576 added to the table. Thus @code{sys_nerr} might be smaller than value
|
|
577 implied by the largest @code{errno} value defined in @code{<errno.h>}.
|
|
578
|
|
579 We return the maximum value that can be used to obtain a meaningful
|
|
580 symbolic name or message.
|
|
581
|
|
582 @end deftypefn
|
|
583
|
|
584 */
|
|
585
|
|
586 int
|
|
587 errno_max (void)
|
|
588 {
|
|
589 int maxsize;
|
|
590
|
|
591 if (error_names == NULL)
|
|
592 {
|
|
593 init_error_tables ();
|
|
594 }
|
|
595 maxsize = MAX (sys_nerr, num_error_names);
|
|
596 return (maxsize - 1);
|
|
597 }
|
|
598
|
|
599 #ifndef HAVE_STRERROR
|
|
600
|
|
601 /*
|
|
602
|
|
603 @deftypefn Supplemental char* strerror (int @var{errnoval})
|
|
604
|
|
605 Maps an @code{errno} number to an error message string, the contents
|
|
606 of which are implementation defined. On systems which have the
|
|
607 external variables @code{sys_nerr} and @code{sys_errlist}, these
|
|
608 strings will be the same as the ones used by @code{perror}.
|
|
609
|
|
610 If the supplied error number is within the valid range of indices for
|
|
611 the @code{sys_errlist}, but no message is available for the particular
|
|
612 error number, then returns the string @samp{Error @var{num}}, where
|
|
613 @var{num} is the error number.
|
|
614
|
|
615 If the supplied error number is not a valid index into
|
|
616 @code{sys_errlist}, returns @code{NULL}.
|
|
617
|
|
618 The returned string is only guaranteed to be valid only until the
|
|
619 next call to @code{strerror}.
|
|
620
|
|
621 @end deftypefn
|
|
622
|
|
623 */
|
|
624
|
|
625 char *
|
|
626 strerror (int errnoval)
|
|
627 {
|
|
628 const char *msg;
|
|
629 static char buf[32];
|
|
630
|
|
631 #ifndef HAVE_SYS_ERRLIST
|
|
632
|
|
633 if (error_names == NULL)
|
|
634 {
|
|
635 init_error_tables ();
|
|
636 }
|
|
637
|
|
638 #endif
|
|
639
|
|
640 if ((errnoval < 0) || (errnoval >= sys_nerr))
|
|
641 {
|
|
642 #ifdef EVMSERR
|
|
643 if (errnoval == evmserr.value)
|
|
644 msg = evmserr.msg;
|
|
645 else
|
|
646 #endif
|
|
647 /* Out of range, just return NULL */
|
|
648 msg = NULL;
|
|
649 }
|
|
650 else if ((sys_errlist == NULL) || (sys_errlist[errnoval] == NULL))
|
|
651 {
|
|
652 /* In range, but no sys_errlist or no entry at this index. */
|
|
653 sprintf (buf, "Error %d", errnoval);
|
|
654 msg = buf;
|
|
655 }
|
|
656 else
|
|
657 {
|
|
658 /* In range, and a valid message. Just return the message. */
|
|
659 msg = (char *) sys_errlist[errnoval];
|
|
660 }
|
|
661
|
|
662 return (msg);
|
|
663 }
|
|
664
|
|
665 #endif /* ! HAVE_STRERROR */
|
|
666
|
|
667
|
|
668 /*
|
|
669
|
|
670 @deftypefn Replacement {const char*} strerrno (int @var{errnum})
|
|
671
|
|
672 Given an error number returned from a system call (typically returned
|
|
673 in @code{errno}), returns a pointer to a string containing the
|
|
674 symbolic name of that error number, as found in @code{<errno.h>}.
|
|
675
|
|
676 If the supplied error number is within the valid range of indices for
|
|
677 symbolic names, but no name is available for the particular error
|
|
678 number, then returns the string @samp{Error @var{num}}, where @var{num}
|
|
679 is the error number.
|
|
680
|
|
681 If the supplied error number is not within the range of valid
|
|
682 indices, then returns @code{NULL}.
|
|
683
|
|
684 The contents of the location pointed to are only guaranteed to be
|
|
685 valid until the next call to @code{strerrno}.
|
|
686
|
|
687 @end deftypefn
|
|
688
|
|
689 */
|
|
690
|
|
691 const char *
|
|
692 strerrno (int errnoval)
|
|
693 {
|
|
694 const char *name;
|
|
695 static char buf[32];
|
|
696
|
|
697 if (error_names == NULL)
|
|
698 {
|
|
699 init_error_tables ();
|
|
700 }
|
|
701
|
|
702 if ((errnoval < 0) || (errnoval >= num_error_names))
|
|
703 {
|
|
704 #ifdef EVMSERR
|
|
705 if (errnoval == evmserr.value)
|
|
706 name = evmserr.name;
|
|
707 else
|
|
708 #endif
|
|
709 /* Out of range, just return NULL */
|
|
710 name = NULL;
|
|
711 }
|
|
712 else if ((error_names == NULL) || (error_names[errnoval] == NULL))
|
|
713 {
|
|
714 /* In range, but no error_names or no entry at this index. */
|
|
715 sprintf (buf, "Error %d", errnoval);
|
|
716 name = (const char *) buf;
|
|
717 }
|
|
718 else
|
|
719 {
|
|
720 /* In range, and a valid name. Just return the name. */
|
|
721 name = error_names[errnoval];
|
|
722 }
|
|
723
|
|
724 return (name);
|
|
725 }
|
|
726
|
|
727 /*
|
|
728
|
|
729 @deftypefn Extension int strtoerrno (const char *@var{name})
|
|
730
|
|
731 Given the symbolic name of a error number (e.g., @code{EACCES}), map it
|
|
732 to an errno value. If no translation is found, returns 0.
|
|
733
|
|
734 @end deftypefn
|
|
735
|
|
736 */
|
|
737
|
|
738 int
|
|
739 strtoerrno (const char *name)
|
|
740 {
|
|
741 int errnoval = 0;
|
|
742
|
|
743 if (name != NULL)
|
|
744 {
|
|
745 if (error_names == NULL)
|
|
746 {
|
|
747 init_error_tables ();
|
|
748 }
|
|
749 for (errnoval = 0; errnoval < num_error_names; errnoval++)
|
|
750 {
|
|
751 if ((error_names[errnoval] != NULL) &&
|
|
752 (strcmp (name, error_names[errnoval]) == 0))
|
|
753 {
|
|
754 break;
|
|
755 }
|
|
756 }
|
|
757 if (errnoval == num_error_names)
|
|
758 {
|
|
759 #ifdef EVMSERR
|
|
760 if (strcmp (name, evmserr.name) == 0)
|
|
761 errnoval = evmserr.value;
|
|
762 else
|
|
763 #endif
|
|
764 errnoval = 0;
|
|
765 }
|
|
766 }
|
|
767 return (errnoval);
|
|
768 }
|
|
769
|
|
770
|
|
771 /* A simple little main that does nothing but print all the errno translations
|
|
772 if MAIN is defined and this file is compiled and linked. */
|
|
773
|
|
774 #ifdef MAIN
|
|
775
|
|
776 #include <stdio.h>
|
|
777
|
|
778 int
|
|
779 main (void)
|
|
780 {
|
|
781 int errn;
|
|
782 int errnmax;
|
|
783 const char *name;
|
|
784 const char *msg;
|
|
785 char *strerror ();
|
|
786
|
|
787 errnmax = errno_max ();
|
|
788 printf ("%d entries in names table.\n", num_error_names);
|
|
789 printf ("%d entries in messages table.\n", sys_nerr);
|
|
790 printf ("%d is max useful index.\n", errnmax);
|
|
791
|
|
792 /* Keep printing values until we get to the end of *both* tables, not
|
|
793 *either* table. Note that knowing the maximum useful index does *not*
|
|
794 relieve us of the responsibility of testing the return pointer for
|
|
795 NULL. */
|
|
796
|
|
797 for (errn = 0; errn <= errnmax; errn++)
|
|
798 {
|
|
799 name = strerrno (errn);
|
|
800 name = (name == NULL) ? "<NULL>" : name;
|
|
801 msg = strerror (errn);
|
|
802 msg = (msg == NULL) ? "<NULL>" : msg;
|
|
803 printf ("%-4d%-18s%s\n", errn, name, msg);
|
|
804 }
|
|
805
|
|
806 return 0;
|
|
807 }
|
|
808
|
|
809 #endif
|