Neels Hofmeyr | 17518fe | 2017-06-20 04:35:06 +0200 | [diff] [blame] | 1 | /*! \file defs.h |
| 2 | * General definitions that are meant to be included from header files. |
| 3 | */ |
| 4 | |
Sylvain Munaut | 12ba778 | 2014-06-16 10:13:40 +0200 | [diff] [blame] | 5 | #pragma once |
Jacob Erlbeck | 6b26218 | 2013-08-14 12:26:27 +0200 | [diff] [blame] | 6 | |
| 7 | /*! \defgroup utils General-purpose utility functions |
| 8 | * @{ |
Neels Hofmeyr | 17518fe | 2017-06-20 04:35:06 +0200 | [diff] [blame] | 9 | * \file defs.h */ |
Jacob Erlbeck | 6b26218 | 2013-08-14 12:26:27 +0200 | [diff] [blame] | 10 | |
Neels Hofmeyr | 87e4550 | 2017-06-20 00:17:59 +0200 | [diff] [blame] | 11 | /*! Check for gcc and version. |
Jacob Erlbeck | 6b26218 | 2013-08-14 12:26:27 +0200 | [diff] [blame] | 12 | * |
| 13 | * \note Albeit glibc provides a features.h file that contains a similar |
| 14 | * definition (__GNUC_PREREQ), this definition has been copied from there |
| 15 | * to have it available with other libraries, too. |
| 16 | * |
| 17 | * \return != 0 iff gcc is used and it's version is at least maj.min. |
| 18 | */ |
| 19 | #if defined __GNUC__ && defined __GNUC_MINOR__ |
| 20 | # define OSMO_GNUC_PREREQ(maj, min) \ |
| 21 | ((__GNUC__ << 16) + __GNUC_MINOR__ >= ((maj) << 16) + (min)) |
| 22 | #else |
| 23 | # define OSMO_GNUC_PREREQ(maj, min) 0 |
| 24 | #endif |
| 25 | |
Neels Hofmeyr | 87e4550 | 2017-06-20 00:17:59 +0200 | [diff] [blame] | 26 | /*! Set the deprecated attribute with a message. |
Jacob Erlbeck | 6b26218 | 2013-08-14 12:26:27 +0200 | [diff] [blame] | 27 | */ |
Jacob Erlbeck | 3f74d9e | 2013-08-14 18:13:45 +0200 | [diff] [blame] | 28 | #if defined(__clang__) |
Jacob Erlbeck | c4cc924 | 2013-08-15 10:38:05 +0200 | [diff] [blame] | 29 | # define _OSMO_HAS_ATTRIBUTE_DEPRECATED __has_attribute(deprecated) |
| 30 | # define _OSMO_HAS_ATTRIBUTE_DEPRECATED_WITH_MESSAGE __has_extension(attribute_deprecated_with_message) |
Jacob Erlbeck | 3f74d9e | 2013-08-14 18:13:45 +0200 | [diff] [blame] | 31 | #elif defined(__GNUC__) |
| 32 | # define _OSMO_HAS_ATTRIBUTE_DEPRECATED 1 |
Jacob Erlbeck | c4cc924 | 2013-08-15 10:38:05 +0200 | [diff] [blame] | 33 | # define _OSMO_HAS_ATTRIBUTE_DEPRECATED_WITH_MESSAGE OSMO_GNUC_PREREQ(4,5) |
Jacob Erlbeck | 6b26218 | 2013-08-14 12:26:27 +0200 | [diff] [blame] | 34 | #endif |
| 35 | |
Jacob Erlbeck | c4cc924 | 2013-08-15 10:38:05 +0200 | [diff] [blame] | 36 | #if _OSMO_HAS_ATTRIBUTE_DEPRECATED_WITH_MESSAGE |
Jacob Erlbeck | 3f74d9e | 2013-08-14 18:13:45 +0200 | [diff] [blame] | 37 | # define OSMO_DEPRECATED(text) __attribute__((__deprecated__(text))) |
Jacob Erlbeck | c4cc924 | 2013-08-15 10:38:05 +0200 | [diff] [blame] | 38 | #elif _OSMO_HAS_ATTRIBUTE_DEPRECATED |
Jacob Erlbeck | 3f74d9e | 2013-08-14 18:13:45 +0200 | [diff] [blame] | 39 | # define OSMO_DEPRECATED(text) __attribute__((__deprecated__)) |
| 40 | #else |
| 41 | # define OSMO_DEPRECATED(text) |
| 42 | #endif |
| 43 | |
Pau Espin Pedrol | 69dfe5a | 2017-06-17 23:18:11 +0200 | [diff] [blame] | 44 | #if BUILDING_LIBOSMOCORE |
| 45 | # define OSMO_DEPRECATED_OUTSIDE_LIBOSMOCORE |
Vadim Yanitskiy | 87b5143 | 2019-11-07 22:15:13 +0700 | [diff] [blame] | 46 | # define OSMO_DEPRECATED_OUTSIDE(text) |
Pau Espin Pedrol | 69dfe5a | 2017-06-17 23:18:11 +0200 | [diff] [blame] | 47 | #else |
| 48 | # define OSMO_DEPRECATED_OUTSIDE_LIBOSMOCORE OSMO_DEPRECATED("For internal use inside libosmocore only.") |
Vadim Yanitskiy | 87b5143 | 2019-11-07 22:15:13 +0700 | [diff] [blame] | 49 | # define OSMO_DEPRECATED_OUTSIDE(text) OSMO_DEPRECATED(text) |
Pau Espin Pedrol | 69dfe5a | 2017-06-17 23:18:11 +0200 | [diff] [blame] | 50 | #endif |
| 51 | |
Jacob Erlbeck | 3f74d9e | 2013-08-14 18:13:45 +0200 | [diff] [blame] | 52 | #undef _OSMO_HAS_ATTRIBUTE_DEPRECATED_WITH_MESSAGE |
| 53 | #undef _OSMO_HAS_ATTRIBUTE_DEPRECATED |
| 54 | |
Jacob Erlbeck | 6b26218 | 2013-08-14 12:26:27 +0200 | [diff] [blame] | 55 | /*! @} */ |