xref: /illumos-gate/usr/src/lib/libc/port/gen/strerror.c (revision e8d3efa1c56e5f2b5368600a2baeb7b1d54a07f8)
1 /*
2  * CDDL HEADER START
3  *
4  * The contents of this file are subject to the terms of the
5  * Common Development and Distribution License (the "License").
6  * You may not use this file except in compliance with the License.
7  *
8  * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
9  * or http://www.opensolaris.org/os/licensing.
10  * See the License for the specific language governing permissions
11  * and limitations under the License.
12  *
13  * When distributing Covered Code, include this CDDL HEADER in each
14  * file and include the License file at usr/src/OPENSOLARIS.LICENSE.
15  * If applicable, add the following below this CDDL HEADER, with the
16  * fields enclosed by brackets "[]" replaced with your own identifying
17  * information: Portions Copyright [yyyy] [name of copyright owner]
18  *
19  * CDDL HEADER END
20  */
21 
22 /*
23  * Copyright 2008 Sun Microsystems, Inc.  All rights reserved.
24  * Use is subject to license terms.
25  */
26 /*
27  * Copyright 2015 Joyent, Inc.
28  * Copyright 2025 Oxide Computer Company
29  */
30 
31 /*	Copyright (c) 1988 AT&T	*/
32 /*	  All Rights Reserved	*/
33 
34 #include "lint.h"
35 #include "_libc_gettext.h"
36 #include "syserr.h"
37 #include "thr_uberdata.h"
38 #include <string.h>
39 #include <sys/types.h>
40 #include <errno.h>
41 
42 char *
43 strerror_l(int errnum, locale_t loc)
44 {
45 	if (errnum < _sys_num_nerr && errnum >= 0)
46 		return (_libc_gettext_l(&_sys_nerrs[_sys_nindex[errnum]],
47 		    loc));
48 
49 	errno = EINVAL;
50 	return (_libc_gettext_l("Unknown error", loc));
51 }
52 
53 char *
54 strerror(int errnum)
55 {
56 	return (strerror_l(errnum, __curlocale()));
57 }
58 
59 /*
60  * A version of sterror() that always operates in the C locale. It returns NULL
61  * rather than the "Unknown error" string.
62  */
63 const char *
64 strerrordesc_np(int errnum)
65 {
66 	if (errnum < _sys_num_nerr && errnum >= 0)
67 		return (&_sys_nerrs[_sys_nindex[errnum]]);
68 
69 	errno = EINVAL;
70 	return (NULL);
71 }
72 
73 const char *
74 strerrorname_np(int errnum)
75 {
76 	if (errnum >= 0 && errnum < _sys_num_nerr &&
77 	    _sys_err_names[errnum] != NULL) {
78 		return (_sys_err_names[errnum]);
79 	}
80 
81 	errno = EINVAL;
82 	return (NULL);
83 }
84 
85 /*
86  * Implemented strerror_r in Solaris 10 to comply with SUSv3 2001.
87  */
88 int
89 strerror_r(int errnum, char *strerrbuf, size_t buflen)
90 {
91 	char *buf;
92 	int ret = 0;
93 
94 	if (errnum < _sys_num_nerr && errnum >= 0) {
95 		buf = _libc_gettext((char *)&_sys_nerrs[_sys_nindex[errnum]]);
96 	} else {
97 		buf = _libc_gettext("Unknown error");
98 		ret = errno = EINVAL;
99 	}
100 
101 	/*
102 	 * At compile time, there is no way to determine the max size of
103 	 * language-dependent error message.
104 	 */
105 	if (buflen < (strlen(buf) + 1)) {
106 		ret = errno = ERANGE;
107 	} else {
108 		(void) strcpy(strerrbuf, buf);
109 	}
110 
111 	return (ret);
112 }
113