From modulus@h24-77-20-99.wp.shawcable.net  Thu Jan 22 18:11:08 2004
Return-Path: <modulus@h24-77-20-99.wp.shawcable.net>
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id 6DFEB16A4CE
	for <FreeBSD-gnats-submit@freebsd.org>; Thu, 22 Jan 2004 18:11:08 -0800 (PST)
Received: from h24-77-20-99.wp.shawcable.net (h24-77-20-99.wp.shawcable.net [24.77.20.99])
	by mx1.FreeBSD.org (Postfix) with ESMTP id 4D51443D4C
	for <FreeBSD-gnats-submit@freebsd.org>; Thu, 22 Jan 2004 18:07:05 -0800 (PST)
	(envelope-from modulus@h24-77-20-99.wp.shawcable.net)
Received: from h24-77-20-99.wp.shawcable.net (localhost [127.0.0.1])
	by h24-77-20-99.wp.shawcable.net (8.12.10/8.12.10) with ESMTP id i0N23VfP062498
	for <FreeBSD-gnats-submit@freebsd.org>; Fri, 23 Jan 2004 02:03:32 GMT
	(envelope-from modulus@h24-77-20-99.wp.shawcable.net)
Received: (from root@localhost)
	by h24-77-20-99.wp.shawcable.net (8.12.10/8.12.10/Submit) id i0N23VV9062497;
	Fri, 23 Jan 2004 02:03:31 GMT
	(envelope-from modulus)
Message-Id: <200401230203.i0N23VV9062497@h24-77-20-99.wp.shawcable.net>
Date: Fri, 23 Jan 2004 02:03:31 GMT
From: "Christian S.J. Peron" <maneo@bsdpro.com>
Reply-To: "Christian S.J. Peron" <maneo@bsdpro.com>
To: FreeBSD-gnats-submit@freebsd.org
Cc:
Subject: [patch] Document environment variables from fetch(3) in fetch(1)
X-Send-Pr-Version: 3.113
X-GNATS-Notify:

>Number:         61759
>Category:       docs
>Synopsis:       [patch] Document environment variables from fetch(3) in fetch(1)
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    wes
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          change-request
>Submitter-Id:   current-users
>Arrival-Date:   Thu Jan 22 18:20:00 PST 2004
>Closed-Date:    Tue Feb 17 12:44:18 PST 2004
>Last-Modified:  Tue Feb 17 12:44:18 PST 2004
>Originator:     Christian S.J. Peron
>Release:        FreeBSD 5.2-CURRENT i386
>Organization:
>Environment:
System: FreeBSD movl 5.2-CURRENT FreeBSD 5.2-CURRENT #0: Sun Dec 14 22:05:47 GMT 2003 maneo@movl:/usr/src/sys/i386/compile/ROUTER i386


	
>Description:

Although the environment variables supported by fetch are documented in
fetch(3), it would be more convinient to have them documented in fetch(1),
as this is the place users would expect to see them.

	
>How-To-Repeat:
N/A
	
>Fix:

--- usr.bin/fetch/fetch.1	Fri Jan 23 01:53:34 2004
+++ usr.bin/fetch/fetch.1.newer	Fri Jan 23 01:50:33 2004
@@ -214,20 +214,116 @@
 will attempt to retrieve them each of them in turn, and return zero
 only if they were all successfully retrieved.
 .Sh ENVIRONMENT
-.Bl -tag -width HTTP_TIMEOUT
-.It Ev FTP_TIMEOUT
-maximum time, in seconds, to wait before aborting an
-.Tn FTP
-connection.
-.It Ev HTTP_TIMEOUT
-maximum time, in seconds, to wait before aborting an
-.Tn HTTP
-connection.
+.Bl -tag -width ".Ev FETCH_BIND_ADDRESS"
+.It Ev FETCH_BIND_ADDRESS
+Specifies a hostname or IP address to which sockets used for outgoing
+connections will be bound.
+.It Ev FTP_LOGIN
+Default FTP login if none was provided in the URL.
+.It Ev FTP_PASSIVE_MODE
+If set to anything but
+.Ql no ,
+forces the FTP code to use passive mode.
+.It Ev FTP_PASSWORD
+Default FTP password if the remote server requests one and none was
+provided in the URL.
+.It Ev FTP_PROXY
+URL of the proxy to use for FTP requests.
+The document part is ignored.
+FTP and HTTP proxies are supported; if no scheme is specified, FTP is
+assumed.
+If the proxy is an FTP proxy,
+.Nm fetch
+will send
+.Ql user@host
+as user name to the proxy, where
+.Ql user
+is the real user name, and
+.Ql host
+is the name of the FTP server.
+.Pp
+If this variable is set to an empty string, no proxy will be used for
+FTP requests, even if the
+.Ev HTTP_PROXY
+variable is set.
+.It Ev ftp_proxy
+Same as
+.Ev FTP_PROXY ,
+for compatibility.
+.It Ev HTTP_AUTH
+Specifies HTTP authorization parameters as a colon-separated list of
+items.
+The first and second item are the authorization scheme and realm
+respectively; further items are scheme-dependent.
+Currently, only basic authorization is supported.
+.Pp
+Basic authorization requires two parameters: the user name and
+password, in that order.
+.Pp
+This variable is only used if the server requires authorization and
+no user name or password was specified in the URL.
+.It Ev HTTP_PROXY
+URL of the proxy to use for HTTP requests.
+The document part is ignored.
+Only HTTP proxies are supported for HTTP requests.
+If no port number is specified, the default is 3128.
+.Pp
+Note that this proxy will also be used for FTP documents, unless the
+.Ev FTP_PROXY
+variable is set.
+.It Ev http_proxy
+Same as
+.Ev HTTP_PROXY ,
+for compatibility.
+.It Ev HTTP_PROXY_AUTH
+Specifies authorization parameters for the HTTP proxy in the same
+format as the
+.Ev HTTP_AUTH
+variable.
+.Pp
+This variable is used if and only if connected to an HTTP proxy, and
+is ignored if a user and/or a password were specified in the proxy
+URL.
+.It Ev HTTP_REFERER
+Specifies the referrer URL to use for HTTP requests.
+If set to
+.Dq auto ,
+the document URL will be used as referrer URL.
+.It Ev HTTP_USER_AGENT
+Specifies the User-Agent string to use for HTTP requests.
+This can be useful when working with HTTP origin or proxy servers that
+differentiate between user agents.
+.It Ev NETRC
+Specifies a file to use instead of
+.Pa ~/.netrc
+to look up login names and passwords for FTP sites.
+See
+.Xr ftp 1
+for a description of the file format.
+This feature is experimental.
 .El
+.Sh EXAMPLES
+To access a proxy server on
+.Pa proxy.example.com
+port 8080, set the
+.Ev HTTP_PROXY
+environment variable in a manner similar to this:
+.Pp
+.Dl HTTP_PROXY=http://proxy.example.com:8080
+.Pp
+If the proxy server requires authentication, there are
+two options available for passing the authentication data.
+The first method is by using the proxy URL:
+.Pp
+.Dl HTTP_PROXY=http://<user>:<pwd>@proxy.example.com:8080
 .Pp
-All environment variables mentioned in the documentation for the
-.Xr fetch 3
-library are supported.
+The second method is by using the
+.Ev HTTP_PROXY_AUTH
+environment variable:
+.Bd -literal -offset indent
+HTTP_PROXY=http://proxy.example.com:8080
+HTTP_PROXY_AUTH=basic:*:<user>:<pwd>
+.Ed
 .Sh SEE ALSO
 .Xr fetch 3
 .Sh HISTORY

>Release-Note:
>Audit-Trail:
Responsible-Changed-From-To: freebsd-doc->wes 
Responsible-Changed-By: wes 
Responsible-Changed-When: Thu Jan 22 21:31:06 PST 2004 
Responsible-Changed-Why:  
Fixxored it. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=61759 
State-Changed-From-To: open->feedback 
State-Changed-By: wes 
State-Changed-When: Thu Jan 22 21:31:28 PST 2004 
State-Changed-Why:  
wes         2004/01/22 20:50:48 PST 

FreeBSD src repository 

Modified files: 
usr.bin/fetch        fetch.1  
Log: 
Document fetch(1) environment variables in fetch(1) man page, instead of 
taking lazy users on the arduous journey through SEE ALSO to fetch(3). 

PR:             docs/61759 
Submitted by:   Christian S.J. Peron <maneo@bsdpro.com> 

Revision  Changes    Path 
1.55      +108 -12   src/usr.bin/fetch/fetch.1 


http://www.freebsd.org/cgi/query-pr.cgi?pr=61759 
State-Changed-From-To: feedback->closed 
State-Changed-By: wes 
State-Changed-When: Tue Feb 17 12:43:46 PST 2004 
State-Changed-Why:  
Committed, then changed to more directly refer to the libary man page. 

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