From patchwork Wed Jun 22 10:35:12 2022 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Rebecca Troy X-Patchwork-Id: 113232 X-Patchwork-Delegate: gakhil@marvell.com Return-Path: X-Original-To: patchwork@inbox.dpdk.org Delivered-To: patchwork@inbox.dpdk.org Received: from mails.dpdk.org (mails.dpdk.org [217.70.189.124]) by inbox.dpdk.org (Postfix) with ESMTP id E5CD5A04FD; Wed, 22 Jun 2022 12:35:22 +0200 (CEST) Received: from [217.70.189.124] (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id C86D94069C; Wed, 22 Jun 2022 12:35:22 +0200 (CEST) Received: from mga05.intel.com (mga05.intel.com [192.55.52.43]) by mails.dpdk.org (Postfix) with ESMTP id 0480E40689 for ; Wed, 22 Jun 2022 12:35:20 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=intel.com; i=@intel.com; q=dns/txt; s=Intel; t=1655894121; x=1687430121; h=from:to:cc:subject:date:message-id:mime-version: content-transfer-encoding; bh=5aNZx0VitHJbmhwegoGYWuig/zZ3pHv5yu3TZvWADOc=; b=lTNBzezJqhMfOHRHgAvCs47Z6fh3XjGPGLmbeoJpOIz4kMJHKWuvIgw8 r7o3qORe2m197eevV2l/gLcuZnNk50Zp9pNUP6TPq94QqqD/PPID/mT/x /DQWmPUOQ/3MtByCRB1xBoayAzacfXIi1ryVAH/cFoEjj9eTFPfGCp4i2 n27/i1kg7acrYmRqPeeOui//0VFZt2XySft/E5wjeulq/PHejetqQAWQE ws7qtodHBZg0Id01ZZf9PfbwGXmOIpyEIY6tEUYEFpLWqFxZ/yNfpB8FN 1pYmQwk/LhyiO01ZFP8z8IjdSJI/CfSuirHwANcnsleZ/Q6jKoDNYXshT A==; X-IronPort-AV: E=McAfee;i="6400,9594,10385"; a="366704580" X-IronPort-AV: E=Sophos;i="5.92,212,1650956400"; d="scan'208";a="366704580" Received: from fmsmga003.fm.intel.com ([10.253.24.29]) by fmsmga105.fm.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 22 Jun 2022 03:35:19 -0700 X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.92,212,1650956400"; d="scan'208";a="677471229" Received: from silpixa00401279.ir.intel.com (HELO silpixa00401279.ger.corp.intel.com.) ([10.237.222.131]) by FMSMGA003.fm.intel.com with ESMTP; 22 Jun 2022 03:35:16 -0700 From: Rebecca Troy To: Fan Zhang Cc: dev@dpdk.org, Rebecca Troy Subject: [PATCH] doc/qat: update QAT driver location Date: Wed, 22 Jun 2022 10:35:12 +0000 Message-Id: <20220622103512.424926-1-rebecca.troy@intel.com> X-Mailer: git-send-email 2.34.1 MIME-Version: 1.0 Organisation: Intel Research and Development Ireland Ltd - Dromore House, East Park, Shannon, Co. Clare X-BeenThere: dev@dpdk.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: DPDK patches and discussions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: dev-bounces@dpdk.org This commit removes any references to the old QAT driver location 01.org in the documentation and replaces them with the updated location intel.com. This commit also adds a note to the docs to alert users of a possible error when building the new QAT driver and provides the patch needed to resolve this error. Signed-off-by: Rebecca Troy Acked-by: Fan Zhang Acked-by: Fan Zhang --- doc/guides/cryptodevs/qat.rst | 108 ++++++++++++++++++++++------------ 1 file changed, 71 insertions(+), 37 deletions(-) diff --git a/doc/guides/cryptodevs/qat.rst b/doc/guides/cryptodevs/qat.rst index 613603eed1..fa664070bc 100644 --- a/doc/guides/cryptodevs/qat.rst +++ b/doc/guides/cryptodevs/qat.rst @@ -369,35 +369,35 @@ to see the full table) .. table:: QAT device generations, devices and drivers - +-----+-----+-----+-----+----------+---------------+---------------+------------+--------+------+--------+--------+ - | S | A | C | Gen | Device | Driver/ver | Kernel Module | Pci Driver | PF Did | #PFs | VF Did | VFs/PF | - +=====+=====+=====+=====+==========+===============+===============+============+========+======+========+========+ - | Yes | No | No | 1 | DH895xCC | linux/4.4+ | qat_dh895xcc | dh895xcc | 435 | 1 | 443 | 32 | - +-----+-----+-----+-----+----------+---------------+---------------+------------+--------+------+--------+--------+ - | Yes | Yes | No | " | " | 01.org/4.2.0+ | " | " | " | " | " | " | - +-----+-----+-----+-----+----------+---------------+---------------+------------+--------+------+--------+--------+ - | Yes | Yes | Yes | " | " | 01.org/4.3.0+ | " | " | " | " | " | " | - +-----+-----+-----+-----+----------+---------------+---------------+------------+--------+------+--------+--------+ - | Yes | No | No | 2 | C62x | linux/4.5+ | qat_c62x | c6xx | 37c8 | 3 | 37c9 | 16 | - +-----+-----+-----+-----+----------+---------------+---------------+------------+--------+------+--------+--------+ - | Yes | Yes | Yes | " | " | 01.org/4.2.0+ | " | " | " | " | " | " | - +-----+-----+-----+-----+----------+---------------+---------------+------------+--------+------+--------+--------+ - | Yes | No | No | 2 | C3xxx | linux/4.5+ | qat_c3xxx | c3xxx | 19e2 | 1 | 19e3 | 16 | - +-----+-----+-----+-----+----------+---------------+---------------+------------+--------+------+--------+--------+ - | Yes | Yes | Yes | " | " | 01.org/4.2.0+ | " | " | " | " | " | " | - +-----+-----+-----+-----+----------+---------------+---------------+------------+--------+------+--------+--------+ - | Yes | No | No | 2 | 200xx | p | qat_200xx | 200xx | 18ee | 1 | 18ef | 16 | - +-----+-----+-----+-----+----------+---------------+---------------+------------+--------+------+--------+--------+ - | Yes | No | No | 2 | D15xx | 01.org/4.2.0+ | qat_d15xx | d15xx | 6f54 | 1 | 6f55 | 16 | - +-----+-----+-----+-----+----------+---------------+---------------+------------+--------+------+--------+--------+ - | Yes | No | No | 3 | C4xxx | p | qat_c4xxx | c4xxx | 18a0 | 1 | 18a1 | 128 | - +-----+-----+-----+-----+----------+---------------+---------------+------------+--------+------+--------+--------+ - | Yes | No | No | 4 | 4xxx | N/A | qat_4xxx | 4xxx | 4940 | 4 | 4941 | 16 | - +-----+-----+-----+-----+----------+---------------+---------------+------------+--------+------+--------+--------+ - | Yes | No | No | 4 | 401xxx | N/A | qat_401xxx | 4xxx | 4942 | 2 | 4943 | 16 | - +-----+-----+-----+-----+----------+---------------+---------------+------------+--------+------+--------+--------+ - -* Note: Symmetric mixed crypto algorithms feature on Gen 2 works only with 01.org driver version 4.9.0+ + +-----+-----+-----+-----+----------+-------------------+---------------+------------+--------+------+--------+--------+ + | S | A | C | Gen | Device | Driver/ver | Kernel Module | Pci Driver | PF Did | #PFs | VF Did | VFs/PF | + +=====+=====+=====+=====+==========+===================+===============+============+========+======+========+========+ + | Yes | No | No | 1 | DH895xCC | linux/4.4+ | qat_dh895xcc | dh895xcc | 435 | 1 | 443 | 32 | + +-----+-----+-----+-----+----------+-------------------+---------------+------------+--------+------+--------+--------+ + | Yes | Yes | No | " | " | intel.com/4.12.0+ | " | " | " | " | " | " | + +-----+-----+-----+-----+----------+-------------------+---------------+------------+--------+------+--------+--------+ + | Yes | Yes | Yes | " | " | intel.com/4.13.0+ | " | " | " | " | " | " | + +-----+-----+-----+-----+----------+-------------------+---------------+------------+--------+------+--------+--------+ + | Yes | No | No | 2 | C62x | linux/4.5+ | qat_c62x | c6xx | 37c8 | 3 | 37c9 | 16 | + +-----+-----+-----+-----+----------+-------------------+---------------+------------+--------+------+--------+--------+ + | Yes | Yes | Yes | " | " | intel.com/4.12.0+ | " | " | " | " | " | " | + +-----+-----+-----+-----+----------+-------------------+---------------+------------+--------+------+--------+--------+ + | Yes | No | No | 2 | C3xxx | linux/4.5+ | qat_c3xxx | c3xxx | 19e2 | 1 | 19e3 | 16 | + +-----+-----+-----+-----+----------+-------------------+---------------+------------+--------+------+--------+--------+ + | Yes | Yes | Yes | " | " | intel.com/4.12.0+ | " | " | " | " | " | " | + +-----+-----+-----+-----+----------+-------------------+---------------+------------+--------+------+--------+--------+ + | Yes | No | No | 2 | 200xx | p | qat_200xx | 200xx | 18ee | 1 | 18ef | 16 | + +-----+-----+-----+-----+----------+-------------------+---------------+------------+--------+------+--------+--------+ + | Yes | No | No | 2 | D15xx | p | qat_d15xx | d15xx | 6f54 | 1 | 6f55 | 16 | + +-----+-----+-----+-----+----------+-------------------+---------------+------------+--------+------+--------+--------+ + | Yes | No | No | 3 | C4xxx | p | qat_c4xxx | c4xxx | 18a0 | 1 | 18a1 | 128 | + +-----+-----+-----+-----+----------+-------------------+---------------+------------+--------+------+--------+--------+ + | Yes | No | No | 4 | 4xxx | N/A | qat_4xxx | 4xxx | 4940 | 4 | 4941 | 16 | + +-----+-----+-----+-----+----------+-------------------+---------------+------------+--------+------+--------+--------+ + | Yes | No | No | 4 | 401xxx | N/A | qat_401xxx | 4xxx | 4942 | 2 | 4943 | 16 | + +-----+-----+-----+-----+----------+-------------------+---------------+------------+--------+------+--------+--------+ + +* Note: Symmetric mixed crypto algorithms feature on Gen 2 works only with intel.com driver version 4.9.0+ The first 3 columns indicate the service: @@ -406,13 +406,13 @@ The first 3 columns indicate the service: * C = Compression service (via compressdev API) The ``Driver`` column indicates either the Linux kernel version in which -support for this device was introduced or a driver available on Intel's 01.org -website. There are both linux in-tree and 01.org kernel drivers available for some +support for this device was introduced or a driver available on Intel's website +intel.com. There are both linux in-tree and intel.com kernel drivers available for some devices. p = release pending. If you are running on a kernel which includes a driver for your device, see `Installation using kernel.org driver`_ below. Otherwise see -`Installation using 01.org QAT driver`_. +`Installation using intel.com QAT driver`_. Installation using kernel.org driver @@ -485,12 +485,12 @@ To complete the installation follow the instructions in ``IOMMU should be enabled for SR-IOV to work correctly``. -Installation using 01.org QAT driver -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +Installation using intel.com QAT driver +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -Download the latest QuickAssist Technology Driver from `01.org -`_. -Consult the *Getting Started Guide* at the same URL for further information. +Download the latest QuickAssist Technology Driver from `intel.com +`_. +Consult the *Quick Start Guide* at the same URL for further information. The steps below assume you are: @@ -579,6 +579,40 @@ To complete the installation - follow instructions in sudo yum install kernel-src-`uname -r` sudo yum install kernel-devel-`uname -r` +.. Note:: + + If the build fails on newer GCC versions (such as GCC 12) with an error relating to + ``-lc`` not being found, apply the following patch: + + .. code-block:: diff + + /QAT/quickassist/lookaside/access_layer/src/Makefile + cd $(ICP_FINAL_OUTPUT_DIR);\ + cmd="$(LINKER) $(LIB_SHARED_FLAGS) -o \ + $(LIB_SHARED) $(ADDITIONAL_OBJECTS) $(ADDITIONAL_LIBS) *.o -lpthread -ludev \ + - -Bstatic -L$(ADF_DIR)/src/build/$(ICP_OS)/$(ICP_OS_LEVEL) \ + - -ladf_user -L$(OSAL_DIR)/src/build/$(ICP_OS)/$(ICP_OS_LEVEL)/ \ + - -losal -Bdynamic -lc"; \ + + -Bstatic -L$(ADF_DIR)/src/build/$(ICP_OS)/$(ICP_OS_LEVEL) \ + + -ladf_user -L$(OSAL_DIR)/src/build/$(ICP_OS)/$(ICP_OS_LEVEL)/ \ + + -losal -Bdynamic -L/lib/x86_64-linux-gnu/ -lc"; \ + echo "$$cmd"; \ + $$cmd + + Followed by this patch: + + .. code-block:: diff + + /QAT/quickassist/build_system/build_files/OS/linux_common_user_space_rules.mk + @echo 'Creating shared library ${LIB_SHARED}'; \ + cd $($(PROG_ACY)_FINAL_OUTPUT_DIR);\ + - echo $(LINKER) $(LIB_SHARED_FLAGS) -o $@ $(OBJECTS) $(ADDITIONAL_OBJECTS) -lc;\ + - $(LINKER) $(LIB_SHARED_FLAGS) -o $@ $(OBJECTS) $(ADDITIONAL_OBJECTS) -lc ; + + echo $(LINKER) $(LIB_SHARED_FLAGS) -o $@ $(OBJECTS) $(ADDITIONAL_OBJECTS) \ + + -L/lib/x86_64-linux-gnu/ -lc;\ + + $(LINKER) $(LIB_SHARED_FLAGS) -o $@ $(OBJECTS) $(ADDITIONAL_OBJECTS) \ + + -L/lib/x86_64-linux-gnu/ -lc ; + Binding the available VFs to the vfio-pci driver ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~