From nobody Fri Jan 2 19:21:27 2026 X-Original-To: dev-commits-src-all@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id 4djYTM61g6z6M6pq for ; Fri, 02 Jan 2026 19:21:27 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "mxrelay.nyi.freebsd.org", Issuer "R13" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4djYTM45PDz3XXC for ; Fri, 02 Jan 2026 19:21:27 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1767381687; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=qk9xhfCOz4hB3Dz/juBUBrpV2h9afZgjLv+L3D4P69I=; b=xQuP1i4oeS9bRjskd0/FUnb1jzJLaXk/IYyc6Z4Fcj1j4c75DlpJyT0ivKib35a5v7S8Bs 8VNS/ji0jTcO4vG62abTq1dzvRY1mbV2qM7LeH4ySgF/3kNbni++E2sjnDSLfrAXxi9Y/M Oxb/99ocoZYMw6hxv0WsDGHhxpgNllsrPWkIKIdZ7aYe1CQMPaXx21n022E06PWFtyUSVl dhtGQg4jt3fp+QLNKJ6kvSJL+pYq9+h1htdoPYZmxnQdtsEsl5IDzjlOha8POj9OO7wLdQ sEUutaaiDhmqmclYkSDK1SgieCNH/TEil8TtjIAJjg1rdr7xiPqofRJS8aFPkQ== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1767381687; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=qk9xhfCOz4hB3Dz/juBUBrpV2h9afZgjLv+L3D4P69I=; b=SzzrFWC+IWYWZ4DxyHlCQ6vxHx7/IYECZHR8HrNvUDDsd1O8La7kvH7vn8rrgYBMUTUUw9 At0s3uCeSG82fKD8oA+4UsDhpMWhTzNAfiySRJrJibkt2UrYJfMGfCHPkII0xbaaNnZD1b siVCh34cvnFnu0SypyJc+64T5l1tKKuYViSdjhg4zDqfCz8VrxG+BKl0PKxcMQ0XtX0HTO 0HMn677cfaH56ehA2O1QL7TSJ9V8AiYukj5jL/8UGoL/dMZFMgGmxw5T+5nl79Pmto+yii a7SmTOVPRlhKbT5YLCBSjjDVhe3wFoX+gNDAfYtEJN20oVdMnolfCLTpSSOXJw== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1767381687; a=rsa-sha256; cv=none; b=dA872uUc9a25GzMXdljsGZ3xf6nPdGjJsTtf9NWHI8gGY07uGqGObszoVQBsOuiEAXpaBm hWhrypN0ClqtD2MAA2XTIvfZS5l+DausdN+FuMzkNkm9in0dqV7PN1ZhUDtmtcRLbM5YjD n+xB8SNSE8mQon71voq3En2f6h55D+CUrYlgLWIT7xBG2Outi3/hny0UFvZFIbSl4t9NGy 4FIO0xCDEzAiwu2rBRs5ZgPuocVYbnIC0aplGDSuIY7/ZJCeVvrR+yWCgA6goEooWnYaXN SDqSXCZQCYgOwl0M67l2jW3mkX06+vaQBNz8HQ2D/rTn5H1wYLCPbi8q1GwOkQ== ARC-Authentication-Results: i=1; mx1.freebsd.org; none Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) by mxrelay.nyi.freebsd.org (Postfix) with ESMTP id 4djYTM3VJFzWsb for ; Fri, 02 Jan 2026 19:21:27 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from git (uid 1279) (envelope-from git@FreeBSD.org) id 39dc6 by gitrepo.freebsd.org (DragonFly Mail Agent v0.13+ on gitrepo.freebsd.org); Fri, 02 Jan 2026 19:21:27 +0000 To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-branches@FreeBSD.org From: Eugene Grosbein Subject: git: a3559f398824 - stable/14 - ipfw.8: fix documentation bug for setmark List-Id: Commit messages for all branches of the src repository List-Archive: https://lists.freebsd.org/archives/dev-commits-src-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: X-BeenThere: dev-commits-src-all@freebsd.org Sender: owner-dev-commits-src-all@FreeBSD.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: eugen X-Git-Repository: src X-Git-Refname: refs/heads/stable/14 X-Git-Reftype: branch X-Git-Commit: a3559f398824e3e7b7d102f4483610881119ff47 Auto-Submitted: auto-generated Date: Fri, 02 Jan 2026 19:21:27 +0000 Message-Id: <69581ab7.39dc6.4c735259@gitrepo.freebsd.org> The branch stable/14 has been updated by eugen: URL: https://cgit.FreeBSD.org/src/commit/?id=a3559f398824e3e7b7d102f4483610881119ff47 commit a3559f398824e3e7b7d102f4483610881119ff47 Author: Eugene Grosbein AuthorDate: 2025-12-28 17:05:22 +0000 Commit: Eugene Grosbein CommitDate: 2026-01-02 19:20:54 +0000 ipfw.8: fix documentation bug for setmark A mark set with "setmark" keyword is intended to be "sticky" and documented as such but in fact it is not yet, as current implementation lacks "sticky" feature and its implementation will be not MFC'd, most probably. Correct the manual page until the implementation improved. Discussed with: Boris Lytochkin (author) (cherry picked from commit a7b8a5d37bcb0009297962137bfb6c6570e5af12) (cherry picked from commit 9fdf49e8a501047b61a615ab1b4b133159ad76e1) --- sbin/ipfw/ipfw.8 | 8 ++++++-- 1 file changed, 6 insertions(+), 2 deletions(-) diff --git a/sbin/ipfw/ipfw.8 b/sbin/ipfw/ipfw.8 index 94ad9e0958cf..1f0ab5916bd7 100644 --- a/sbin/ipfw/ipfw.8 +++ b/sbin/ipfw/ipfw.8 @@ -796,8 +796,12 @@ When a packet matches a rule with the .Cm setmark keyword, a 32-bit numeric mark is assigned to the packet. The mark is an extension to the tags. -As tags, mark is "sticky" so the value is kept the same within the kernel and -is lost when the packet leaves the kernel. +The mark is preserved for a packet within a single ipfw ruleset traversal +and is lost when the packet is checked against the active ruleset +next time (see +.Sx PACKET FLOW +section) or leaves ipfw context (e.g. accepted, +diverted, bridged or routed). Unlike tags, mark can be matched as a lookup table key or compared with bitwise mask applied against another value. Each packet can have only one mark, so