summaryrefslogtreecommitdiffstats
path: root/src/isa-l/README.md
diff options
context:
space:
mode:
authorDaniel Baumann <daniel.baumann@progress-linux.org>2024-04-21 11:54:28 +0000
committerDaniel Baumann <daniel.baumann@progress-linux.org>2024-04-21 11:54:28 +0000
commite6918187568dbd01842d8d1d2c808ce16a894239 (patch)
tree64f88b554b444a49f656b6c656111a145cbbaa28 /src/isa-l/README.md
parentInitial commit. (diff)
downloadceph-b26c4052f3542036551aa9dec9caa4226e456195.tar.xz
ceph-b26c4052f3542036551aa9dec9caa4226e456195.zip
Adding upstream version 18.2.2.upstream/18.2.2
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to 'src/isa-l/README.md')
-rw-r--r--src/isa-l/README.md74
1 files changed, 74 insertions, 0 deletions
diff --git a/src/isa-l/README.md b/src/isa-l/README.md
new file mode 100644
index 000000000..091fee2bd
--- /dev/null
+++ b/src/isa-l/README.md
@@ -0,0 +1,74 @@
+Intel(R) Intelligent Storage Acceleration Library
+=================================================
+
+[![Build Status](https://travis-ci.org/intel/isa-l.svg?branch=master)](https://travis-ci.org/intel/isa-l)
+[![Package on conda-forge](https://img.shields.io/conda/v/conda-forge/isa-l.svg)](https://anaconda.org/conda-forge/isa-l)
+
+ISA-L is a collection of optimized low-level functions targeting storage
+applications. ISA-L includes:
+* Erasure codes - Fast block Reed-Solomon type erasure codes for any
+ encode/decode matrix in GF(2^8).
+* CRC - Fast implementations of cyclic redundancy check. Six different
+ polynomials supported.
+ - iscsi32, ieee32, t10dif, ecma64, iso64, jones64.
+* Raid - calculate and operate on XOR and P+Q parity found in common RAID
+ implementations.
+* Compression - Fast deflate-compatible data compression.
+* De-compression - Fast inflate-compatible data compression.
+
+Also see:
+* [ISA-L for updates](https://github.com/intel/isa-l).
+* For crypto functions see [isa-l_crypto on github](https://github.com/intel/isa-l_crypto).
+* The [github wiki](https://github.com/intel/isa-l/wiki) including a list of
+ [distros/ports](https://github.com/intel/isa-l/wiki/Ports--Repos) offering binary packages.
+* ISA-L [mailing list](https://lists.01.org/hyperkitty/list/isal@lists.01.org/).
+* [Contributing](CONTRIBUTING.md).
+
+Building ISA-L
+--------------
+
+### Prerequisites
+
+* Make: GNU 'make' or 'nmake' (Windows).
+* Optional: Building with autotools requires autoconf/automake packages.
+
+x86_64:
+* Assembler: nasm v2.11.01 or later (nasm v2.13 or better suggested for building in AVX512 support)
+ or yasm version 1.2.0 or later.
+* Compiler: gcc, clang, icc or VC compiler.
+
+aarch64:
+* Assembler: gas v2.24 or later.
+* Compiler: gcc v4.7 or later.
+
+other:
+* Compiler: Portable base functions are available that build with most C compilers.
+
+### Autotools
+To build and install the library with autotools it is usually sufficient to run:
+
+ ./autogen.sh
+ ./configure
+ make
+ sudo make install
+
+### Makefile
+To use a standard makefile run:
+
+ make -f Makefile.unx
+
+### Windows
+On Windows use nmake to build dll and static lib:
+
+ nmake -f Makefile.nmake
+
+or see [details on setting up environment here](doc/build.md).
+
+### Other make targets
+Other targets include:
+* `make check` : create and run tests
+* `make tests` : create additional unit tests
+* `make perfs` : create included performance tests
+* `make ex` : build examples
+* `make other` : build other utilities such as compression file tests
+* `make doc` : build API manual