mirror of
https://github.com/amd/blis.git
synced 2026-05-11 17:50:00 +00:00
a4abb10831
Details:
- Added a new sandbox called 'gemmlike', which implements sequential and
multithreaded gemm in the style of gemmsup but also unconditionally
employs packing. The purpose of this sandbox is to
(1) avoid select abstractions, such as objects and control trees, in
order to allow readers to better understand how a real-world
implementation of high-performance gemm can be constructed;
(2) provide a starting point for expert users who wish to build
something that is gemm-like without "reinventing the wheel."
Thanks to Jeff Diamond, Tze Meng Low, Nicholai Tukanov, and Devangi
Parikh for requesting and inspiring this work.
- The functions defined in this sandbox currently use the "bls_" prefix
instead of "bli_" in order to avoid any symbol collisions in the main
library.
- The sandbox contains two variants, each of which implements gemm via a
block-panel algorithm. The only difference between the two is that
variant 1 calls the microkernel directly while variant 2 calls the
microkernel indirectly, via a function wrapper, which allows the edge
case handling to be abstracted away from the classic five loops.
- This sandbox implementation utilizes the conventional gemm microkernel
(not the skinny/unpacked gemmsup kernels).
- Updated some typos in the comments of a few files in the main
framework.
Change-Id: Ifc3c50e9fd0072aada38eace50c57552c88cc6cf
228 lines
5.2 KiB
C
228 lines
5.2 KiB
C
/*
|
|
|
|
BLIS
|
|
An object-based framework for developing high-performance BLAS-like
|
|
libraries.
|
|
|
|
Copyright (C) 2014, The University of Texas at Austin
|
|
Copyright (C) 2016, Hewlett Packard Enterprise Development LP
|
|
Copyright (C) 2018 - 2020, Advanced Micro Devices, Inc.
|
|
|
|
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_H
|
|
#define BLIS_H
|
|
|
|
|
|
// Allow C++ users to include this header file in their source code. However,
|
|
// we make the extern "C" conditional on whether we're using a C++ compiler,
|
|
// since regular C compilers don't understand the extern "C" construct.
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
// NOTE: PLEASE DON'T CHANGE THE ORDER IN WHICH HEADERS ARE INCLUDED UNLESS
|
|
// YOU ARE SURE THAT IT DOESN'T BREAK INTER-HEADER MACRO DEPENDENCIES.
|
|
|
|
// -- System headers --
|
|
// NOTE: This header must be included before bli_config_macro_defs.h.
|
|
|
|
#include "bli_system.h"
|
|
|
|
|
|
// -- configure definitions --
|
|
|
|
#include "bli_config.h"
|
|
#include "bli_config_macro_defs.h"
|
|
|
|
|
|
// -- Common BLIS definitions --
|
|
|
|
#include "bli_type_defs.h"
|
|
#include "bli_macro_defs.h"
|
|
|
|
|
|
// -- pragma definitions --
|
|
|
|
#include "bli_pragma_macro_defs.h"
|
|
|
|
|
|
// -- Threading definitions --
|
|
|
|
#include "bli_thread.h"
|
|
#include "bli_pthread.h"
|
|
|
|
|
|
// -- Constant definitions --
|
|
|
|
#include "bli_extern_defs.h"
|
|
|
|
|
|
// -- BLIS architecture/kernel definitions --
|
|
|
|
#include "bli_l1v_ker_prot.h"
|
|
#include "bli_l1f_ker_prot.h"
|
|
#include "bli_l1m_ker_prot.h"
|
|
#include "bli_l2_ker_prot.h"
|
|
#include "bli_l3_ukr_prot.h"
|
|
#include "bli_l3_sup_ker_prot.h"
|
|
|
|
#include "bli_arch_config_pre.h"
|
|
#include "bli_arch_config.h"
|
|
|
|
#include "bli_kernel_macro_defs.h"
|
|
|
|
|
|
// -- Base operation prototypes --
|
|
|
|
#include "bli_init.h"
|
|
#include "bli_const.h"
|
|
#include "bli_obj.h"
|
|
#include "bli_obj_scalar.h"
|
|
#include "bli_blksz.h"
|
|
#include "bli_func.h"
|
|
#include "bli_mbool.h"
|
|
#include "bli_cntx.h"
|
|
#include "bli_rntm.h"
|
|
#include "bli_gks.h"
|
|
#include "bli_ind.h"
|
|
#include "bli_membrk.h"
|
|
#include "bli_pool.h"
|
|
#include "bli_array.h"
|
|
#include "bli_apool.h"
|
|
#include "bli_sba.h"
|
|
#include "bli_memsys.h"
|
|
#include "bli_mem.h"
|
|
#include "bli_part.h"
|
|
#include "bli_prune.h"
|
|
#include "bli_query.h"
|
|
#include "bli_auxinfo.h"
|
|
#include "bli_param_map.h"
|
|
#include "bli_clock.h"
|
|
#include "bli_check.h"
|
|
#include "bli_error.h"
|
|
#include "bli_f2c.h"
|
|
#include "bli_machval.h"
|
|
#include "bli_getopt.h"
|
|
#include "bli_opid.h"
|
|
#include "bli_cntl.h"
|
|
#include "bli_env.h"
|
|
#include "bli_pack.h"
|
|
#include "bli_info.h"
|
|
#include "bli_arch.h"
|
|
#include "bli_cpuid.h"
|
|
#include "bli_string.h"
|
|
#include "bli_setgetij.h"
|
|
#include "bli_setri.h"
|
|
|
|
#include "bli_castm.h"
|
|
#include "bli_castnzm.h"
|
|
#include "bli_castv.h"
|
|
#include "bli_projm.h"
|
|
#include "bli_projv.h"
|
|
|
|
|
|
// -- Level-0 operations --
|
|
|
|
#include "bli_l0.h"
|
|
|
|
|
|
// -- Level-1v operations --
|
|
|
|
#include "bli_l1v.h"
|
|
|
|
|
|
// -- Level-1d operations --
|
|
|
|
#include "bli_l1d.h"
|
|
|
|
|
|
// -- Level-1f operations --
|
|
|
|
#include "bli_l1f.h"
|
|
|
|
|
|
// -- Level-1m operations --
|
|
|
|
#include "bli_l1m.h"
|
|
|
|
|
|
// -- Level-2 operations --
|
|
|
|
#include "bli_l2.h"
|
|
|
|
|
|
// -- Level-3 operations --
|
|
|
|
#include "bli_l3.h"
|
|
|
|
|
|
// -- Utility operations --
|
|
|
|
#include "bli_util.h"
|
|
|
|
|
|
// -- addon definitions --
|
|
|
|
// NOTE: These definitions should not be included much earlier since an addon
|
|
// may wish to utilize other types and definitions provided by BLIS.
|
|
// TODO: Disable addon header file inclusion for windows since configure
|
|
// script is not executed, and subsequently the header file ie not generated.
|
|
#if !defined(_WIN32) && !defined(__CYGWIN__)
|
|
#include "bli_addon.h"
|
|
#endif
|
|
|
|
|
|
// -- sandbox implementation --
|
|
|
|
#include "bli_sbox.h"
|
|
|
|
|
|
// -- BLAS compatibility layer --
|
|
|
|
#include "bli_blas.h"
|
|
|
|
|
|
// -- CBLAS compatibility layer --
|
|
|
|
#include "bli_cblas.h"
|
|
|
|
// -- Windows definitions
|
|
|
|
#include "bli_winsys.h"
|
|
|
|
#include "aocldtl.h"
|
|
#include "aocldtl_blis.h"
|
|
|
|
// End extern "C" construct block.
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
#endif
|
|
|