Bug 138485 - bpf(4) and ip(4) man pages missing important corner cases
Summary: bpf(4) and ip(4) man pages missing important corner cases
Status: Open
Alias: None
Product: Documentation
Classification: Unclassified
Component: Manual Pages (show other bugs)
Version: Latest
Hardware: Any Any
: Normal Affects Only Me
Assignee: freebsd-bugs (Nobody)
Depends on:
Reported: 2009-09-02 21:30 UTC by Chris Smowton
Modified: 2018-04-11 21:05 UTC (History)
1 user (show)

See Also:


Note You need to log in before you can comment on or make changes to this bug.
Description Chris Smowton 2009-09-02 21:30:08 UTC
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.


Amend the man pages :)
How-To-Repeat: Read the man pages :)
Comment 1 Mark Linimon freebsd_committer freebsd_triage 2009-09-02 21:53:27 UTC
Responsible Changed
From-To: freebsd-bugs->freebsd-doc

Comment 2 Eitan Adler freebsd_committer freebsd_triage 2017-12-31 07:59:59 UTC
For bugs matching the following criteria:

Status: In Progress Changed: (is less than) 2014-06-01

Reset to default assignee and clear in-progress tags.

Mail being skipped