|
Packit Service |
b23acc |
// SPDX-License-Identifier: LGPL-2.1+
|
|
Packit Service |
b23acc |
/*
|
|
Packit Service |
b23acc |
* Copyright (C) 2018 Red Hat, Inc.
|
|
Packit Service |
b23acc |
*/
|
|
Packit Service |
b23acc |
|
|
Packit Service |
b23acc |
#include "nm-default.h"
|
|
Packit Service |
b23acc |
|
|
Packit Service |
b23acc |
#include "nm-errno.h"
|
|
Packit Service |
b23acc |
|
|
Packit Service |
b23acc |
#include <pthread.h>
|
|
Packit Service |
b23acc |
|
|
Packit Service |
b23acc |
/*****************************************************************************/
|
|
Packit Service |
b23acc |
|
|
Packit Service |
b23acc |
static
|
|
Packit Service |
b23acc |
NM_UTILS_LOOKUP_STR_DEFINE (_geterror,
|
|
Packit Service |
b23acc |
#if 0
|
|
Packit Service |
b23acc |
enum _NMErrno,
|
|
Packit Service |
b23acc |
#else
|
|
Packit Service |
b23acc |
int,
|
|
Packit Service |
b23acc |
#endif
|
|
Packit Service |
b23acc |
NM_UTILS_LOOKUP_DEFAULT (NULL),
|
|
Packit Service |
b23acc |
|
|
Packit Service |
b23acc |
NM_UTILS_LOOKUP_STR_ITEM (NME_ERRNO_SUCCESS, "NME_ERRNO_SUCCESS"),
|
|
Packit Service |
b23acc |
NM_UTILS_LOOKUP_STR_ITEM (NME_ERRNO_OUT_OF_RANGE, "NME_ERRNO_OUT_OF_RANGE"),
|
|
Packit Service |
b23acc |
|
|
Packit Service |
b23acc |
NM_UTILS_LOOKUP_STR_ITEM (NME_UNSPEC, "NME_UNSPEC"),
|
|
Packit Service |
b23acc |
NM_UTILS_LOOKUP_STR_ITEM (NME_BUG, "NME_BUG"),
|
|
Packit Service |
b23acc |
NM_UTILS_LOOKUP_STR_ITEM (NME_NATIVE_ERRNO, "NME_NATIVE_ERRNO"),
|
|
Packit Service |
b23acc |
|
|
Packit Service |
b23acc |
NM_UTILS_LOOKUP_STR_ITEM (NME_NL_ATTRSIZE, "NME_NL_ATTRSIZE"),
|
|
Packit Service |
b23acc |
NM_UTILS_LOOKUP_STR_ITEM (NME_NL_BAD_SOCK, "NME_NL_BAD_SOCK"),
|
|
Packit Service |
b23acc |
NM_UTILS_LOOKUP_STR_ITEM (NME_NL_DUMP_INTR, "NME_NL_DUMP_INTR"),
|
|
Packit Service |
b23acc |
NM_UTILS_LOOKUP_STR_ITEM (NME_NL_MSG_OVERFLOW, "NME_NL_MSG_OVERFLOW"),
|
|
Packit Service |
b23acc |
NM_UTILS_LOOKUP_STR_ITEM (NME_NL_MSG_TOOSHORT, "NME_NL_MSG_TOOSHORT"),
|
|
Packit Service |
b23acc |
NM_UTILS_LOOKUP_STR_ITEM (NME_NL_MSG_TRUNC, "NME_NL_MSG_TRUNC"),
|
|
Packit Service |
b23acc |
NM_UTILS_LOOKUP_STR_ITEM (NME_NL_SEQ_MISMATCH, "NME_NL_SEQ_MISMATCH"),
|
|
Packit Service |
b23acc |
NM_UTILS_LOOKUP_STR_ITEM (NME_NL_NOADDR, "NME_NL_NOADDR"),
|
|
Packit Service |
b23acc |
|
|
Packit Service |
b23acc |
NM_UTILS_LOOKUP_STR_ITEM (NME_PL_NOT_FOUND, "not-found"),
|
|
Packit Service |
b23acc |
NM_UTILS_LOOKUP_STR_ITEM (NME_PL_EXISTS, "exists"),
|
|
Packit Service |
b23acc |
NM_UTILS_LOOKUP_STR_ITEM (NME_PL_WRONG_TYPE, "wrong-type"),
|
|
Packit Service |
b23acc |
NM_UTILS_LOOKUP_STR_ITEM (NME_PL_NOT_SLAVE, "not-slave"),
|
|
Packit Service |
b23acc |
NM_UTILS_LOOKUP_STR_ITEM (NME_PL_NO_FIRMWARE, "no-firmware"),
|
|
Packit Service |
b23acc |
NM_UTILS_LOOKUP_STR_ITEM (NME_PL_OPNOTSUPP, "not-supported"),
|
|
Packit Service |
b23acc |
NM_UTILS_LOOKUP_STR_ITEM (NME_PL_NETLINK, "netlink"),
|
|
Packit Service |
b23acc |
NM_UTILS_LOOKUP_STR_ITEM (NME_PL_CANT_SET_MTU, "cant-set-mtu"),
|
|
Packit Service |
b23acc |
|
|
Packit Service |
b23acc |
NM_UTILS_LOOKUP_ITEM_IGNORE (_NM_ERRNO_MININT),
|
|
Packit Service |
b23acc |
NM_UTILS_LOOKUP_ITEM_IGNORE (_NM_ERRNO_RESERVED_LAST_PLUS_1),
|
|
Packit Service |
b23acc |
);
|
|
Packit Service |
b23acc |
|
|
Packit Service |
b23acc |
/**
|
|
Packit Service |
b23acc |
* nm_strerror():
|
|
Packit Service |
b23acc |
* @nmerr: the NetworkManager specific errno to be converted
|
|
Packit Service |
b23acc |
* to string.
|
|
Packit Service |
b23acc |
*
|
|
Packit Service |
b23acc |
* NetworkManager specific error numbers reserve a range in "errno.h" with
|
|
Packit Service |
b23acc |
* our own defines. For numbers that don't fall into this range, the numbers
|
|
Packit Service |
b23acc |
* are identical to the common error numbers.
|
|
Packit Service |
b23acc |
*
|
|
Packit Service |
b23acc |
* Idential to strerror(), g_strerror(), nm_strerror_native() for error numbers
|
|
Packit Service |
b23acc |
* that are not in the reserved range of NetworkManager specific errors.
|
|
Packit Service |
b23acc |
*
|
|
Packit Service |
b23acc |
* Returns: (transfer none): the string representation of the error number.
|
|
Packit Service |
b23acc |
*/
|
|
Packit Service |
b23acc |
const char *
|
|
Packit Service |
b23acc |
nm_strerror (int nmerr)
|
|
Packit Service |
b23acc |
{
|
|
Packit Service |
b23acc |
const char *s;
|
|
Packit Service |
b23acc |
|
|
Packit Service |
b23acc |
nmerr = nm_errno (nmerr);
|
|
Packit Service |
b23acc |
|
|
Packit Service |
b23acc |
if (nmerr >= _NM_ERRNO_RESERVED_FIRST) {
|
|
Packit Service |
b23acc |
s = _geterror (nmerr);
|
|
Packit Service |
b23acc |
if (s)
|
|
Packit Service |
b23acc |
return s;
|
|
Packit Service |
b23acc |
}
|
|
Packit Service |
b23acc |
return nm_strerror_native (nmerr);
|
|
Packit Service |
b23acc |
}
|
|
Packit Service |
b23acc |
|
|
Packit Service |
b23acc |
/*****************************************************************************/
|
|
Packit Service |
b23acc |
|
|
Packit Service |
b23acc |
/**
|
|
Packit Service |
b23acc |
* nm_strerror_native_r:
|
|
Packit Service |
b23acc |
* @errsv: the errno to convert to string.
|
|
Packit Service |
b23acc |
* @buf: the output buffer where to write the string to.
|
|
Packit Service |
b23acc |
* @buf_size: the length of buffer.
|
|
Packit Service |
b23acc |
*
|
|
Packit Service |
b23acc |
* This is like strerror_r(), with one difference: depending on the
|
|
Packit Service |
b23acc |
* locale, the returned string is guaranteed to be valid UTF-8.
|
|
Packit Service |
b23acc |
* Also, there is some confusion as to whether to use glibc's
|
|
Packit Service |
b23acc |
* strerror_r() or the POXIX/XSI variant. This is abstracted
|
|
Packit Service |
b23acc |
* by the function.
|
|
Packit Service |
b23acc |
*
|
|
Packit Service |
b23acc |
* Note that the returned buffer may also be a statically allocated
|
|
Packit Service |
b23acc |
* buffer, and not the input buffer @buf. Consequently, the returned
|
|
Packit Service |
b23acc |
* string may be longer than @buf_size.
|
|
Packit Service |
b23acc |
*
|
|
Packit Service |
b23acc |
* Returns: (transfer none): a NUL terminated error message. This is either a static
|
|
Packit Service |
b23acc |
* string (that is never freed), or the provided @buf argumnt.
|
|
Packit Service |
b23acc |
*/
|
|
Packit Service |
b23acc |
const char *
|
|
Packit Service |
b23acc |
nm_strerror_native_r (int errsv, char *buf, gsize buf_size)
|
|
Packit Service |
b23acc |
{
|
|
Packit Service |
b23acc |
char *buf2;
|
|
Packit Service |
b23acc |
|
|
Packit Service |
b23acc |
nm_assert (buf);
|
|
Packit Service |
b23acc |
nm_assert (buf_size > 0);
|
|
Packit Service |
b23acc |
|
|
Packit Service |
b23acc |
#if (_POSIX_C_SOURCE >= 200112L) && ! _GNU_SOURCE
|
|
Packit Service |
b23acc |
/* XSI-compliant */
|
|
Packit Service |
b23acc |
{
|
|
Packit Service |
b23acc |
int errno_saved = errno;
|
|
Packit Service |
b23acc |
|
|
Packit Service |
b23acc |
if (strerror_r (errsv, buf, buf_size) != 0) {
|
|
Packit Service |
b23acc |
g_snprintf (buf, buf_size, "Unspecified errno %d", errsv);
|
|
Packit Service |
b23acc |
errno = errno_saved;
|
|
Packit Service |
b23acc |
}
|
|
Packit Service |
b23acc |
buf2 = buf;
|
|
Packit Service |
b23acc |
}
|
|
Packit Service |
b23acc |
#else
|
|
Packit Service |
b23acc |
/* GNU-specific */
|
|
Packit Service |
b23acc |
buf2 = strerror_r (errsv, buf, buf_size);
|
|
Packit Service |
b23acc |
#endif
|
|
Packit Service |
b23acc |
|
|
Packit Service |
b23acc |
/* like g_strerror(), ensure that the error message is UTF-8. */
|
|
Packit Service |
b23acc |
if ( !g_get_charset (NULL)
|
|
Packit Service |
b23acc |
&& !g_utf8_validate (buf2, -1, NULL)) {
|
|
Packit Service |
b23acc |
gs_free char *msg = NULL;
|
|
Packit Service |
b23acc |
|
|
Packit Service |
b23acc |
msg = g_locale_to_utf8 (buf2, -1, NULL, NULL, NULL);
|
|
Packit Service |
b23acc |
if (msg) {
|
|
Packit Service |
b23acc |
g_strlcpy (buf, msg, buf_size);
|
|
Packit Service |
b23acc |
buf2 = buf;
|
|
Packit Service |
b23acc |
}
|
|
Packit Service |
b23acc |
}
|
|
Packit Service |
b23acc |
|
|
Packit Service |
b23acc |
return buf2;
|
|
Packit Service |
b23acc |
}
|
|
Packit Service |
b23acc |
|
|
Packit Service |
b23acc |
/**
|
|
Packit Service |
b23acc |
* nm_strerror_native:
|
|
Packit Service |
b23acc |
* @errsv: the errno integer from <errno.h>
|
|
Packit Service |
b23acc |
*
|
|
Packit Service |
b23acc |
* Like strerror(), but strerror() is not thread-safe and not guaranteed
|
|
Packit Service |
b23acc |
* to be UTF-8.
|
|
Packit Service |
b23acc |
*
|
|
Packit Service |
b23acc |
* g_strerror() is a thread-safe variant of strerror(), however it caches
|
|
Packit Service |
b23acc |
* all returned strings in a dictionary. That means, using this on untrusted
|
|
Packit Service |
b23acc |
* error numbers can result in this cache to grow without limits.
|
|
Packit Service |
b23acc |
*
|
|
Packit Service |
b23acc |
* Instead, return a tread-local buffer. This way, it's thread-safe.
|
|
Packit Service |
b23acc |
*
|
|
Packit Service |
b23acc |
* There is a downside to this: subsequent calls of nm_strerror_native()
|
|
Packit Service |
b23acc |
* overwrite the error message.
|
|
Packit Service |
b23acc |
*
|
|
Packit Service |
b23acc |
* Returns: (transfer none): the text representation of the error number.
|
|
Packit Service |
b23acc |
*/
|
|
Packit Service |
b23acc |
const char *
|
|
Packit Service |
b23acc |
nm_strerror_native (int errsv)
|
|
Packit Service |
b23acc |
{
|
|
Packit Service |
b23acc |
static _nm_thread_local char *buf_static = NULL;
|
|
Packit Service |
b23acc |
char *buf;
|
|
Packit Service |
b23acc |
|
|
Packit Service |
b23acc |
buf = buf_static;
|
|
Packit Service |
b23acc |
if (G_UNLIKELY (!buf)) {
|
|
Packit Service |
b23acc |
int errno_saved = errno;
|
|
Packit Service |
b23acc |
pthread_key_t key;
|
|
Packit Service |
b23acc |
|
|
Packit Service |
b23acc |
buf = g_malloc (NM_STRERROR_BUFSIZE);
|
|
Packit Service |
b23acc |
buf_static = buf;
|
|
Packit Service |
b23acc |
|
|
Packit Service |
b23acc |
if ( pthread_key_create (&key, g_free) != 0
|
|
Packit Service |
b23acc |
|| pthread_setspecific (key, buf) != 0) {
|
|
Packit Service |
b23acc |
/* Failure. We will leak the buffer when the thread exits.
|
|
Packit Service |
b23acc |
*
|
|
Packit Service |
b23acc |
* Nothing we can do about it really. For Debug builds we fail with an assertion. */
|
|
Packit Service |
b23acc |
nm_assert_not_reached ();
|
|
Packit Service |
b23acc |
}
|
|
Packit Service |
b23acc |
errno = errno_saved;
|
|
Packit Service |
b23acc |
}
|
|
Packit Service |
b23acc |
|
|
Packit Service |
b23acc |
return nm_strerror_native_r (errsv, buf, NM_STRERROR_BUFSIZE);
|
|
Packit Service |
b23acc |
}
|