d/numam-dpdk
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

doc: extend installation section for SNOW3G/KASUMI

Browse Source 
SNOW3G and KASUMI SW libraries encrypt buffers
assuming that they are padded to a specific block size.
This behaviour can be changed to avoid buffer overflow,
by modifying the Makefile of these libraries.
Therefore, the Installation section in the SNOW3G and
KASUMI documentation has been extended, to document
this case.

Signed-off-by: Pablo de Lara <pablo.de.lara.guarch@intel.com>
Acked-by: Declan Doherty <declan.doherty@intel.com>
This commit is contained in:
Pablo de Lara 2017-07-13 06:36:50 +01:00
parent 2142e6dc71
commit 4792d3ea85
2 changed files with 23 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

12
doc/guides/cryptodevs/kasumi.rst
View File

@ -70,6 +70,18 @@ on their system before building DPDK::
make
**Note**: When encrypting with KASUMI F8, by default the library
encrypts full blocks of 8 bytes, regardless the number of bytes to
be encrypted provided (which leads to a possible buffer overflow).
To avoid this situation, it is necessary not to pass
3GPP_SAFE_BUFFERS as a compilation flag.
Also, this is required when using chained operations
(cipher-then-auth/auth-then-cipher).
For this, in the Makefile of the library, make sure that this flag
is commented out::
#EXTRA_CFLAGS += -D_3GPP_SAFE_BUFFERS
**Note**: To build the PMD as a shared library, the libsso_kasumi
library must be built as follows::

11
doc/guides/cryptodevs/snow3g.rst
View File

@ -69,6 +69,17 @@ on their system before building DPDK::
make snow3G
**Note**: When encrypting with SNOW3G UEA2, by default the library
encrypts blocks of 4 bytes, regardless the number of bytes to
be encrypted provided (which leads to a possible buffer overflow).
To avoid this situation, it is necessary not to pass
3GPP_SAFE_BUFFERS as a compilation flag.
For this, in the Makefile of the library, make sure that this flag
is commented out.::
#EXTRA_CFLAGS += -D_3GPP_SAFE_BUFFERS
Initialization
--------------