chore: make yuzu REUSE compliant
[REUSE] is a specification that aims at making file copyright
information consistent, so that it can be both human and machine
readable. It basically requires that all files have a header containing
copyright and licensing information. When this isn't possible, like
when dealing with binary assets, generated files or embedded third-party
dependencies, it is permitted to insert copyright information in the
`.reuse/dep5` file.
Oh, and it also requires that all the licenses used in the project are
present in the `LICENSES` folder, that's why the diff is so huge.
This can be done automatically with `reuse download --all`.
The `reuse` tool also contains a handy subcommand that analyzes the
project and tells whether or not the project is (still) compliant,
`reuse lint`.
Following REUSE has a few advantages over the current approach:
- Copyright information is easy to access for users / downstream
- Files like `dist/license.md` do not need to exist anymore, as
`.reuse/dep5` is used instead
- `reuse lint` makes it easy to ensure that copyright information of
files like binary assets / images is always accurate and up to date
To add copyright information of files that didn't have it I looked up
who committed what and when, for each file. As yuzu contributors do not
have to sign a CLA or similar I couldn't assume that copyright ownership
was of the "yuzu Emulator Project", so I used the name and/or email of
the commit author instead.
[REUSE]: https://reuse.software
Follow-up to 01cf05bc75b1e47beb08937439f3ed9339e7b254
2022-05-14 20:06:02 -04:00
|
|
|
// SPDX-FileCopyrightText: 2013 Dolphin Emulator Project
|
|
|
|
// SPDX-FileCopyrightText: 2014 Citra Emulator Project
|
|
|
|
// SPDX-License-Identifier: GPL-2.0-or-later
|
2013-09-04 20:17:46 -04:00
|
|
|
|
2015-06-21 08:12:49 -04:00
|
|
|
#include <cstddef>
|
2013-09-08 20:41:23 -04:00
|
|
|
#ifdef _WIN32
|
2018-08-13 16:28:24 -04:00
|
|
|
#include <windows.h>
|
2015-05-06 03:06:12 -04:00
|
|
|
#else
|
2015-06-21 08:12:49 -04:00
|
|
|
#include <cerrno>
|
|
|
|
#include <cstring>
|
2013-09-08 20:41:23 -04:00
|
|
|
#endif
|
|
|
|
|
2021-09-08 14:36:20 -04:00
|
|
|
#include "common/error.h"
|
|
|
|
|
|
|
|
namespace Common {
|
2013-09-04 20:17:46 -04:00
|
|
|
|
[network] Error handling reform
`network.cpp` has several error paths which either:
- report "Unhandled host socket error=n" and return `SUCCESS`, or
- switch on a few possible errors, log them, and translate them to
Errno; the same switch statement is copied and pasted in multiple
places in the code
Convert these paths to use a helper function `GetAndLogLastError`, which
is roughly the equivalent of one of the switch statements, but:
- handling more cases (both ones that were already in `Errno`, and a few
more I added), and
- using OS functions to convert the error to a string when logging, so
it'll describe the error even if it's not one of the ones in the
switch statement.
- To handle this, refactor the logic in `GetLastErrorMsg` to expose a
new function `NativeErrorToString` which takes the error number
explicitly as an argument. And improve the Windows version a bit.
Also, add a test which exercises two random error paths.
2021-01-24 15:17:02 -05:00
|
|
|
std::string NativeErrorToString(int e) {
|
2013-09-08 20:41:23 -04:00
|
|
|
#ifdef _WIN32
|
[network] Error handling reform
`network.cpp` has several error paths which either:
- report "Unhandled host socket error=n" and return `SUCCESS`, or
- switch on a few possible errors, log them, and translate them to
Errno; the same switch statement is copied and pasted in multiple
places in the code
Convert these paths to use a helper function `GetAndLogLastError`, which
is roughly the equivalent of one of the switch statements, but:
- handling more cases (both ones that were already in `Errno`, and a few
more I added), and
- using OS functions to convert the error to a string when logging, so
it'll describe the error even if it's not one of the ones in the
switch statement.
- To handle this, refactor the logic in `GetLastErrorMsg` to expose a
new function `NativeErrorToString` which takes the error number
explicitly as an argument. And improve the Windows version a bit.
Also, add a test which exercises two random error paths.
2021-01-24 15:17:02 -05:00
|
|
|
LPSTR err_str;
|
|
|
|
|
|
|
|
DWORD res = FormatMessageA(FORMAT_MESSAGE_FROM_SYSTEM | FORMAT_MESSAGE_ALLOCATE_BUFFER |
|
|
|
|
FORMAT_MESSAGE_IGNORE_INSERTS,
|
|
|
|
nullptr, e, MAKELANGID(LANG_NEUTRAL, SUBLANG_DEFAULT),
|
|
|
|
reinterpret_cast<LPSTR>(&err_str), 1, nullptr);
|
|
|
|
if (!res) {
|
|
|
|
return "(FormatMessageA failed to format error)";
|
|
|
|
}
|
|
|
|
std::string ret(err_str);
|
|
|
|
LocalFree(err_str);
|
|
|
|
return ret;
|
|
|
|
#else
|
|
|
|
char err_str[255];
|
2022-12-18 02:37:37 -05:00
|
|
|
#if defined(ANDROID) || \
|
|
|
|
(defined(__GLIBC__) && (_GNU_SOURCE || (_POSIX_C_SOURCE < 200112L && _XOPEN_SOURCE < 600)))
|
2020-10-29 23:30:42 -04:00
|
|
|
// Thread safe (GNU-specific)
|
[network] Error handling reform
`network.cpp` has several error paths which either:
- report "Unhandled host socket error=n" and return `SUCCESS`, or
- switch on a few possible errors, log them, and translate them to
Errno; the same switch statement is copied and pasted in multiple
places in the code
Convert these paths to use a helper function `GetAndLogLastError`, which
is roughly the equivalent of one of the switch statements, but:
- handling more cases (both ones that were already in `Errno`, and a few
more I added), and
- using OS functions to convert the error to a string when logging, so
it'll describe the error even if it's not one of the ones in the
switch statement.
- To handle this, refactor the logic in `GetLastErrorMsg` to expose a
new function `NativeErrorToString` which takes the error number
explicitly as an argument. And improve the Windows version a bit.
Also, add a test which exercises two random error paths.
2021-01-24 15:17:02 -05:00
|
|
|
const char* str = strerror_r(e, err_str, sizeof(err_str));
|
2020-10-29 23:30:42 -04:00
|
|
|
return std::string(str);
|
2013-09-08 20:41:23 -04:00
|
|
|
#else
|
2014-04-01 18:20:08 -04:00
|
|
|
// Thread safe (XSI-compliant)
|
[network] Error handling reform
`network.cpp` has several error paths which either:
- report "Unhandled host socket error=n" and return `SUCCESS`, or
- switch on a few possible errors, log them, and translate them to
Errno; the same switch statement is copied and pasted in multiple
places in the code
Convert these paths to use a helper function `GetAndLogLastError`, which
is roughly the equivalent of one of the switch statements, but:
- handling more cases (both ones that were already in `Errno`, and a few
more I added), and
- using OS functions to convert the error to a string when logging, so
it'll describe the error even if it's not one of the ones in the
switch statement.
- To handle this, refactor the logic in `GetLastErrorMsg` to expose a
new function `NativeErrorToString` which takes the error number
explicitly as an argument. And improve the Windows version a bit.
Also, add a test which exercises two random error paths.
2021-01-24 15:17:02 -05:00
|
|
|
int second_err = strerror_r(e, err_str, sizeof(err_str));
|
|
|
|
if (second_err != 0) {
|
|
|
|
return "(strerror_r failed to format error)";
|
2020-10-29 23:30:42 -04:00
|
|
|
}
|
|
|
|
return std::string(err_str);
|
[network] Error handling reform
`network.cpp` has several error paths which either:
- report "Unhandled host socket error=n" and return `SUCCESS`, or
- switch on a few possible errors, log them, and translate them to
Errno; the same switch statement is copied and pasted in multiple
places in the code
Convert these paths to use a helper function `GetAndLogLastError`, which
is roughly the equivalent of one of the switch statements, but:
- handling more cases (both ones that were already in `Errno`, and a few
more I added), and
- using OS functions to convert the error to a string when logging, so
it'll describe the error even if it's not one of the ones in the
switch statement.
- To handle this, refactor the logic in `GetLastErrorMsg` to expose a
new function `NativeErrorToString` which takes the error number
explicitly as an argument. And improve the Windows version a bit.
Also, add a test which exercises two random error paths.
2021-01-24 15:17:02 -05:00
|
|
|
#endif // GLIBC etc.
|
|
|
|
#endif // _WIN32
|
|
|
|
}
|
|
|
|
|
|
|
|
std::string GetLastErrorMsg() {
|
|
|
|
#ifdef _WIN32
|
|
|
|
return NativeErrorToString(GetLastError());
|
|
|
|
#else
|
|
|
|
return NativeErrorToString(errno);
|
2013-09-08 20:41:23 -04:00
|
|
|
#endif
|
|
|
|
}
|
2021-09-08 14:36:20 -04:00
|
|
|
|
|
|
|
} // namespace Common
|