History log of /freebsd-current/usr.bin/fetch/fetch.1
Revision Date Author Comments
# 2821a749 07-Oct-2023 Dag-Erling Smørgrav <des@FreeBSD.org>

libfetch, fetch: Stop recommending the use of ca_root_nss.

MFC after: 3 days
Reviewed by: kevans, emaste
Differential Revision: https://reviews.freebsd.org/D42119


# fa9896e0 16-Aug-2023 Warner Losh <imp@FreeBSD.org>

Remove $FreeBSD$: two-line nroff pattern

Remove /^\.\\"\n\.\\"\s*\$FreeBSD\$$\n/


# 86e149e1 30-Oct-2020 Fernando Apesteguía <fernape@FreeBSD.org>

fetch(1): Fix style

Fix style problems introduced in r367141:

* s/Ql/Pa/ for file names
* Break line properly in macro
* Properly generate back slash character

Not bumping .Dd

Reported by: xtouqh@icloud.com, steffen@sdaoden.eu
Approved by: 0mp@
Differential Revision: https://reviews.freebsd.org/D26946


# 538d212d 29-Oct-2020 Fernando Apesteguía <fernape@FreeBSD.org>

fetch(1): Add EXAMPLES section

Add a few examples covering flags: 1, R, a, o, q, r, s, v

Approved by: manpages (bcr@)
Differential Revision: https://reviews.freebsd.org/D26946


# b24eca8b 06-May-2018 Benjamin Kaduk <bjk@FreeBSD.org>

Fix spelling of --output long option in fetch.1

PR: 228017
Reported by: rff1917@yahoo.com


# 43a623c8 29-Mar-2016 Edward Tomasz Napierala <trasz@FreeBSD.org>

Add phttpget(8) .Xr to fetch(1).

MFC after: 1 month
Sponsored by: The FreeBSD Foundation


# 1ec923fd 19-Mar-2016 Michael Gmelin <grembo@FreeBSD.org>

Update fetch.1 and fetch.3 to reflect libfetch's actual use of CA bundles

Reviewed by: wblock
Approved by: wblock
MFC after: 1 week
Differential Revision: https://reviews.freebsd.org/D5558


# 01ed3ca3 25-Mar-2015 Jung-uk Kim <jkim@FreeBSD.org>

Remove defunct SSLv2 support from fetch(1) and fetch(3).


# 2b7af31c 23-Jun-2014 Baptiste Daroussin <bapt@FreeBSD.org>

use .Mt to mark up email addresses consistently (part3)

PR: 191174
Submitted by: Franco Fichtner <franco at lastsummer.de>


# c2ea176d 28-Jan-2014 Dag-Erling Smørgrav <des@FreeBSD.org>

Increase the default (and minimum) buffer size from 4 kB to 16 kB. Also,
propagate the buffer size to libc, which uses a 1 kB buffer by default,
negating any hypothetical benefit of increasing fetch(1)'s buffer size.

MFC after: 3 days


# 1453595f 30-Jul-2013 Dag-Erling Smørgrav <des@FreeBSD.org>

Include an Accept header in requests.

PR: kern/180917
MFC after: 1 week


# cb67f01d 30-Jul-2013 Dag-Erling Smørgrav <des@FreeBSD.org>

Add Michael Gmelin's name to the copyright statement.


# b5a4266b 28-Jul-2013 Joel Dahl <joel@FreeBSD.org>

Remove EOL whitespace.


# dcd47379 26-Jul-2013 Dag-Erling Smørgrav <des@FreeBSD.org>

Implement certificate verification, and many other SSL-related
imrovements; complete details in the PR.

PR: kern/175514
Submitted by: Michael Gmelin <freebsd@grem.de>
MFC after: 1 week


# 011a8335 21-Jul-2013 Dag-Erling Smørgrav <des@FreeBSD.org>

mdoc nit


# 0ce8603c 26-May-2012 Dag-Erling Smørgrav <des@FreeBSD.org>

Revert r232274 - unauthorized, unnecessary and incorrect.


# 2fccbf04 09-May-2012 Glen Barber <gjb@FreeBSD.org>

General mdoc(7) and typo fixes.

PR: 167696
Submitted by: Nobuyuki Koganemaru (kogane!jp.freebsd.org)
MFC after: 3 days


# 800f9722 28-Feb-2012 David E. O'Brien <obrien@FreeBSD.org>

Document the 'URL' argument.


# b6f6aba3 04-Oct-2011 Dag-Erling Smørgrav <des@FreeBSD.org>

latin1 -> utf8


# bb6e3329 27-Sep-2011 Dag-Erling Smørgrav <des@FreeBSD.org>

Document the fact that passive mode is now the default.
Update copyright dates and strip my middle name.


# a7d5f7eb 19-Oct-2010 Jamie Gritton <jamie@FreeBSD.org>

A new jail(8) with a configuration file, to replace the work currently done
by /etc/rc.d/jail.


# fe0506d7 09-Mar-2010 Marcel Moolenaar <marcel@FreeBSD.org>

Create the altix project branch. The altix project will add support
for the SGI Altix 350 to FreeBSD/ia64. The hardware used for porting
is a two-module system, consisting of a base compute module and a
CPU expansion module. SGI's NUMAFlex architecture can be an excellent
platform to test CPU affinity and NUMA-aware features in FreeBSD.


# 7f92799f 15-Dec-2008 Murray Stokely <murray@FreeBSD.org>

Add support for HTTP 1.1 If-Modified-Since behavior.

fetch(1) accepts a new argument -i <file> that if specified will cause
the file to be downloaded only if it is more recent than the mtime of
<file>.

libfetch(3) accepts the mtime in the url structure and a flag to
indicate when this behavior is desired.

PR: bin/87841
Submitted by: Jukka A. Ukkonen <jau@iki.fi> (partially)
Reviewed by: des, ru
MFC after: 3 weeks


# e801aa48 13-Dec-2008 Ruslan Ermilov <ru@FreeBSD.org>

Improve usage and sync SYNOPSIS with usage.


# d7f03759 19-Oct-2008 Ulf Lilleengen <lulf@FreeBSD.org>

- Import the HEAD csup code which is the basis for the cvsmode work.


# 0fc781ff 28-Dec-2007 Dag-Erling Smørgrav <des@FreeBSD.org>

List all environment variables supported by libfetch, along with a reference
to the fetch(3) man page.

MFC after: 1 week


# ee8e4b36 21-Apr-2006 Joseph Koshy <jkoshy@FreeBSD.org>

Fix a typo.

Submitted by: Pawel Worach <pawel.worach at gmail dot com>
MFC after: 1 week


# 0227791b 13-Feb-2005 Ruslan Ermilov <ru@FreeBSD.org>

Expand *n't contractions.


# 6c7216df 18-Jan-2005 Ruslan Ermilov <ru@FreeBSD.org>

Sort sections.


# a866e170 17-Jan-2005 Ruslan Ermilov <ru@FreeBSD.org>

Added the EXIT STATUS section where appropriate.


# 2cbbf9da 21-Sep-2004 Dag-Erling Smørgrav <des@FreeBSD.org>

Update copyright years.


# fe6a0485 30-Jul-2004 Colin Percival <cperciva@FreeBSD.org>

Document the behaviour of the "-o file" option when "file" is a directory
(downloaded file(s) are created inside the directory).

MFC after: 3 days


# 4bdd89ba 19-May-2004 Ruslan Ermilov <ru@FreeBSD.org>

Restore part of the word that got (accidentally) removed.
Removed whitespace at EOL.


# ac9fd74e 27-Feb-2004 Dag-Erling Smørgrav <des@FreeBSD.org>

Remove EXAMPLES section which duplicates text in fetch(3).


# fbcf5e65 28-Jan-2004 Wes Peters <wes@FreeBSD.org>

Remove the inadvertant HTML additions to this man page.
These appear to have been inserted in the PR text by gnatsweb.

Noticed by: des (maintainer)


# 09d2d42e 26-Jan-2004 Wes Peters <wes@FreeBSD.org>

Revert changes of rev 1.55; replace with strong encouragement to
read fetch(3) as well.

Requested by: des (maintainer)


# 90ffd7ea 26-Jan-2004 Dag-Erling Smørgrav <des@FreeBSD.org>

Previous commit did the reverse of what the log message said (and of
what I intended to do). Really remove my middle name.


# 09e06539 25-Jan-2004 Dag-Erling Smørgrav <des@FreeBSD.org>

I don't normally use my middle name, so remove it from attributions in
man pages (though not from copyright notices). While I'm here, add email
addresses where appropriate.


# cec5287b 22-Jan-2004 Wes Peters <wes@FreeBSD.org>

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>


# 6ce729e1 08-Sep-2003 Ruslan Ermilov <ru@FreeBSD.org>

Finish the reversion of rev. 1.52.


# fa676bbf 10-Jun-2003 Tom Rhodes <trhodes@FreeBSD.org>

Revert 1.52. This should have been added to fetch.3.

Discussed with: des, ru


# ac6bad09 17-May-2003 Tom Rhodes <trhodes@FreeBSD.org>

Add an EXAMPLES section.
Xref sh(1) as we use environment variables.

PR: 43899
Reviewed by: des


# 1bbb80b6 11-Mar-2003 Dag-Erling Smørgrav <des@FreeBSD.org>

Clarify that -r implies -R.


# ace5be68 24-Feb-2003 Ruslan Ermilov <ru@FreeBSD.org>

mdoc(7) police: Scheduled sweep.


# 7dcb0a0e 22-Jan-2003 Dag-Erling Smørgrav <des@FreeBSD.org>

Document netrc support.


# 3898680c 19-Apr-2002 Philippe Charnier <charnier@FreeBSD.org>

Use `The .Nm utility'


# ab47d799 16-Jan-2002 Ruslan Ermilov <ru@FreeBSD.org>

Document fetch(1) reaction to SIGINFO.

PR: docs/33640
Submitted by: Maxim Konovalov <maxim@macomnet.ru>
Approved by: des


# f247324d 15-Jul-2001 Dima Dorfman <dd@FreeBSD.org>

Remove whitespace at EOL.


# 7c480c6c 23-Mar-2001 Dag-Erling Smørgrav <des@FreeBSD.org>

Now that libfetch uses the high port range by default, add a -U option to
make it use the low (default) port range instead.


# 150fb21b 06-Mar-2001 Dag-Erling Smørgrav <des@FreeBSD.org>

Fix a formatting bug (MFC candidate)


# d0353b83 01-Feb-2001 Ruslan Ermilov <ru@FreeBSD.org>

mdoc(7) police: split punctuation characters + misc fixes.


# f4d874a1 22-Nov-2000 Ruslan Ermilov <ru@FreeBSD.org>

mdoc(7) police: do not split author names in the AUTHORS section.


# b82f5db0 14-Nov-2000 Ruslan Ermilov <ru@FreeBSD.org>

Spell the des's name correctly.


# cf575052 18-Jul-2000 Ben Smithurst <ben@FreeBSD.org>

* Remove description of obsolete -t option.
* Insert newline before "and" in ".Fl c and".

Approved by: des


# 38a616e4 17-Jul-2000 Dag-Erling Smørgrav <des@FreeBSD.org>

The description of the semantics of -v and -q has long since been OBE.


# c0b0d54e 17-Jul-2000 Dag-Erling Smørgrav <des@FreeBSD.org>

Document the fact that -r and -m are mutually exclusive.


# 0b474bc6 08-Jul-2000 Dag-Erling Smørgrav <des@FreeBSD.org>

Clarify the meaning of -m and -n (thanks to bde).


# 114c3c1a 04-Jul-2000 Dag-Erling Smørgrav <des@FreeBSD.org>

Add MIT copyright


# 047843dd 29-Jun-2000 Dag-Erling Smørgrav <des@FreeBSD.org>

Note that the -h, -c and -f options are deprecated, and remove note that
incorrectly stated that they were not implemented.
Document the -d option.


# b39628e7 28-Jun-2000 Dag-Erling Smørgrav <des@FreeBSD.org>

New libfetch-based fetch.


# 87faa07b 29-Feb-2000 Sheldon Hearn <sheldonh@FreeBSD.org>

Remove single-space hard sentence breaks. These degrade the quality
of the typeset output, tend to make diffs harder to read and provide
bad examples for new-comers to mdoc.


# d6a8296a 23-Oct-1999 Brian Feldman <green@FreeBSD.org>

Add the -F option. This is for forcing restarts with -r by inhibiting
transmission of the If-Range HTTP header field.


# c3aac50f 27-Aug-1999 Peter Wemm <peter@FreeBSD.org>

$Id$ -> $FreeBSD$


# 90331af0 02-Jul-1999 Brian Feldman <green@FreeBSD.org>

"transfered" -> "transferred"

Reviewed by: dict(1)


# 189da044 23-Feb-1999 Garrett Wollman <wollman@FreeBSD.org>

Deal with broken Web sites which return 302 responses rather than 404
and an error document when the requested resource does not exist. Grrr.

Requested by: asami


# 054672c7 03-Feb-1999 Bill Fenner <fenner@FreeBSD.org>

Warn about collapsing multiple slashes into 1 in ftp URL's.
Look at the FTP_PASSIVE_MODE environment variable like the man page says.

PR: bin/9464
Submitted by: John A. Shue <John.Shue@symmetron.com>

Add references to RFC's 1790, 959, 850.

PR: doc/6564


# c1468430 15-Jan-1999 Garrett Wollman <wollman@FreeBSD.org>

For RFC 850 dates received in HTTP responses, implement the century pivot
described in RFC 2068. Include a reference to same in the manual page.


# b451f452 08-Dec-1998 Martin Cracauer <cracauer@FreeBSD.org>

Add -s option, just report size of file that would be fetched.
Reviewed by: -current list


# 9f63f2aa 08-Nov-1998 Dag-Erling Smørgrav <des@FreeBSD.org>

main.c:
Fix usage string. Fix getopt() string. Fix ordering of compatibility options.
fetch.1:
Fix synopsis. Fix ordering of T and t options. Fix minor grammar nit.


# 0637c2cc 19-Sep-1998 Jordan K. Hubbard <jkh@FreeBSD.org>

Add -S flag; this is benign since fetch's behavior is unchanged if you
don't use it. That's why I'm bringing it in during our "code slush"
Submitted by: Stefan Esser <se@mi.uni-koeln.de>


# cffe96c9 09-May-1998 Garrett Wollman <wollman@FreeBSD.org>

Fix my last change: the .Fx macro doesn't do anything useful without an
argument, so use `.Tn FreeBSD' instead.


# eeed58d8 09-May-1998 Garrett Wollman <wollman@FreeBSD.org>

Documentation fix: delete references to T/TCP as they are not relevant
to the case in question. (Said case being quite clearly defined by
the basic TCP specification, RFC 792.)


# 5e922007 09-May-1998 Bill Fenner <fenner@FreeBSD.org>

Describe absolute paths in FTP URL's. This patch has been sitting
around uncommitted for 2 months =(


# 306005e7 23-Mar-1998 Philippe Charnier <charnier@FreeBSD.org>

.Sh AUTHOR -> .Sh AUTHORS. Use .An/.Aq.


# f4e4504f 05-Aug-1997 Andrey A. Chernov <ache@FreeBSD.org>

Add -t option which turns T/TCP off as workaround for some broken servers
Submitted by: Marc Slemko <marcs@znep.com>


# 0c8cc99e 25-Jul-1997 Garrett Wollman <wollman@FreeBSD.org>

Provide a new `-b' flag to work around some broken HTTP/TCP implementations
that can't deal with a half-closed connection.


# 8a2f8e39 05-Mar-1997 Bill Fenner <fenner@FreeBSD.org>

Fix FTP_PROXY to use user@host[@port] for FTP proxy and eliminate
undocumented FTP_PROXY_USER
Make FTP file errors contian hostname and path.
Pass the FTP port to libftp.
Partially un-HTMLify error messages returned from server
Handle "HTTP NNN" instead of "HTTP/V.vv NNN" response sent by
pre-HTTP/1.0 servers

Reviewed by: wollman


# bc5d5816 22-Feb-1997 Wolfram Schneider <wosch@FreeBSD.org>

These man page will appear in 2.2, not 3.0.


# c115df18 22-Feb-1997 Peter Wemm <peter@FreeBSD.org>

Revert $FreeBSD$ to $Id$


# 76dafb89 05-Feb-1997 Garrett Wollman <wollman@FreeBSD.org>

Some bug-fixes, clean-ups, and one new feature:

- Fix the bug with URIs of the form ftp://host/filename.
- Fix some more string-termination bugs in util.c.
- Use safe_malloc() rather than testing the return value of
regular malloc() in 15 places.
- Implement HTTP authentication, for both servers and proxies.
Currently only ``basic'' authentication is supported; This Is A Bug
(but less of one tjhan nmot supporting any authentication).

I think there is only one more feature which is required for full
HTTP/1.1 support, which is Transfer-Encoding: chunked; this should
not be toohard, but it isn't very important, either.


# 2494e810 31-Jan-1997 Garrett Wollman <wollman@FreeBSD.org>

Some fixes for HTTP:

1) Implement redirects (or try to, at least).
2) Implement automatic retry after 503 errors when Retry-After is given.
3) Implement a -a flag to enable both of these behaviors.
4) Recognize Transfer-Encoding headers and emit a warning that the file
is likely to be damaged.
5) Bug fix: only write the amount of data we read.
6) Actually document some of these.
7) Fix the usage message to display flags in semi-alphabetical order.


# 78be3199 30-Jan-1997 Garrett Wollman <wollman@FreeBSD.org>

Here is my long-threatened revamping of fetch. Jean-Marc probably won't
recognize it any more. This makes the following significant changes:

- The main body of the program doesn't know a thing about URIs,
HTTP, or FTP. This makes it possible to easily plug in other
protocols. (The next revision will probably be able to dynamically
add new recognizers.)

- There are no longer arbitrary timeouts for the protocols. If you want
to set one for yourself, use the environment variables.

- FTP proxies are now supported (if I implemented it right).

- The HTTP implementation is much more complete, and can now do restarts,
preserve modtimes, and mrun in mirror mode. It's not yet up to 1.1,
but it's getting there.

- Transaction TCP is now used for sending HTTP requests. The HTTP/1.1 syntax
for requesting that the connection be closed after one request is
implemented.

In all of this, I have doubtless broken somebody. Please test it and tell me
about the bugs.


# da1ff3cb 15-Jan-1997 Wolfram Schneider <wosch@FreeBSD.org>

Sort cross references.


# 1130b656 14-Jan-1997 Jordan K. Hubbard <jkh@FreeBSD.org>

Make the long-awaited change from $Id$ to $FreeBSD$

This will make a number of things easier in the future, as well as (finally!)
avoiding the Id-smashing problem which has plagued developers for so long.

Boy, I'm glad we're not using sup anymore. This update would have been
insane otherwise.


# e0e5145c 23-Sep-1996 Wolfram Schneider <wosch@FreeBSD.org>

add missing comma(s) in .Xr macros


# a43a248c 19-Sep-1996 Peter Wemm <peter@FreeBSD.org>

Attempt to untangle the timeout code a bit, also make the default ftp
and http timeouts the same, since when using a http proxy to do ftp
transfers, the http timeout was being used for what is coming in via
ftp.


# 7ae26f14 31-Aug-1996 Jordan K. Hubbard <jkh@FreeBSD.org>

Allow proper ftp verbosity with a new -v flag.


# 85cf659a 22-Aug-1996 Mike Pritchard <mpp@FreeBSD.org>

Use the .Fx macro where appropriate.


# fc6fcbf9 22-Aug-1996 Jordan K. Hubbard <jkh@FreeBSD.org>

1. Understand file:/path style URLs.
2. Add a -l flag for symlinking to rather than copying file:/path style URLs.
3. Add a -T flag for setting the timeout interval (overrides FTP_TIMEOUT if set)


# 477a3f54 14-Aug-1996 Jordan K. Hubbard <jkh@FreeBSD.org>

Add support for HTTP proxies, fix some bugs with http transfers.
Submitted-By: Mikael Hybsch <micke@dynas.se>


# 6b5c2db2 17-Jul-1996 Jordan K. Hubbard <jkh@FreeBSD.org>

Add -n flag to use the current modtime rather than preserving it.


# 7fefc698 04-Jul-1996 Jordan K. Hubbard <jkh@FreeBSD.org>

New man page for fetch(1).
Submitted by: jmz (with some small tweaks)


# 5e5a2c7f 19-Jun-1996 Satoshi Asami <asami@FreeBSD.org>

Jean-Marc's url fetch program, with Josh MacDonald's patches and
Jordan's ftpio library.

Submitted by: jmz, jkh, jmacd (three-j!)