From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from mail-wm1-f47.google.com (mail-wm1-f47.google.com [209.85.128.47]) (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 E4A3C36F42E for ; Sun, 15 Mar 2026 15:46:31 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.128.47 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1773589593; cv=none; b=ZzWgWKef7hLytV4exxy6P6Z6G/XP5L2mmL1dAhiuDOo3ZcbwwSR4c9/PPemSvdy9PrNoceD/eLZBcXx5hwL1MtXTZ5imaSJJF6goM+QTT1tKu+7tRzMdb6CUwVvkXOyl8XcdjbgQU1d9KavnpYvBcV1ODcwJ8W4belFF07/27Ak= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1773589593; c=relaxed/simple; bh=cHsfQEX6nJtrDQcvkGLpiDB2ls4Eg6ZwQbI/nM5TG70=; h=From:To:Cc:Subject:Date:Message-ID:MIME-Version; b=ciZsvZ5FqIfYBaIheeAYUuHo31jWk2fMgur+5PCaALj7CM74ujzFIaXPfzRP1bSPfXCzQ7OoE5tj0Set+jVuVZ8Qcs8RhH0GYPYvJNiPwGqmjOR5aL3aNbcE//B2NhXlX7pdiG/qBzhVfVPpKApHF7U8zlKW0XKRJhl5gMBReXM= 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=S1Le3zAV; arc=none smtp.client-ip=209.85.128.47 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="S1Le3zAV" Received: by mail-wm1-f47.google.com with SMTP id 5b1f17b1804b1-483487335c2so35890415e9.2 for ; Sun, 15 Mar 2026 08:46:31 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1773589590; x=1774194390; 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=VgZy+Q1L27OWqLYYEqVJekt4sFF+frCP6hIfuOIBpPA=; b=S1Le3zAVfnqrhswZMfa4Xsdq5NR+MTVL9ZPUpks2aU/jkMBv3zzvUAuugOdti/QppP esRpQ32983P+fd4UjCCoYuMVbicek2Cx6h8JGVUQP+DB3vRvGXHKqolEbsxp1ugd0kOc GMRpuW16S1MrHvt2NqFW7DljZpTyxlGm3g2wktTg/P4A9xMJgw93R5eLrZ8I2jwlxIzq HvGHB5/OcLDuERCT0nMY3/0JdnzAOxL9k1uEKOs6PD2MjwkqlR0niCfdWQezwc+PdM/S Kn9teIpYrLereAAnqg6wlYXxJBz1ycPqXSzHwjw622H2NZuKmBIE0vlayCvvw8DKc7YH hRPw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20251104; t=1773589590; x=1774194390; 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=VgZy+Q1L27OWqLYYEqVJekt4sFF+frCP6hIfuOIBpPA=; b=ku9vUPK35c73fr3XWp3G8dk98p/ln6vB62L6B7/fT/O2qSxkpMkDndOEYR7667bDmV Fmz5M9VlUHx0h1SFDtwA5XJjiVP1NiqAyHQb7jBlnm1WVDusCMh6qXg8noJSQ+OpWuli PRT0OGUKyCc2uKpVA1YdyANslqYGGYtRZukgHkfSKKUfrVM1IPg/wpX6tbw+BPQkrn3W 07iXwOrfW0XfVkYXJCWNL+XW8lXCFUjW818T72qxWGnBtyaiirQFOON2KNBSoJDrn2K8 mNSKIJFGgormS01sHAnLxpQW4TIV27EVk61B2AJAwRB9I2MymgB9cR7Is1sriinK/RLQ DMDg== X-Forwarded-Encrypted: i=1; AJvYcCWWFMS1DI2wwvusS6Ep/xJL3TnMtntiwUKWtXk7nAKP+5X97yZDgIa+er/2+1zo3vtHBBPwr9RS06Mp7dg=@vger.kernel.org X-Gm-Message-State: AOJu0YwgVuRxH9bCIoYuPpwsoT9cLTbSRfWLV4iDpzf33Aka6LRTdTdY 7bDUcS/GepEFs6MAjhwR0EgUFxZaMq7ypFPiUL1/G86vm1U3JJKVp4ck X-Gm-Gg: ATEYQzz0T+/gKMXLqZfHIbRy6rwiLJ0TsUHESH3K3/jY5zK+n4ImNXpNZZvrp2z9iwD 2LiJPdzodan7pACfOEJuakczxj/75HSUc4xIbBnPPFGCN26jNvbe2jjoZkCQNl2o1ZL9zUJA0h3 8rGFTO5TjCOXYMMwopUFodvTSV0ScsuANG0s4C+ljOEkhERpID0URLMFkVcDAcMI9Kises7Faec 9fAQ1yfSzGaHKztR2grj53ZfzODGfH4buMk444L1ckQY1PmQrntn4pj4ItduALYxlXVAUWkEdj0 5n/5yeOhcsWJWWsqDyh61AXRN+OmqSeWswrilTWund22UszBs0rkoag+Wpo4nsFSWCDWa2PNImr wi0XhRlyhsfIFdhTkO2WZxOyTcS9CcikC18yVBHxicMQ16ndvEvG5U6f37I3wN5zGlBRkKJW5la ldyyun0ibkW8LdlMSIYLM8PX6IZJ3vgln/lu9k1X+KZ475w3njz3+x/PVrYb+kRClpPCjOSlZN8 hJptx26t8EpSnmCmHfUebdhN9G/6em9hgJniriJ X-Received: by 2002:a05:600c:4753:b0:485:3a93:3aa3 with SMTP id 5b1f17b1804b1-485566d3094mr163674105e9.12.1773589590016; Sun, 15 Mar 2026 08:46:30 -0700 (PDT) Received: from DESKTOP-TILNSD1.localdomain ([139.47.104.103]) by smtp.gmail.com with ESMTPSA id 5b1f17b1804b1-4854b6070acsm312793115e9.8.2026.03.15.08.46.28 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sun, 15 Mar 2026 08:46:29 -0700 (PDT) From: Kit Dallege To: Pablo Neira Ayuso , Florian Westphal Cc: Phil Sutter , netfilter-devel@vger.kernel.org, coreteam@netfilter.org, linux-kernel@vger.kernel.org, Kit Dallege , Claude Subject: [PATCH 2/3] netfilter: add missing kernel-doc parameters for nf_hook() Date: Sun, 15 Mar 2026 16:46:19 +0100 Message-ID: <20260315154619.50964-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 all 8 parameters of nf_hook() that were missing from the kernel-doc comment. Assisted-by: Claude Signed-off-by: Kit Dallege --- include/linux/netfilter.h | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/include/linux/netfilter.h b/include/linux/netfilter.h index efbbfa770d66..a67fa43955bd 100644 --- a/include/linux/netfilter.h +++ b/include/linux/netfilter.h @@ -219,6 +219,14 @@ void nf_hook_slow_list(struct list_head *head, struct nf_hook_state *state, const struct nf_hook_entries *e); /** * nf_hook - call a netfilter hook + * @pf: protocol family (e.g. NFPROTO_IPV4) + * @hook: hook number (e.g. NF_INET_PRE_ROUTING) + * @net: network namespace + * @sk: socket associated with the packet, or NULL + * @skb: socket buffer holding the packet + * @indev: input network device, or NULL + * @outdev: output network device, or NULL + * @okfn: function to call if the hook allows the packet to pass * * Returns 1 if the hook has allowed the packet to pass. The function * okfn must be invoked by the caller in this case. Any other return -- 2.53.0