Page MenuHomeFreeBSD

Improve ipfw.8 manual page with more clear layer2 processing documentation
ClosedPublic

Authored by eugen_grosbein.net on Oct 27 2018, 3:16 PM.
Tags
None
Referenced Files
Unknown Object (File)
Nov 4 2024, 8:44 PM
Unknown Object (File)
Nov 4 2024, 8:44 PM
Unknown Object (File)
Nov 4 2024, 8:44 PM
Unknown Object (File)
Nov 4 2024, 8:44 PM
Unknown Object (File)
Nov 4 2024, 8:33 PM
Unknown Object (File)
Oct 16 2024, 5:51 AM
Unknown Object (File)
Sep 23 2024, 5:14 PM
Unknown Object (File)
Sep 23 2024, 5:14 PM
Subscribers

Details

Summary

ipfw(8) has means to filter and/or process (layer3) IP packets and (layer2) link-level frames. Kernel-side part of ipfw has distinct processors for layer2 and layer3 mbufs in the sys/netpfil/ipfw/ip_fw_pfil.c: ipfw_check_frame() and ipfw_check_packet() respectively.

Full set of ipfw actions is implemented within ipfw_check_packet() only and ipfw_check_frame() supports only allow/deny/ngtee/netgraph and dummynet-related actions. This means, for example, that "divert 1 ip from any to any layer2" does not work. This is not documented. This change adds some words on the topic.

Test Plan

N/A

Diff Detail

Repository
rS FreeBSD src repository - subversion
Lint
Lint Not Applicable
Unit
Tests Not Applicable

Event Timeline

yuripv added inline comments.
sbin/ipfw/ipfw.8
516 ↗(On Diff #49686)

The rest of the man page (correctly) uses .Cm for keywords. More so, apropos uses .Nm results outside of SYNOPSIS section as well, so misusing .Nm will clobber the search results.

529 ↗(On Diff #49686)

Please start new sentences from new line.

Use .Cm instead of .Nm for keyword. Begin sentences with new line.

This revision was not accepted when it landed; it landed in state Needs Review.Nov 4 2018, 6:36 AM
This revision was automatically updated to reflect the committed changes.