From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from mail-wr1-f43.google.com (mail-wr1-f43.google.com [209.85.221.43]) (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 4EFB336B067 for ; Sun, 15 Mar 2026 14:57:35 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.221.43 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1773586657; cv=none; b=FxbpsSSsK2RKlh7Bb6HWgpWMyUEDpPT+2vh09CU7xaMscUXqHH/RR2Z3rqjs84AAaIuP0725UmVdY0xkx2VMrx2y6wyqXugQdPuFUQ1OtTvPw9gfmHPng7s/Pdh7BgrQ5/YB2tb+Baf4IphCrjMwAJ8ALUns993VOW6ARe2E5KE= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1773586657; c=relaxed/simple; bh=bdzgUYp9Hfk5Jhb55dw+Ajj+qPfsDMuNmgtx+Zl5MR8=; h=From:To:Cc:Subject:Date:Message-ID:MIME-Version; b=n3J7fH+LCUZVtdOX6f8jhdY0ChL6QXQchBXwG2m0V41LJxmpDrULXNac/pFjpfRjcfkFRLQ5e9q0ipRzqRjYZeC2bZB5Ow3dmjwpnGjr9Q7rizd7QeGEo/t4z6R+1SbWWZ1L4h2YrMnk+I2REbgBj1+awkWeOmIGrqgAzTnvO1E= ARC-Authentication-Results:i=1; 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=Z0CbEB5e; arc=none smtp.client-ip=209.85.221.43 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="Z0CbEB5e" Received: by mail-wr1-f43.google.com with SMTP id ffacd0b85a97d-43b3cfc38edso960322f8f.3 for ; Sun, 15 Mar 2026 07:57:35 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1773586653; x=1774191453; darn=vger.kernel.org; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from:from:to:cc:subject:date:message-id:reply-to; bh=ctMsamV79lnDxH1eZ0yPc5TbWrVVMUxp8VuhiBWLzMA=; b=Z0CbEB5eIytM5T8sRDOHZzuRT9JztpbGP4iRh4HICIRnUNYOeiAxjjf8PFd2VCIG+W tv3mOX6gD37vpC/V0i5ftpETZIbmwfp6EYN4W0d0Vda+RmVIq2Eawe1MzPOiWm2LP+l5 tIk2fUGWWtf6jk/dWLO4ONItdg4o65g5FDZpNFoQ7eVnvKppf8NK4now4fYISiVate0h WlBXw6PSEL0qL4Wvm6e1MBCh6eGHV5jmIV0g+Hf77Q4OJkcBtYOob9gF1a9soLjuOuOv xLHZzT1ACM/LgpeFUYI8JZDvZtOyWEzRtSLfSrtQoFFJ33evEuI//LketYATncSGL5Z1 Q9Ug== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20251104; t=1773586653; x=1774191453; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from:x-gm-gg:x-gm-message-state:from:to:cc:subject:date :message-id:reply-to; bh=ctMsamV79lnDxH1eZ0yPc5TbWrVVMUxp8VuhiBWLzMA=; b=SuGVsSV6qgj1mAgfXEPcott7k8+v9aYJM2hvZ0Eo9ZAjBNFwbHc6dqszKwn26t3foH lAL+avFlCyv4ZncRQ5IKAMqBpcBXaiNHU/VwHmsS90/b1CyIRvbutOIBcF63e2vzWR90 sE3fNIkwiqMlpNQIgqZ7kTi5QnRNst3j11B+FzyMZfAwZ9k7Slp2EUkS7JjbBWMr/Ibn 0XbccaoVkO7/mOAi17gR3lypLv+OS0bnTvIy71jq5awA+gFmyYaEpRhyD7IBem8liKXJ MzmZaQ5cajDyAaFPtYyntCiGZwMvSWcyc3udYkWm9edo1JheznRNGca3N0Ri7j9f13lF S4SA== X-Forwarded-Encrypted: i=1; AJvYcCUMsH31jk5yyPjKCYXdpoGt9MmMjqIklS/CgAuh9XQJPNDaCe+qnRYvruS0ZVjmKbUsjeuZjCt/utSVHT8=@vger.kernel.org X-Gm-Message-State: AOJu0YyPdstD0O0CojpkK3WmH1ebNBnENCryIjjRU3/Hu05idGBFPq29 9ncvaiNTd4qIOR+5NM6T3nas10+7U0EER/Vu1Mi/2gy/lEUkWbG8Cups X-Gm-Gg: ATEYQzzXLvPCsWHmS+Nj7gBvgI7qFIU3aRcE3IceNn+sB8aYZyCroCSTxop410leKbq zSyTrOjlOeFGeLRZkJWI+F7qahnhDziUESPbcrPnvKsGFpo4m4bICyD9IvcImkjMH/eIMH2Caqd Cly2yC1PKgOBbajFuuSzA5yKJLRyynfqWzINXtzmoAT4tUkVOxREx+EVqwIiCt4V4gYmtixlvoY k0dGNaoLDik7OEYfc750ea8xrkOTf7r53ZBbeCObyEB2ZPb7ZOZ6yKX4HfcLC9xo4naUBECdI2a 2KS5BWZrCXGt21xaLmZognDmqx3HM83maZ8XL60alWlCz3pf5/vo9sEJzwaOwMJFfSWAP6IVhr9 VfvnyofZFgPRFRk29tO0nSTa3l6xOUEK0c10QXjTgw6H0O7sGMI0lBnimSJYTT5EYbzpp5+05t2 xHnxfrHACXYtUwEkCaAp0mNpuQfUgb/GEsOdHlfWOqsPstChUNcFesxsMMsvifC0a1MMjPX3kqq JYg7eEjjjABuBrVn/SisqIMT0Y+jA== X-Received: by 2002:a5d:5e01:0:b0:439:befa:91cb with SMTP id ffacd0b85a97d-43a04dc0958mr17059954f8f.45.1773586653358; Sun, 15 Mar 2026 07:57:33 -0700 (PDT) Received: from DESKTOP-TILNSD1.localdomain ([139.47.104.103]) by smtp.gmail.com with ESMTPSA id ffacd0b85a97d-439fe1a72cdsm36221172f8f.9.2026.03.15.07.57.32 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sun, 15 Mar 2026 07:57:32 -0700 (PDT) From: Kit Dallege To: Herbert Xu , "David S . Miller" Cc: linux-crypto@vger.kernel.org, linux-kernel@vger.kernel.org, Kit Dallege Subject: [PATCH 1/5] crypto: add missing kernel-doc for anonymous union members Date: Sun, 15 Mar 2026 15:57:22 +0100 Message-ID: <20260315145722.24081-1-xaum.io@gmail.com> X-Mailer: git-send-email 2.53.0 Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Transfer-Encoding: 8bit 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 chunks * 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