summaryrefslogtreecommitdiffstats
path: root/src/isa-l/README.md
diff options
context:
space:
mode:
authorDaniel Baumann <daniel.baumann@progress-linux.org>2024-04-07 18:45:59 +0000
committerDaniel Baumann <daniel.baumann@progress-linux.org>2024-04-07 18:45:59 +0000
commit19fcec84d8d7d21e796c7624e521b60d28ee21ed (patch)
tree42d26aa27d1e3f7c0b8bd3fd14e7d7082f5008dc /src/isa-l/README.md
parentInitial commit. (diff)
downloadceph-upstream/16.2.11+ds.tar.xz
ceph-upstream/16.2.11+ds.zip
Adding upstream version 16.2.11+ds.upstream/16.2.11+dsupstream
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.md71
1 files changed, 71 insertions, 0 deletions
diff --git a/src/isa-l/README.md b/src/isa-l/README.md
new file mode 100644
index 000000000..b8fd220e4
--- /dev/null
+++ b/src/isa-l/README.md
@@ -0,0 +1,71 @@
+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)
+
+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
+
+### 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