grpc 1.84.0 → 1.85.0.pre1

data/third_party/boringssl-with-bazel/crypto/fipsmodule/cipher/internal.h

@@ -19,16 +19,21 @@
 
 #include <openssl/aead.h>
 #include <openssl/aes.h>
+#include <openssl/span.h>
 
 #include "../../internal.h"
+#include "../../mem_internal.h"
 #include "../aes/internal.h"
 
-#if defined(__cplusplus)
+#include <algorithm>
+#include <functional>
+#include <optional>
+#include <type_traits>
+
 extern "C" {
-#endif
 
 
-// EVP_CIPH_MODE_MASK contains the bits of |flags| that represent the mode.
+// EVP_CIPH_MODE_MASK contains the bits of `flags` that represent the mode.
 #define EVP_CIPH_MODE_MASK 0x3f
 
 // EVP_AEAD represents a specific AEAD algorithm.
@@ -37,37 +42,39 @@ struct evp_aead_st {
   uint8_t nonce_len;
   uint8_t overhead;
   uint8_t max_tag_len;
-  int seal_scatter_supports_extra_in;
 
-  // init initialises an |EVP_AEAD_CTX|. If this call returns zero then
-  // |cleanup| will not be called for that context.
+  // init initialises an `EVP_AEAD_CTX`. If this call returns zero then
+  // `cleanup` will not be called for that context.
   int (*init)(EVP_AEAD_CTX *, const uint8_t *key, size_t key_len,
               size_t tag_len);
   int (*init_with_direction)(EVP_AEAD_CTX *, const uint8_t *key, size_t key_len,
                              size_t tag_len, enum evp_aead_direction_t dir);
   void (*cleanup)(EVP_AEAD_CTX *);
 
-  int (*open)(const EVP_AEAD_CTX *ctx, uint8_t *out, size_t *out_len,
-              size_t max_out_len, const uint8_t *nonce, size_t nonce_len,
-              const uint8_t *in, size_t in_len, const uint8_t *ad,
-              size_t ad_len);
+  // AEADs need to provide one of the following sets of methods:
+  //
+  // - openv + sealv: variable tag lenght AEAD.
+  // - openv_detached + sealv: fixed tag length AEAD.
+
+  int (*openv)(const EVP_AEAD_CTX *ctx, bssl::Span<const CRYPTO_IOVEC> iovecs,
+               size_t *out_total_bytes, bssl::Span<const uint8_t> nonce,
+               bssl::Span<const CRYPTO_IVEC> aadvecs);
 
-  int (*seal_scatter)(const EVP_AEAD_CTX *ctx, uint8_t *out, uint8_t *out_tag,
-                      size_t *out_tag_len, size_t max_out_tag_len,
-                      const uint8_t *nonce, size_t nonce_len, const uint8_t *in,
-                      size_t in_len, const uint8_t *extra_in,
-                      size_t extra_in_len, const uint8_t *ad, size_t ad_len);
+  int (*sealv)(const EVP_AEAD_CTX *ctx, bssl::Span<const CRYPTO_IOVEC> iovecs,
+               bssl::Span<uint8_t> out_tag, size_t *out_tag_len,
+               bssl::Span<const uint8_t> nonce,
+               bssl::Span<const CRYPTO_IVEC> aadvecs);
 
-  int (*open_gather)(const EVP_AEAD_CTX *ctx, uint8_t *out,
-                     const uint8_t *nonce, size_t nonce_len, const uint8_t *in,
-                     size_t in_len, const uint8_t *in_tag, size_t in_tag_len,
-                     const uint8_t *ad, size_t ad_len);
+  int (*openv_detached)(const EVP_AEAD_CTX *ctx,
+                        bssl::Span<const CRYPTO_IOVEC> iovecs,
+                        bssl::Span<const uint8_t> nonce,
+                        bssl::Span<const uint8_t> in_tag,
+                        bssl::Span<const CRYPTO_IVEC> aadvecs);
 
   int (*get_iv)(const EVP_AEAD_CTX *ctx, const uint8_t **out_iv,
                 size_t *out_len);
 
-  size_t (*tag_len)(const EVP_AEAD_CTX *ctx, size_t in_Len,
-                    size_t extra_in_len);
+  size_t (*tag_len)(const EVP_AEAD_CTX *ctx, size_t in_len);
 };
 
 struct evp_cipher_st {
@@ -89,25 +96,365 @@ struct evp_cipher_st {
   // cipher.
   unsigned ctx_size;
 
-  // flags contains the OR of a number of flags. See |EVP_CIPH_*|.
+  // flags contains the OR of a number of flags. See `EVP_CIPH_*`.
   uint32_t flags;
 
   int (*init)(EVP_CIPHER_CTX *ctx, const uint8_t *key, const uint8_t *iv,
               int enc);
 
-  int (*cipher)(EVP_CIPHER_CTX *ctx, uint8_t *out, const uint8_t *in,
-                size_t inl);
+  // cipher encrypts/decrypts `in`, write output to `out`. Writes exactly `len`
+  // bytes, which must be a multiple of the `block_size`.
+  //
+  // For ciphers where encryption and decryption operations differ, `init`
+  // shall set an internal state for this.
+  //
+  // Returns 1 on success, or 0 on error.
+  int (*cipher_update)(EVP_CIPHER_CTX *ctx, uint8_t *out, const uint8_t *in,
+                       size_t len);
+
+  // cipher_final finalizes the cipher, performing possible final
+  // authentication checks.
+  //
+  // Only used for `EVP_CIPH_FLAG_CUSTOM_CIPHER` ciphers.
+  //
+  // Returns 1 on success, or 0 on error. When decrypting, if an error is
+  // returned, the decrypted data must not be used.
+  int (*cipher_final)(EVP_CIPHER_CTX *ctx);
+
+  // update_aad adds `in` (of length `inl`) to the authenticated data for the
+  // encryption operation.
+  //
+  // Only used for `EVP_CIPH_FLAG_CUSTOM_CIPHER` ciphers.
+  //
+  // Returns 1 on success, or 0 on error.
+  int (*update_aad)(EVP_CIPHER_CTX *ctx, const uint8_t *in, size_t inl);
 
   // cleanup, if non-NULL, releases memory associated with the context. It is
-  // called if |EVP_CTRL_INIT| succeeds. Note that |init| may not have been
+  // called if `EVP_CTRL_INIT` succeeds. Note that `init` may not have been
   // called at this point.
   void (*cleanup)(EVP_CIPHER_CTX *);
 
   int (*ctrl)(EVP_CIPHER_CTX *, int type, int arg, void *ptr);
 };
 
-#if defined(__cplusplus)
 }  // extern C
-#endif
+
+BSSL_NAMESPACE_BEGIN
+
+// CopySpan copies an entire span of bytes from `from` to `to`.
+//
+// The spans need to have the same length.
+inline void CopySpan(Span<const uint8_t> from, Span<uint8_t> to) {
+  BSSL_CHECK(from.size() == to.size());
+  std::copy(from.begin(), from.end(), to.begin());
+}
+
+// CopyToPrefix copies a span of bytes from `from` into `to`. It aborts
+// if there is not enough space.
+//
+// TODO(crbug.com/404286922): Can we simplify this in a C++20 world (e.g.
+// std::ranges::copy)? Must preserve range checking on the destination span.
+inline void CopyToPrefix(Span<const uint8_t> from, Span<uint8_t> to) {
+  CopySpan(from, to.first(from.size()));
+}
+
+// Generic CRYPTO_IOVEC/CRYPTO_IVEC helpers.
+namespace iovec {
+
+// IsValid returns whether the given `CRYPTO_IVEC` or `CRYPTO_IOVEC` is
+// valid for use with public APIs, i.e. does not contain more than `SIZE_MAX`
+// bytes and not more than `CRYPTO_IOVEC_MAX` chunks. Note that the `EVP_AEAD`
+// methods need to accept an arbitrary number of chunks.
+template <typename IVec>
+inline bool IsValid(Span<IVec> ivecs) {
+  if (ivecs.size() > CRYPTO_IOVEC_MAX) {
+    return false;
+  }
+  size_t allowed = SIZE_MAX;
+  for (const IVec &ivec : ivecs) {
+    size_t len = ivec.len;
+    if (len > allowed) {
+      return false;
+    }
+    allowed -= len;
+  }
+  return true;
+}
+
+// Length returns the total length in bytes of a given `CRYPTO_IVEC` or
+// `CRYPTO_IOVEC`.
+template <typename IVec>
+inline size_t TotalLength(Span<IVec> ivecs) {
+  size_t total = 0;
+  for (const IVec &ivec : ivecs) {
+    total += ivec.len;
+  }
+  return total;
+}
+
+// GetAndRemoveSuffix takes `suffix_buf.size()` final bytes from the given
+// `CRYPTO_IVEC` or `CRYPTO_IOVEC` (mutating said iovec to no longer contain
+// those bytes) and returns them.
+//
+// If the byte range is contained in a single chunk of `ivecs`, it will just
+// return that span pointing into `ivecs`; otherwise, it will copy the bytes
+// into `out` and return that.
+//
+// If `ivecs` is too short, returns `nullopt`.
+template <typename IVec, typename ReadFromT = const uint8_t *,
+          ReadFromT IVec::*ReadFrom = &IVec::in>
+inline std::optional<Span<const uint8_t>> GetAndRemoveSuffix(
+    Span<uint8_t> suffix_buf, Span<IVec> ivecs) {
+  // Get the trivial case out.
+  if (suffix_buf.empty()) {
+    return suffix_buf;
+  }
+  // Strip trailing zero length chunks.
+  while (!ivecs.empty() && ivecs.back().len == 0) {
+    ivecs = ivecs.first(ivecs.size() - 1);
+  }
+  if (ivecs.empty()) {
+    return std::nullopt;
+  }
+  // Is the requested chunk entirely contained? If so, just return it.
+  if (ivecs.back().len >= suffix_buf.size()) {
+    ivecs.back().len -= suffix_buf.size();
+    return Span(ivecs.back().*ReadFrom + ivecs.back().len, suffix_buf.size());
+  }
+  // Otherwise, collect it into the buffer while trimming `ivecs`.
+  Span<uint8_t> remaining = suffix_buf;
+  while (!ivecs.empty()) {
+    Span<const uint8_t> src(ivecs.back().*ReadFrom, ivecs.back().len);
+    if (src.size() >= remaining.size()) {
+      CopySpan(src.last(remaining.size()), remaining);
+      ivecs.back().len -= remaining.size();
+      return suffix_buf;
+    }
+    CopySpan(src, remaining.last(src.size()));
+    remaining = remaining.first(remaining.size() - src.size());
+    ivecs.back().len = 0;
+    ivecs = ivecs.first(ivecs.size() - 1);
+  }
+  return std::nullopt;
+}
+
+// GetAndRemoveOutSuffix is like `GetAndRemoveSuffix` but takes from a
+// `CRYPTO_IOVEC`'s `out` member instead.
+inline std::optional<Span<const uint8_t>> GetAndRemoveOutSuffix(
+    Span<uint8_t> out, Span<CRYPTO_IOVEC> iovecs) {
+  return GetAndRemoveSuffix<CRYPTO_IOVEC, /*ReadFromT=*/uint8_t *,
+                            /*ReadFrom=*/&CRYPTO_IOVEC::out>(out, iovecs);
+}
+
+namespace internal {
+inline void CopySpanToIOVec(Span<const uint8_t> out, CRYPTO_IOVEC head,
+                            Span<const CRYPTO_IOVEC> rest) {
+  for (;;) {
+    size_t to_copy = std::min(head.len, out.size());
+    CopySpan(out.first(to_copy), Span(head.out, to_copy));
+    out = out.subspan(to_copy);
+    if (out.empty()) {
+      break;
+    }
+    head = rest.front();  // Checkfails if insufficient space in CRYPTO_IOVEC.
+    rest = rest.subspan(1);
+  }
+}
+}  // namespace internal
+
+// ForEachBlockRange iterates over the `ivecs` as follows:
+//
+// - `f_whole` gets called on whole blocks crossing `ivecs` chunk boundaries, or
+//   ranges of whole blocks that are entirely in chunks.
+// - `f` gets called exactly once, on the last block range which may
+//   end up with a partial block.
+// - Both functions receive an `in` pointer that either points into `ivecs` or
+//   into a chunk assembly buffer and a `len` which indicates the number of
+//   bytes from `in` that can be accessed. If the function returns 0,
+//   iteration stops.
+// - If `WriteOut` is set, `f_whole` and `f` receive an extra `out`
+//   argument to which they can write output. This output will be placed into
+//   the `ivecs`'s `out` members either during or after the call. If iteration
+//   was stopped, the contents of `out` are indeterminate.
+// - The return value is true if iteration was not stopped by the callbacks.
+template <
+    size_t BlockSize, bool WriteOut = false, typename IVec,
+    typename ReadFromT = const uint8_t *, ReadFromT IVec::*ReadFrom = &IVec::in,
+    typename /* bool(const uint8_t *in, [uint8_t *out,] size_t len) */ FWhole,
+    typename /* bool(const uint8_t *in, [uint8_t *out,] size_t len) */
+    FFinal>
+inline bool ForEachBlockRange(Span<IVec> ivecs, const FWhole &f_whole,
+                              const FFinal &f_final) {
+  using MutableIVec = std::remove_const_t<IVec>;
+  // Helper to make the function calls simpler.
+  auto call_func = [&](const auto &f, const IVec &ivec) {
+    if constexpr (WriteOut) {
+      return f(ivec.*ReadFrom, ivec.out, ivec.len);
+    } else {
+      return f(ivec.*ReadFrom, ivec.len);
+    }
+  };
+  // Helper to cut from the start of an IVec.
+  auto remove_prefix = [&](MutableIVec &ivec, size_t by) {
+    ivec.*ReadFrom += by;
+    if constexpr (WriteOut) {
+      ivec.out += by;
+    }
+    ivec.len -= by;
+  };
+  // Helper to copy a range to an iovec list.
+  auto maybe_copy_to_iovec = [&](Span<const uint8_t> out, MutableIVec head,
+                                 Span<IVec> rest) {
+    if constexpr (WriteOut) {
+      internal::CopySpanToIOVec(out, head, rest);
+    }
+  };
+
+  // Ensure the last item in `ivecs` is nonempty. This is necessary for
+  // detecting being at the end and calling `f_final` at the appropriate time.
+  Span<IVec> ivecs_trimmed = ivecs;
+  while (!ivecs_trimmed.empty() && ivecs_trimmed.back().len == 0) {
+    ivecs_trimmed = ivecs_trimmed.first(ivecs_trimmed.size() - 1);
+  }
+  if (ivecs_trimmed.empty()) {
+    return call_func(f_final, IVec{});
+  }
+
+  // Now there are at least two non-empty `ivecs`, and neither the first nor the
+  // last can be empty.
+
+  MutableIVec current_range_head = ivecs_trimmed.front();
+  Span<IVec> current_range_rest = ivecs_trimmed.subspan(1);
+  while (!current_range_rest.empty()) {
+    // Process as many whole blocks as possible.
+    size_t whole_blocks_len = (current_range_head.len / BlockSize) * BlockSize;
+    if (whole_blocks_len != 0) {
+      MutableIVec whole_part = current_range_head;
+      whole_part.len = whole_blocks_len;
+      if (!call_func(f_whole, whole_part)) {
+        return false;
+      }
+      remove_prefix(current_range_head, whole_blocks_len);
+    }
+
+    if (current_range_head.len == 0) {
+      current_range_head = current_range_rest.front();
+      current_range_rest = current_range_rest.subspan(1);
+      continue;
+    }
+
+    // Collect a whole block.
+    alignas(BlockSize) InplaceVector<uint8_t, BlockSize> in;
+    alignas(BlockSize) uint8_t out[BlockSize];
+    MutableIVec collect_from_head = current_range_head;
+    Span<IVec> collect_from_rest = current_range_rest;
+    while (in.size() <= BlockSize) {
+      size_t remaining = BlockSize - in.size();
+      if (remaining < collect_from_head.len) {
+        // Got enough to complete the block _and more_.
+        in.Append(Span(collect_from_head.*ReadFrom, remaining));
+        remove_prefix(collect_from_head, remaining);
+        break;
+      }
+      // Consume all of `ivec` and advance.
+      in.Append(Span(collect_from_head.*ReadFrom, collect_from_head.len));
+      if (collect_from_rest.empty()) {
+        // Nothing left - so this is the final block.
+        auto finalout = Span(out).first(in.size());
+        MutableIVec finalvec = {};
+        finalvec.len = in.size();
+        finalvec.*ReadFrom = in.data();
+        if constexpr (WriteOut) {
+          finalvec.out = finalout.data();
+        }
+        if (!call_func(f_final, finalvec)) {
+          return false;
+        }
+        maybe_copy_to_iovec(finalout, current_range_head, current_range_rest);
+        return true;
+      }
+      collect_from_head = collect_from_rest.front();
+      collect_from_rest = collect_from_rest.subspan(1);
+    }
+    assert(in.size() == BlockSize);
+
+    // The above loop ensures this condition by the `break` only happening if
+    // `collect_from_head` has at least one byte remaining, and the loop
+    // otherwise ensuring as an invariant that the final chunk - which is
+    // nonempty - is among `collect_from_head` and `collect_from_rest`.
+    //
+    // As such, at least one byte is remaining, and thus calling `f_whole` is
+    // appropriate.
+    assert(collect_from_head.len != 0 || !collect_from_rest.empty());
+
+    // Process the block.
+    MutableIVec wholevec = {};
+    wholevec.len = in.size();
+    wholevec.*ReadFrom = in.data();
+    if constexpr (WriteOut) {
+      wholevec.out = out;
+    }
+    if (!call_func(f_whole, wholevec)) {
+      return false;
+    }
+    maybe_copy_to_iovec(Span(out).first(in.size()), current_range_head,
+                        current_range_rest);
+
+    // Set the new position.
+    current_range_head = collect_from_head;
+    current_range_rest = collect_from_rest;
+  }
+
+  // If current_range_head.len is zero, then the last item of ivecs is empty.
+  // That however was excluded at the start of the function to ensure `f_final`
+  // is always used for the last call.
+  assert(current_range_head.len != 0);
+
+  return call_func(f_final, current_range_head);
+}
+
+// ForEachOutBlockRange is like `ForEachBlockRange` but reads from a
+// `CRYPTO_IOVEC`'s `out` member instead.
+template <
+    size_t BlockSize,
+    typename /* int(const uint8_t *in, [uint8_t *out,] size_t len) */ FWhole,
+    typename /* int(const uint8_t *in, [uint8_t *out,] size_t len) */
+    FFinal>
+inline int ForEachOutBlockRange(Span<const CRYPTO_IOVEC> iovecs,
+                                const FWhole &f_whole, const FFinal &f_final) {
+  return ForEachBlockRange<BlockSize, /*WriteOut=*/false, const CRYPTO_IOVEC,
+                           /*ReadFromT=*/uint8_t *,
+                           /*ReadFrom=*/&CRYPTO_IOVEC::out>(iovecs, f_whole,
+                                                            f_final);
+}
+
+// ForEachBlockRange_Dynamic is simply `ForEachBlockRange` with a
+// runtime dispatch on the block size.
+template <
+    bool WriteOut = false, typename IVec, typename ReadFromT = const uint8_t *,
+    ReadFromT IVec::*ReadFrom = &IVec::in,
+    typename /* int(const uint8_t *in, uint8_t *out, size_t len) */ FWhole,
+    typename /* int(const uint8_t *in, uint8_t *out, size_t len) */
+    FFinal>
+inline int ForEachBlockRange_Dynamic(size_t block_size, Span<IVec> ivecs,
+                                     const FWhole &f_whole,
+                                     const FFinal &f_final) {
+  switch (block_size) {
+    case 8:
+      return ForEachBlockRange<8, WriteOut, IVec, ReadFromT, ReadFrom>(
+          ivecs, f_whole, f_final);
+      break;
+    case 16:
+      return ForEachBlockRange<16, WriteOut, IVec, ReadFromT, ReadFrom>(
+          ivecs, f_whole, f_final);
+      break;
+    default:
+      return 0;
+  }
+}
+
+}  // namespace iovec
+
+BSSL_NAMESPACE_END
 
 #endif  // OPENSSL_HEADER_CRYPTO_FIPSMODULE_CIPHER_INTERNAL_H

data/third_party/boringssl-with-bazel/crypto/fipsmodule/cmac/cmac.cc.inc

@@ -23,9 +23,12 @@
 #include <openssl/mem.h>
 
 #include "../../internal.h"
+#include "../../mem_internal.h"
 #include "../service_indicator/internal.h"
 
 
+using namespace bssl;
+
 struct cmac_ctx_st {
   EVP_CIPHER_CTX cipher_ctx;
   // k1 and k2 are the CMAC subkeys. See
@@ -34,7 +37,7 @@ struct cmac_ctx_st {
   uint8_t k2[AES_BLOCK_SIZE];
   // Last (possibly partial) scratch
   uint8_t block[AES_BLOCK_SIZE];
-  // block_used contains the number of valid bytes in |block|.
+  // block_used contains the number of valid bytes in `block`.
   unsigned block_used;
 };
 
@@ -72,7 +75,7 @@ int AES_CMAC(uint8_t out[16], const uint8_t *key, size_t key_len,
   // We have to verify that all the CMAC services actually succeed before
   // updating the indicator state, so we lock the state here.
   FIPS_service_indicator_lock_state();
-  const int ok = CMAC_Init(&ctx, key, key_len, cipher, NULL /* engine */) &&
+  const int ok = CMAC_Init(&ctx, key, key_len, cipher, nullptr /* engine */) &&
                  CMAC_Update(&ctx, in, in_len) &&
                  CMAC_Final(&ctx, out, &scratch_out_len);
   FIPS_service_indicator_unlock_state();
@@ -84,21 +87,21 @@ int AES_CMAC(uint8_t out[16], const uint8_t *key, size_t key_len,
   return ok;
 }
 
-CMAC_CTX *CMAC_CTX_new(void) {
-  CMAC_CTX *ctx = reinterpret_cast<CMAC_CTX *>(OPENSSL_malloc(sizeof(*ctx)));
-  if (ctx != NULL) {
+CMAC_CTX *CMAC_CTX_new() {
+  CMAC_CTX *ctx = New<CMAC_CTX>();
+  if (ctx != nullptr) {
     CMAC_CTX_init(ctx);
   }
   return ctx;
 }
 
 void CMAC_CTX_free(CMAC_CTX *ctx) {
-  if (ctx == NULL) {
+  if (ctx == nullptr) {
     return;
   }
 
   CMAC_CTX_cleanup(ctx);
-  OPENSSL_free(ctx);
+  Delete(ctx);
 }
 
 int CMAC_CTX_copy(CMAC_CTX *out, const CMAC_CTX *in) {
@@ -112,14 +115,14 @@ int CMAC_CTX_copy(CMAC_CTX *out, const CMAC_CTX *in) {
   return 1;
 }
 
-// binary_field_mul_x_128 treats the 128 bits at |in| as an element of GF(2¹²⁸)
-// with a hard-coded reduction polynomial and sets |out| as x times the input.
+// binary_field_mul_x_128 treats the 128 bits at `in` as an element of GF(2¹²⁸)
+// with a hard-coded reduction polynomial and sets `out` as x times the input.
 //
 // See https://tools.ietf.org/html/rfc4493#section-2.3
 static void binary_field_mul_x_128(uint8_t out[16], const uint8_t in[16]) {
   unsigned i;
 
-  // Shift |in| to left, including carry.
+  // Shift `in` to left, including carry.
   for (i = 0; i < 15; i++) {
     out[i] = (in[i] << 1) | (in[i + 1] >> 7);
   }
@@ -129,14 +132,14 @@ static void binary_field_mul_x_128(uint8_t out[16], const uint8_t in[16]) {
   out[i] = (in[i] << 1) ^ ((0 - carry) & 0x87);
 }
 
-// binary_field_mul_x_64 behaves like |binary_field_mul_x_128| but acts on an
+// binary_field_mul_x_64 behaves like `binary_field_mul_x_128` but acts on an
 // element of GF(2⁶⁴).
 //
 // See https://nvlpubs.nist.gov/nistpubs/SpecialPublications/NIST.SP.800-38b.pdf
 static void binary_field_mul_x_64(uint8_t out[8], const uint8_t in[8]) {
   unsigned i;
 
-  // Shift |in| to left, including carry.
+  // Shift `in` to left, including carry.
   for (i = 0; i < 7; i++) {
     out[i] = (in[i] << 1) | (in[i + 1] >> 7);
   }
@@ -153,18 +156,19 @@ int CMAC_Init(CMAC_CTX *ctx, const void *key, size_t key_len,
   int ret = 0;
   uint8_t scratch[AES_BLOCK_SIZE];
 
-  // We have to avoid the underlying AES-CBC |EVP_CIPHER| services updating the
+  // We have to avoid the underlying AES-CBC `EVP_CIPHER` services updating the
   // indicator state, so we lock the state here.
   FIPS_service_indicator_lock_state();
 
   size_t block_size = EVP_CIPHER_block_size(cipher);
   if ((block_size != AES_BLOCK_SIZE && block_size != 8 /* 3-DES */) ||
       EVP_CIPHER_key_length(cipher) != key_len ||
-      !EVP_EncryptInit_ex(&ctx->cipher_ctx, cipher, NULL,
+      !EVP_EncryptInit_ex(&ctx->cipher_ctx, cipher, nullptr,
                           reinterpret_cast<const uint8_t *>(key), kZeroIV) ||
       !EVP_Cipher(&ctx->cipher_ctx, scratch, kZeroIV, block_size) ||
       // Reset context again ready for first data.
-      !EVP_EncryptInit_ex(&ctx->cipher_ctx, NULL, NULL, NULL, kZeroIV)) {
+      !EVP_EncryptInit_ex(&ctx->cipher_ctx, nullptr, nullptr, nullptr,
+                          kZeroIV)) {
     goto out;
   }
 
@@ -185,13 +189,14 @@ out:
 
 int CMAC_Reset(CMAC_CTX *ctx) {
   ctx->block_used = 0;
-  return EVP_EncryptInit_ex(&ctx->cipher_ctx, NULL, NULL, NULL, kZeroIV);
+  return EVP_EncryptInit_ex(&ctx->cipher_ctx, nullptr, nullptr, nullptr,
+                            kZeroIV);
 }
 
 int CMAC_Update(CMAC_CTX *ctx, const uint8_t *in, size_t in_len) {
   int ret = 0;
 
-  // We have to avoid the underlying AES-CBC |EVP_Cipher| services updating the
+  // We have to avoid the underlying AES-CBC `EVP_Cipher` services updating the
   // indicator state, so we lock the state here.
   FIPS_service_indicator_lock_state();
 
@@ -210,9 +215,9 @@ int CMAC_Update(CMAC_CTX *ctx, const uint8_t *in, size_t in_len) {
     in_len -= todo;
     ctx->block_used += todo;
 
-    // If |in_len| is zero then either |ctx->block_used| is less than
-    // |block_size|, in which case we can stop here, or |ctx->block_used| is
-    // exactly |block_size| but there's no more data to process. In the latter
+    // If `in_len` is zero then either `ctx->block_used` is less than
+    // `block_size`, in which case we can stop here, or `ctx->block_used` is
+    // exactly `block_size` but there's no more data to process. In the latter
     // case we don't want to process this block now because it might be the last
     // block and that block is treated specially.
     if (in_len == 0) {
@@ -237,7 +242,7 @@ int CMAC_Update(CMAC_CTX *ctx, const uint8_t *in, size_t in_len) {
   }
 
   OPENSSL_memcpy(ctx->block, in, in_len);
-  // |in_len| is bounded by |block_size|, which fits in |unsigned|.
+  // `in_len` is bounded by `block_size`, which fits in `unsigned`.
   static_assert(EVP_MAX_BLOCK_LENGTH < UINT_MAX,
                 "EVP_MAX_BLOCK_LENGTH is too large");
   ctx->block_used = (unsigned)in_len;
@@ -253,13 +258,13 @@ int CMAC_Final(CMAC_CTX *ctx, uint8_t *out, size_t *out_len) {
   size_t block_size = EVP_CIPHER_CTX_block_size(&ctx->cipher_ctx);
   assert(block_size <= AES_BLOCK_SIZE);
 
-  // We have to avoid the underlying AES-CBC |EVP_Cipher| services updating the
+  // We have to avoid the underlying AES-CBC `EVP_Cipher` services updating the
   // indicator state, so we lock the state here.
   FIPS_service_indicator_lock_state();
 
   *out_len = block_size;
   const uint8_t *mask = ctx->k1;
-  if (out == NULL) {
+  if (out == nullptr) {
     ret = 1;
     goto out;
   }