Intel(R) Integrated Performance Primitives Cryptography 2021.7

Author: ipl_ci

.clang-format

@@ -1,18 +1,19 @@
 
 #===============================================================================
-# Copyright 2022 Intel Corporation
+# Copyright (C) 2022 Intel Corporation
 #
-# Licensed under the Apache License, Version 2.0 (the "License");
+# Licensed under the Apache License, Version 2.0 (the 'License');
 # you may not use this file except in compliance with the License.
 # You may obtain a copy of the License at
-#
-#     http://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS,
+# 
+# http://www.apache.org/licenses/LICENSE-2.0
+# 
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an 'AS IS' BASIS,
 # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-# See the License for the specific language governing permissions and
-# limitations under the License.
+# See the License for the specific language governing permissions
+# and limitations under the License.
+# 
 #===============================================================================
 
 BasedOnStyle: WebKit

BUILD.md

@@ -149,7 +149,7 @@ To build the Intel IPP Cryptography library on Windows* OS, complete the followi
 
 The software was validated on:
 
-- macOS\* 11.0
+- macOS\* 12.0
 
 To build the Intel IPP Cryptography library on macOS*, complete the following steps:
 

CHANGELOG.md

@@ -2,6 +2,13 @@
 
 This is a list of notable changes to Intel(R) IPP Cryptography, in reverse chronological order.
 
+## Intel(R) IPP Cryptography 2021.7
+- Mitigation for Frequency Throttling Side-Channel Attack ([Frequency Throttling Side Channel Software Guidance for Cryptography Implementations](https://www.intel.com/content/www/us/en/developer/articles/technical/software-security-guidance/technical-documentation/frequency-throttling-side-channel-guidance.html)) was added for ECB, CMAC and GCM modes of AES (for more details refer to ippsAESSetupNoise, ippsAES_GCMSetupNoise and ippsAES_CMACSetupNoise).
+- Crypto Multi-buffer library was extended with CCM and GCM modes of SM4 algorithm.
+- In Crypto Multi-buffer library in-place mode of executing (when pa_out == pa_inp) was fixed for SM4 CBC and CFB modes.
+- New API that updates pointer to IppsHashMethod context inside the IppsHashState_rmf state was added (please, refer to ippsHashStateMethodSet_ API).
+- ippsHMAC_Pack(_rmf), ippsHMAC_Unpack(_rmf) APIs were fixed - context id is set up properly now during the packing-unpacking process.
+
 ## Intel(R) IPP Cryptography 2021.6
 - EC cryptography functionality for the NIST curves p256r1, p384r1, p521r1 and SM2 curve was enabled with Intel® Advanced Vector Extensions 512 (Intel® AVX-512) IFMA instructions.
 - EC cryptography functionality input parameters checking was improved by adding keys boundaries check.

CMakeLists.txt

@@ -1,17 +1,18 @@
 #===============================================================================
-# Copyright 2017 Intel Corporation
+# Copyright (C) 2017 Intel Corporation
 #
-# Licensed under the Apache License, Version 2.0 (the "License");
+# Licensed under the Apache License, Version 2.0 (the 'License');
 # you may not use this file except in compliance with the License.
 # You may obtain a copy of the License at
-#
-#     http://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS,
+# 
+# http://www.apache.org/licenses/LICENSE-2.0
+# 
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an 'AS IS' BASIS,
 # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-# See the License for the specific language governing permissions and
-# limitations under the License.
+# See the License for the specific language governing permissions
+# and limitations under the License.
+# 
 #===============================================================================
 
 #
@@ -182,6 +183,38 @@ else()
   message (STATUS "BUILD_EXAMPLES ........................ off")
 endif()
 
+# Build with sanitizers
+set(SANITIZERS OFF)
+if(BUILD_WITH_SANITIZERS AND UNIX AND ${CMAKE_CXX_COMPILER_ID} STREQUAL "Clang" AND ${CMAKE_CXX_COMPILER_VERSION} VERSION_GREATER_EQUAL "12.0.0")
+  set(ASAN OFF)
+  set(UBSAN OFF)
+  set(MSAN OFF)
+  if("${BUILD_WITH_SANITIZERS}" MATCHES "address")
+    set(ASAN ON)
+    list(APPEND PRINT_TYPES_OF_SANITIZERS_LIST "address")
+  endif()
+  if("${BUILD_WITH_SANITIZERS}" MATCHES "undefined")
+    set(UBSAN ON)
+    list(APPEND PRINT_TYPES_OF_SANITIZERS_LIST "undefined")
+  endif()
+  if("${BUILD_WITH_SANITIZERS}" MATCHES "memory")
+    set(MSAN ON)
+    list(APPEND PRINT_TYPES_OF_SANITIZERS_LIST "memory")
+  endif()
+  if((ASAN OR UBSAN) AND MSAN)
+    message (FATAL_ERROR "Can not use address | undefined sanitizers with memory sanitizer")
+  endif()
+  if(ASAN OR UBSAN OR MSAN)
+    set(SANITIZERS ON)
+  endif()
+endif()
+if(SANITIZERS)
+  list(JOIN PRINT_TYPES_OF_SANITIZERS_LIST "," PRINT_TYPES_OF_SANITIZERS_STRING)
+  message (STATUS "BUILD_WITH_SANITIZERS ................. on (${PRINT_TYPES_OF_SANITIZERS_STRING})")
+else()
+  message (STATUS "BUILD_WITH_SANITIZERS ................. off - use -DBUILD_WITH_SANITIZERS=[memory,address,undefined] with CLANG compiler to enable this option")
+endif(SANITIZERS)
+
 if((UNIX) AND (NOT APPLE))
   set(LINUX ON)
 else()

examples/CMakeLists.txt

@@ -1,17 +1,18 @@
 #===============================================================================
-# Copyright 2019 Intel Corporation
+# Copyright (C) 2019 Intel Corporation
 #
-# Licensed under the Apache License, Version 2.0 (the "License");
+# Licensed under the Apache License, Version 2.0 (the 'License');
 # you may not use this file except in compliance with the License.
 # You may obtain a copy of the License at
-#
-#     http://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS,
+# 
+# http://www.apache.org/licenses/LICENSE-2.0
+# 
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an 'AS IS' BASIS,
 # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-# See the License for the specific language governing permissions and
-# limitations under the License.
+# See the License for the specific language governing permissions
+# and limitations under the License.
+# 
 #===============================================================================
 
 #

examples/FindIPPCrypto.cmake

@@ -1,17 +1,18 @@
 #===============================================================================
-# Copyright 2019 Intel Corporation
+# Copyright (C) 2019 Intel Corporation
 #
-# Licensed under the Apache License, Version 2.0 (the "License");
+# Licensed under the Apache License, Version 2.0 (the 'License');
 # you may not use this file except in compliance with the License.
 # You may obtain a copy of the License at
-#
-#     http://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS,
+# 
+# http://www.apache.org/licenses/LICENSE-2.0
+# 
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an 'AS IS' BASIS,
 # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-# See the License for the specific language governing permissions and
-# limitations under the License.
+# See the License for the specific language governing permissions
+# and limitations under the License.
+# 
 #===============================================================================
 
 #

examples/aes/aes-256-ctr-decryption.cpp

@@ -1,17 +1,18 @@
 /*******************************************************************************
-* Copyright 2019 Intel Corporation
+* Copyright (C) 2019 Intel Corporation
 *
-* Licensed under the Apache License, Version 2.0 (the "License");
+* Licensed under the Apache License, Version 2.0 (the 'License');
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
-*
-*     http://www.apache.org/licenses/LICENSE-2.0
-*
-* Unless required by applicable law or agreed to in writing, software
-* distributed under the License is distributed on an "AS IS" BASIS,
+* 
+* http://www.apache.org/licenses/LICENSE-2.0
+* 
+* Unless required by applicable law or agreed to in writing,
+* software distributed under the License is distributed on an 'AS IS' BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-* See the License for the specific language governing permissions and
-* limitations under the License.
+* See the License for the specific language governing permissions
+* and limitations under the License.
+* 
 *******************************************************************************/
 
 /*!

examples/aes/aes-256-ctr-encryption.cpp

@@ -1,17 +1,18 @@
 /*******************************************************************************
-* Copyright 2019 Intel Corporation
+* Copyright (C) 2019 Intel Corporation
 *
-* Licensed under the Apache License, Version 2.0 (the "License");
+* Licensed under the Apache License, Version 2.0 (the 'License');
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
-*
-*     http://www.apache.org/licenses/LICENSE-2.0
-*
-* Unless required by applicable law or agreed to in writing, software
-* distributed under the License is distributed on an "AS IS" BASIS,
+* 
+* http://www.apache.org/licenses/LICENSE-2.0
+* 
+* Unless required by applicable law or agreed to in writing,
+* software distributed under the License is distributed on an 'AS IS' BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-* See the License for the specific language governing permissions and
-* limitations under the License.
+* See the License for the specific language governing permissions
+* and limitations under the License.
+* 
 *******************************************************************************/
 
 /*!

examples/dsa/categoryOptions.cmake

@@ -1,17 +1,18 @@
 #===============================================================================
-# Copyright 2019 Intel Corporation
+# Copyright (C) 2019 Intel Corporation
 #
-# Licensed under the Apache License, Version 2.0 (the "License");
+# Licensed under the Apache License, Version 2.0 (the 'License');
 # you may not use this file except in compliance with the License.
 # You may obtain a copy of the License at
-#
-#     http://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS,
+# 
+# http://www.apache.org/licenses/LICENSE-2.0
+# 
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an 'AS IS' BASIS,
 # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-# See the License for the specific language governing permissions and
-# limitations under the License.
+# See the License for the specific language governing permissions
+# and limitations under the License.
+# 
 #===============================================================================
 
 set(dsa_CATEGORY_COMMON_SOURCES

examples/dsa/dsa-dlp-sha-1-verification.cpp

@@ -1,17 +1,18 @@
 /*******************************************************************************
-* Copyright 2021 Intel Corporation
+* Copyright (C) 2021 Intel Corporation
 *
-* Licensed under the Apache License, Version 2.0 (the "License");
+* Licensed under the Apache License, Version 2.0 (the 'License');
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
-*
-*     http://www.apache.org/licenses/LICENSE-2.0
-*
-* Unless required by applicable law or agreed to in writing, software
-* distributed under the License is distributed on an "AS IS" BASIS,
+* 
+* http://www.apache.org/licenses/LICENSE-2.0
+* 
+* Unless required by applicable law or agreed to in writing,
+* software distributed under the License is distributed on an 'AS IS' BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-* See the License for the specific language governing permissions and
-* limitations under the License.
+* See the License for the specific language governing permissions
+* and limitations under the License.
+* 
 *******************************************************************************/
 
 /*!