From nobody Tue Dec 2 02:32:09 2025 Received: from mail-pl1-f178.google.com (mail-pl1-f178.google.com [209.85.214.178]) (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 4146131E0FB for ; Wed, 19 Nov 2025 06:26:12 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.214.178 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1763533575; cv=none; b=suo/XzV5txoJxd6OfoCg86JzTc+xNqHj8NnMkCF8PXhGLBTrbsnqc6SIDLaGh7wJ3fw+CpXaiXCFNDdyH0TWLcH7ynKrqCCpVo7+O5EOGS+wVJw8I+XtGO7nH/fsRTdjUeXs6MWpMEd4ZzI/VQVRzHx++ShXUZxDaYM3L+qUCjQ= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1763533575; c=relaxed/simple; bh=bOG7MFQkS3iZCbR1WAM2BNfX2hMyDdstzBOkhBe3YpA=; h=From:To:Cc:Subject:Date:Message-ID:MIME-Version; b=IsHBy5KZbMZ0d6obyWOm1lPrY76M+c/dOzG/NhieQhDYCT2GolXtQn4tIQ9pc19AV5bL2XqqZ65Pnk6IQz2XINxThn3vdhZbeabGvDhnOa2XNFBQN+NbCIYyzDpgeFJcmew+fviIXRx+gd3GEbHcNj8pIoxL+qO03Zj02e8y2kE= 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=GmD43xjd; arc=none smtp.client-ip=209.85.214.178 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="GmD43xjd" Received: by mail-pl1-f178.google.com with SMTP id d9443c01a7336-29808a9a96aso67965225ad.1 for ; Tue, 18 Nov 2025 22:26:11 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1763533571; x=1764138371; 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=w3uck5SLJDFUscVdZUo0LHnIxtPzwUVM7ArDFS0hzBY=; b=GmD43xjdwe/q5Rqts7NkNlZCL9mQiiTIIdgSv6EJly+6kskPUj3PoALVcf6Edn1bhb uurom4RVvW/c1Dl9+VaITde0d19LzzhcjKuqR9nLUO4Jwo4RDUzpIJPXyP+8tEEpQK6r Nvr/U7CAnpOe64UBsOND4YhRfS3IA09n+0hl3rtj6dKvceX30Yfum4Hg0DNxqr0r3U5r eRoaOF4JgBUEHBnz0ipIyn90GsadKOhLVnKqFTZyjZ5gFo3SyzMg/uN56IzTS2fqOP8E sViWElOwDClg96Ip6uYz8sWa+UUheoAkUMTcqqTtZRXKctt4I64O3YyuXgB/3aZTca9e umtQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1763533571; x=1764138371; 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=w3uck5SLJDFUscVdZUo0LHnIxtPzwUVM7ArDFS0hzBY=; b=J5szEVGN01FVKc5tcfpcDWzqziEO+IWs7pPmo4/buTHNAhz2vXsOk2a+ZiOiokczmH wJUrJ0IX+OSZq/Ay3plqTuseoArnTWQsgbxUzZPPGOnlgWvceHZR2TBKvkKyRXMLAgsG SIa/ELs9gLB0ZkJ7w4B5hJkrrSCfxmRSMKmCnqTHtZPb5o4WXkPrZmZQ9PNGRt1I75PJ iy5v2xVKOcJgmQ82zAyXXnAaP0/xYDksxw9FGnzhkBKbAopHmq2uox93z/NJySwkJbE4 L4f95qAnuJg74PnPUuarRHp+rkhxMr6RwyyyoShr8RtFSLf73k7z9ZUtc4roxkN9ZoeY MMnA== X-Forwarded-Encrypted: i=1; AJvYcCXOPwnhz3TXBHm5KMkJNf3VN0ZAHc23TbQqpjxWmQ15+d9EJQNh6AyTwk/5OqBYCqxgwDQMEPBXVn2DsSM=@vger.kernel.org X-Gm-Message-State: AOJu0YwiddNLjDfKwHCcb6VM608ErTrc7vRJ4FHtpKbii2Wv/CVUz/4W ByYrbyVHoJh/6OxGWRsO+Nvd+agSDFVfl+yLGK0iumMf2J+/A1UsDdWy X-Gm-Gg: ASbGnctZKRqvaLVrh2yKo3fgQ4E4G3Yk2d4eI2uWnzmDX1ph0ljCu8mYjKsdEQvc8pk dsDQLrthKWV7Lkofb6L92j+t5nP+PC43YN6CfoF6IC9q9FsWRQ2nT8PnRgeRRHrWU+PfQ/XCQ1X bXsgL6NKvSXRFKPfOesCTfMNmZkViFQLILGzj+LjCeR0zjKfMXdpqWpXsCCIVQIoBdakXzQqA/T /+vADIH6cIRZqy7XrIneBNEuBX3fl7vUyeXvYfTHZn7Okdl6E8NI0pMLHZX+0VbJ74iNBVtXkJP dZYRQqG1LZT2DOpboH6CkHZRC96ORxD0XcaFR2eX4IGjsM80zOSprq6W4KHmN2H4zAC1scBEW3p /oWpK654hCiry1CLaDzDeom9WKAmQO0hB7wF559fhPPoQ1STMha3BJLfluW3XVufi74B17NueMa Xdb5vJJ/pIFLdkBcgeCOEu/RyfafnehmaDbtSFHvPLvMbcUVfAScx8Xv21PCrHZ+PTmcV8cRx/o z3WWw== X-Google-Smtp-Source: AGHT+IGTgkIGWP9fMJYS46fqWm9eVKlbop6ssm2ZVW3H9bFUJ8EJrgktDkyGqkKhuRWps5cc6VoELg== X-Received: by 2002:a17:903:2c04:b0:295:b7a3:30e6 with SMTP id d9443c01a7336-2986a6d55c0mr232723075ad.18.1763533571305; Tue, 18 Nov 2025 22:26:11 -0800 (PST) Received: from prakrititz-UB.. ([119.161.98.68]) by smtp.gmail.com with ESMTPSA id d9443c01a7336-2985c2376f6sm190992735ad.21.2025.11.18.22.26.04 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 18 Nov 2025 22:26:10 -0800 (PST) From: Nirbhay Sharma To: Alexei Starovoitov , Daniel Borkmann , Andrii Nakryiko Cc: Martin KaFai Lau , Eduard Zingerman , Song Liu , Yonghong Song , John Fastabend , KP Singh , Stanislav Fomichev , Hao Luo , Jiri Olsa , skhan@linuxfoundation.org, david.hunter.linux@gmail.com, linux-kernel-mentees@lists.linuxfoundation.org, bpf@vger.kernel.org, linux-kernel@vger.kernel.org, Nirbhay Sharma Subject: [PATCH] bpf: Document cfi_stubs and owner fields in struct bpf_struct_ops Date: Wed, 19 Nov 2025 11:54:31 +0530 Message-ID: <20251119062430.997648-2-nirbhay.lkd@gmail.com> X-Mailer: git-send-email 2.48.1 Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" Add missing kernel-doc documentation for the cfi_stubs and owner fields in struct bpf_struct_ops to fix the following warnings: Warning: include/linux/bpf.h:1931 struct member 'cfi_stubs' not described in 'bpf_struct_ops' Warning: include/linux/bpf.h:1931 struct member 'owner' not described in 'bpf_struct_ops' The cfi_stubs field was added in commit 2cd3e3772e41 ("x86/cfi,bpf: Fix bpf_struct_ops CFI") to provide CFI stub functions for trampolines, and the owner field is used for module reference counting. Signed-off-by: Nirbhay Sharma --- include/linux/bpf.h | 10 ++++++++-- 1 file changed, 8 insertions(+), 2 deletions(-) diff --git a/include/linux/bpf.h b/include/linux/bpf.h index d808253f2e94..d39b4b2c8f35 100644 --- a/include/linux/bpf.h +++ b/include/linux/bpf.h @@ -1905,10 +1905,16 @@ struct btf_member; * reason, if this callback is not defined, the check is skipped as * the struct_ops map will have final verification performed in * @reg. - * @type: BTF type. - * @value_type: Value type. + * @cfi_stubs: Pointer to a structure of stub functions for CFI. These stu= bs + * provide the correct Control Flow Integrity hashes for the + * trampolines generated by BPF struct_ops. + * @owner: The module that owns this struct_ops. Used for module reference + * counting to ensure the module providing the struct_ops cannot be + * unloaded while in use. * @name: The name of the struct bpf_struct_ops object. * @func_models: Func models + * @type: BTF type. + * @value_type: Value type. * @type_id: BTF type id. * @value_id: BTF value id. */ --=20 2.48.1