1 /* strerror_r.c --- POSIX compatible system error routine
3 Copyright (C) 2010-2021 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';
124 # define snprintf local_snprintf
127 /* Copy as much of MSG into BUF as possible, without corrupting errno.
128 Return 0 if MSG fit in BUFLEN, otherwise return ERANGE. */
130 safe_copy (char *buf, size_t buflen, const char *msg)
132 size_t len = strlen (msg);
133 size_t moved = len < buflen ? len : buflen - 1;
135 /* Although POSIX lets memmove corrupt errno, we don't
136 know of any implementation where this is a real problem. */
137 memmove (buf, msg, moved);
139 return len < buflen ? 0 : ERANGE;
144 strerror_r (int errnum, char *buf, size_t buflen)
147 /* Filter this out now, so that rest of this replacement knows that
148 there is room for a non-empty message and trailing NUL. */
157 /* Check for gnulib overrides. */
159 char const *msg = strerror_override (errnum);
162 return safe_copy (buf, buflen, msg);
167 int saved_errno = errno;
169 #if USE_XPG_STRERROR_R
172 ret = __xpg_strerror_r (errnum, buf, buflen);
177 /* glibc 2.13 would not touch buf on err, so we have to fall
178 back to GNU strerror_r which always returns a thread-safe
179 untruncated string to (partially) copy into our buf. */
180 safe_copy (buf, buflen, strerror_r (errnum, buf, buflen));
184 #elif USE_SYSTEM_STRERROR_R
186 if (buflen > INT_MAX)
190 /* On HP-UX 11.31, strerror_r always fails when buflen < 80; it
191 also fails to change buf on EINVAL. */
195 if (buflen < sizeof stackbuf)
197 ret = strerror_r (errnum, stackbuf, sizeof stackbuf);
199 ret = safe_copy (buf, buflen, stackbuf);
202 ret = strerror_r (errnum, buf, buflen);
205 ret = strerror_r (errnum, buf, buflen);
207 /* Some old implementations may return (-1, EINVAL) instead of EINVAL.
208 But on Haiku, valid error numbers are negative. */
209 # if !defined __HAIKU__
215 # if defined _AIX || defined __HAIKU__
216 /* AIX and Haiku return 0 rather than ERANGE when truncating strings; try
217 again until we are sure we got the entire string. */
218 if (!ret && strlen (buf) == buflen - 1)
220 char stackbuf[STACKBUF_LEN];
222 strerror_r (errnum, stackbuf, sizeof stackbuf);
223 len = strlen (stackbuf);
224 /* STACKBUF_LEN should have been large enough. */
225 if (len + 1 == sizeof stackbuf)
231 /* Solaris 10 does not populate buf on ERANGE. OpenBSD 4.7
232 truncates early on ERANGE rather than return a partial integer.
233 We prefer the maximal string. We set buf[0] earlier, and we
234 know of no implementation that modifies buf to be an
235 unterminated string, so this strlen should be portable in
236 practice (rather than pulling in a safer strnlen). */
237 if (ret == ERANGE && strlen (buf) < buflen - 1)
239 char stackbuf[STACKBUF_LEN];
241 /* STACKBUF_LEN should have been large enough. */
242 if (strerror_r (errnum, stackbuf, sizeof stackbuf) == ERANGE)
244 safe_copy (buf, buflen, stackbuf);
248 #else /* USE_SYSTEM_STRERROR */
250 /* Try to do what strerror (errnum) does, but without clobbering the
251 buffer used by strerror(). */
253 # if defined __NetBSD__ || defined __hpux || (defined _WIN32 && !defined __CYGWIN__) || defined __CYGWIN__ /* NetBSD, HP-UX, native Windows, Cygwin */
255 /* NetBSD: sys_nerr, sys_errlist are declared through _NETBSD_SOURCE
257 HP-UX: sys_nerr, sys_errlist are declared explicitly above.
258 native Windows: sys_nerr, sys_errlist are declared in <stdlib.h>.
259 Cygwin: sys_nerr, sys_errlist are declared in <errno.h>. */
260 if (errnum >= 0 && errnum < sys_nerr)
262 # if HAVE_CATGETS && (defined __NetBSD__ || defined __hpux)
263 # if defined __NetBSD__
264 nl_catd catd = catopen ("libc", NL_CAT_LOCALE);
267 ? catgets (catd, 1, errnum, sys_errlist[errnum])
268 : sys_errlist[errnum]);
271 nl_catd catd = catopen ("perror", NL_CAT_LOCALE);
274 ? catgets (catd, 1, 1 + errnum, sys_errlist[errnum])
275 : sys_errlist[errnum]);
278 const char *errmsg = sys_errlist[errnum];
280 if (errmsg == NULL || *errmsg == '\0')
283 ret = safe_copy (buf, buflen, errmsg);
284 # if HAVE_CATGETS && (defined __NetBSD__ || defined __hpux)
285 if (catd != (nl_catd)-1)
292 # elif defined __sgi || (defined __sun && !defined _LP64) /* IRIX, Solaris <= 9 32-bit */
294 /* For a valid error number, the system's strerror() function returns
295 a pointer to a not copied string, not to a buffer. */
296 if (errnum >= 0 && errnum < sys_nerr)
298 char *errmsg = strerror (errnum);
300 if (errmsg == NULL || *errmsg == '\0')
303 ret = safe_copy (buf, buflen, errmsg);
310 gl_lock_lock (strerror_lock);
313 char *errmsg = strerror (errnum);
315 /* For invalid error numbers, strerror() on
316 - IRIX 6.5 returns NULL,
317 - HP-UX 11 returns an empty string. */
318 if (errmsg == NULL || *errmsg == '\0')
321 ret = safe_copy (buf, buflen, errmsg);
324 gl_lock_unlock (strerror_lock);
330 #if defined _WIN32 && !defined __CYGWIN__
331 /* MSVC 14 defines names for many error codes in the range 100..140,
332 but _sys_errlist contains strings only for the error codes
340 case 100 /* EADDRINUSE */:
341 errmsg = "Address already in use";
343 case 101 /* EADDRNOTAVAIL */:
344 errmsg = "Cannot assign requested address";
346 case 102 /* EAFNOSUPPORT */:
347 errmsg = "Address family not supported by protocol";
349 case 103 /* EALREADY */:
350 errmsg = "Operation already in progress";
352 case 105 /* ECANCELED */:
353 errmsg = "Operation canceled";
355 case 106 /* ECONNABORTED */:
356 errmsg = "Software caused connection abort";
358 case 107 /* ECONNREFUSED */:
359 errmsg = "Connection refused";
361 case 108 /* ECONNRESET */:
362 errmsg = "Connection reset by peer";
364 case 109 /* EDESTADDRREQ */:
365 errmsg = "Destination address required";
367 case 110 /* EHOSTUNREACH */:
368 errmsg = "No route to host";
370 case 112 /* EINPROGRESS */:
371 errmsg = "Operation now in progress";
373 case 113 /* EISCONN */:
374 errmsg = "Transport endpoint is already connected";
376 case 114 /* ELOOP */:
377 errmsg = "Too many levels of symbolic links";
379 case 115 /* EMSGSIZE */:
380 errmsg = "Message too long";
382 case 116 /* ENETDOWN */:
383 errmsg = "Network is down";
385 case 117 /* ENETRESET */:
386 errmsg = "Network dropped connection on reset";
388 case 118 /* ENETUNREACH */:
389 errmsg = "Network is unreachable";
391 case 119 /* ENOBUFS */:
392 errmsg = "No buffer space available";
394 case 123 /* ENOPROTOOPT */:
395 errmsg = "Protocol not available";
397 case 126 /* ENOTCONN */:
398 errmsg = "Transport endpoint is not connected";
400 case 128 /* ENOTSOCK */:
401 errmsg = "Socket operation on non-socket";
403 case 129 /* ENOTSUP */:
404 errmsg = "Not supported";
406 case 130 /* EOPNOTSUPP */:
407 errmsg = "Operation not supported";
409 case 132 /* EOVERFLOW */:
410 errmsg = "Value too large for defined data type";
412 case 133 /* EOWNERDEAD */:
413 errmsg = "Owner died";
415 case 134 /* EPROTO */:
416 errmsg = "Protocol error";
418 case 135 /* EPROTONOSUPPORT */:
419 errmsg = "Protocol not supported";
421 case 136 /* EPROTOTYPE */:
422 errmsg = "Protocol wrong type for socket";
424 case 138 /* ETIMEDOUT */:
425 errmsg = "Connection timed out";
427 case 140 /* EWOULDBLOCK */:
428 errmsg = "Operation would block";
435 ret = safe_copy (buf, buflen, errmsg);
439 if (ret == EINVAL && !*buf)
441 #if defined __HAIKU__
442 /* For consistency with perror(). */
443 snprintf (buf, buflen, "Unknown Application Error (%d)", errnum);
445 snprintf (buf, buflen, "Unknown error %d", errnum);