From p@i609.hadiko.de  Thu Sep 21 08:11:35 2000
Return-Path: <p@i609.hadiko.de>
Received: from mailgate.rz.uni-karlsruhe.de (mailgate.rz.uni-karlsruhe.de [129.13.64.97])
	by hub.freebsd.org (Postfix) with ESMTP id 4925037B423
	for <FreeBSD-gnats-submit@freebsd.org>; Thu, 21 Sep 2000 08:11:35 -0700 (PDT)
Received: from nce2.hadiko.de (hadince2.hadiko.uni-karlsruhe.de [172.20.32.2])
	by mailgate.rz.uni-karlsruhe.de with esmtp (Exim 3.16 #1)
	id 13c80c-0005l5-00; Thu, 21 Sep 2000 17:11:34 +0200
Received: from i609.hadiko.de (hadii609.hadiko.uni-karlsruhe.de [172.20.44.159])
	by nce2.hadiko.de (8.9.3/8.9.3) with ESMTP id RAA05523
	for <FreeBSD-gnats-submit@freebsd.org>; Thu, 21 Sep 2000 17:11:35 +0200 (MET DST)
Received: (from p@localhost)
	by i609.hadiko.de (8.11.0/8.11.0) id e8LFBWB02617;
	Thu, 21 Sep 2000 17:11:32 +0200 (CEST)
	(envelope-from p)
Message-Id: <200009211511.e8LFBWB02617@i609.hadiko.de>
Date: Thu, 21 Sep 2000 17:11:32 +0200 (CEST)
From: Philipp Mergenthaler <p@i609.hadiko.de>
Reply-To: p@i609.hadiko.de
To: FreeBSD-gnats-submit@freebsd.org
Subject: [PATCH] Release/Sysinstall documentation: mention installing via HTTP proxy
X-Send-Pr-Version: 3.2

>Number:         21451
>Category:       misc
>Synopsis:       [PATCH] Release/Sysinstall documentation: mention installing via HTTP proxy
>Confidential:   no
>Severity:       serious
>Priority:       medium
>Responsible:    murray
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          change-request
>Submitter-Id:   current-users
>Arrival-Date:   Thu Sep 21 08:20:00 PDT 2000
>Closed-Date:    Wed Mar 14 03:09:19 PST 2001
>Last-Modified:  Wed Mar 14 03:10:01 PST 2001
>Originator:     Philipp Mergenthaler
>Release:        FreeBSD 5.0-CURRENT i386
>Organization:
University of Karlsruhe
>Environment:

/usr/src/release/texts/i386/INSTALL.TXT  version 1.13
/usr/src/release/sysinstall/help/media.hlp  version 1.5

>Description:

Neither of these texts mentions installing via an HTTP proxy.

>How-To-Repeat:

	

>Fix:



--- texts/i386/INSTALL.TXT	Thu Sep 21 17:04:36 2000
+++ texts/i386/INSTALL.TXT.new	Thu Sep 21 17:08:59 2000
@@ -338,5 +338,7 @@
 hosts by name rather than IP address, you'll also need a name server
 and possibly the address of a gateway (if you're using PPP, it's your
-provider's IP address) to use in talking to it.
+provider's IP address) to use in talking to it.  If you want to install
+by FTP via an HTTP proxy (see below), you will also need the proxy's
+address.
 
 If you do not know the answers to these questions then you should
@@ -396,5 +398,5 @@
                 ftp://192.216.191.11/pub/FreeBSD
 
-        There are two FTP installation modes you can use:
+        There are three FTP installation modes you can use:
 
            o FTP:
@@ -412,7 +414,19 @@
              incoming connections on random port addresses.
 
-        NOTE: ACTIVE AND PASSIVE MODES ARE NOT THE SAME AS A `PROXY'
-        CONNECTIONS, WHERE A PROXY FTP SERVER IS LISTENING ON A
-        DIFFERENT PORT!
+           o FTP via an HTTP proxy:
+             This option instructs FreeBSD to use HTTP (like a web
+             browser) to connect to a proxy for all FTP operations.
+             The proxy will translate the requests and send them to
+             the FTP server.  This allows the user to pass through
+             firewalls that do not allow FTP at all, but offer an
+             HTTP proxy.
+             In this case, you have to specify the proxy in addition
+             to the FTP server.
+
+
+        NOTE: THERE IS ANOTHER TYPE OF FTP PROXY OTHER THAN HTTP PROXIES.
+        THIS TYPE IS VERY UNCOMMON, THOUGH.  IF YOU ARE NOT ABSOLUTELY
+        CERTAIN, YOU CAN ASSUME THAT YOU HAVE AN HTTP PROXY AS DESCRIBED
+        ABOVE.
 
         In such instances, you should specify the URL as something like:






--- sysinstall/help/media.hlp	Tue Feb  8 10:52:31 2000
+++ sysinstall/help/media.hlp.new	Thu Sep 21 16:29:55 2000
@@ -26,15 +26,18 @@
    FTP      Get the distribution files from an anonymous ftp server
             (you will be presented with a list).  Please note that
-            there are also two ways of invoking FTP in either
-            "Active" and "Passive" mode.
+            there are also three ways of invoking FTP in either
+            "Active" and "Passive" mode or via an HTTP proxy.
 
             Active mode is the standard way of fetching files and
             Passive mode is for use when you're behind a firewall or
             some other security mechanism that blocks active FTP
-            connections.  If you chose "other" in the FTP menu, please
-            also note that all paths are *relative* to the home
-            directory of the user being logged in as.  By default, this
-            is the user "ftp" (anonymous ftp) but you may change this
-            in the Options screen.
+            connections.  Using an HTTP proxy is sometimes necessary
+            for firewalls which block all FTP connections.
+
+            If you chose "other" in the FTP menu, please also note
+            that all paths are *relative* to the home directory of
+            the user being logged in as.  By default, this is the
+            user "ftp" (anonymous ftp) but you may change this in
+            the Options screen.
 
 


>Release-Note:
>Audit-Trail:
Responsible-Changed-From-To: freebsd-bugs->murray 
Responsible-Changed-By: johan 
Responsible-Changed-When: Fri Oct 6 10:28:44 PDT 2000 
Responsible-Changed-Why:  
Over to sysinstall maintainer. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=21451 
State-Changed-From-To: open->closed 
State-Changed-By: murray 
State-Changed-When: Wed Mar 14 03:09:19 PST 2001 
State-Changed-Why:  
Patch committed to -current, thanks! 


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