2019-06-25 11:12:58 +00:00
|
|
|
.. SPDX-License-Identifier: BSD-3-Clause
|
|
|
|
|
Copyright(c) 2018 Intel Corporation.
|
|
|
|
|
|
|
|
|
|
Intel(R) QuickAssist (QAT) Compression Poll Mode Driver
|
|
|
|
|
=======================================================
|
|
|
|
|
|
|
|
|
|
The QAT compression PMD provides poll mode compression & decompression driver
|
|
|
|
|
support for the following hardware accelerator devices:
|
|
|
|
|
|
|
|
|
|
* ``Intel QuickAssist Technology C62x``
|
|
|
|
|
* ``Intel QuickAssist Technology C3xxx``
|
2020-06-18 16:55:50 +00:00
|
|
|
* ``Intel QuickAssist Technology DH895x``
|
2019-06-25 11:12:58 +00:00
|
|
|
|
|
|
|
|
|
|
|
|
|
Features
|
|
|
|
|
--------
|
|
|
|
|
|
|
|
|
|
QAT compression PMD has support for:
|
|
|
|
|
|
|
|
|
|
Compression/Decompression algorithm:
|
|
|
|
|
|
|
|
|
|
* DEFLATE - using Fixed and Dynamic Huffman encoding
|
|
|
|
|
|
|
|
|
|
Window size support:
|
|
|
|
|
|
|
|
|
|
* 32K
|
|
|
|
|
|
|
|
|
|
Checksum generation:
|
|
|
|
|
|
|
|
|
|
* CRC32, Adler and combined checksum
|
|
|
|
|
|
2020-06-18 16:55:50 +00:00
|
|
|
Stateful operation:
|
|
|
|
|
|
|
|
|
|
* Decompression only
|
|
|
|
|
|
2019-06-25 11:12:58 +00:00
|
|
|
Limitations
|
|
|
|
|
-----------
|
|
|
|
|
|
|
|
|
|
* Compressdev level 0, no compression, is not supported.
|
|
|
|
|
* Queue pairs are not thread-safe (that is, within a single queue pair, RX and TX from different lcores is not supported).
|
|
|
|
|
* No BSD support as BSD QAT kernel driver not available.
|
2020-06-18 16:55:50 +00:00
|
|
|
* When using Deflate dynamic huffman encoding for compression, the input size (op.src.length)
|
|
|
|
|
must be < CONFIG_RTE_PMD_QAT_COMP_IM_BUFFER_SIZE from the config file,
|
|
|
|
|
see :ref:`building_qat_config` for more details.
|
|
|
|
|
* Stateful compression is not supported.
|
2019-06-25 11:12:58 +00:00
|
|
|
|
|
|
|
|
|
|
|
|
|
Installation
|
|
|
|
|
------------
|
|
|
|
|
|
|
|
|
|
The QAT compression PMD is built by default with a standard DPDK build.
|
|
|
|
|
|
|
|
|
|
It depends on a QAT kernel driver, see :ref:`building_qat`.
|
