NetBSD Problem Report #59753

From gharris@sonic.net  Mon Nov 10 18:49:42 2025
Return-Path: <gharris@sonic.net>
Received: from mail.netbsd.org (mail.netbsd.org [199.233.217.200])
	(using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)
	 key-exchange X25519 server-signature RSA-PSS (2048 bits)
	 client-signature RSA-PSS (2048 bits))
	(Client CN "mail.NetBSD.org", Issuer "mail.NetBSD.org CA" (not verified))
	by mollari.NetBSD.org (Postfix) with ESMTPS id 6C7F21A9239
	for <gnats-bugs@gnats.NetBSD.org>; Mon, 10 Nov 2025 18:49:42 +0000 (UTC)
Message-Id: <A9B38CF6-BE46-4C25-92F2-92EF35A126D5@sonic.net>
Date: Mon, 10 Nov 2025 10:39:10 -0800
From: Guy Harris <gharris@sonic.net>
To: "gnats-bugs@netbsd.org" <gnats-bugs@NetBSD.org>
Subject: bpf(4) man page doesn't document BPF_MOD or BPF_XOR

>Number:         59753
>Category:       misc
>Synopsis:       bpf(4) man page doesn't document BPF_MOD or BPF_XOR
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    misc-bug-people
>State:          open
>Class:          doc-bug
>Submitter-Id:   net
>Arrival-Date:   Mon Nov 10 18:50:00 +0000 2025
>Originator:     Guy Harris <gharris@sonic.net>
>Release:        NetBSD 10.1
>Organization:
	none
>Environment:
System: NetBSD netbsd10.local 10.1 NetBSD 10.1 (GENERIC) #0: Mon Dec 16 =
13:08:11 UTC 2024 =
mkrepro@mkrepro.NetBSD.org:/usr/src/sys/arch/amd64/compile/GENERIC amd64
Architecture: x86_64
Machine: amd64
>Description:
	NetBSD added support for the BPF_MOD and BPF_XOR BPF =
instructions many years ago, but didn't update the documentation.

	FreeBSD added it later, and updated the documentation.
>How-To-Repeat:
	man 4 bpf
>Fix:
	Here's a patch to share/man/man4/bpf.4:

Index: share/man/man4/bpf.4
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
RCS file: /cvsroot/src/share/man/man4/bpf.4,v
retrieving revision 1.73
diff -u -r1.73 bpf.4
--- share/man/man4/bpf.4	11 Feb 2023 18:03:25 -0000	1.73
+++ share/man/man4/bpf.4	10 Nov 2025 18:26:58 -0000
@@ -653,16 +653,20 @@
 .It Sy BPF_ALU + BPF_SUB + BPF_K Ta A \[<-] A \- k
 .It Sy BPF_ALU + BPF_MUL + BPF_K Ta A \[<-] A * k
 .It Sy BPF_ALU + BPF_DIV + BPF_K Ta A \[<-] A / k
+.It Sy BPF_ALU + BPF_MOD + BPF_K Ta A \[<-] A % k
 .It Sy BPF_ALU + BPF_AND + BPF_K Ta A \[<-] A & k
 .It Sy BPF_ALU + BPF_OR + BPF_K Ta A \[<-] A | k
+.It Sy BPF_ALU + BPF_XOR + BPF_K Ta A \[<-] A ^ k
 .It Sy BPF_ALU + BPF_LSH + BPF_K Ta A \[<-] A \[<<] k
 .It Sy BPF_ALU + BPF_RSH + BPF_K Ta A \[<-] A \[>>] k
 .It Sy BPF_ALU + BPF_ADD + BPF_X Ta A \[<-] A + X
 .It Sy BPF_ALU + BPF_SUB + BPF_X Ta A \[<-] A \- X
 .It Sy BPF_ALU + BPF_MUL + BPF_X Ta A \[<-] A * X
 .It Sy BPF_ALU + BPF_DIV + BPF_X Ta A \[<-] A / X
+.It Sy BPF_ALU + BPF_MOD + BPF_X Ta A \[<-] A % X
 .It Sy BPF_ALU + BPF_AND + BPF_X Ta A \[<-] A & X
 .It Sy BPF_ALU + BPF_OR + BPF_X Ta A \[<-] A | X
+.It Sy BPF_ALU + BPF_XOR + BPF_X Ta A \[<-] A ^ X
 .It Sy BPF_ALU + BPF_LSH + BPF_X Ta A \[<-] A \[<<] X
 .It Sy BPF_ALU + BPF_RSH + BPF_X Ta A \[<-] A \[>>] X
 .It Sy BPF_ALU + BPF_NEG Ta A \[<-] \-A

Home	PR Database Search