From owner-freebsd-bugs@FreeBSD.ORG Wed Sep 2 20:30:09 2009 Return-Path: Delivered-To: freebsd-bugs@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 165371065693 for ; Wed, 2 Sep 2009 20:30:09 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id CCCDB8FC1E for ; Wed, 2 Sep 2009 20:30:08 +0000 (UTC) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.14.3/8.14.3) with ESMTP id n82KU81O018103 for ; Wed, 2 Sep 2009 20:30:08 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.3/8.14.3/Submit) id n82KU8Bc018100; Wed, 2 Sep 2009 20:30:08 GMT (envelope-from gnats) Resent-Date: Wed, 2 Sep 2009 20:30:08 GMT Resent-Message-Id: <200909022030.n82KU8Bc018100@freefall.freebsd.org> Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer) Resent-To: freebsd-bugs@FreeBSD.org Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org, Chris Smowton Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 93F0E1065679 for ; Wed, 2 Sep 2009 20:23:30 +0000 (UTC) (envelope-from nobody@FreeBSD.org) Received: from www.freebsd.org (www.freebsd.org [IPv6:2001:4f8:fff6::21]) by mx1.freebsd.org (Postfix) with ESMTP id 831958FC1B for ; Wed, 2 Sep 2009 20:23:30 +0000 (UTC) Received: from www.freebsd.org (localhost [127.0.0.1]) by www.freebsd.org (8.14.3/8.14.3) with ESMTP id n82KNUHI046151 for ; Wed, 2 Sep 2009 20:23:30 GMT (envelope-from nobody@www.freebsd.org) Received: (from nobody@localhost) by www.freebsd.org (8.14.3/8.14.3/Submit) id n82KNTOX046150; Wed, 2 Sep 2009 20:23:29 GMT (envelope-from nobody) Message-Id: <200909022023.n82KNTOX046150@www.freebsd.org> Date: Wed, 2 Sep 2009 20:23:29 GMT From: Chris Smowton To: freebsd-gnats-submit@FreeBSD.org X-Send-Pr-Version: www-3.1 Cc: Subject: kern/138485: BPF and raw-IP man pages missing important corner cases X-BeenThere: freebsd-bugs@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Bug reports List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 02 Sep 2009 20:30:09 -0000 >Number: 138485 >Category: kern >Synopsis: BPF and raw-IP man pages missing important corner cases >Confidential: no >Severity: non-critical >Priority: medium >Responsible: freebsd-bugs >State: open >Quarter: >Keywords: >Date-Required: >Class: doc-bug >Submitter-Id: current-users >Arrival-Date: Wed Sep 02 20:30:08 UTC 2009 >Closed-Date: >Last-Modified: >Originator: Chris Smowton >Release: Any >Organization: N/A >Environment: N/A >Description: Both the man pages concerning raw-IP and Berkeley Packet Filter are missing details of the following important corner cases: how should the kernel behave when faced with a packet which could be handled by more than one handler? In the raw-IP case, what if there exists a raw-IP socket live on some interface, as well as a TCP socket relevant to an incoming packet? Does the IP or the TCP socket receive that packet, or both? In the BPF case, it's mentioned that the filter program may request to "ignore" a packet, but it isn't specified whether "ignored" packets, non-"ignored" packets or both will then go on to be handled by the kernel's ordinary TCP packet handler. Both of these things can be discovered by experimentation, but it's tedious that every person facing these questions needs to do that when a couple of lines in the docs could save them the trouble. >How-To-Repeat: Read the man pages :) >Fix: Amend the man pages :) >Release-Note: >Audit-Trail: >Unformatted: