docs/172927: ipfw manual page doesn't show simpliest NAT case

[Wojciech A. Koszek]

>Number:         172927
>Category:       docs
>Synopsis:       ipfw manual page doesn't show simpliest NAT case
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          change-request
>Submitter-Id:   current-users
>Arrival-Date:   Sun Oct 21 10:20:00 UTC 2012
>Closed-Date:
>Last-Modified:
>Originator:     Wojciech A. Koszek
>Release:        9.0-BETA3
>Organization:
FreeBSD.org
>Environment:
9.0-BETA3
>Description:
I don't get ipfw(1) manual's:

ipfw add nat 123 all from any to any

What typical user wants is to add NAT (aka "Leeenux masquerade") for 2nd/3rd computer. We show complex cases of NAT usage in EXAMPLES section, but don't show the simple, most popular case:

ipfw nat 123 config ip ADDR log
ipfw add 20 nat 123 ip from any to ADDR
ipfw add 10 nat 123 ip from 10.0.0.0/24 to any

I think this (or similar) should be in a man page ready for copy&paste with no thinking. I had to Google around:

http://linuxconfig.net/manual-howto/ipfw-nat-on-freebsd-7.html


>How-To-Repeat:
man ipfw
/EXAMPLES
>Fix:


>Release-Note:
>Audit-Trail:
>Unformatted: