mem.h 6.4 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262
  1. /* SPDX-License-Identifier: GPL-2.0+ OR BSD-3-Clause */
  2. /*
  3. * Copyright (c) Yann Collet, Facebook, Inc.
  4. * All rights reserved.
  5. *
  6. * This source code is licensed under both the BSD-style license (found in the
  7. * LICENSE file in the root directory of this source tree) and the GPLv2 (found
  8. * in the COPYING file in the root directory of this source tree).
  9. * You may select, at your option, one of the above-listed licenses.
  10. */
  11. #ifndef MEM_H_MODULE
  12. #define MEM_H_MODULE
  13. /*-****************************************
  14. * Dependencies
  15. ******************************************/
  16. #include <asm/unaligned.h> /* get_unaligned, put_unaligned* */
  17. #include <linux/compiler.h> /* inline */
  18. #include <asm/byteorder.h> /* swab32, swab64 */
  19. #include <linux/types.h> /* size_t, ptrdiff_t */
  20. #include "debug.h" /* DEBUG_STATIC_ASSERT */
  21. #include "compiler.h" /* INLINE_KEYWORD, UNUSED_ATTR */
  22. /*-****************************************
  23. * Compiler specifics
  24. ******************************************/
  25. #define MEM_STATIC static INLINE_KEYWORD UNUSED_ATTR
  26. /*-**************************************************************
  27. * Basic Types
  28. *****************************************************************/
  29. typedef uint8_t BYTE;
  30. typedef uint8_t U8;
  31. typedef int8_t S8;
  32. typedef uint16_t U16;
  33. typedef int16_t S16;
  34. typedef uint32_t U32;
  35. typedef int32_t S32;
  36. typedef uint64_t U64;
  37. typedef int64_t S64;
  38. /*-**************************************************************
  39. * Memory I/O API
  40. *****************************************************************/
  41. /*=== Static platform detection ===*/
  42. MEM_STATIC unsigned MEM_32bits(void);
  43. MEM_STATIC unsigned MEM_64bits(void);
  44. MEM_STATIC unsigned MEM_isLittleEndian(void);
  45. /*=== Native unaligned read/write ===*/
  46. MEM_STATIC U16 MEM_read16(const void* memPtr);
  47. MEM_STATIC U32 MEM_read32(const void* memPtr);
  48. MEM_STATIC U64 MEM_read64(const void* memPtr);
  49. MEM_STATIC size_t MEM_readST(const void* memPtr);
  50. MEM_STATIC void MEM_write16(void* memPtr, U16 value);
  51. MEM_STATIC void MEM_write32(void* memPtr, U32 value);
  52. MEM_STATIC void MEM_write64(void* memPtr, U64 value);
  53. /*=== Little endian unaligned read/write ===*/
  54. MEM_STATIC U16 MEM_readLE16(const void* memPtr);
  55. MEM_STATIC U32 MEM_readLE24(const void* memPtr);
  56. MEM_STATIC U32 MEM_readLE32(const void* memPtr);
  57. MEM_STATIC U64 MEM_readLE64(const void* memPtr);
  58. MEM_STATIC size_t MEM_readLEST(const void* memPtr);
  59. MEM_STATIC void MEM_writeLE16(void* memPtr, U16 val);
  60. MEM_STATIC void MEM_writeLE24(void* memPtr, U32 val);
  61. MEM_STATIC void MEM_writeLE32(void* memPtr, U32 val32);
  62. MEM_STATIC void MEM_writeLE64(void* memPtr, U64 val64);
  63. MEM_STATIC void MEM_writeLEST(void* memPtr, size_t val);
  64. /*=== Big endian unaligned read/write ===*/
  65. MEM_STATIC U32 MEM_readBE32(const void* memPtr);
  66. MEM_STATIC U64 MEM_readBE64(const void* memPtr);
  67. MEM_STATIC size_t MEM_readBEST(const void* memPtr);
  68. MEM_STATIC void MEM_writeBE32(void* memPtr, U32 val32);
  69. MEM_STATIC void MEM_writeBE64(void* memPtr, U64 val64);
  70. MEM_STATIC void MEM_writeBEST(void* memPtr, size_t val);
  71. /*=== Byteswap ===*/
  72. MEM_STATIC U32 MEM_swap32(U32 in);
  73. MEM_STATIC U64 MEM_swap64(U64 in);
  74. MEM_STATIC size_t MEM_swapST(size_t in);
  75. /*-**************************************************************
  76. * Memory I/O Implementation
  77. *****************************************************************/
  78. MEM_STATIC unsigned MEM_32bits(void)
  79. {
  80. return sizeof(size_t) == 4;
  81. }
  82. MEM_STATIC unsigned MEM_64bits(void)
  83. {
  84. return sizeof(size_t) == 8;
  85. }
  86. #if defined(__LITTLE_ENDIAN)
  87. #define MEM_LITTLE_ENDIAN 1
  88. #else
  89. #define MEM_LITTLE_ENDIAN 0
  90. #endif
  91. MEM_STATIC unsigned MEM_isLittleEndian(void)
  92. {
  93. return MEM_LITTLE_ENDIAN;
  94. }
  95. MEM_STATIC U16 MEM_read16(const void *memPtr)
  96. {
  97. return get_unaligned((const U16 *)memPtr);
  98. }
  99. MEM_STATIC U32 MEM_read32(const void *memPtr)
  100. {
  101. return get_unaligned((const U32 *)memPtr);
  102. }
  103. MEM_STATIC U64 MEM_read64(const void *memPtr)
  104. {
  105. return get_unaligned((const U64 *)memPtr);
  106. }
  107. MEM_STATIC size_t MEM_readST(const void *memPtr)
  108. {
  109. return get_unaligned((const size_t *)memPtr);
  110. }
  111. MEM_STATIC void MEM_write16(void *memPtr, U16 value)
  112. {
  113. put_unaligned(value, (U16 *)memPtr);
  114. }
  115. MEM_STATIC void MEM_write32(void *memPtr, U32 value)
  116. {
  117. put_unaligned(value, (U32 *)memPtr);
  118. }
  119. MEM_STATIC void MEM_write64(void *memPtr, U64 value)
  120. {
  121. put_unaligned(value, (U64 *)memPtr);
  122. }
  123. /*=== Little endian r/w ===*/
  124. MEM_STATIC U16 MEM_readLE16(const void *memPtr)
  125. {
  126. return get_unaligned_le16(memPtr);
  127. }
  128. MEM_STATIC void MEM_writeLE16(void *memPtr, U16 val)
  129. {
  130. put_unaligned_le16(val, memPtr);
  131. }
  132. MEM_STATIC U32 MEM_readLE24(const void *memPtr)
  133. {
  134. return MEM_readLE16(memPtr) + (((const BYTE *)memPtr)[2] << 16);
  135. }
  136. MEM_STATIC void MEM_writeLE24(void *memPtr, U32 val)
  137. {
  138. MEM_writeLE16(memPtr, (U16)val);
  139. ((BYTE *)memPtr)[2] = (BYTE)(val >> 16);
  140. }
  141. MEM_STATIC U32 MEM_readLE32(const void *memPtr)
  142. {
  143. return get_unaligned_le32(memPtr);
  144. }
  145. MEM_STATIC void MEM_writeLE32(void *memPtr, U32 val32)
  146. {
  147. put_unaligned_le32(val32, memPtr);
  148. }
  149. MEM_STATIC U64 MEM_readLE64(const void *memPtr)
  150. {
  151. return get_unaligned_le64(memPtr);
  152. }
  153. MEM_STATIC void MEM_writeLE64(void *memPtr, U64 val64)
  154. {
  155. put_unaligned_le64(val64, memPtr);
  156. }
  157. MEM_STATIC size_t MEM_readLEST(const void *memPtr)
  158. {
  159. if (MEM_32bits())
  160. return (size_t)MEM_readLE32(memPtr);
  161. else
  162. return (size_t)MEM_readLE64(memPtr);
  163. }
  164. MEM_STATIC void MEM_writeLEST(void *memPtr, size_t val)
  165. {
  166. if (MEM_32bits())
  167. MEM_writeLE32(memPtr, (U32)val);
  168. else
  169. MEM_writeLE64(memPtr, (U64)val);
  170. }
  171. /*=== Big endian r/w ===*/
  172. MEM_STATIC U32 MEM_readBE32(const void *memPtr)
  173. {
  174. return get_unaligned_be32(memPtr);
  175. }
  176. MEM_STATIC void MEM_writeBE32(void *memPtr, U32 val32)
  177. {
  178. put_unaligned_be32(val32, memPtr);
  179. }
  180. MEM_STATIC U64 MEM_readBE64(const void *memPtr)
  181. {
  182. return get_unaligned_be64(memPtr);
  183. }
  184. MEM_STATIC void MEM_writeBE64(void *memPtr, U64 val64)
  185. {
  186. put_unaligned_be64(val64, memPtr);
  187. }
  188. MEM_STATIC size_t MEM_readBEST(const void *memPtr)
  189. {
  190. if (MEM_32bits())
  191. return (size_t)MEM_readBE32(memPtr);
  192. else
  193. return (size_t)MEM_readBE64(memPtr);
  194. }
  195. MEM_STATIC void MEM_writeBEST(void *memPtr, size_t val)
  196. {
  197. if (MEM_32bits())
  198. MEM_writeBE32(memPtr, (U32)val);
  199. else
  200. MEM_writeBE64(memPtr, (U64)val);
  201. }
  202. MEM_STATIC U32 MEM_swap32(U32 in)
  203. {
  204. return swab32(in);
  205. }
  206. MEM_STATIC U64 MEM_swap64(U64 in)
  207. {
  208. return swab64(in);
  209. }
  210. MEM_STATIC size_t MEM_swapST(size_t in)
  211. {
  212. if (MEM_32bits())
  213. return (size_t)MEM_swap32((U32)in);
  214. else
  215. return (size_t)MEM_swap64((U64)in);
  216. }
  217. #endif /* MEM_H_MODULE */