From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from mail-pf1-f174.google.com (mail-pf1-f174.google.com [209.85.210.174]) (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 5B5AE3314A1 for ; Mon, 15 Dec 2025 09:12:56 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.210.174 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1765789977; cv=none; b=FKOwIgv8YQQQ/m27g2oZSVLeyqyvugCpKi6qjhZRDalvUkSu3vS9UewkWG13dXlzLIqHq6aHjDoJeV7ub9fbGk9EEWOHi9qp65dE8IzC1Dupf8OFTbQoWbH591ADvkrGU2rmm8A+E7PGOsK5V/HgzPPo4KejnBXZ0tcwQXxeAGI= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1765789977; c=relaxed/simple; bh=z6JBVVpYTLKQYsp6P49h+E3D5NtloPxytMIPj3+CkBU=; h=Date:From:To:Cc:Subject:Message-ID:MIME-Version:Content-Type: Content-Disposition; b=lppEqNFUBrnWKUO5KVwJH2BictXu8/xkjsqRpetD3U4gHiWRBLlrkB4imDubqoBHeaSp4pJAzhZATSfudu7CNPyAAaBMhbw58r++x9z9TrCt5hdLKwvOJIPvXGa/JTYJfTd2VugqPv4XYLS8DiGOlbucbZhyBmpWls51md3R2Vc= 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=b7M9KKBg; arc=none smtp.client-ip=209.85.210.174 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="b7M9KKBg" Received: by mail-pf1-f174.google.com with SMTP id d2e1a72fcca58-7b8eff36e3bso4909858b3a.2 for ; Mon, 15 Dec 2025 01:12:56 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1765789976; x=1766394776; darn=vger.kernel.org; h=content-disposition:mime-version:message-id:subject:cc:to:from:date :from:to:cc:subject:date:message-id:reply-to; bh=aR0q5gZgzi5K6sLzSLf9sKZOIrpuIZwxmRjvvPcUdsg=; b=b7M9KKBgGPToQJYsAJamNY5Tg3zjoWQP+14nRP0nZfoT3EYQsrCOJB5K17hHrKTq8J 8MtbNxxB/eJESOHdH2FGml10uLlaNhVzP6EDwC9PF5boNwehHq7x76/sczxjqVOJpT6M MuUwXR81gkD+WATSUqrZvxw9F98rB6i3w+Sz5Vo5AmL8CA4hxNTOwCGrklwLhGLgIcQp +M4JWHr1XWAdyVCB9U4kliRWF/H0QrYfw2p9SW6Z+DmyEbguk5vBGoHdCtz/Mw43BU7t NalA0SX1snXBmr+pVkYZ6695TxQgVJJEoVBYUBzzlItBw+yW+UUI09m0ccw18K66Al4o FpqA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1765789976; x=1766394776; h=content-disposition:mime-version:message-id:subject:cc:to:from:date :x-gm-gg:x-gm-message-state:from:to:cc:subject:date:message-id :reply-to; bh=aR0q5gZgzi5K6sLzSLf9sKZOIrpuIZwxmRjvvPcUdsg=; b=eaOCnuAJkRCOY/hxM5toaLzrK6/G5TmGTkMdct+dGC+1g4jgIR/74jw+AnWoW/NVqM TXqO6Q8VXRSM820lJ21hrYnNDHf285ATujuhdB2KPHPXYNZDNfF3W5GJ7KDrMDw06a0u yz48wId1ONWS1YS9+qXyAzxmo26qEefsUgWqU9Mnnf7eiNEyjolKLTf1eTa4Lk8oYzvF rWYcxGNyjQ7vVJcG7rRdmr81WcRvS5SjfiKuUn/MY44q6HJjKEeIAF7fI3ql5MOLOKV7 EP8kBBP0pUZkv1Y74WK7Sx6me1WFpwt/XdVLHr7FCq4qBk9aULyMGhfSGlwiKwrKRqmP XNSw== X-Forwarded-Encrypted: i=1; AJvYcCWmtNp4lAnO8wbXfyznV+E/sjs9xibnwLobzh4ITMpzJ2QdAyYbIZtPufrAj9h8YRuRVcWnEiJj4CmVfJE=@vger.kernel.org X-Gm-Message-State: AOJu0YyUyQr0h3E4UuRY819yYEJEYmnkeAVUbVRO/kpfO23I5jaYnD+0 wOt76Zufjk3zjzcjQt+6OMs8v6KqoDG79mL1s8SoXoL5wbmkgIVQ3WUK X-Gm-Gg: AY/fxX4wepGkAF74l34JbmyDFnrOCSKtD9nAYG2DDGO7NM2KSasJHOAPPa8tAhfpjfK 9VYQx6U4R0XQ9OJj9mwKpeSOyCM46Bm+u9P7Quj6jRgpWYZdW7BnjdWr3j/UrtrQMj+FlKdHVAb rJs6chGKNdAPvNOBTjUqSkyQ88lFY5ASDQOr/XGXW9Fe8ojsuIQvee1IIyMtb3H5HFO5X7ObQ+9 2lJAxIBWvbcjemOA983mxb5FffeOttqTEHy2tYt62kphlHR3Ww25AB4oqZC9gMzwLhKQLvuhf+6 clJZH7+bjpGimqKuwTfmtEDfOqVztPV37dOBTFhe0ioY5Yb915iW3OjzP1LGMM8dScMn9A7mfyl /dzGF5wfGXtKD/R/uUl5X5Y9KkoOEPRH1vt0Lu4QWjqBthk+r3BzqqDqriqfPYXt63h3NEcd5Ua YQUFb7VKc+BcU= X-Google-Smtp-Source: AGHT+IEo9HFyRxBh3H58peELrcoKXuQEto6liK2jEeLWBCANq6VtutrYLACJVBWT8TeJY4kzXM3I9g== X-Received: by 2002:a05:6a00:339b:b0:7ac:1444:6777 with SMTP id d2e1a72fcca58-7f66744724emr11597719b3a.12.1765789975604; Mon, 15 Dec 2025 01:12:55 -0800 (PST) Received: from archie.me ([210.87.74.117]) by smtp.gmail.com with ESMTPSA id d2e1a72fcca58-7f4bf7be436sm11997902b3a.0.2025.12.15.01.12.54 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 15 Dec 2025 01:12:54 -0800 (PST) Received: by archie.me (Postfix, from userid 1000) id 9F95D41902F7; Mon, 15 Dec 2025 16:12:44 +0700 (WIB) Date: Mon, 15 Dec 2025 16:12:44 +0700 From: Bagas Sanjaya To: Linux Kernel Mailing List , Linux Crypto , Linux Documentation Cc: Randy Dunlap , Herbert Xu , "David S. Miller" , Jonathan Corbet Subject: kernel-doc comment with anonymous variable in anonymous union? Message-ID: Precedence: bulk X-Mailing-List: linux-crypto@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha512; protocol="application/pgp-signature"; boundary="qEoMnYBTe+dXSVaM" Content-Disposition: inline --qEoMnYBTe+dXSVaM Content-Type: text/plain; charset=utf-8 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable Hi, kernel-doc reports warning on include/crypto/skcipher.h: WARNING: ./include/crypto/skcipher.h:166 struct member 'SKCIPHER_ALG_COMMON= ' not described in 'skcipher_alg' skciper_alg struct is defined as: struct skcipher_alg { int (*setkey)(struct crypto_skcipher *tfm, const u8 *key, unsigned int keylen); int (*encrypt)(struct skcipher_request *req); int (*decrypt)(struct skcipher_request *req); int (*export)(struct skcipher_request *req, void *out); int (*import)(struct skcipher_request *req, const void *in); int (*init)(struct crypto_skcipher *tfm); void (*exit)(struct crypto_skcipher *tfm); unsigned int walksize; union { struct SKCIPHER_ALG_COMMON; struct skcipher_alg_common co; }; }; Note the first member in the union, which is an anonymous (i.e. unnamed) va= riable. What can I do on it? Should the offending member be deleted? Thanks. --=20 An old man doll... just what I always wanted! - Clara --qEoMnYBTe+dXSVaM Content-Type: application/pgp-signature; name=signature.asc -----BEGIN PGP SIGNATURE----- iHUEABYKAB0WIQSSYQ6Cy7oyFNCHrUH2uYlJVVFOowUCaT/RDAAKCRD2uYlJVVFO o09iAQCiZd1XPtjXzmtyrrBrzCiDsiuOIlgzXMzu6/NeoJKQdAEAqhyJNLilw7Bb BgN14Sa2taVF0vxRRwQ4frrJyKVVeg4= =ly+T -----END PGP SIGNATURE----- --qEoMnYBTe+dXSVaM--