/usr/include/uhd/error.h is in libuhd-dev 3.9.2-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 | /*
* Copyright 2015 Ettus Research LLC
*
* This program is free software: you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation, either version 3 of the License, or
* (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with this program. If not, see <http://www.gnu.org/licenses/>.
*/
#ifndef INCLUDED_UHD_ERROR_H
#define INCLUDED_UHD_ERROR_H
#include <stdlib.h>
//! UHD error codes
/*!
* Each error code corresponds to a specific uhd::exception, with
* extra codes corresponding to a boost::exception, std::exception,
* and a catch-all for everything else. When an internal C++ function
* throws an exception, UHD converts it to one of these error codes
* to return on the C level.
*/
typedef enum {
//! No error thrown.
UHD_ERROR_NONE = 0,
//! Invalid device arguments.
UHD_ERROR_INVALID_DEVICE = 1,
//! See uhd::index_error.
UHD_ERROR_INDEX = 10,
//! See uhd::key_error.
UHD_ERROR_KEY = 11,
//! See uhd::not_implemented_error.
UHD_ERROR_NOT_IMPLEMENTED = 20,
//! See uhd::usb_error.
UHD_ERROR_USB = 21,
//! See uhd::io_error.
UHD_ERROR_IO = 30,
//! See uhd::os_error.
UHD_ERROR_OS = 31,
//! See uhd::assertion_error.
UHD_ERROR_ASSERTION = 40,
//! See uhd::lookup_error.
UHD_ERROR_LOOKUP = 41,
//! See uhd::type_error.
UHD_ERROR_TYPE = 42,
//! See uhd::value_error.
UHD_ERROR_VALUE = 43,
//! See uhd::runtime_error.
UHD_ERROR_RUNTIME = 44,
//! See uhd::environment_error.
UHD_ERROR_ENVIRONMENT = 45,
//! See uhd::system_error.
UHD_ERROR_SYSTEM = 46,
//! See uhd::exception.
UHD_ERROR_EXCEPT = 47,
//! A boost::exception was thrown.
UHD_ERROR_BOOSTEXCEPT = 60,
//! A std::exception was thrown.
UHD_ERROR_STDEXCEPT = 70,
//! An unknown error was thrown.
UHD_ERROR_UNKNOWN = 100
} uhd_error;
#ifdef __cplusplus
#include <uhd/config.hpp>
#include <uhd/exception.hpp>
#include <boost/exception/diagnostic_information.hpp>
#include <string>
UHD_API uhd_error error_from_uhd_exception(const uhd::exception* e);
UHD_API const std::string& get_c_global_error_string();
UHD_API void set_c_global_error_string(const std::string &msg);
/*!
* This macro runs the given C++ code, and if there are any exceptions
* thrown, they are caught and converted to the corresponding UHD error
* code.
*/
#define UHD_SAFE_C(...) \
try{ __VA_ARGS__ } \
catch (const uhd::exception &e) { \
set_c_global_error_string(e.what()); \
return error_from_uhd_exception(&e); \
} \
catch (const boost::exception &e) { \
set_c_global_error_string(boost::diagnostic_information(e)); \
return UHD_ERROR_BOOSTEXCEPT; \
} \
catch (const std::exception &e) { \
set_c_global_error_string(e.what()); \
return UHD_ERROR_STDEXCEPT; \
} \
catch (...) { \
set_c_global_error_string("Unrecognized exception caught."); \
return UHD_ERROR_UNKNOWN; \
} \
set_c_global_error_string("None"); \
return UHD_ERROR_NONE;
/*!
* This macro runs the given C++ code, and if there are any exceptions
* thrown, they are caught and converted to the corresponding UHD error
* code. The error message is also saved into the given handle.
*/
#define UHD_SAFE_C_SAVE_ERROR(h, ...) \
h->last_error.clear(); \
try{ __VA_ARGS__ } \
catch (const uhd::exception &e) { \
set_c_global_error_string(e.what()); \
h->last_error = e.what(); \
return error_from_uhd_exception(&e); \
} \
catch (const boost::exception &e) { \
set_c_global_error_string(boost::diagnostic_information(e)); \
h->last_error = boost::diagnostic_information(e); \
return UHD_ERROR_BOOSTEXCEPT; \
} \
catch (const std::exception &e) { \
set_c_global_error_string(e.what()); \
h->last_error = e.what(); \
return UHD_ERROR_STDEXCEPT; \
} \
catch (...) { \
set_c_global_error_string("Unrecognized exception caught."); \
h->last_error = "Unrecognized exception caught."; \
return UHD_ERROR_UNKNOWN; \
} \
h->last_error = "None"; \
set_c_global_error_string("None"); \
return UHD_ERROR_NONE;
extern "C" {
#endif
//! Return the last error string reported by UHD
/*!
* Functions that do not take in UHD structs/handles will place any error
* strings into a buffer that can be queried with this function. Functions that
* do take in UHD structs/handles will place their error strings in both locations.
*/
uhd_error uhd_get_last_error(
char* error_out,
size_t strbuffer_len
);
#ifdef __cplusplus
}
#endif
#endif /* INCLUDED_UHD_ERROR_H */
|