doc: add inline crypto feature
authorRadu Nicolau <radu.nicolau@intel.com>
Thu, 9 Nov 2017 12:29:42 +0000 (12:29 +0000)
committerThomas Monjalon <thomas@monjalon.net>
Sun, 12 Nov 2017 04:02:42 +0000 (05:02 +0100)
Signed-off-by: Radu Nicolau <radu.nicolau@intel.com>
doc/guides/nics/features.rst
doc/guides/nics/features/default.ini
doc/guides/nics/features/ixgbe.ini
doc/guides/nics/features/ixgbe_vec.ini
doc/guides/nics/features/ixgbe_vf.ini
doc/guides/nics/features/ixgbe_vf_vec.ini
doc/guides/nics/ixgbe.rst

index d9917d4..d5bf38a 100644 (file)
@@ -506,6 +506,23 @@ Supports adding traffic mirroring rules.
 * **[related]    API**: ``rte_eth_mirror_rule_set()``, ``rte_eth_mirror_rule_reset()``.
 
 
+.. _nic_features_inline_crypto_doc:
+
+Inline crypto
+-------------
+
+Supports inline crypto processing (eg. inline IPsec). See Security library and PMD documentation for more details.
+
+* **[uses]       rte_eth_rxconf,rte_eth_rxmode**: ``offloads:DEV_RX_OFFLOAD_SECURITY``,
+* **[uses]       rte_eth_txconf,rte_eth_txmode**: ``offloads:DEV_TX_OFFLOAD_SECURITY``.
+* **[implements] rte_security_ops**: ``session_create``, ``session_update``,
+  ``session_stats_get``, ``session_destroy``, ``set_pkt_metadata``, ``capabilities_get``.
+* **[provides] rte_eth_dev_info**: ``rx_offload_capa,rx_queue_offload_capa:DEV_RX_OFFLOAD_SECURITY``,
+  ``tx_offload_capa,tx_queue_offload_capa:DEV_TX_OFFLOAD_SECURITY``.
+* **[provides]   mbuf**: ``mbuf.ol_flags:PKT_RX_SEC_OFFLOAD``,
+  ``mbuf.ol_flags:PKT_TX_SEC_OFFLOAD``, ``mbuf.ol_flags:PKT_RX_SEC_OFFLOAD_FAILED``.
+
+
 .. _nic_features_crc_offload:
 
 CRC offload
index 95c5698..dae2ad7 100644 (file)
@@ -44,6 +44,7 @@ Flow control         =
 Flow API             =
 Rate limitation      =
 Traffic mirroring    =
+Inline crypto        =
 CRC offload          =
 VLAN offload         =
 QinQ offload         =
index 9ff5d8f..1d68ee8 100644 (file)
@@ -33,6 +33,7 @@ Flow control         = Y
 Flow API             = Y
 Rate limitation      = Y
 Traffic mirroring    = Y
+Inline crypto        = Y
 CRC offload          = Y
 VLAN offload         = Y
 QinQ offload         = Y
index 4d56df4..28bc054 100644 (file)
@@ -32,6 +32,7 @@ Flow director        = Y
 Flow control         = Y
 Rate limitation      = Y
 Traffic mirroring    = Y
+Inline crypto        = Y
 Timesync             = Y
 Rx descriptor status = Y
 Tx descriptor status = Y
index b63e32c..0a15500 100644 (file)
@@ -17,6 +17,7 @@ RSS hash             = Y
 RSS key update       = Y
 RSS reta update      = Y
 VLAN filter          = Y
+Inline crypto        = Y
 CRC offload          = Y
 VLAN offload         = Y
 QinQ offload         = Y
index c994857..80e7f3b 100644 (file)
@@ -17,6 +17,7 @@ RSS hash             = Y
 RSS key update       = Y
 RSS reta update      = Y
 VLAN filter          = Y
+Inline crypto        = Y
 Rx descriptor status = Y
 Tx descriptor status = Y
 Basic stats          = Y
index c687c63..d477ea0 100644 (file)
@@ -239,6 +239,22 @@ There is no RTE API to add a VF's MAC address from the PF. On ixgbe, the
 as a workaround.
 
 
+Inline crypto processing support
+--------------------------------
+
+Inline IPsec processing is supported for ``RTE_SECURITY_ACTION_TYPE_INLINE_CRYPTO``
+mode for ESP packets only:
+
+- ESP authentication only: AES-128-GMAC (128-bit key)
+- ESP encryption and authentication: AES-128-GCM (128-bit key)
+
+IPsec Security Gateway Sample Application supports inline IPsec processing for
+ixgbe PMD.
+
+For more details see the IPsec Security Gateway Sample Application and Security
+library documentation.
+
+
 Supported Chipsets and NICs
 ---------------------------