From owner-freebsd-doc@freebsd.org Thu Mar 10 03:47:14 2016 Return-Path: Delivered-To: freebsd-doc@mailman.ysv.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by mailman.ysv.freebsd.org (Postfix) with ESMTP id 3D1F5ACAD0E for ; Thu, 10 Mar 2016 03:47:14 +0000 (UTC) (envelope-from bugzilla-noreply@freebsd.org) Received: from kenobi.freebsd.org (kenobi.freebsd.org [IPv6:2001:1900:2254:206a::16:76]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client did not present a certificate) by mx1.freebsd.org (Postfix) with ESMTPS id 13DABD5B for ; Thu, 10 Mar 2016 03:47:14 +0000 (UTC) (envelope-from bugzilla-noreply@freebsd.org) Received: from bugs.freebsd.org ([127.0.1.118]) by kenobi.freebsd.org (8.15.2/8.15.2) with ESMTP id u2A3lDb7054728 for ; Thu, 10 Mar 2016 03:47:13 GMT (envelope-from bugzilla-noreply@freebsd.org) From: bugzilla-noreply@freebsd.org To: freebsd-doc@FreeBSD.org Subject: [Bug 207866] BPF(4) is out-of-date Date: Thu, 10 Mar 2016 03:47:14 +0000 X-Bugzilla-Reason: AssignedTo X-Bugzilla-Type: new X-Bugzilla-Watch-Reason: None X-Bugzilla-Product: Documentation X-Bugzilla-Component: Documentation X-Bugzilla-Version: Latest X-Bugzilla-Keywords: X-Bugzilla-Severity: Affects Some People X-Bugzilla-Who: guy@alum.mit.edu X-Bugzilla-Status: New X-Bugzilla-Resolution: X-Bugzilla-Priority: --- X-Bugzilla-Assigned-To: freebsd-doc@FreeBSD.org X-Bugzilla-Flags: X-Bugzilla-Changed-Fields: bug_id short_desc product version rep_platform op_sys bug_status bug_severity priority component assigned_to reporter attachments.created Message-ID: Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable X-Bugzilla-URL: https://bugs.freebsd.org/bugzilla/ Auto-Submitted: auto-generated MIME-Version: 1.0 X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.21 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 10 Mar 2016 03:47:14 -0000 https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=3D207866 Bug ID: 207866 Summary: BPF(4) is out-of-date Product: Documentation Version: Latest Hardware: Any OS: Any Status: New Severity: Affects Some People Priority: --- Component: Documentation Assignee: freebsd-doc@FreeBSD.org Reporter: guy@alum.mit.edu Created attachment 167947 --> https://bugs.freebsd.org/bugzilla/attachment.cgi?id=3D167947&action= =3Dedit Patch to fix these issues The BPF(4) man page makes some claims that are no longer true (or never were true), and doesn't fully document some things that are true: It says "A separate device file is required for each minor device.", talking about the old /dev/bpfN devices, even though it speaks of the cloning device earlier. It speaks of particular link-layer types that are supported, mentioning only Ethernet, SLIP, and PPP, but that hasn't been true for quite a while. It says "packet data is in network byte order", but that's only true of some protocols (*very important* protocols, but not *all* protocols). It doesn't give as much detail about BIOCLOCK as the OpenBSD man page. It claims that a read() that doesn't read the full buffer returns EIO rather than EINVAL. It doesn't mention BIOCGDLTLIST, BIOCSDLT, BIOCGRSIG, BIOCSRSIG,=20 It doesn't note that promiscuous mode is on as long as at least one BPF fil= e on which it was turned on is open. It doesn't give the type of the argument to BIOCROTZBUF. It doesn't document all the standard FIO ioctls. It gives the wrong type for the k field in struct bpf_insn. It claims that protocols with variable-length link-layer headers are not supported, which is not true, given that, for example, you can capture on an 802.11 device in monitor mode. There are also some typos, inconsistent use of "set and get" rather than "s= ets and gets", and other things requiring copyediting. --=20 You are receiving this mail because: You are the assignee for the bug.=