/src/openssl30/crypto/o_str.c

Source
/*
 * Copyright 2003-2024 The OpenSSL Project Authors. All Rights Reserved.
 *
 * Licensed under the Apache License 2.0 (the "License").  You may not use
 * this file except in compliance with the License.  You can obtain a copy
 * in the file LICENSE in the source distribution or at
 * https://www.openssl.org/source/license.html
 */

#include "e_os.h"
#include <string.h>
#include <limits.h>
#include <openssl/crypto.h>
#include "crypto/ctype.h"
#include "internal/cryptlib.h"
#include "internal/thread_once.h"

#define DEFAULT_SEPARATOR ':'
#define CH_ZERO '\0'

char *CRYPTO_strdup(const char *str, const char *file, int line)
{
    char *ret;

    if (str == NULL)
        return NULL;
    ret = CRYPTO_malloc(strlen(str) + 1, file, line);
    if (ret != NULL)
        strcpy(ret, str);
    return ret;
}

char *CRYPTO_strndup(const char *str, size_t s, const char *file, int line)
{
    size_t maxlen;
    char *ret;

    if (str == NULL)
        return NULL;

    maxlen = OPENSSL_strnlen(str, s);

    ret = CRYPTO_malloc(maxlen + 1, file, line);
    if (ret) {
        memcpy(ret, str, maxlen);
        ret[maxlen] = CH_ZERO;
    }
    return ret;
}

void *CRYPTO_memdup(const void *data, size_t siz, const char *file, int line)
{
    void *ret;

    if (data == NULL || siz >= INT_MAX)
        return NULL;

    ret = CRYPTO_malloc(siz, file, line);
    if (ret == NULL) {
        ERR_raise(ERR_LIB_CRYPTO, ERR_R_MALLOC_FAILURE);
        return NULL;
    }
    return memcpy(ret, data, siz);
}

size_t OPENSSL_strnlen(const char *str, size_t maxlen)
{
    const char *p;

    for (p = str; maxlen-- != 0 && *p != CH_ZERO; ++p)
        ;

    return p - str;
}

size_t OPENSSL_strlcpy(char *dst, const char *src, size_t size)
{
    size_t l = 0;
    for (; size > 1 && *src; size--) {
        *dst++ = *src++;
        l++;
    }
    if (size)
        *dst = CH_ZERO;
    return l + strlen(src);
}

size_t OPENSSL_strlcat(char *dst, const char *src, size_t size)
{
    size_t l = 0;
    for (; size > 0 && *dst; size--, dst++)
        l++;
    return l + OPENSSL_strlcpy(dst, src, size);
}

int OPENSSL_hexchar2int(unsigned char c)
{
#ifdef CHARSET_EBCDIC
    c = os_toebcdic[c];
#endif

    switch (c) {
    case '0':
        return 0;
    case '1':
        return 1;
    case '2':
        return 2;
    case '3':
        return 3;
    case '4':
        return 4;
    case '5':
        return 5;
    case '6':
        return 6;
    case '7':
        return 7;
    case '8':
        return 8;
    case '9':
        return 9;
    case 'a':
    case 'A':
        return 0x0A;
    case 'b':
    case 'B':
        return 0x0B;
    case 'c':
    case 'C':
        return 0x0C;
    case 'd':
    case 'D':
        return 0x0D;
    case 'e':
    case 'E':
        return 0x0E;
    case 'f':
    case 'F':
        return 0x0F;
    }
    return -1;
}

static int hexstr2buf_sep(unsigned char *buf, size_t buf_n, size_t *buflen,
    const char *str, const char sep)
{
    unsigned char *q;
    unsigned char ch, cl;
    int chi, cli;
    const unsigned char *p;
    size_t cnt;

    for (p = (const unsigned char *)str, q = buf, cnt = 0; *p;) {
        ch = *p++;
        /* A separator of CH_ZERO means there is no separator */
        if (ch == sep && sep != CH_ZERO)
            continue;
        cl = *p++;
        if (!cl) {
            ERR_raise(ERR_LIB_CRYPTO, CRYPTO_R_ODD_NUMBER_OF_DIGITS);
            return 0;
        }
        cli = OPENSSL_hexchar2int(cl);
        chi = OPENSSL_hexchar2int(ch);
        if (cli < 0 || chi < 0) {
            ERR_raise(ERR_LIB_CRYPTO, CRYPTO_R_ILLEGAL_HEX_DIGIT);
            return 0;
        }
        cnt++;
        if (q != NULL) {
            if (cnt > buf_n) {
                ERR_raise(ERR_LIB_CRYPTO, CRYPTO_R_TOO_SMALL_BUFFER);
                return 0;
            }
            *q++ = (unsigned char)((chi << 4) | cli);
        }
    }

    if (buflen != NULL)
        *buflen = cnt;
    return 1;
}

/*
 * Given a string of hex digits convert to a buffer
 */
int OPENSSL_hexstr2buf_ex(unsigned char *buf, size_t buf_n, size_t *buflen,
    const char *str, const char sep)
{
    return hexstr2buf_sep(buf, buf_n, buflen, str, sep);
}

unsigned char *ossl_hexstr2buf_sep(const char *str, long *buflen,
    const char sep)
{
    unsigned char *buf;
    size_t buf_n, tmp_buflen;

    buf_n = strlen(str);
    if (buf_n <= 1) {
        ERR_raise(ERR_LIB_CRYPTO, CRYPTO_R_HEX_STRING_TOO_SHORT);
        return NULL;
    }
    buf_n /= 2;
    if ((buf = OPENSSL_malloc(buf_n)) == NULL) {
        ERR_raise(ERR_LIB_CRYPTO, ERR_R_MALLOC_FAILURE);
        return NULL;
    }

    if (buflen != NULL)
        *buflen = 0;
    tmp_buflen = 0;
    if (hexstr2buf_sep(buf, buf_n, &tmp_buflen, str, sep)) {
        if (buflen != NULL)
            *buflen = (long)tmp_buflen;
        return buf;
    }
    OPENSSL_free(buf);
    return NULL;
}

unsigned char *OPENSSL_hexstr2buf(const char *str, long *buflen)
{
    return ossl_hexstr2buf_sep(str, buflen, DEFAULT_SEPARATOR);
}

static int buf2hexstr_sep(char *str, size_t str_n, size_t *strlength,
    const unsigned char *buf, size_t buflen,
    const char sep)
{
    static const char hexdig[] = "0123456789ABCDEF";
    const unsigned char *p;
    char *q;
    size_t i;
    int has_sep = (sep != CH_ZERO);
    size_t len = has_sep ? buflen * 3 : 1 + buflen * 2;

    if (len == 0)
        ++len;
    if (strlength != NULL)
        *strlength = len;
    if (str == NULL)
        return 1;

    if (str_n < len) {
        ERR_raise(ERR_LIB_CRYPTO, CRYPTO_R_TOO_SMALL_BUFFER);
        return 0;
    }

    q = str;
    for (i = 0, p = buf; i < buflen; i++, p++) {
        *q++ = hexdig[(*p >> 4) & 0xf];
        *q++ = hexdig[*p & 0xf];
        if (has_sep)
            *q++ = sep;
    }
    if (has_sep && buflen > 0)
        --q;
    *q = CH_ZERO;

#ifdef CHARSET_EBCDIC
    ebcdic2ascii(str, str, q - str);
#endif
    return 1;
}

int OPENSSL_buf2hexstr_ex(char *str, size_t str_n, size_t *strlength,
    const unsigned char *buf, size_t buflen,
    const char sep)
{
    return buf2hexstr_sep(str, str_n, strlength, buf, buflen, sep);
}

char *ossl_buf2hexstr_sep(const unsigned char *buf, long buflen, char sep)
{
    char *tmp;
    size_t tmp_n;

    if (buflen == 0)
        return OPENSSL_zalloc(1);

    tmp_n = (sep != CH_ZERO) ? buflen * 3 : 1 + buflen * 2;
    if ((tmp = OPENSSL_malloc(tmp_n)) == NULL) {
        ERR_raise(ERR_LIB_CRYPTO, ERR_R_MALLOC_FAILURE);
        return NULL;
    }

    if (buf2hexstr_sep(tmp, tmp_n, NULL, buf, buflen, sep))
        return tmp;
    OPENSSL_free(tmp);
    return NULL;
}

/*
 * Given a buffer of length 'len' return a OPENSSL_malloc'ed string with its
 * hex representation @@@ (Contents of buffer are always kept in ASCII, also
 * on EBCDIC machines)
 */
char *OPENSSL_buf2hexstr(const unsigned char *buf, long buflen)
{
    return ossl_buf2hexstr_sep(buf, buflen, ':');
}

int openssl_strerror_r(int errnum, char *buf, size_t buflen)
{
#if defined(_MSC_VER) && _MSC_VER >= 1400 && !defined(_WIN32_WCE)
    return !strerror_s(buf, buflen, errnum);
#elif defined(_GNU_SOURCE)
    char *err;

    /*
     * GNU strerror_r may not actually set buf.
     * It can return a pointer to some (immutable) static string in which case
     * buf is left unused.
     */
    err = strerror_r(errnum, buf, buflen);
    if (err == NULL || buflen == 0)
        return 0;
    /*
     * If err is statically allocated, err != buf and we need to copy the data.
     * If err points somewhere inside buf, OPENSSL_strlcpy can handle this,
     * since src and dest are not annotated with __restrict and the function
     * reads src byte for byte and writes to dest.
     * If err == buf we do not have to copy anything.
     */
    if (err != buf)
        OPENSSL_strlcpy(buf, err, buflen);
    return 1;
#elif (defined(_POSIX_C_SOURCE) && _POSIX_C_SOURCE >= 200112L) || (defined(_XOPEN_SOURCE) && _XOPEN_SOURCE >= 600)
    /*
     * We can use "real" strerror_r. The OpenSSL version differs in that it
     * gives 1 on success and 0 on failure for consistency with other OpenSSL
     * functions. Real strerror_r does it the other way around
     */
    return !strerror_r(errnum, buf, buflen);
#else
    char *err;

    /* Fall back to non-thread safe strerror()...its all we can do */
    if (buflen < 2)
        return 0;
    err = strerror(errnum);
    /* Can this ever happen? */
    if (err == NULL)
        return 0;
    OPENSSL_strlcpy(buf, err, buflen);
    return 1;
#endif
}

int OPENSSL_strcasecmp(const char *s1, const char *s2)
{
    int t;

    while ((t = ossl_tolower(*s1) - ossl_tolower(*s2++)) == 0)
        if (*s1++ == '\0')
            return 0;
    return t;
}

int OPENSSL_strncasecmp(const char *s1, const char *s2, size_t n)
{
    int t;
    size_t i;

    for (i = 0; i < n; i++)
        if ((t = ossl_tolower(*s1) - ossl_tolower(*s2++)) != 0)
            return t;
        else if (*s1++ == '\0')
            return 0;
    return 0;
}

Coverage Report

Created: 2026-02-14 07:20

Line	Count	Source
1		/*
2		* Copyright 2003-2024 The OpenSSL Project Authors. All Rights Reserved.
3		*
4		* Licensed under the Apache License 2.0 (the "License"). You may not use
5		* this file except in compliance with the License. You can obtain a copy
6		* in the file LICENSE in the source distribution or at
7		* https://www.openssl.org/source/license.html
8		*/
9
10		#include "e_os.h"
11		#include <string.h>
12		#include <limits.h>
13		#include <openssl/crypto.h>
14		#include "crypto/ctype.h"
15		#include "internal/cryptlib.h"
16		#include "internal/thread_once.h"
17
18	0	#define DEFAULT_SEPARATOR ':'
19	2.50G	#define CH_ZERO '\0'
20
21		char CRYPTO_strdup(const char str, const char *file, int line)
22	100M	{
23	100M	char *ret;
24
25	100M	if (str == NULL)
26	0	return NULL;
27	100M	ret = CRYPTO_malloc(strlen(str) + 1, file, line);
28	100M	if (ret != NULL)
29	100M	strcpy(ret, str);
30	100M	return ret;
31	100M	}
32
33		char CRYPTO_strndup(const char str, size_t s, const char *file, int line)
34	233M	{
35	233M	size_t maxlen;
36	233M	char *ret;
37
38	233M	if (str == NULL)
39	0	return NULL;
40
41	233M	maxlen = OPENSSL_strnlen(str, s);
42
43	233M	ret = CRYPTO_malloc(maxlen + 1, file, line);
44	233M	if (ret) {
45	233M	memcpy(ret, str, maxlen);
46	233M	ret[maxlen] = CH_ZERO;
47	233M	}
48	233M	return ret;
49	233M	}
50
51		void CRYPTO_memdup(const void data, size_t siz, const char *file, int line)
52	54.5M	{
53	54.5M	void *ret;
54
55	54.5M	if (data == NULL \|\| siz >= INT_MAX)
56	0	return NULL;
57
58	54.5M	ret = CRYPTO_malloc(siz, file, line);
59	54.5M	if (ret == NULL) {
60	0	ERR_raise(ERR_LIB_CRYPTO, ERR_R_MALLOC_FAILURE);
61	0	return NULL;
62	0	}
63	54.5M	return memcpy(ret, data, siz);
64	54.5M	}
65
66		size_t OPENSSL_strnlen(const char *str, size_t maxlen)
67	467M	{
68	467M	const char *p;
69
70	2.43G	for (p = str; maxlen-- != 0 && *p != CH_ZERO; ++p)
71	1.96G	;
72
73	467M	return p - str;
74	467M	}
75
76		size_t OPENSSL_strlcpy(char dst, const char src, size_t size)
77	76.6M	{
78	76.6M	size_t l = 0;
79	849M	for (; size > 1 && *src; size--) {
80	772M	dst++ = src++;
81	772M	l++;
82	772M	}
83	76.6M	if (size)
84	76.5M	*dst = CH_ZERO;
85	76.6M	return l + strlen(src);
86	76.6M	}
87
88		size_t OPENSSL_strlcat(char dst, const char src, size_t size)
89	58.5M	{
90	58.5M	size_t l = 0;
91	713M	for (; size > 0 && *dst; size--, dst++)
92	655M	l++;
93	58.5M	return l + OPENSSL_strlcpy(dst, src, size);
94	58.5M	}
95
96		int OPENSSL_hexchar2int(unsigned char c)
97	374	{
98		#ifdef CHARSET_EBCDIC
99		c = os_toebcdic[c];
100		#endif
101
102	374	switch (c) {
103	18	case '0':
104	18	return 0;
105	31	case '1':
106	31	return 1;
107	18	case '2':
108	18	return 2;
109	4	case '3':
110	4	return 3;
111	6	case '4':
112	6	return 4;
113	11	case '5':
114	11	return 5;
115	18	case '6':
116	18	return 6;
117	14	case '7':
118	14	return 7;
119	4	case '8':
120	4	return 8;
121	30	case '9':
122	30	return 9;
123	7	case 'a':
124	14	case 'A':
125	14	return 0x0A;
126	40	case 'b':
127	57	case 'B':
128	57	return 0x0B;
129	12	case 'c':
130	21	case 'C':
131	21	return 0x0C;
132	19	case 'd':
133	21	case 'D':
134	21	return 0x0D;
135	22	case 'e':
136	23	case 'E':
137	23	return 0x0E;
138	22	case 'f':
139	41	case 'F':
140	41	return 0x0F;
141	374	}
142	43	return -1;
143	374	}
144
145		static int hexstr2buf_sep(unsigned char buf, size_t buf_n, size_t buflen,
146		const char *str, const char sep)
147	0	{
148	0	unsigned char *q;
149	0	unsigned char ch, cl;
150	0	int chi, cli;
151	0	const unsigned char *p;
152	0	size_t cnt;
153
154	0	for (p = (const unsigned char )str, q = buf, cnt = 0; p;) {
155	0	ch = *p++;
156		/* A separator of CH_ZERO means there is no separator */
157	0	if (ch == sep && sep != CH_ZERO)
158	0	continue;
159	0	cl = *p++;
160	0	if (!cl) {
161	0	ERR_raise(ERR_LIB_CRYPTO, CRYPTO_R_ODD_NUMBER_OF_DIGITS);
162	0	return 0;
163	0	}
164	0	cli = OPENSSL_hexchar2int(cl);
165	0	chi = OPENSSL_hexchar2int(ch);
166	0	if (cli < 0 \|\| chi < 0) {
167	0	ERR_raise(ERR_LIB_CRYPTO, CRYPTO_R_ILLEGAL_HEX_DIGIT);
168	0	return 0;
169	0	}
170	0	cnt++;
171	0	if (q != NULL) {
172	0	if (cnt > buf_n) {
173	0	ERR_raise(ERR_LIB_CRYPTO, CRYPTO_R_TOO_SMALL_BUFFER);
174	0	return 0;
175	0	}
176	0	*q++ = (unsigned char)((chi << 4) \| cli);
177	0	}
178	0	}
179
180	0	if (buflen != NULL)
181	0	*buflen = cnt;
182	0	return 1;
183	0	}
184
185		/*
186		* Given a string of hex digits convert to a buffer
187		*/
188		int OPENSSL_hexstr2buf_ex(unsigned char buf, size_t buf_n, size_t buflen,
189		const char *str, const char sep)
190	0	{
191	0	return hexstr2buf_sep(buf, buf_n, buflen, str, sep);
192	0	}
193
194		unsigned char ossl_hexstr2buf_sep(const char str, long *buflen,
195		const char sep)
196	0	{
197	0	unsigned char *buf;
198	0	size_t buf_n, tmp_buflen;
199
200	0	buf_n = strlen(str);
201	0	if (buf_n <= 1) {
202	0	ERR_raise(ERR_LIB_CRYPTO, CRYPTO_R_HEX_STRING_TOO_SHORT);
203	0	return NULL;
204	0	}
205	0	buf_n /= 2;
206	0	if ((buf = OPENSSL_malloc(buf_n)) == NULL) {
207	0	ERR_raise(ERR_LIB_CRYPTO, ERR_R_MALLOC_FAILURE);
208	0	return NULL;
209	0	}
210
211	0	if (buflen != NULL)
212	0	*buflen = 0;
213	0	tmp_buflen = 0;
214	0	if (hexstr2buf_sep(buf, buf_n, &tmp_buflen, str, sep)) {
215	0	if (buflen != NULL)
216	0	*buflen = (long)tmp_buflen;
217	0	return buf;
218	0	}
219	0	OPENSSL_free(buf);
220	0	return NULL;
221	0	}
222
223		unsigned char OPENSSL_hexstr2buf(const char str, long *buflen)
224	0	{
225	0	return ossl_hexstr2buf_sep(str, buflen, DEFAULT_SEPARATOR);
226	0	}
227
228		static int buf2hexstr_sep(char str, size_t str_n, size_t strlength,
229		const unsigned char *buf, size_t buflen,
230		const char sep)
231	124k	{
232	124k	static const char hexdig[] = "0123456789ABCDEF";
233	124k	const unsigned char *p;
234	124k	char *q;
235	124k	size_t i;
236	124k	int has_sep = (sep != CH_ZERO);
237	124k	size_t len = has_sep ? buflen * 3 : 1 + buflen * 2;
238
239	124k	if (len == 0)
240	0	++len;
241	124k	if (strlength != NULL)
242	0	*strlength = len;
243	124k	if (str == NULL)
244	0	return 1;
245
246	124k	if (str_n < len) {
247	0	ERR_raise(ERR_LIB_CRYPTO, CRYPTO_R_TOO_SMALL_BUFFER);
248	0	return 0;
249	0	}
250
251	124k	q = str;
252	15.3M	for (i = 0, p = buf; i < buflen; i++, p++) {
253	15.2M	q++ = hexdig[(p >> 4) & 0xf];
254	15.2M	q++ = hexdig[p & 0xf];
255	15.2M	if (has_sep)
256	15.0M	*q++ = sep;
257	15.2M	}
258	124k	if (has_sep && buflen > 0)
259	93.4k	--q;
260	124k	*q = CH_ZERO;
261
262		#ifdef CHARSET_EBCDIC
263		ebcdic2ascii(str, str, q - str);
264		#endif
265	124k	return 1;
266	124k	}
267
268		int OPENSSL_buf2hexstr_ex(char str, size_t str_n, size_t strlength,
269		const unsigned char *buf, size_t buflen,
270		const char sep)
271	0	{
272	0	return buf2hexstr_sep(str, str_n, strlength, buf, buflen, sep);
273	0	}
274
275		char ossl_buf2hexstr_sep(const unsigned char buf, long buflen, char sep)
276	97.6k	{
277	97.6k	char *tmp;
278	97.6k	size_t tmp_n;
279
280	97.6k	if (buflen == 0)
281	7.89k	return OPENSSL_zalloc(1);
282
283	89.7k	tmp_n = (sep != CH_ZERO) ? buflen * 3 : 1 + buflen * 2;
284	89.7k	if ((tmp = OPENSSL_malloc(tmp_n)) == NULL) {
285	0	ERR_raise(ERR_LIB_CRYPTO, ERR_R_MALLOC_FAILURE);
286	0	return NULL;
287	0	}
288
289	89.7k	if (buf2hexstr_sep(tmp, tmp_n, NULL, buf, buflen, sep))
290	89.7k	return tmp;
291	0	OPENSSL_free(tmp);
292	0	return NULL;
293	89.7k	}
294
295		/*
296		* Given a buffer of length 'len' return a OPENSSL_malloc'ed string with its
297		* hex representation @@@ (Contents of buffer are always kept in ASCII, also
298		* on EBCDIC machines)
299		*/
300		char OPENSSL_buf2hexstr(const unsigned char buf, long buflen)
301	104k	{
302	104k	return ossl_buf2hexstr_sep(buf, buflen, ':');
303	104k	}
304
305		int openssl_strerror_r(int errnum, char *buf, size_t buflen)
306	0	{
307		#if defined(_MSC_VER) && _MSC_VER >= 1400 && !defined(_WIN32_WCE)
308		return !strerror_s(buf, buflen, errnum);
309		#elif defined(_GNU_SOURCE)
310		char *err;
311
312		/*
313		* GNU strerror_r may not actually set buf.
314		* It can return a pointer to some (immutable) static string in which case
315		* buf is left unused.
316		*/
317		err = strerror_r(errnum, buf, buflen);
318		if (err == NULL \|\| buflen == 0)
319		return 0;
320		/*
321		* If err is statically allocated, err != buf and we need to copy the data.
322		* If err points somewhere inside buf, OPENSSL_strlcpy can handle this,
323		* since src and dest are not annotated with __restrict and the function
324		* reads src byte for byte and writes to dest.
325		* If err == buf we do not have to copy anything.
326		*/
327		if (err != buf)
328		OPENSSL_strlcpy(buf, err, buflen);
329		return 1;
330		#elif (defined(_POSIX_C_SOURCE) && _POSIX_C_SOURCE >= 200112L) \|\| (defined(_XOPEN_SOURCE) && _XOPEN_SOURCE >= 600)
331		/*
332		* We can use "real" strerror_r. The OpenSSL version differs in that it
333		* gives 1 on success and 0 on failure for consistency with other OpenSSL
334		* functions. Real strerror_r does it the other way around
335		*/
336	0	return !strerror_r(errnum, buf, buflen);
337		#else
338		char *err;
339
340		/* Fall back to non-thread safe strerror()...its all we can do */
341		if (buflen < 2)
342		return 0;
343		err = strerror(errnum);
344		/* Can this ever happen? */
345		if (err == NULL)
346		return 0;
347		OPENSSL_strlcpy(buf, err, buflen);
348		return 1;
349		#endif
350	0	}
351
352		int OPENSSL_strcasecmp(const char s1, const char s2)
353	242M	{
354	242M	int t;
355
356	1.43G	while ((t = ossl_tolower(s1) - ossl_tolower(s2++)) == 0)
357	1.40G	if (*s1++ == '\0')
358	211M	return 0;
359	30.5M	return t;
360	242M	}
361
362		int OPENSSL_strncasecmp(const char s1, const char s2, size_t n)
363	6.43M	{
364	6.43M	int t;
365	6.43M	size_t i;
366
367	13.1M	for (i = 0; i < n; i++)
368	11.1M	if ((t = ossl_tolower(s1) - ossl_tolower(s2++)) != 0)
369	4.52M	return t;
370	6.67M	else if (*s1++ == '\0')
371	0	return 0;
372	1.90M	return 0;
373	6.43M	}