1 /* strerror_r.c --- POSIX compatible system error routine
3 Copyright (C) 2010-2018 Free Software Foundation, Inc.
5 This program is free software: you can redistribute it and/or modify
6 it under the terms of the GNU General Public License as published by
7 the Free Software Foundation; either version 3 of the License, or
8 (at your option) any later version.
10 This program 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 General Public License for more details.
15 You should have received a copy of the GNU General Public License
16 along with this program. If not, see <https://www.gnu.org/licenses/>. */
18 /* Written by Bruno Haible <bruno@clisp.org>, 2010. */
22 /* Enable declaration of sys_nerr and sys_errlist in <errno.h> on NetBSD. */
23 #define _NETBSD_SOURCE 1
35 #include "strerror-override.h"
37 #if (__GLIBC__ >= 2 || defined __UCLIBC__ || defined __CYGWIN__) && HAVE___XPG_STRERROR_R /* glibc >= 2.3.4, cygwin >= 1.7.9 */
39 # define USE_XPG_STRERROR_R 1
44 int __xpg_strerror_r (int errnum, char *buf, size_t buflen);
46 #elif HAVE_DECL_STRERROR_R && !(__GLIBC__ >= 2 || defined __UCLIBC__ || defined __CYGWIN__)
48 /* The system's strerror_r function is OK, except that its third argument
49 is 'int', not 'size_t', or its return type is wrong. */
53 # define USE_SYSTEM_STRERROR_R 1
55 #else /* (__GLIBC__ >= 2 || defined __UCLIBC__ || defined __CYGWIN__ ? !HAVE___XPG_STRERROR_R : !HAVE_DECL_STRERROR_R) */
57 /* Use the system's strerror(). Exclude glibc and cygwin because the
58 system strerror_r has the wrong return type, and cygwin 1.7.9
59 strerror_r clobbers strerror. */
62 # define USE_SYSTEM_STRERROR 1
64 # if defined __NetBSD__ || defined __hpux || (defined _WIN32 && !defined __CYGWIN__) || defined __sgi || (defined __sun && !defined _LP64) || defined __CYGWIN__
66 /* No locking needed. */
68 /* Get catgets internationalization functions. */
70 # include <nl_types.h>
77 /* Get sys_nerr, sys_errlist on HP-UX (otherwise only declared in C++ mode).
78 Get sys_nerr, sys_errlist on IRIX (otherwise only declared with _SGIAPI). */
79 # if defined __hpux || defined __sgi
81 extern char *sys_errlist[];
84 /* Get sys_nerr on Solaris. */
85 # if defined __sun && !defined _LP64
95 # include "glthread/lock.h"
97 /* This lock protects the buffer returned by strerror(). We assume that
98 no other uses of strerror() exist in the program. */
99 gl_lock_define_initialized(static, strerror_lock)
105 /* On MSVC, there is no snprintf() function, just a _snprintf().
106 It is of lower quality, but sufficient for the simple use here.
107 We only have to make sure to NUL terminate the result (_snprintf
108 does not NUL terminate, like strncpy). */
111 local_snprintf (char *buf, size_t buflen, const char *format, ...)
116 va_start (args, format);
117 result = _vsnprintf (buf, buflen, format, args);
119 if (buflen > 0 && (result < 0 || result >= buflen))
120 buf[buflen - 1] = '\0';
123 # define snprintf local_snprintf
126 /* Copy as much of MSG into BUF as possible, without corrupting errno.
127 Return 0 if MSG fit in BUFLEN, otherwise return ERANGE. */
129 safe_copy (char *buf, size_t buflen, const char *msg)
131 size_t len = strlen (msg);
132 size_t moved = len < buflen ? len : buflen - 1;
134 /* Although POSIX lets memmove corrupt errno, we don't
135 know of any implementation where this is a real problem. */
136 memmove (buf, msg, moved);
138 return len < buflen ? 0 : ERANGE;
143 strerror_r (int errnum, char *buf, size_t buflen)
146 /* Filter this out now, so that rest of this replacement knows that
147 there is room for a non-empty message and trailing NUL. */
156 /* Check for gnulib overrides. */
158 char const *msg = strerror_override (errnum);
161 return safe_copy (buf, buflen, msg);
166 int saved_errno = errno;
168 #if USE_XPG_STRERROR_R
171 ret = __xpg_strerror_r (errnum, buf, buflen);
176 /* glibc 2.13 would not touch buf on err, so we have to fall
177 back to GNU strerror_r which always returns a thread-safe
178 untruncated string to (partially) copy into our buf. */
179 safe_copy (buf, buflen, strerror_r (errnum, buf, buflen));
183 #elif USE_SYSTEM_STRERROR_R
185 if (buflen > INT_MAX)
189 /* On HP-UX 11.31, strerror_r always fails when buflen < 80; it
190 also fails to change buf on EINVAL. */
194 if (buflen < sizeof stackbuf)
196 ret = strerror_r (errnum, stackbuf, sizeof stackbuf);
198 ret = safe_copy (buf, buflen, stackbuf);
201 ret = strerror_r (errnum, buf, buflen);
204 ret = strerror_r (errnum, buf, buflen);
206 /* Some old implementations may return (-1, EINVAL) instead of EINVAL.
207 But on Haiku, valid error numbers are negative. */
208 # if !defined __HAIKU__
214 # if defined _AIX || defined __HAIKU__
215 /* AIX and Haiku return 0 rather than ERANGE when truncating strings; try
216 again until we are sure we got the entire string. */
217 if (!ret && strlen (buf) == buflen - 1)
219 char stackbuf[STACKBUF_LEN];
221 strerror_r (errnum, stackbuf, sizeof stackbuf);
222 len = strlen (stackbuf);
223 /* STACKBUF_LEN should have been large enough. */
224 if (len + 1 == sizeof stackbuf)
230 /* Solaris 10 does not populate buf on ERANGE. OpenBSD 4.7
231 truncates early on ERANGE rather than return a partial integer.
232 We prefer the maximal string. We set buf[0] earlier, and we
233 know of no implementation that modifies buf to be an
234 unterminated string, so this strlen should be portable in
235 practice (rather than pulling in a safer strnlen). */
236 if (ret == ERANGE && strlen (buf) < buflen - 1)
238 char stackbuf[STACKBUF_LEN];
240 /* STACKBUF_LEN should have been large enough. */
241 if (strerror_r (errnum, stackbuf, sizeof stackbuf) == ERANGE)
243 safe_copy (buf, buflen, stackbuf);
247 #else /* USE_SYSTEM_STRERROR */
249 /* Try to do what strerror (errnum) does, but without clobbering the
250 buffer used by strerror(). */
252 # if defined __NetBSD__ || defined __hpux || (defined _WIN32 && !defined __CYGWIN__) || defined __CYGWIN__ /* NetBSD, HP-UX, native Windows, Cygwin */
254 /* NetBSD: sys_nerr, sys_errlist are declared through _NETBSD_SOURCE
256 HP-UX: sys_nerr, sys_errlist are declared explicitly above.
257 native Windows: sys_nerr, sys_errlist are declared in <stdlib.h>.
258 Cygwin: sys_nerr, sys_errlist are declared in <errno.h>. */
259 if (errnum >= 0 && errnum < sys_nerr)
261 # if HAVE_CATGETS && (defined __NetBSD__ || defined __hpux)
262 # if defined __NetBSD__
263 nl_catd catd = catopen ("libc", NL_CAT_LOCALE);
266 ? catgets (catd, 1, errnum, sys_errlist[errnum])
267 : sys_errlist[errnum]);
270 nl_catd catd = catopen ("perror", NL_CAT_LOCALE);
273 ? catgets (catd, 1, 1 + errnum, sys_errlist[errnum])
274 : sys_errlist[errnum]);
277 const char *errmsg = sys_errlist[errnum];
279 if (errmsg == NULL || *errmsg == '\0')
282 ret = safe_copy (buf, buflen, errmsg);
283 # if HAVE_CATGETS && (defined __NetBSD__ || defined __hpux)
284 if (catd != (nl_catd)-1)
291 # elif defined __sgi || (defined __sun && !defined _LP64) /* IRIX, Solaris <= 9 32-bit */
293 /* For a valid error number, the system's strerror() function returns
294 a pointer to a not copied string, not to a buffer. */
295 if (errnum >= 0 && errnum < sys_nerr)
297 char *errmsg = strerror (errnum);
299 if (errmsg == NULL || *errmsg == '\0')
302 ret = safe_copy (buf, buflen, errmsg);
309 gl_lock_lock (strerror_lock);
312 char *errmsg = strerror (errnum);
314 /* For invalid error numbers, strerror() on
315 - IRIX 6.5 returns NULL,
316 - HP-UX 11 returns an empty string. */
317 if (errmsg == NULL || *errmsg == '\0')
320 ret = safe_copy (buf, buflen, errmsg);
323 gl_lock_unlock (strerror_lock);
329 #if defined _WIN32 && !defined __CYGWIN__
330 /* MSVC 14 defines names for many error codes in the range 100..140,
331 but _sys_errlist contains strings only for the error codes
339 case 100 /* EADDRINUSE */:
340 errmsg = "Address already in use";
342 case 101 /* EADDRNOTAVAIL */:
343 errmsg = "Cannot assign requested address";
345 case 102 /* EAFNOSUPPORT */:
346 errmsg = "Address family not supported by protocol";
348 case 103 /* EALREADY */:
349 errmsg = "Operation already in progress";
351 case 105 /* ECANCELED */:
352 errmsg = "Operation canceled";
354 case 106 /* ECONNABORTED */:
355 errmsg = "Software caused connection abort";
357 case 107 /* ECONNREFUSED */:
358 errmsg = "Connection refused";
360 case 108 /* ECONNRESET */:
361 errmsg = "Connection reset by peer";
363 case 109 /* EDESTADDRREQ */:
364 errmsg = "Destination address required";
366 case 110 /* EHOSTUNREACH */:
367 errmsg = "No route to host";
369 case 112 /* EINPROGRESS */:
370 errmsg = "Operation now in progress";
372 case 113 /* EISCONN */:
373 errmsg = "Transport endpoint is already connected";
375 case 114 /* ELOOP */:
376 errmsg = "Too many levels of symbolic links";
378 case 115 /* EMSGSIZE */:
379 errmsg = "Message too long";
381 case 116 /* ENETDOWN */:
382 errmsg = "Network is down";
384 case 117 /* ENETRESET */:
385 errmsg = "Network dropped connection on reset";
387 case 118 /* ENETUNREACH */:
388 errmsg = "Network is unreachable";
390 case 119 /* ENOBUFS */:
391 errmsg = "No buffer space available";
393 case 123 /* ENOPROTOOPT */:
394 errmsg = "Protocol not available";
396 case 126 /* ENOTCONN */:
397 errmsg = "Transport endpoint is not connected";
399 case 128 /* ENOTSOCK */:
400 errmsg = "Socket operation on non-socket";
402 case 129 /* ENOTSUP */:
403 errmsg = "Not supported";
405 case 130 /* EOPNOTSUPP */:
406 errmsg = "Operation not supported";
408 case 132 /* EOVERFLOW */:
409 errmsg = "Value too large for defined data type";
411 case 133 /* EOWNERDEAD */:
412 errmsg = "Owner died";
414 case 134 /* EPROTO */:
415 errmsg = "Protocol error";
417 case 135 /* EPROTONOSUPPORT */:
418 errmsg = "Protocol not supported";
420 case 136 /* EPROTOTYPE */:
421 errmsg = "Protocol wrong type for socket";
423 case 138 /* ETIMEDOUT */:
424 errmsg = "Connection timed out";
426 case 140 /* EWOULDBLOCK */:
427 errmsg = "Operation would block";
434 ret = safe_copy (buf, buflen, errmsg);
438 if (ret == EINVAL && !*buf)
440 #if defined __HAIKU__
441 /* For consistency with perror(). */
442 snprintf (buf, buflen, "Unknown Application Error (%d)", errnum);
444 snprintf (buf, buflen, "Unknown error %d", errnum);