]> git.proxmox.com Git - ceph.git/blame - ceph/src/isa-l/README.md
update sources to v12.1.1
[ceph.git] / ceph / src / isa-l / README.md
CommitLineData
7c673cae
FG
1Intel(R) Intelligent Storage Acceleration Library
2=================================================
3
4[![Build Status](https://travis-ci.org/01org/isa-l.svg?branch=master)](https://travis-ci.org/01org/isa-l)
5
224ce89b
WB
6ISA-L is a collection of optimized low-level functions targeting storage
7applications. ISA-L includes:
8* Erasure codes - Fast block Reed-Solomon type erasure codes for any
9 encode/decode matrix in GF(2^8).
10* CRC - Fast implementations of cyclic redundancy check. Six different
11 polynomials supported.
12 - iscsi32, ieee32, t10dif, ecma64, iso64, jones64.
13* Raid - calculate and operate on XOR and P+Q parity found in common RAID
14 implementations.
15* Compression - Fast deflate-compatible data compression.
16* De-compression - Fast inflate-compatible data compression.
17
18Also see:
19* [ISA-L for updates](https://github.com/01org/isa-l).
20* For crypto functions see [isa-l_crypto on github](https://github.com/01org/isa-l_crypto).
21* The [github wiki](https://github.com/01org/isa-l/wiki).
22* ISA-L [mailing list](https://lists.01.org/mailman/listinfo/isal).
23* [Contributing](CONTRIBUTING.md).
7c673cae
FG
24
25Building ISA-L
224ce89b
WB
26--------------
27
28### Prerequisites
7c673cae 29
224ce89b
WB
30* yasm version 1.2.0 or later or nasm v2.11.01 or later.
31* gcc, clang, icc or VC compiler.
32* GNU 'make' or 'nmake' (Windows).
33* Building with autotools requires autoconf/automake packages.
7c673cae 34
224ce89b
WB
35### Autotools
36To build and install the library with autotools it is usually sufficient to run:
7c673cae
FG
37
38 ./autogen.sh
39 ./configure
40 make
41 sudo make install
42
224ce89b
WB
43### Makefile
44To use a standard makefile run:
7c673cae 45
224ce89b 46 make -f Makefile.unx
7c673cae 47
224ce89b 48### Windows
7c673cae
FG
49On Windows use nmake to build dll and static lib:
50
51 nmake -f Makefile.nmake
52
224ce89b
WB
53### Other make targets
54Other targets include:
55* `make check` : create and run tests
56* `make tests` : create additional unit tests
57* `make perfs` : create included performance tests
58* `make ex` : build examples
59* `make other` : build other utilities such as compression file tests