From nobody Tue Apr 7 14:41:42 2026 Received: from mail-oa1-f51.google.com (mail-oa1-f51.google.com [209.85.160.51]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 232AD3603EB for ; Thu, 12 Mar 2026 21:35:01 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=pass smtp.client-ip=209.85.160.51 ARC-Seal: i=2; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1773351303; cv=pass; b=PV2Z8bdcI2NVwTmXUHVRcoA3FQDURUfV9/yUf1r4sSwdTaRRP9bM62WU/RMPVGXmSI941J1/Hvm9asrqFPaCR9ARHYbT3icsiE9r2Iow10nDt2bp/g+y42wAkYWL4T5PnkSaRlXFLPYo8ITk9rLCBc+l/13QjUfTekW5IHVB1Z4= ARC-Message-Signature: i=2; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1773351303; c=relaxed/simple; bh=gIjUIJ1qavPnJ09f8IJAA3QTQeJp8aH9yAtz2EQNkXQ=; h=MIME-Version:From:Date:Message-ID:Subject:To:Cc:Content-Type; b=h5WIQbz5xjyNK9MMuOaZHw9v1Jk8Y67a01uJk8LeGtsT8x1l+nb3j5dtiO7PGytMEq/H3ayRzps9AaltpORdWuhAQZ/ZpXplRM+vDe053HlQKPqU2ydKxdCGjeAkWG933TGxOivyDHxk8mOQdQvZsjnbRWfcoybeigi5wn/+BNA= ARC-Authentication-Results: i=2; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com; spf=pass smtp.mailfrom=gmail.com; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b=BmXuZY58; arc=pass smtp.client-ip=209.85.160.51 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=gmail.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b="BmXuZY58" Received: by mail-oa1-f51.google.com with SMTP id 586e51a60fabf-40ef10ec84cso1066563fac.2 for ; Thu, 12 Mar 2026 14:35:01 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1773351301; cv=none; d=google.com; s=arc-20240605; b=gSSO3VDPTOJCDQuji9tk+gKi98N0BIyd8/Lc4pYJwByq5q1zStkRxw8JfOVJmvhUvs Z8ODleVRkSHYTcrlEifV8VyTmP08eqZ0g7PpPO43xBjFhyar4BoQV641P9kZoCYrqZP6 PIWZe07jcym/zEjxR/PlBVm217n6sxMTKMcfYpcC5hT/28Lg0y8gopTCRiYU4saxotyO I+HDudnIzV+VEhRCIZlpkAjSvSNuxEUTK3X56t8ztiyWMUAsZTp4LjhyMQsNwczeStL4 rJaZy68pPSYgK/O6zt4tfh2UokF7CbEzkmJb2+y37TSd3MhY0Hs7vl1eZK3oTylQPSl4 eUjg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20240605; h=cc:to:subject:message-id:date:from:mime-version:dkim-signature; bh=tdgabxvgrR3NH9n6dRdF+gCtINqaBantNHEPEnk5z6I=; fh=TlYFu+E5oI98FEmNC6ghO+rgiFcoKhjB/PBBB/10yi8=; b=SQHe93Uk7gLczvxjU1uEL3r5AFXK+0RKic7o2sK4mUvs8ewV9C7/DSZCvODljasKfn G/PYGzgbO+HvlYq3Ny+gP/Pnt5vJG6jd3hSmwPzXofTds98xga8/r0Zgtstz/+BRI5QH bpryK31B1aOlI0C9vDj9Mwhs2dL7m+IsZn/dM9UKWQJ7Yq8BYAclqQRjb2L2vbkGucs8 Ykk4mr6gespFEdRQaqhSAGuFuWZwehuY3sl30b0VzXfG8+IxULoJlZQmYNUpcp60TBDD EHcVG0Q8z69c7HLtfA8YwtpQCoWy2C8ph5QEHAuHXMKsz2+EVZ3fDYtqjfcNXmuiX+VH ukRg==; darn=vger.kernel.org ARC-Authentication-Results: i=1; mx.google.com; arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1773351301; x=1773956101; darn=vger.kernel.org; h=cc:to:subject:message-id:date:from:mime-version:from:to:cc:subject :date:message-id:reply-to; bh=tdgabxvgrR3NH9n6dRdF+gCtINqaBantNHEPEnk5z6I=; b=BmXuZY58sbCTlclLwTDEIdk3zWUzmRerA2+xA/8xhoajn+RuPUQ7Zf+V/0zcEIqvAq qzN7ai5nt79apoYz6uJGPsCiW7uMWc1H6dZYoeNn6HlXP1paOgK+L+qD5SQmG9uGHdu5 HtP0Zckz2RZq4uwUOYQ4bvGPshtM3ymh8j8q93Cp4UguTrcrcUnXCt2X//jDue8hLXRB fCHuB0gq+c3qb0W20OSfbLmHb3C6oFeRDykio8znFsRGeSQslYvhEuKvaRm3LHIQ5I45 VZJ2rzOo7EULsK1kPSWMxArS3sVhVejha3+s27ikFniZB8x6luNm38lsDl6xcS0C4S67 u88w== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20251104; t=1773351301; x=1773956101; h=cc:to:subject:message-id:date:from:mime-version:x-gm-gg :x-gm-message-state:from:to:cc:subject:date:message-id:reply-to; bh=tdgabxvgrR3NH9n6dRdF+gCtINqaBantNHEPEnk5z6I=; b=app+ImWm+k7VGVc4oBAydWUMHLtUg4g1zEsQme+HIiif2h8IoPEkCM7Cq586TNuuyT zpeLY3qYou05ME2uOm1LFl6AC8FX3uEPq15vaCsbhLiiU+mJO+cMfDnpt/ipD/WerOBP D/X6rSqwa6jxgsScKMHieWuN3LjimCx58uA59SnIUReXgTMqou5/AqNgklf3KWL6GEt2 d3jQU6pNnLTSJZnEzWfdvAlKK0YQd4ghgbkegMYe/0RRH6ggSSxd+zthY/+sa/aUly5E qA/mdXxpyxbir2djks63fITCJhe7PvQTpBWbpZvxU9z95aTzJ/Ey49HWXp6sPaUdlMKN DxXg== X-Forwarded-Encrypted: i=1; AJvYcCUddwxIZhncSK98RVavvGmSbURBu/6PaZp3k8uS09v9uK+0njMqiAHcMBckWCP/fxaLSpS+55dMLsrztJ4=@vger.kernel.org X-Gm-Message-State: AOJu0YwhBU12LbLTYLzR4CVd0n/HCrBzzt3I+CdwH5YSBdy5HkS7v3be Jl+ylv8P4dbNb7x+Iwd+Z+LgrSXG+Cbkn4loJEIYGswaoRPrtH09IiN89WR9PmL9rc7Zz9F2zoN LQXh5nKRGQ7ZEuVHt6XQDPmW1UsEjPnw= X-Gm-Gg: ATEYQzxIba6DX3D98POfBXyhJ0IWKpUhoVsrN0NK2G2is9n65TEOR4OdlXKJhlVsYN2 wWw5bjk1tKq50+KXC1LuKnrUUaI48PRqjQnh9W1Gk+FTCtuH0RToOM9UDUDcQ7IaSKoH0sKcsYI +kaEvaWpgebyK/KgxM+nLDJlBviBiAv7Y8yU2LNa+DBN5imv+PHC0xhLgEiy19coS4jQABpGJb7 9q3O+bUY+07rDoeKozY9b3dujxm/jH4XFUsOYF4eKJvEs2AGLIA/wntoRxzkUM6uvhkeW8D/SjQ xoZNZfq2DhvrfQGWOWUtP949VVUfZWd6hKJVoLSlyArHB/LcXwZh6Mn4/bpqel6WFHgTWAvPF6h Tqfwc X-Received: by 2002:a05:6870:6589:b0:404:15e7:b86c with SMTP id 586e51a60fabf-417b906d0femr494861fac.3.1773351300889; Thu, 12 Mar 2026 14:35:00 -0700 (PDT) Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 From: John S Date: Thu, 12 Mar 2026 22:34:48 +0100 X-Gm-Features: AaiRm519wtUg4oD9zNSZ11uUpzstseJGm2kD5X_fr26rbOp17N0s2he-FTifDv8 Message-ID: Subject: [PATCH] crypto: add missing kernel-doc for anonymous union members To: herbert@gondor.apana.org.au, davem@davemloft.net Cc: linux-crypto@vger.kernel.org, linux-kernel@vger.kernel.org Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" Document the anonymous SKCIPHER_ALG_COMMON and COMP_ALG_COMMON struct members in skcipher_alg, scomp_alg, and acomp_alg, following the existing pattern used by HASH_ALG_COMMON in shash_alg. This fixes the following kernel-doc warnings: include/crypto/skcipher.h:166: struct member 'SKCIPHER_ALG_COMMON' not described in 'skcipher_alg' include/crypto/internal/scompress.h:39: struct member 'COMP_ALG_COMMON' not described in 'scomp_alg' include/crypto/internal/acompress.h:55: struct member 'COMP_ALG_COMMON' not described in 'acomp_alg' Signed-off-by: Kit Dallege --- include/crypto/internal/acompress.h | 1 + include/crypto/internal/scompress.h | 1 + include/crypto/skcipher.h | 1 + 3 files changed, 3 insertions(+) diff --git a/include/crypto/internal/acompress.h b/include/crypto/internal/acompress.h index 9a3f28baa804..9cd37df32dc4 100644 --- a/include/crypto/internal/acompress.h +++ b/include/crypto/internal/acompress.h @@ -42,6 +42,7 @@ * * @base: Common crypto API algorithm data structure * @calg: Cmonn algorithm data structure shared with scomp + * @COMP_ALG_COMMON: see struct comp_alg_common */ struct acomp_alg { int (*compress)(struct acomp_req *req); diff --git a/include/crypto/internal/scompress.h b/include/crypto/internal/scompress.h index 6a2c5f2e90f9..13a0851a995b 100644 --- a/include/crypto/internal/scompress.h +++ b/include/crypto/internal/scompress.h @@ -22,6 +22,7 @@ struct crypto_scomp { * @decompress: Function performs a de-compress operation * @streams: Per-cpu memory for algorithm * @calg: Cmonn algorithm data structure shared with acomp + * @COMP_ALG_COMMON: see struct comp_alg_common */ struct scomp_alg { int (*compress)(struct crypto_scomp *tfm, const u8 *src, diff --git a/include/crypto/skcipher.h b/include/crypto/skcipher.h index 9e5853464345..4efe2ca8c4d1 100644 --- a/include/crypto/skcipher.h +++ b/include/crypto/skcipher.h @@ -145,6 +145,7 @@ struct skcipher_alg_common SKCIPHER_ALG_COMMON; * considerably more efficient if it can operate on multiple chu= nks * in parallel. Should be a multiple of chunksize. * @co: see struct skcipher_alg_common + * @SKCIPHER_ALG_COMMON: see struct skcipher_alg_common * * All fields except @ivsize are mandatory and must be filled. */ -- 2.53.0