2 * Assembly testing and benchmarking tool
3 * Copyright (c) 2015 Henrik Gramner
4 * Copyright (c) 2008 Loren Merritt
6 * This file is part of Libav.
8 * Libav 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.
13 * Libav 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.
18 * You should have received a copy of the GNU General Public License along
19 * with Libav; if not, write to the Free Software Foundation, Inc.,
20 * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
28 #include "libavutil/common.h"
29 #include "libavutil/cpu.h"
30 #include "libavutil/random_seed.h"
33 #include "libavutil/x86/cpu.h"
36 #if HAVE_SETCONSOLETEXTATTRIBUTE
38 #define COLOR_RED FOREGROUND_RED
39 #define COLOR_GREEN FOREGROUND_GREEN
40 #define COLOR_YELLOW (FOREGROUND_RED|FOREGROUND_GREEN)
44 #define COLOR_YELLOW 3
55 /* List of tests to invoke */
56 static void (* const tests[])(void) = {
58 checkasm_check_bswapdsp,
61 checkasm_check_h264pred,
64 checkasm_check_h264qpel,
69 /* List of cpu flags to check */
76 { "MMX", "mmx", AV_CPU_FLAG_MMX|AV_CPU_FLAG_CMOV },
77 { "MMXEXT", "mmxext", AV_CPU_FLAG_MMXEXT },
78 { "3DNOW", "3dnow", AV_CPU_FLAG_3DNOW },
79 { "3DNOWEXT", "3dnowext", AV_CPU_FLAG_3DNOWEXT },
80 { "SSE", "sse", AV_CPU_FLAG_SSE },
81 { "SSE2", "sse2", AV_CPU_FLAG_SSE2|AV_CPU_FLAG_SSE2SLOW },
82 { "SSE3", "sse3", AV_CPU_FLAG_SSE3|AV_CPU_FLAG_SSE3SLOW },
83 { "SSSE3", "ssse3", AV_CPU_FLAG_SSSE3|AV_CPU_FLAG_ATOM },
84 { "SSE4.1", "sse4", AV_CPU_FLAG_SSE4 },
85 { "SSE4.2", "sse42", AV_CPU_FLAG_SSE42 },
86 { "AVX", "avx", AV_CPU_FLAG_AVX },
87 { "XOP", "xop", AV_CPU_FLAG_XOP },
88 { "FMA3", "fma3", AV_CPU_FLAG_FMA3 },
89 { "FMA4", "fma4", AV_CPU_FLAG_FMA4 },
90 { "AVX2", "avx2", AV_CPU_FLAG_AVX2 },
95 typedef struct CheckasmFuncVersion {
96 struct CheckasmFuncVersion *next;
102 } CheckasmFuncVersion;
104 /* Binary search tree node */
105 typedef struct CheckasmFunc {
106 struct CheckasmFunc *child[2];
107 CheckasmFuncVersion versions;
114 CheckasmFunc *current_func;
115 CheckasmFuncVersion *current_func_ver;
116 const char *bench_pattern;
117 int bench_pattern_len;
122 const char *cpu_flag_name;
128 /* Print colored text to stderr if the terminal supports it */
129 static void color_printf(int color, const char *fmt, ...)
131 static int use_color = -1;
134 #if HAVE_SETCONSOLETEXTATTRIBUTE
136 static WORD org_attributes;
139 CONSOLE_SCREEN_BUFFER_INFO con_info;
140 con = GetStdHandle(STD_ERROR_HANDLE);
141 if (con && con != INVALID_HANDLE_VALUE && GetConsoleScreenBufferInfo(con, &con_info)) {
142 org_attributes = con_info.wAttributes;
148 SetConsoleTextAttribute(con, (org_attributes & 0xfff0) | (color & 0x0f));
151 const char *term = getenv("TERM");
152 use_color = term && strcmp(term, "dumb") && isatty(2);
155 fprintf(stderr, "\x1b[%d;3%dm", (color & 0x08) >> 3, color & 0x07);
159 vfprintf(stderr, fmt, arg);
163 #if HAVE_SETCONSOLETEXTATTRIBUTE
164 SetConsoleTextAttribute(con, org_attributes);
166 fprintf(stderr, "\x1b[0m");
171 /* Deallocate a tree */
172 static void destroy_func_tree(CheckasmFunc *f)
175 CheckasmFuncVersion *v = f->versions.next;
177 CheckasmFuncVersion *next = v->next;
182 destroy_func_tree(f->child[0]);
183 destroy_func_tree(f->child[1]);
188 /* Allocate a zero-initialized block, clean up and exit on failure */
189 static void *checkasm_malloc(size_t size)
191 void *ptr = calloc(1, size);
193 fprintf(stderr, "checkasm: malloc failed\n");
194 destroy_func_tree(state.funcs);
200 /* Get the suffix of the specified cpu flag */
201 static const char *cpu_suffix(int cpu)
203 int i = FF_ARRAY_ELEMS(cpus);
206 if (cpu & cpus[i].flag)
207 return cpus[i].suffix;
213 static int cmp_nop(const void *a, const void *b)
215 return *(const uint16_t*)a - *(const uint16_t*)b;
218 /* Measure the overhead of the timing code (in decicycles) */
219 static int measure_nop_time(void)
221 uint16_t nops[10000];
224 for (i = 0; i < 10000; i++) {
225 uint64_t t = AV_READ_TIME();
226 nops[i] = AV_READ_TIME() - t;
229 qsort(nops, 10000, sizeof(uint16_t), cmp_nop);
230 for (i = 2500; i < 7500; i++)
233 return nop_sum / 500;
236 /* Print benchmark results */
237 static void print_benchs(CheckasmFunc *f)
240 print_benchs(f->child[0]);
242 /* Only print functions with at least one assembly version */
243 if (f->versions.cpu || f->versions.next) {
244 CheckasmFuncVersion *v = &f->versions;
247 int decicycles = (10*v->cycles/v->iterations - state.nop_time) / 4;
248 printf("%s_%s: %d.%d\n", f->name, cpu_suffix(v->cpu), decicycles/10, decicycles%10);
250 } while ((v = v->next));
253 print_benchs(f->child[1]);
258 /* ASCIIbetical sort except preserving natural order for numbers */
259 static int cmp_func_names(const char *a, const char *b)
261 int ascii_diff, digit_diff;
263 for (; !(ascii_diff = *a - *b) && *a; a++, b++);
264 for (; av_isdigit(*a) && av_isdigit(*b); a++, b++);
266 return (digit_diff = av_isdigit(*a) - av_isdigit(*b)) ? digit_diff : ascii_diff;
269 /* Get a node with the specified name, creating it if it doesn't exist */
270 static CheckasmFunc *get_func(const char *name, int length)
272 CheckasmFunc *f, **f_ptr = &state.funcs;
274 /* Search the tree for a matching node */
275 while ((f = *f_ptr)) {
276 int cmp = cmp_func_names(name, f->name);
280 f_ptr = &f->child[(cmp > 0)];
283 /* Allocate and insert a new node into the tree */
284 f = *f_ptr = checkasm_malloc(sizeof(CheckasmFunc) + length);
285 memcpy(f->name, name, length+1);
290 /* Perform tests and benchmarks for the specified cpu flag if supported by the host */
291 static void check_cpu_flag(const char *name, int flag)
293 int old_cpu_flag = state.cpu_flag;
295 flag |= old_cpu_flag;
296 av_set_cpu_flags_mask(flag);
297 state.cpu_flag = av_get_cpu_flags();
299 if (!flag || state.cpu_flag != old_cpu_flag) {
302 state.cpu_flag_name = name;
303 for (i = 0; tests[i]; i++)
308 /* Print the name of the current CPU flag, but only do it once */
309 static void print_cpu_name(void)
311 if (state.cpu_flag_name) {
312 color_printf(COLOR_YELLOW, "%s:\n", state.cpu_flag_name);
313 state.cpu_flag_name = NULL;
317 int main(int argc, char *argv[])
319 int i, seed, ret = 0;
321 if (!tests[0] || !cpus[0].flag) {
322 fprintf(stderr, "checkasm: no tests to perform\n");
326 if (argc > 1 && !strncmp(argv[1], "--bench", 7)) {
328 fprintf(stderr, "checkasm: --bench is not supported on your system\n");
331 if (argv[1][7] == '=') {
332 state.bench_pattern = argv[1] + 8;
333 state.bench_pattern_len = strlen(state.bench_pattern);
335 state.bench_pattern = "";
341 seed = (argc > 1) ? atoi(argv[1]) : av_get_random_seed();
342 fprintf(stderr, "checkasm: using random seed %u\n", seed);
343 av_lfg_init(&checkasm_lfg, seed);
345 check_cpu_flag(NULL, 0);
346 for (i = 0; cpus[i].flag; i++)
347 check_cpu_flag(cpus[i].name, cpus[i].flag);
349 if (state.num_failed) {
350 fprintf(stderr, "checkasm: %d of %d tests have failed\n", state.num_failed, state.num_checked);
353 fprintf(stderr, "checkasm: all %d tests passed\n", state.num_checked);
355 if (state.bench_pattern) {
356 state.nop_time = measure_nop_time();
357 printf("nop: %d.%d\n", state.nop_time/10, state.nop_time%10);
358 print_benchs(state.funcs);
363 destroy_func_tree(state.funcs);
367 /* Decide whether or not the specified function needs to be tested and
368 * allocate/initialize data structures if needed. Returns a pointer to a
369 * reference function if the function should be tested, otherwise NULL */
370 intptr_t (*checkasm_check_func(intptr_t (*func)(), const char *name, ...))()
373 intptr_t (*ref)() = func;
374 CheckasmFuncVersion *v;
379 name_length = vsnprintf(name_buf, sizeof(name_buf), name, arg);
382 if (!func || name_length <= 0 || name_length >= sizeof(name_buf))
385 state.current_func = get_func(name_buf, name_length);
386 v = &state.current_func->versions;
389 CheckasmFuncVersion *prev;
391 /* Only test functions that haven't already been tested */
399 } while ((v = v->next));
401 v = prev->next = checkasm_malloc(sizeof(CheckasmFuncVersion));
406 v->cpu = state.cpu_flag;
407 state.current_func_ver = v;
415 /* Decide whether or not the current function needs to be benchmarked */
416 int checkasm_bench_func(void)
418 return !state.num_failed && state.bench_pattern &&
419 !strncmp(state.current_func->name, state.bench_pattern, state.bench_pattern_len);
422 /* Indicate that the current test has failed */
423 void checkasm_fail_func(const char *msg, ...)
425 if (state.current_func_ver->cpu && state.current_func_ver->ok) {
429 fprintf(stderr, " %s_%s (", state.current_func->name, cpu_suffix(state.current_func_ver->cpu));
431 vfprintf(stderr, msg, arg);
433 fprintf(stderr, ")\n");
435 state.current_func_ver->ok = 0;
440 /* Update benchmark results of the current function */
441 void checkasm_update_bench(int iterations, uint64_t cycles)
443 state.current_func_ver->iterations += iterations;
444 state.current_func_ver->cycles += cycles;
447 /* Print the outcome of all tests performed since the last time this function was called */
448 void checkasm_report(const char *name, ...)
450 static int prev_checked, prev_failed, max_length;
452 if (state.num_checked > prev_checked) {
456 int pad_length = max_length;
459 fprintf(stderr, " - ");
461 pad_length -= vfprintf(stderr, name, arg);
463 fprintf(stderr, "%*c", FFMAX(pad_length, 0) + 2, '[');
465 fprintf(stderr, " - %-*s [", max_length, state.current_func->name);
467 if (state.num_failed == prev_failed)
468 color_printf(COLOR_GREEN, "OK");
470 color_printf(COLOR_RED, "FAILED");
471 fprintf(stderr, "]\n");
473 prev_checked = state.num_checked;
474 prev_failed = state.num_failed;
475 } else if (!state.cpu_flag) {
478 /* Calculate the amount of padding required to make the output vertically aligned */
482 length = vsnprintf(NULL, 0, name, arg);
485 length = strlen(state.current_func->name);
487 if (length > max_length)