checkasm.h 12 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282
  1. /*
  2. * Assembly testing and benchmarking tool
  3. * Copyright (c) 2015 Henrik Gramner
  4. * Copyright (c) 2008 Loren Merritt
  5. *
  6. * This file is part of FFmpeg.
  7. *
  8. * FFmpeg is free software; you can redistribute it and/or modify
  9. * it under the terms of the GNU General Public License as published by
  10. * the Free Software Foundation; either version 2 of the License, or
  11. * (at your option) any later version.
  12. *
  13. * FFmpeg is distributed in the hope that it will be useful,
  14. * but WITHOUT ANY WARRANTY; without even the implied warranty of
  15. * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
  16. * GNU General Public License for more details.
  17. *
  18. * You should have received a copy of the GNU General Public License along
  19. * with FFmpeg; if not, write to the Free Software Foundation, Inc.,
  20. * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
  21. */
  22. #ifndef TESTS_CHECKASM_CHECKASM_H
  23. #define TESTS_CHECKASM_CHECKASM_H
  24. #include <stdint.h>
  25. #include "config.h"
  26. #if CONFIG_LINUX_PERF
  27. #include <unistd.h> // read(3)
  28. #include <sys/ioctl.h>
  29. #include <asm/unistd.h>
  30. #include <linux/perf_event.h>
  31. #endif
  32. #include "libavutil/avstring.h"
  33. #include "libavutil/cpu.h"
  34. #include "libavutil/internal.h"
  35. #include "libavutil/lfg.h"
  36. #include "libavutil/timer.h"
  37. void checkasm_check_aacpsdsp(void);
  38. void checkasm_check_afir(void);
  39. void checkasm_check_alacdsp(void);
  40. void checkasm_check_audiodsp(void);
  41. void checkasm_check_blend(void);
  42. void checkasm_check_blockdsp(void);
  43. void checkasm_check_bswapdsp(void);
  44. void checkasm_check_colorspace(void);
  45. void checkasm_check_exrdsp(void);
  46. void checkasm_check_fixed_dsp(void);
  47. void checkasm_check_flacdsp(void);
  48. void checkasm_check_float_dsp(void);
  49. void checkasm_check_fmtconvert(void);
  50. void checkasm_check_g722dsp(void);
  51. void checkasm_check_h264dsp(void);
  52. void checkasm_check_h264pred(void);
  53. void checkasm_check_h264qpel(void);
  54. void checkasm_check_hevc_add_res(void);
  55. void checkasm_check_hevc_idct(void);
  56. void checkasm_check_hevc_sao(void);
  57. void checkasm_check_huffyuvdsp(void);
  58. void checkasm_check_jpeg2000dsp(void);
  59. void checkasm_check_llviddsp(void);
  60. void checkasm_check_llviddspenc(void);
  61. void checkasm_check_nlmeans(void);
  62. void checkasm_check_opusdsp(void);
  63. void checkasm_check_pixblockdsp(void);
  64. void checkasm_check_sbrdsp(void);
  65. void checkasm_check_synth_filter(void);
  66. void checkasm_check_sw_rgb(void);
  67. void checkasm_check_sw_scale(void);
  68. void checkasm_check_utvideodsp(void);
  69. void checkasm_check_v210dec(void);
  70. void checkasm_check_v210enc(void);
  71. void checkasm_check_vf_eq(void);
  72. void checkasm_check_vf_gblur(void);
  73. void checkasm_check_vf_hflip(void);
  74. void checkasm_check_vf_threshold(void);
  75. void checkasm_check_vp8dsp(void);
  76. void checkasm_check_vp9dsp(void);
  77. void checkasm_check_videodsp(void);
  78. struct CheckasmPerf;
  79. void *checkasm_check_func(void *func, const char *name, ...) av_printf_format(2, 3);
  80. int checkasm_bench_func(void);
  81. void checkasm_fail_func(const char *msg, ...) av_printf_format(1, 2);
  82. struct CheckasmPerf *checkasm_get_perf_context(void);
  83. void checkasm_report(const char *name, ...) av_printf_format(1, 2);
  84. /* float compare utilities */
  85. int float_near_ulp(float a, float b, unsigned max_ulp);
  86. int float_near_abs_eps(float a, float b, float eps);
  87. int float_near_abs_eps_ulp(float a, float b, float eps, unsigned max_ulp);
  88. int float_near_ulp_array(const float *a, const float *b, unsigned max_ulp,
  89. unsigned len);
  90. int float_near_abs_eps_array(const float *a, const float *b, float eps,
  91. unsigned len);
  92. int float_near_abs_eps_array_ulp(const float *a, const float *b, float eps,
  93. unsigned max_ulp, unsigned len);
  94. int double_near_abs_eps(double a, double b, double eps);
  95. int double_near_abs_eps_array(const double *a, const double *b, double eps,
  96. unsigned len);
  97. extern AVLFG checkasm_lfg;
  98. #define rnd() av_lfg_get(&checkasm_lfg)
  99. static av_unused void *func_ref, *func_new;
  100. #define BENCH_RUNS 1000 /* Trade-off between accuracy and speed */
  101. /* Decide whether or not the specified function needs to be tested */
  102. #define check_func(func, ...) (func_ref = checkasm_check_func((func_new = func), __VA_ARGS__))
  103. /* Declare the function prototype. The first argument is the return value, the remaining
  104. * arguments are the function parameters. Naming parameters is optional. */
  105. #define declare_func(ret, ...) declare_new(ret, __VA_ARGS__) typedef ret func_type(__VA_ARGS__)
  106. #define declare_func_float(ret, ...) declare_new_float(ret, __VA_ARGS__) typedef ret func_type(__VA_ARGS__)
  107. #define declare_func_emms(cpu_flags, ret, ...) declare_new_emms(cpu_flags, ret, __VA_ARGS__) typedef ret func_type(__VA_ARGS__)
  108. /* Indicate that the current test has failed */
  109. #define fail() checkasm_fail_func("%s:%d", av_basename(__FILE__), __LINE__)
  110. /* Print the test outcome */
  111. #define report checkasm_report
  112. /* Call the reference function */
  113. #define call_ref(...) ((func_type *)func_ref)(__VA_ARGS__)
  114. #if ARCH_X86 && HAVE_X86ASM
  115. /* Verifies that clobbered callee-saved registers are properly saved and restored
  116. * and that either no MMX registers are touched or emms is issued */
  117. void checkasm_checked_call(void *func, ...);
  118. /* Verifies that clobbered callee-saved registers are properly saved and restored
  119. * and issues emms for asm functions which are not required to do so */
  120. void checkasm_checked_call_emms(void *func, ...);
  121. /* Verifies that clobbered callee-saved registers are properly saved and restored
  122. * but doesn't issue emms. Meant for dsp functions returning float or double */
  123. void checkasm_checked_call_float(void *func, ...);
  124. #if ARCH_X86_64
  125. /* Evil hack: detect incorrect assumptions that 32-bit ints are zero-extended to 64-bit.
  126. * This is done by clobbering the stack with junk around the stack pointer and calling the
  127. * assembly function through checked_call() with added dummy arguments which forces all
  128. * real arguments to be passed on the stack and not in registers. For 32-bit arguments the
  129. * upper half of the 64-bit register locations on the stack will now contain junk which will
  130. * cause misbehaving functions to either produce incorrect output or segfault. Note that
  131. * even though this works extremely well in practice, it's technically not guaranteed
  132. * and false negatives is theoretically possible, but there can never be any false positives.
  133. */
  134. void checkasm_stack_clobber(uint64_t clobber, ...);
  135. #define declare_new(ret, ...) ret (*checked_call)(void *, int, int, int, int, int, __VA_ARGS__)\
  136. = (void *)checkasm_checked_call;
  137. #define declare_new_float(ret, ...) ret (*checked_call)(void *, int, int, int, int, int, __VA_ARGS__)\
  138. = (void *)checkasm_checked_call_float;
  139. #define declare_new_emms(cpu_flags, ret, ...) \
  140. ret (*checked_call)(void *, int, int, int, int, int, __VA_ARGS__) = \
  141. ((cpu_flags) & av_get_cpu_flags()) ? (void *)checkasm_checked_call_emms : \
  142. (void *)checkasm_checked_call;
  143. #define CLOB (UINT64_C(0xdeadbeefdeadbeef))
  144. #define call_new(...) (checkasm_stack_clobber(CLOB,CLOB,CLOB,CLOB,CLOB,CLOB,CLOB,CLOB,CLOB,CLOB,CLOB,\
  145. CLOB,CLOB,CLOB,CLOB,CLOB,CLOB,CLOB,CLOB,CLOB,CLOB),\
  146. checked_call(func_new, 0, 0, 0, 0, 0, __VA_ARGS__))
  147. #elif ARCH_X86_32
  148. #define declare_new(ret, ...) ret (*checked_call)(void *, __VA_ARGS__) = (void *)checkasm_checked_call;
  149. #define declare_new_float(ret, ...) ret (*checked_call)(void *, __VA_ARGS__) = (void *)checkasm_checked_call_float;
  150. #define declare_new_emms(cpu_flags, ret, ...) ret (*checked_call)(void *, __VA_ARGS__) = \
  151. ((cpu_flags) & av_get_cpu_flags()) ? (void *)checkasm_checked_call_emms : \
  152. (void *)checkasm_checked_call;
  153. #define call_new(...) checked_call(func_new, __VA_ARGS__)
  154. #endif
  155. #elif ARCH_ARM && HAVE_ARMV5TE_EXTERNAL
  156. /* Use a dummy argument, to offset the real parameters by 2, not only 1.
  157. * This makes sure that potential 8-byte-alignment of parameters is kept the same
  158. * even when the extra parameters have been removed. */
  159. void checkasm_checked_call_vfp(void *func, int dummy, ...);
  160. void checkasm_checked_call_novfp(void *func, int dummy, ...);
  161. extern void (*checkasm_checked_call)(void *func, int dummy, ...);
  162. #define declare_new(ret, ...) ret (*checked_call)(void *, int dummy, __VA_ARGS__, \
  163. int, int, int, int, int, int, int, int, \
  164. int, int, int, int, int, int, int) = (void *)checkasm_checked_call;
  165. #define call_new(...) checked_call(func_new, 0, __VA_ARGS__, 11, 10, 9, 8, 7, 6, 5, 4, 3, 2, 1, 0, 0, 0, 0)
  166. #elif ARCH_AARCH64 && !defined(__APPLE__)
  167. void checkasm_stack_clobber(uint64_t clobber, ...);
  168. void checkasm_checked_call(void *func, ...);
  169. #define declare_new(ret, ...) ret (*checked_call)(void *, int, int, int, int, int, int, int, __VA_ARGS__,\
  170. int, int, int, int, int, int, int, int,\
  171. int, int, int, int, int, int, int)\
  172. = (void *)checkasm_checked_call;
  173. #define CLOB (UINT64_C(0xdeadbeefdeadbeef))
  174. #define call_new(...) (checkasm_stack_clobber(CLOB,CLOB,CLOB,CLOB,CLOB,CLOB,CLOB,CLOB,CLOB,CLOB,CLOB,CLOB,\
  175. CLOB,CLOB,CLOB,CLOB,CLOB,CLOB,CLOB,CLOB,CLOB,CLOB,CLOB),\
  176. checked_call(func_new, 0, 0, 0, 0, 0, 0, 0, __VA_ARGS__,\
  177. 7, 6, 5, 4, 3, 2, 1, 0, 0, 0, 0, 0, 0, 0, 0))
  178. #else
  179. #define declare_new(ret, ...)
  180. #define declare_new_float(ret, ...)
  181. #define declare_new_emms(cpu_flags, ret, ...)
  182. /* Call the function */
  183. #define call_new(...) ((func_type *)func_new)(__VA_ARGS__)
  184. #endif
  185. #ifndef declare_new_emms
  186. #define declare_new_emms(cpu_flags, ret, ...) declare_new(ret, __VA_ARGS__)
  187. #endif
  188. #ifndef declare_new_float
  189. #define declare_new_float(ret, ...) declare_new(ret, __VA_ARGS__)
  190. #endif
  191. typedef struct CheckasmPerf {
  192. int sysfd;
  193. uint64_t cycles;
  194. int iterations;
  195. } CheckasmPerf;
  196. #if defined(AV_READ_TIME) || CONFIG_LINUX_PERF
  197. #if CONFIG_LINUX_PERF
  198. #define PERF_START(t) do { \
  199. ioctl(sysfd, PERF_EVENT_IOC_RESET, 0); \
  200. ioctl(sysfd, PERF_EVENT_IOC_ENABLE, 0); \
  201. } while (0)
  202. #define PERF_STOP(t) do { \
  203. ioctl(sysfd, PERF_EVENT_IOC_DISABLE, 0); \
  204. read(sysfd, &t, sizeof(t)); \
  205. } while (0)
  206. #else
  207. #define PERF_START(t) t = AV_READ_TIME()
  208. #define PERF_STOP(t) t = AV_READ_TIME() - t
  209. #endif
  210. /* Benchmark the function */
  211. #define bench_new(...)\
  212. do {\
  213. if (checkasm_bench_func()) {\
  214. struct CheckasmPerf *perf = checkasm_get_perf_context();\
  215. av_unused const int sysfd = perf->sysfd;\
  216. func_type *tfunc = func_new;\
  217. uint64_t tsum = 0;\
  218. int ti, tcount = 0;\
  219. uint64_t t = 0; \
  220. for (ti = 0; ti < BENCH_RUNS; ti++) {\
  221. PERF_START(t);\
  222. tfunc(__VA_ARGS__);\
  223. tfunc(__VA_ARGS__);\
  224. tfunc(__VA_ARGS__);\
  225. tfunc(__VA_ARGS__);\
  226. PERF_STOP(t);\
  227. if (t*tcount <= tsum*4 && ti > 0) {\
  228. tsum += t;\
  229. tcount++;\
  230. }\
  231. }\
  232. emms_c();\
  233. perf->cycles += t;\
  234. perf->iterations++;\
  235. }\
  236. } while (0)
  237. #else
  238. #define bench_new(...) while(0)
  239. #define PERF_START(t) while(0)
  240. #define PERF_STOP(t) while(0)
  241. #endif
  242. #define DECL_CHECKASM_CHECK_FUNC(type) \
  243. int checkasm_check_##type(const char *const file, const int line, \
  244. const type *const buf1, const ptrdiff_t stride1, \
  245. const type *const buf2, const ptrdiff_t stride2, \
  246. const int w, const int h, const char *const name)
  247. DECL_CHECKASM_CHECK_FUNC(uint8_t);
  248. DECL_CHECKASM_CHECK_FUNC(uint16_t);
  249. DECL_CHECKASM_CHECK_FUNC(int16_t);
  250. DECL_CHECKASM_CHECK_FUNC(int32_t);
  251. #define PASTE(a,b) a ## b
  252. #define CONCAT(a,b) PASTE(a,b)
  253. #define checkasm_check(prefix, ...) CONCAT(checkasm_check_, prefix)(__FILE__, __LINE__, __VA_ARGS__)
  254. #endif /* TESTS_CHECKASM_CHECKASM_H */