ua_config.h.in 10 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325
  1. /* This Source Code Form is subject to the terms of the Mozilla Public
  2. * License, v. 2.0. If a copy of the MPL was not distributed with this
  3. * file, You can obtain one at http://mozilla.org/MPL/2.0/. */
  4. #ifndef UA_CONFIG_H_
  5. #define UA_CONFIG_H_
  6. #ifdef __cplusplus
  7. extern "C" {
  8. #endif
  9. /**
  10. * open62541 Version
  11. * ----------------- */
  12. #define UA_OPEN62541_VER_MAJOR ${OPEN62541_VER_MAJOR}
  13. #define UA_OPEN62541_VER_MINOR ${OPEN62541_VER_MINOR}
  14. #define UA_OPEN62541_VER_PATCH ${OPEN62541_VER_PATCH}
  15. #define UA_OPEN62541_VER_LABEL "${OPEN62541_VER_LABEL}" /* Release candidate label, etc. */
  16. #define UA_OPEN62541_VER_COMMIT "${OPEN62541_VER_COMMIT}"
  17. /**
  18. * Feature Options
  19. * ---------------
  20. * Changing the feature options has no effect on a pre-compiled library. */
  21. #define UA_LOGLEVEL ${UA_LOGLEVEL}
  22. #cmakedefine UA_ENABLE_METHODCALLS
  23. #cmakedefine UA_ENABLE_NODEMANAGEMENT
  24. #cmakedefine UA_ENABLE_SUBSCRIPTIONS
  25. #cmakedefine UA_ENABLE_PUBSUB
  26. #cmakedefine UA_ENABLE_PUBSUB_DELTAFRAMES
  27. #cmakedefine UA_ENABLE_PUBSUB_INFORMATIONMODEL
  28. #cmakedefine UA_ENABLE_ENCRYPTION
  29. #cmakedefine UA_ENABLE_SUBSCRIPTIONS_EVENTS
  30. /* Multithreading */
  31. #cmakedefine UA_ENABLE_MULTITHREADING
  32. #cmakedefine UA_ENABLE_IMMUTABLE_NODES
  33. #if defined(UA_ENABLE_MULTITHREADING) && !defined(UA_ENABLE_IMMUTABLE_NODES)
  34. #error "The multithreading feature requires nodes to be immutable"
  35. #endif
  36. /* Advanced Options */
  37. #cmakedefine UA_ENABLE_STATUSCODE_DESCRIPTIONS
  38. #cmakedefine UA_ENABLE_TYPENAMES
  39. #cmakedefine UA_ENABLE_DETERMINISTIC_RNG
  40. #cmakedefine UA_ENABLE_GENERATE_NAMESPACE0
  41. #cmakedefine UA_ENABLE_NONSTANDARD_UDP
  42. #cmakedefine UA_ENABLE_DISCOVERY
  43. #cmakedefine UA_ENABLE_DISCOVERY_MULTICAST
  44. #cmakedefine UA_ENABLE_DISCOVERY_SEMAPHORE
  45. #cmakedefine UA_ENABLE_UNIT_TEST_FAILURE_HOOKS
  46. #cmakedefine UA_ENABLE_VALGRIND_INTERACTIVE
  47. #define UA_VALGRIND_INTERACTIVE_INTERVAL ${UA_VALGRIND_INTERACTIVE_INTERVAL}
  48. /* Options for Debugging */
  49. #cmakedefine UA_DEBUG
  50. #cmakedefine UA_DEBUG_DUMP_PKGS
  51. /**
  52. * C99 Definitions
  53. * --------------- */
  54. #include <string.h>
  55. #include <stddef.h>
  56. /* Include stdint.h and stdbool.h or workaround for older Visual Studios */
  57. #if !defined(_MSC_VER) || _MSC_VER >= 1600
  58. # include <stdint.h>
  59. # include <stdbool.h> /* C99 Boolean */
  60. # if defined(_WRS_KERNEL)
  61. # define UINT32_C(x) ((x) + (UINT32_MAX - UINT32_MAX))
  62. # endif
  63. #else
  64. # include "ms_stdint.h"
  65. # if !defined(__bool_true_false_are_defined)
  66. # define bool short
  67. # define true 1
  68. # define false 0
  69. # define __bool_true_false_are_defined
  70. # endif
  71. #endif
  72. /**
  73. * Assertions
  74. * ----------
  75. * The assert macro is disabled by defining NDEBUG. It is often forgotten to
  76. * include -DNDEBUG in the compiler flags when using the single-file release. So
  77. * we make assertions dependent on the UA_DEBUG definition handled by CMake. */
  78. #ifdef UA_DEBUG
  79. # include <assert.h>
  80. # define UA_assert(ignore) assert(ignore)
  81. #else
  82. # define UA_assert(ignore)
  83. #endif
  84. /* Outputs an error message at compile time if the assert fails.
  85. * Example usage:
  86. * UA_STATIC_ASSERT(sizeof(long)==7, use_another_compiler_luke)
  87. * See: https://stackoverflow.com/a/4815532/869402 */
  88. #if defined(__cplusplus) && __cplusplus >= 201103L /* C++11 or above */
  89. # define UA_STATIC_ASSERT(cond,msg) static_assert(cond, #msg)
  90. #elif defined(__STDC_VERSION__) && __STDC_VERSION__ >= 201112L /* C11 or above */
  91. # define UA_STATIC_ASSERT(cond,msg) _Static_assert(cond, #msg)
  92. #elif defined(__GNUC__) || defined(__clang__) || defined(_MSC_VER) /* GCC, Clang, MSC */
  93. # define UA_CTASTR2(pre,post) pre ## post
  94. # define UA_CTASTR(pre,post) UA_CTASTR2(pre,post)
  95. # ifndef __COUNTER__ /* PPC GCC fix */
  96. # define __COUNTER__ __LINE__
  97. # endif
  98. # define UA_STATIC_ASSERT(cond,msg) \
  99. typedef struct { \
  100. int UA_CTASTR(static_assertion_failed_,msg) : !!(cond); \
  101. } UA_CTASTR(static_assertion_failed_,__COUNTER__)
  102. #else /* Everybody else */
  103. # define UA_STATIC_ASSERT(cond,msg) typedef char static_assertion_##msg[(cond)?1:-1]
  104. #endif
  105. /**
  106. * Memory Management
  107. * -----------------
  108. * The default is to use the malloc implementation from ``stdlib.h``. Override
  109. * if required. Changing the settings has no effect on a pre-compiled
  110. * library. */
  111. #include <stdlib.h>
  112. #if defined(_WIN32) && !defined(__clang__)
  113. # include <malloc.h>
  114. #endif
  115. #if !defined(UA_FREERTOS)
  116. # define UA_free(ptr) free(ptr)
  117. # define UA_malloc(size) malloc(size)
  118. # define UA_calloc(num, size) calloc(num, size)
  119. # define UA_realloc(ptr, size) realloc(ptr, size)
  120. #else
  121. # include <FreeRTOS.h>
  122. # define UA_free(ptr) vPortFree(ptr)
  123. # define UA_malloc(size) pvPortMalloc(size)
  124. # define UA_calloc(num, size) pvPortCalloc(num, size)
  125. # define UA_realloc(ptr, size) pvPortRealloc(ptr, size)
  126. #endif
  127. /* Stack-allocation of memory. Use C99 variable-length arrays if possible.
  128. * Otherwise revert to alloca. Note that alloca is not supported on some
  129. * plattforms. */
  130. #if defined(__GNUC__) || defined(__clang__)
  131. # define UA_STACKARRAY(TYPE, NAME, SIZE) TYPE NAME[SIZE]
  132. #elif defined(_WIN32)
  133. # define UA_STACKARRAY(TYPE, NAME, SIZE) \
  134. TYPE *NAME = (TYPE*)_alloca(sizeof(TYPE) * SIZE)
  135. #else
  136. # include <alloca.h>
  137. # define UA_STACKARRAY(TYPE, NAME, SIZE) \
  138. TYPE *NAME = (TYPE*)alloca(sizeof(TYPE) * SIZE)
  139. #endif
  140. /**
  141. * Function Export
  142. * ---------------
  143. * On Win32: Define ``UA_DYNAMIC_LINKING`` and ``UA_DYNAMIC_LINKING_EXPORT`` in
  144. * order to export symbols for a DLL. Define ``UA_DYNAMIC_LINKING`` only to
  145. * import symbols from a DLL.*/
  146. #cmakedefine UA_DYNAMIC_LINKING
  147. #if defined(_WIN32) && defined(UA_DYNAMIC_LINKING)
  148. # ifdef UA_DYNAMIC_LINKING_EXPORT /* export dll */
  149. # ifdef __GNUC__
  150. # define UA_EXPORT __attribute__ ((dllexport))
  151. # else
  152. # define UA_EXPORT __declspec(dllexport)
  153. # endif
  154. # else /* import dll */
  155. # ifdef __GNUC__
  156. # define UA_EXPORT __attribute__ ((dllimport))
  157. # else
  158. # define UA_EXPORT __declspec(dllimport)
  159. # endif
  160. # endif
  161. #else /* non win32 */
  162. # if __GNUC__ || __clang__
  163. # define UA_EXPORT __attribute__ ((visibility ("default")))
  164. # endif
  165. #endif
  166. #ifndef UA_EXPORT
  167. # define UA_EXPORT /* fallback to default */
  168. #endif
  169. /**
  170. * Inline Functions
  171. * ---------------- */
  172. #ifdef _MSC_VER
  173. # define UA_INLINE __inline
  174. #else
  175. # define UA_INLINE inline
  176. #endif
  177. /**
  178. * Non-aliasing pointers
  179. * -------------------- */
  180. #ifdef _MSC_VER
  181. # define UA_RESTRICT __restrict
  182. #elif defined(__GNUC__)
  183. # define UA_RESTRICT __restrict__
  184. #else
  185. # define UA_RESTRICT restrict
  186. #endif
  187. /**
  188. * Function attributes
  189. * ------------------- */
  190. #if defined(__GNUC__) || defined(__clang__)
  191. # define UA_FUNC_ATTR_MALLOC __attribute__((malloc))
  192. # define UA_FUNC_ATTR_PURE __attribute__ ((pure))
  193. # define UA_FUNC_ATTR_CONST __attribute__((const))
  194. # define UA_FUNC_ATTR_WARN_UNUSED_RESULT __attribute__((warn_unused_result))
  195. # define UA_FORMAT(X,Y) __attribute__ ((format (printf, X, Y)))
  196. #else
  197. # define UA_FUNC_ATTR_MALLOC
  198. # define UA_FUNC_ATTR_PURE
  199. # define UA_FUNC_ATTR_CONST
  200. # define UA_FUNC_ATTR_WARN_UNUSED_RESULT
  201. # define UA_FORMAT(X,Y)
  202. #endif
  203. #if defined(__GNUC__) || defined(__clang__)
  204. # define UA_DEPRECATED __attribute__((deprecated))
  205. #elif defined(_MSC_VER)
  206. # define UA_DEPRECATED __declspec(deprecated)
  207. #else
  208. # define UA_DEPRECATED
  209. #endif
  210. /**
  211. * Detect Binary Overlaying for Encoding
  212. * -------------------------------------
  213. * Integers and floating point numbers are transmitted in little-endian (IEEE 754
  214. * for floating point) encoding. If the target architecture uses the same
  215. * format, numeral datatypes can be memcpy'd (overlayed) on the binary stream.
  216. * This speeds up encoding.
  217. *
  218. * Integer Endianness
  219. * ^^^^^^^^^^^^^^^^^^
  220. * The definition ``UA_BINARY_OVERLAYABLE_INTEGER`` is true when the integer
  221. * representation of the target architecture is little-endian. */
  222. #if defined(_WIN32)
  223. # define UA_BINARY_OVERLAYABLE_INTEGER 1
  224. #elif (defined(__BYTE_ORDER__) && defined(__ORDER_LITTLE_ENDIAN__) && \
  225. (__BYTE_ORDER__ == __ORDER_LITTLE_ENDIAN__))
  226. # define UA_BINARY_OVERLAYABLE_INTEGER 1
  227. #elif defined(__linux__) /* Linux (including Android) */
  228. # include <endian.h>
  229. # if __BYTE_ORDER == __LITTLE_ENDIAN
  230. # define UA_BINARY_OVERLAYABLE_INTEGER 1
  231. # endif
  232. #elif defined(__OpenBSD__) /* OpenBSD */
  233. # include <sys/endian.h>
  234. # if BYTE_ORDER == LITTLE_ENDIAN
  235. # define UA_BINARY_OVERLAYABLE_INTEGER 1
  236. # endif
  237. #elif defined(__NetBSD__) || defined(__FreeBSD__) || defined(__DragonFly__) /* Other BSD */
  238. # include <sys/endian.h>
  239. # if _BYTE_ORDER == _LITTLE_ENDIAN
  240. # define UA_BINARY_OVERLAYABLE_INTEGER 1
  241. # endif
  242. #elif defined(__APPLE__) /* Apple (MacOS, iOS) */
  243. # include <libkern/OSByteOrder.h>
  244. # if defined(__LITTLE_ENDIAN__)
  245. # define UA_BINARY_OVERLAYABLE_INTEGER 1
  246. # endif
  247. #elif defined(__QNX__) || defined(__QNXNTO__) /* QNX */
  248. # include <gulliver.h>
  249. # if defined(__LITTLEENDIAN__)
  250. # define UA_BINARY_OVERLAYABLE_INTEGER 1
  251. # endif
  252. #endif
  253. #ifndef UA_BINARY_OVERLAYABLE_INTEGER
  254. # define UA_BINARY_OVERLAYABLE_INTEGER 0
  255. #endif
  256. /**
  257. * Float Endianness
  258. * ^^^^^^^^^^^^^^^^
  259. * The definition ``UA_BINARY_OVERLAYABLE_FLOAT`` is true when the floating
  260. * point number representation of the target architecture is IEEE 754. Note that
  261. * this cannot be reliable detected with macros for the clang compiler
  262. * (beginning of 2017). ``UA_BINARY_OVERLAYABLE_FLOAT`` can be manually set if
  263. * the target is known to be little endian with floats in the IEEE 754
  264. * format. */
  265. #if defined(_WIN32)
  266. # define UA_BINARY_OVERLAYABLE_FLOAT 1
  267. #elif defined(__FLOAT_WORD_ORDER__) && defined(__ORDER_LITTLE_ENDIAN__) && \
  268. (__FLOAT_WORD_ORDER__ == __ORDER_LITTLE_ENDIAN__) /* Defined only in GCC */
  269. # define UA_BINARY_OVERLAYABLE_FLOAT 1
  270. #elif defined(__FLOAT_WORD_ORDER) && defined(__LITTLE_ENDIAN) && \
  271. (__FLOAT_WORD_ORDER == __LITTLE_ENDIAN) /* Defined only in GCC */
  272. # define UA_BINARY_OVERLAYABLE_FLOAT 1
  273. #elif defined(__linux__) /* Linux (including Android) */
  274. # include <endian.h>
  275. # if defined(__ANDROID__)
  276. # if __BYTE_ORDER == __LITTLE_ENDIAN
  277. # define UA_BINARY_OVERLAYABLE_INTEGER 1
  278. # endif
  279. # elif __FLOAT_WORD_ORDER == __LITTLE_ENDIAN
  280. # define UA_BINARY_OVERLAYABLE_FLOAT 1
  281. # endif
  282. #elif defined(_WRS_KERNEL)
  283. # define UA_BINARY_OVERLAYABLE_FLOAT 1
  284. #endif
  285. #ifndef UA_BINARY_OVERLAYABLE_FLOAT
  286. # define UA_BINARY_OVERLAYABLE_FLOAT 0
  287. #endif
  288. #ifdef __cplusplus
  289. } // extern "C"
  290. #endif
  291. #endif /* UA_CONFIG_H_ */