Vector Optimized Library of Kernels  2.0
Architecture-tuned implementations of math kernels
volk.tmpl.h
Go to the documentation of this file.
1 /*
2  * Copyright 2011-2012 Free Software Foundation, Inc.
3  *
4  * This file is part of GNU Radio
5  *
6  * GNU Radio is free software; you can redistribute it and/or modify
7  * it under the terms of the GNU General Public License as published by
8  * the Free Software Foundation; either version 3, or (at your option)
9  * any later version.
10  *
11  * GNU Radio is distributed in the hope that it will be useful,
12  * but WITHOUT ANY WARRANTY; without even the implied warranty of
13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14  * GNU General Public License for more details.
15  *
16  * You should have received a copy of the GNU General Public License
17  * along with GNU Radio; see the file COPYING. If not, write to
18  * the Free Software Foundation, Inc., 51 Franklin Street,
19  * Boston, MA 02110-1301, USA.
20  */
21 
22 #ifndef INCLUDED_VOLK_RUNTIME
23 #define INCLUDED_VOLK_RUNTIME
24 
25 #include <volk/volk_typedefs.h>
26 #include <volk/volk_config_fixed.h>
27 #include <volk/volk_common.h>
28 #include <volk/volk_complex.h>
29 #include <volk/volk_malloc.h>
30 
31 #include <stdlib.h>
32 #include <stdbool.h>
33 
35 
36 typedef struct volk_func_desc
37 {
38  const char **impl_names;
39  const int *impl_deps;
40  const bool *impl_alignment;
41  size_t n_impls;
43 
45 VOLK_API void volk_list_machines(void);
46 
48 VOLK_API const char* volk_get_machine(void);
49 
51 VOLK_API size_t volk_get_alignment(void);
52 
59 #define VOLK_OR_PTR(ptr0, ptr1) \
60  (const void *)(((intptr_t)(ptr0)) | ((intptr_t)(ptr1)))
61 
72 VOLK_API bool volk_is_aligned(const void *ptr);
73 
74 
75 %for kern in kernels:
76 
78 extern VOLK_API ${kern.pname} ${kern.name};
79 
81 extern VOLK_API ${kern.pname} ${kern.name}_a;
82 
84 extern VOLK_API ${kern.pname} ${kern.name}_u;
85 
87 extern VOLK_API void ${kern.name}_manual(${kern.arglist_full}, const char* impl_name);
88 
90 extern VOLK_API volk_func_desc_t ${kern.name}_get_func_desc(void);
91 %endfor
92 
94 
95 #endif /*INCLUDED_VOLK_RUNTIME*/
VOLK_API const char * volk_get_machine(void)
Returns the name of the machine this instance will use.
Definition: volk.tmpl.c:77
VOLK_API
A function pointer to the fastest aligned implementation.
Definition: volk.tmpl.h:84
VOLK_API void volk_list_machines(void)
Prints a list of machines available.
Definition: volk.tmpl.c:63
size_t n_impls
Definition: volk.tmpl.h:41
#define __VOLK_DECL_BEGIN
Definition: volk_common.h:60
#define __VOLK_DECL_END
Definition: volk_common.h:61
const bool * impl_alignment
Definition: volk.tmpl.h:40
const char ** impl_names
Definition: volk.tmpl.h:38
const int * impl_deps
Definition: volk.tmpl.h:39
__VOLK_DECL_BEGIN struct volk_func_desc volk_func_desc_t
Get description parameters for this kernel.
Definition: volk.tmpl.h:90
VOLK_API size_t volk_get_alignment(void)
Get the machine alignment in bytes.
Definition: volk.tmpl.c:102
VOLK_API bool volk_is_aligned(const void *ptr)
Definition: volk.tmpl.c:108
<% this_machine=machine_dict[args[0]] %><% arch_names=this_machine.arch_names %> for arch in this_machine<% this_machine_name="\"+this_machine.name+"\" %> for kern in<% make_impl_name_list="{"+', '.join(['"%s"'%i.name for i in impls])+"}" %><% make_impl_deps_list="{"+', '.join(['|'.join(['(1<< LV_%s)'%d.upper() for d in i.deps]) for i in impls])+"}" %><% make_impl_align_list="{"+', '.join([ 'true' if i.is_aligned else 'false' for i in impls])+"}" %><% make_impl_fcn_list="{"+', '.join(['%s_%s'%(kern.name, i.name) for i in impls])+"}" %><% len_impls=len(impls) %> endfor
Definition: volk_machine_xxx.tmpl.c:59
for kern in kernels
Definition: volk.tmpl.h:78
Definition: volk.tmpl.h:36