From marck@woozle.rinet.ru  Thu Oct 24 11:07:43 2002
Return-Path: <marck@woozle.rinet.ru>
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id 3A56E37B401
	for <FreeBSD-gnats-submit@freebsd.org>; Thu, 24 Oct 2002 11:07:43 -0700 (PDT)
Received: from woozle.rinet.ru (woozle.rinet.ru [195.54.192.68])
	by mx1.FreeBSD.org (Postfix) with ESMTP id 4EB6C43E77
	for <FreeBSD-gnats-submit@freebsd.org>; Thu, 24 Oct 2002 11:07:42 -0700 (PDT)
	(envelope-from marck@woozle.rinet.ru)
Received: from woozle.rinet.ru (localhost [127.0.0.1])
	by woozle.rinet.ru (8.12.5/8.12.5) with ESMTP id g9OI7fTI029999
	for <FreeBSD-gnats-submit@freebsd.org>; Thu, 24 Oct 2002 22:07:41 +0400 (MSD)
	(envelope-from marck@woozle.rinet.ru)
Received: (from marck@localhost)
	by woozle.rinet.ru (8.12.5/8.12.5/Submit) id g9OI7fvf029998;
	Thu, 24 Oct 2002 22:07:41 +0400 (MSD)
Message-Id: <200210241807.g9OI7fvf029998@woozle.rinet.ru>
Date: Thu, 24 Oct 2002 22:07:41 +0400 (MSD)
From: Dmitry Morozovsky <marck@rinet.ru>
Reply-To: Dmitry Morozovsky <marck@rinet.ru>
To: FreeBSD-gnats-submit@freebsd.org
Cc:
Subject: addition to handbook: Using User-level PPP NAT
X-Send-Pr-Version: 3.113
X-GNATS-Notify:

>Number:         44443
>Category:       docs
>Synopsis:       addition to handbook: Using User-level PPP NAT
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    trhodes
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          change-request
>Submitter-Id:   current-users
>Arrival-Date:   Thu Oct 24 11:10:04 PDT 2002
>Closed-Date:    Wed Dec 11 22:22:46 PST 2002
>Last-Modified:  Wed Dec 11 22:22:46 PST 2002
>Originator:     Dmitry Morozovsky
>Release:        FreeBSD 4-STABLE i386
>Organization:
Cronyx Plus LLC (RiNet ISP)
>Environment:
System: FreeBSD 4-STABLE 

>Description:

There is very handy feature of current /usr/sbin/ppp: internal NAT.
It would be useful to say at least a word or two about it in the Handbook.
So, here it is. As I am by no means native speaker ;-) actual wording
should be selected as appropriate; however, I suppose my diff would be
good place to start.

>How-To-Repeat:

N/A.

>Fix:


Index: chapter.sgml
===================================================================
RCS file: /home/ncvs/doc/en_US.ISO8859-1/books/handbook/ppp-and-slip/chapter.sgml,v
retrieving revision 1.93
diff -u -r1.93 chapter.sgml
--- chapter.sgml	13 Oct 2002 15:36:41 -0000	1.93
+++ chapter.sgml	24 Oct 2002 18:02:19 -0000
@@ -1280,6 +1280,33 @@
 	</sect4>
       </sect3>
 
+      <sect3 id="userppp-nat">
+	<title>Using PPP Network Address Translation Capability</title>
+	<indexterm><primary>PPP</primary><secondary>NAT</secondary></indexterm>
+
+	<para>PPP has ability to use internal NAT without kernel diverting
+	  capabilities. This functionality may be enabled by the following 
+	  line in <filename>/etc/ppp/ppp.conf</filename>:</para>
+
+	<programlisting>nat enable yes</programlisting>
+
+	<para>Alternatively, PPP NAT may be enabled by command-line
+	  option <literal>-nat</literal>. There is also 
+	  <filename>/etc/rc.conf</filename> knob named 
+	  <literal>ppp_nat</literal>, which is enabled by default.</para>
+
+	<para>If you use this feature, you may also find useful
+	  the following <filename>/etc/ppp/ppp.conf</filename> options
+	  to enable incoming connections forwarding:</para>
+
+	<programlisting>nat port tcp 10.0.0.2:ftp ftp
+nat port tcp 10.0.0.2:http http</programlisting>
+
+	<para>or don't trust the outside at all</para>
+
+	<programlisting>nat deny_incoming yes</programlisting>
+      </sect3>
+
       <sect3 id="userppp-final">
 	<title>Final System Configuration</title>
 	<indexterm><primary>PPP</primary><secondary>configuration</secondary></indexterm>
>Release-Note:
>Audit-Trail:
Responsible-Changed-From-To: freebsd-doc->trhodes 
Responsible-Changed-By: trhodes 
Responsible-Changed-When: Tue Nov 5 17:21:48 PST 2002 
Responsible-Changed-Why:  
Task list, I've been meaning to work over this entire section. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=44443 
State-Changed-From-To: open->feedback 
State-Changed-By: trhodes 
State-Changed-When: Fri Dec 6 13:04:57 PST 2002 
State-Changed-Why:  
Added, thanks for the submission!  It may take up to 24 hours to appear on 
the website. 

Note: switched to feedback because this entire chapter needs a rework 
job.  But I highly doubt that will happen before 5.0 

http://www.freebsd.org/cgi/query-pr.cgi?pr=44443 
State-Changed-From-To: feedback->closed 
State-Changed-By: trhodes 
State-Changed-When: Wed Dec 11 22:21:50 PST 2002 
State-Changed-Why:  
I do not think we will get the ppp chapter work done.  So close this PR, 
write it on my 'todo' list, and continue.  Thanks alot for the submission! 

http://www.freebsd.org/cgi/query-pr.cgi?pr=44443 
>Unformatted:
