mirror of
https://github.com/amd/blis.git
synced 2026-05-05 06:51:11 +00:00
31c8657f1d
Details: - Added support for being able to duplicate (broadcast) elements in memory when packing matrix B (ie: the left-hand operand) in level-3 operations. This turns out advantageous for some architectures that can afford the cost of the extra bandwidth and somehow benefit from the pre-broadcast elements (and thus being able to avoid using broadcast-style load instructions on micro-rows of B in the gemm microkernel). - Support optionally disabling right-side hemm and symm. If this occurs, hemm_r is implemented in terms of hemm_l (and symm_r in terms of symm_l). This is needed when broadcasting during packing because the alternative--supporting the broadcast of B while also allowing matrix B to be Hermitian/symmetric--would be an absolute mess. - Support alignment factors for packed blocks of A, B, and C separately (as well as for general-purpose buffers). In addition, we support byte offsets from those alignment values (which is different from aligning by align+offset bytes to begin with). The default alignment values are BLIS_PAGE_SIZE in all four cases, with the offset values defaulting to zero. - Pass pack_t schema into bli_?packm_cxk() so that it can be then passed into the packm kernel, where it will be needed by packm kernels that perform broadcasts of B, since the idea is that we *only* want to broadcast when packing micropanels of B and not A. - Added definition for variadic bli_cntx_set_l3_vir_ukrs(), which can be used to set custom virtual level-3 microkernels in the cntx_t, which would typically be done in the bli_cntx_init_*() function defined in the subconfiguration of interest. - Added a "broadcast B" kernel function for use with NP/NR = 12/6, defined in in ref_kernels/1m/bli_packm_cxk_bb_ref.c. - Added a gemm, gemmtrsm, and trsm "broadcast B" reference kernels defined in ref_kernels/3/bb. (These kernels have been tested with double real with NP/NR = 12/6.) - Added #ifndef ... #endif guards around several macro constants defined in frame/include/bli_kernel_macro_defs.h. - Defined a few "broadcast B" static functions in frame/include/level0/bb for use by "broadcast B"-style packm reference kernels. For now, only the real domain kernels are tested and fully defined. - Output the alignment and offset values for packed blocks of A and B in the testsuite's "BLIS configuration info" section. - Comment updates to various files. - Bumped so_version to 3.0.0.
223 lines
7.3 KiB
C
223 lines
7.3 KiB
C
/*
|
|
|
|
BLIS
|
|
An object-based framework for developing high-performance BLAS-like
|
|
libraries.
|
|
|
|
Copyright (C) 2014, The University of Texas at Austin
|
|
|
|
Redistribution and use in source and binary forms, with or without
|
|
modification, are permitted provided that the following conditions are
|
|
met:
|
|
- Redistributions of source code must retain the above copyright
|
|
notice, this list of conditions and the following disclaimer.
|
|
- Redistributions in binary form must reproduce the above copyright
|
|
notice, this list of conditions and the following disclaimer in the
|
|
documentation and/or other materials provided with the distribution.
|
|
- Neither the name(s) of the copyright holder(s) nor the names of its
|
|
contributors may be used to endorse or promote products derived
|
|
from this software without specific prior written permission.
|
|
|
|
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
|
|
"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
|
|
LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
|
|
A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
|
|
HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
|
|
SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
|
|
LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
|
|
DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
|
|
THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
|
|
(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
|
|
OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
|
|
|
*/
|
|
|
|
#ifndef BLIS_KERNEL_MACRO_DEFS_H
|
|
#define BLIS_KERNEL_MACRO_DEFS_H
|
|
|
|
|
|
// -- Define default threading parameters --------------------------------------
|
|
|
|
#ifndef BLIS_THREAD_RATIO_M
|
|
#define BLIS_THREAD_RATIO_M 2
|
|
#endif
|
|
|
|
#ifndef BLIS_THREAD_RATIO_N
|
|
#define BLIS_THREAD_RATIO_N 1
|
|
#endif
|
|
|
|
#ifndef BLIS_THREAD_MAX_IR
|
|
#define BLIS_THREAD_MAX_IR 1
|
|
#endif
|
|
|
|
#ifndef BLIS_THREAD_MAX_JR
|
|
#define BLIS_THREAD_MAX_JR 4
|
|
#endif
|
|
|
|
|
|
// -- Memory allocation --------------------------------------------------------
|
|
|
|
// hbwmalloc.h provides hbw_malloc() and hbw_free() on systems with
|
|
// libmemkind. But disable use of libmemkind if BLIS_DISABLE_MEMKIND
|
|
// was explicitly defined.
|
|
#ifdef BLIS_DISABLE_MEMKIND
|
|
#undef BLIS_ENABLE_MEMKIND
|
|
#endif
|
|
#ifdef BLIS_ENABLE_MEMKIND
|
|
#include <hbwmalloc.h>
|
|
#endif
|
|
|
|
// Memory allocation functions. These macros define the three types of
|
|
// malloc()-style functions, and their free() counterparts: one for each
|
|
// type of memory to be allocated.
|
|
// NOTE: ANY ALTERNATIVE TO malloc()/free() USED FOR ANY OF THE FOLLOWING
|
|
// THREE PAIRS OF MACROS MUST USE THE SAME FUNCTION PROTOTYPE AS malloc()
|
|
// and free():
|
|
//
|
|
// void* malloc( size_t size );
|
|
// void free( void* p );
|
|
//
|
|
|
|
// This allocation function is called to allocate memory for blocks within
|
|
// BLIS's internal memory pools.
|
|
#ifndef BLIS_MALLOC_POOL
|
|
// If use of libmemkind was enabled at configure-time, the default
|
|
// memory allocation function for memory pools should be hbw_malloc()
|
|
// instead of malloc().
|
|
#ifdef BLIS_ENABLE_MEMKIND
|
|
#define BLIS_MALLOC_POOL hbw_malloc
|
|
#else
|
|
#define BLIS_MALLOC_POOL malloc
|
|
#endif
|
|
#endif
|
|
|
|
#ifndef BLIS_FREE_POOL
|
|
// If use of libmemkind was enabled at configure-time, the default
|
|
// memory deallocation function for memory pools should be hbw_free()
|
|
// instead of free().
|
|
#ifdef BLIS_ENABLE_MEMKIND
|
|
#define BLIS_FREE_POOL hbw_free
|
|
#else
|
|
#define BLIS_FREE_POOL free
|
|
#endif
|
|
#endif
|
|
|
|
// This allocation function is called to allocate memory for internally-
|
|
// used objects and structures, such as control tree nodes.
|
|
#ifndef BLIS_MALLOC_INTL
|
|
#define BLIS_MALLOC_INTL malloc
|
|
#endif
|
|
|
|
#ifndef BLIS_FREE_INTL
|
|
#define BLIS_FREE_INTL free
|
|
#endif
|
|
|
|
// This allocation function is called to allocate memory for objects
|
|
// created by user-level API functions, such as bli_obj_create().
|
|
#ifndef BLIS_MALLOC_USER
|
|
#define BLIS_MALLOC_USER malloc
|
|
#endif
|
|
|
|
#ifndef BLIS_FREE_USER
|
|
#define BLIS_FREE_USER free
|
|
#endif
|
|
|
|
// -- Other system-related definitions -----------------------------------------
|
|
|
|
// Size of a virtual memory page. This is used to align blocks within the
|
|
// memory pools.
|
|
#ifndef BLIS_PAGE_SIZE
|
|
#define BLIS_PAGE_SIZE 4096
|
|
#endif
|
|
|
|
// The maximum number of named SIMD vector registers available for use.
|
|
// When configuring with umbrella configuration families, this should be
|
|
// set to the maximum number of registers across all sub-configurations in
|
|
// the family.
|
|
#ifndef BLIS_SIMD_NUM_REGISTERS
|
|
#define BLIS_SIMD_NUM_REGISTERS 32
|
|
#endif
|
|
|
|
// The maximum size (in bytes) of each SIMD vector.
|
|
// When configuring with umbrella configuration families, this should be
|
|
// set to the maximum SIMD size across all sub-configurations in the family.
|
|
#ifndef BLIS_SIMD_SIZE
|
|
#define BLIS_SIMD_SIZE 64
|
|
#endif
|
|
|
|
// Alignment size (in bytes) needed by the instruction set for aligned
|
|
// SIMD/vector instructions.
|
|
#ifndef BLIS_SIMD_ALIGN_SIZE
|
|
#define BLIS_SIMD_ALIGN_SIZE BLIS_SIMD_SIZE
|
|
#endif
|
|
|
|
// The maximum size in bytes of local stack buffers within macro-kernel
|
|
// functions. These buffers are usually used to store a temporary copy
|
|
// of a single microtile. The reason we multiply by 2 is to handle induced
|
|
// methods, where we use real domain register blocksizes in units of
|
|
// complex elements. Specifically, the macro-kernels will need this larger
|
|
// micro-tile footprint, even though the virtual micro-kernels will only
|
|
// ever be writing to half (real or imaginary part) at a time.
|
|
#ifndef BLIS_STACK_BUF_MAX_SIZE
|
|
#define BLIS_STACK_BUF_MAX_SIZE ( BLIS_SIMD_NUM_REGISTERS * \
|
|
BLIS_SIMD_SIZE * 2 )
|
|
#endif
|
|
|
|
// Alignment size used to align local stack buffers within macro-kernel
|
|
// functions.
|
|
#ifndef BLIS_STACK_BUF_ALIGN_SIZE
|
|
#define BLIS_STACK_BUF_ALIGN_SIZE BLIS_SIMD_ALIGN_SIZE
|
|
#endif
|
|
|
|
// Alignment size used when allocating memory via BLIS_MALLOC_USER.
|
|
// To disable heap alignment, set this to 1.
|
|
#ifndef BLIS_HEAP_ADDR_ALIGN_SIZE
|
|
#define BLIS_HEAP_ADDR_ALIGN_SIZE BLIS_SIMD_ALIGN_SIZE
|
|
#endif
|
|
|
|
// Alignment size used when sizing leading dimensions of memory allocated
|
|
// via BLIS_MALLOC_USER.
|
|
#ifndef BLIS_HEAP_STRIDE_ALIGN_SIZE
|
|
#define BLIS_HEAP_STRIDE_ALIGN_SIZE BLIS_SIMD_ALIGN_SIZE
|
|
#endif
|
|
|
|
// Alignment sizes used when allocating blocks to the internal memory
|
|
// pool, via BLIS_MALLOC_POOL.
|
|
#ifndef BLIS_POOL_ADDR_ALIGN_SIZE_A
|
|
#define BLIS_POOL_ADDR_ALIGN_SIZE_A BLIS_PAGE_SIZE
|
|
#endif
|
|
|
|
#ifndef BLIS_POOL_ADDR_ALIGN_SIZE_B
|
|
#define BLIS_POOL_ADDR_ALIGN_SIZE_B BLIS_PAGE_SIZE
|
|
#endif
|
|
|
|
#ifndef BLIS_POOL_ADDR_ALIGN_SIZE_C
|
|
#define BLIS_POOL_ADDR_ALIGN_SIZE_C BLIS_PAGE_SIZE
|
|
#endif
|
|
|
|
#ifndef BLIS_POOL_ADDR_ALIGN_SIZE_GEN
|
|
#define BLIS_POOL_ADDR_ALIGN_SIZE_GEN BLIS_PAGE_SIZE
|
|
#endif
|
|
|
|
// Offsets from alignment specified by BLIS_POOL_ADDR_ALIGN_SIZE_*.
|
|
#ifndef BLIS_POOL_ADDR_OFFSET_SIZE_A
|
|
#define BLIS_POOL_ADDR_OFFSET_SIZE_A 0
|
|
#endif
|
|
|
|
#ifndef BLIS_POOL_ADDR_OFFSET_SIZE_B
|
|
#define BLIS_POOL_ADDR_OFFSET_SIZE_B 0
|
|
#endif
|
|
|
|
#ifndef BLIS_POOL_ADDR_OFFSET_SIZE_C
|
|
#define BLIS_POOL_ADDR_OFFSET_SIZE_C 0
|
|
#endif
|
|
|
|
#ifndef BLIS_POOL_ADDR_OFFSET_SIZE_GEN
|
|
#define BLIS_POOL_ADDR_OFFSET_SIZE_GEN 0
|
|
#endif
|
|
|
|
|
|
|
|
#endif
|
|
|