[pkgsrc/trunk]: pkgsrc/net/fetch Add fetch-1.0 from FreeBSD, the frontend for...

[joerg <joerg%pkgsrc.org@localhost>]

details:   https://anonhg.NetBSD.org/pkgsrc/rev/650ad39c0703
branches:  trunk
changeset: 548088:650ad39c0703
user:      joerg <joerg%pkgsrc.org@localhost>
date:      Wed Oct 08 15:28:30 2008 +0000

description:
Add fetch-1.0 from FreeBSD, the frontend for libfetch(3).

diffstat:

 net/fetch/DESCR            |     3 +
 net/fetch/Makefile         |    28 +
 net/fetch/PLIST            |     4 +
 net/fetch/files/Makefile   |    14 +
 net/fetch/files/fetch.1    |   275 +++++++++++
 net/fetch/files/fetch.c    |  1016 ++++++++++++++++++++++++++++++++++++++++++++
 net/fetch/files/fetch.cat1 |   153 ++++++
 net/fetch/options.mk       |    15 +
 8 files changed, 1508 insertions(+), 0 deletions(-)

diffs (truncated from 1540 to 300 lines):

diff -r cbf8b84bae70 -r 650ad39c0703 net/fetch/DESCR
--- /dev/null   Thu Jan 01 00:00:00 1970 +0000
+++ b/net/fetch/DESCR   Wed Oct 08 15:28:30 2008 +0000
@@ -0,0 +1,3 @@
+fetch is a command line for transferring files with URL syntax.
+Supported schemas are FTP, HTTP, HTTPS and FILE.  It includes Advanced
+features like proxy connections and restarting of interrupted transfers.
diff -r cbf8b84bae70 -r 650ad39c0703 net/fetch/Makefile
--- /dev/null   Thu Jan 01 00:00:00 1970 +0000
+++ b/net/fetch/Makefile        Wed Oct 08 15:28:30 2008 +0000
@@ -0,0 +1,28 @@
+# $NetBSD: Makefile,v 1.1.1.1 2008/10/08 15:28:30 joerg Exp $
+#
+
+DISTNAME=      fetch-1.0
+CATEGORIES=    net
+MASTER_SITES=  # empty
+DISTFILES=     # empty
+
+MAINTAINER=    joerg%NetBSD.org@localhost
+HOMEPAGE=      http://www.FreeBSD.org/
+COMMENT=       Client to fetch URLs
+#LICENSE=      modified-bsd
+
+PKG_DESTDIR_SUPPORT=   user-destdir
+
+USE_FEATURES=          nbcompat
+
+USE_BSD_MAKEFILE=      yes
+
+INSTALLATION_DIRS=     bin ${PKGMANDIR}/cat1 ${PKGMANDIR}/man1
+
+do-extract:
+       ${CP} -r ${FILESDIR} ${WRKSRC}
+
+.include "options.mk"
+
+.include "../../net/libfetch/buildlink3.mk"
+.include "../../mk/bsd.pkg.mk"
diff -r cbf8b84bae70 -r 650ad39c0703 net/fetch/PLIST
--- /dev/null   Thu Jan 01 00:00:00 1970 +0000
+++ b/net/fetch/PLIST   Wed Oct 08 15:28:30 2008 +0000
@@ -0,0 +1,4 @@
+@comment $NetBSD: PLIST,v 1.1.1.1 2008/10/08 15:28:30 joerg Exp $
+bin/fetch
+man/cat1/fetch.0
+man/man1/fetch.1
diff -r cbf8b84bae70 -r 650ad39c0703 net/fetch/files/Makefile
--- /dev/null   Thu Jan 01 00:00:00 1970 +0000
+++ b/net/fetch/files/Makefile  Wed Oct 08 15:28:30 2008 +0000
@@ -0,0 +1,14 @@
+# $FreeBSD$
+
+.include <bsd.own.mk>
+
+PROG=          fetch
+LDADD=         -lfetch
+
+FETCH_WITH_OPENSSL?=   no
+
+.if ${FETCH_WITH_OPENSSL} != "no"
+LDADD+=                -lssl -lcrypto
+.endif
+
+.include <bsd.prog.mk>
diff -r cbf8b84bae70 -r 650ad39c0703 net/fetch/files/fetch.1
--- /dev/null   Thu Jan 01 00:00:00 1970 +0000
+++ b/net/fetch/files/fetch.1   Wed Oct 08 15:28:30 2008 +0000
@@ -0,0 +1,275 @@
+.\"-
+.\" Copyright (c) 2000-2004 Dag-Erling Coïdan Smørgrav
+.\" All rights reserved.
+.\" Portions Copyright (c) 1999 Massachusetts Institute of Technology; used
+.\" by permission.
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\"    notice, this list of conditions and the following disclaimer
+.\"    in this position and unchanged.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\"    notice, this list of conditions and the following disclaimer in the
+.\"    documentation and/or other materials provided with the distribution.
+.\" 3. The name of the author may not be used to endorse or promote products
+.\"    derived from this software without specific prior written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
+.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
+.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
+.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
+.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
+.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
+.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+.\"
+.\" $FreeBSD$
+.\"
+.Dd March 11, 2003
+.Dt FETCH 1
+.Os
+.Sh NAME
+.Nm fetch
+.Nd retrieve a file by Uniform Resource Locator
+.Sh SYNOPSIS
+.Nm
+.Op Fl 146AFMRUadlmnqrsv
+.Op Fl B Ar bytes
+.Op Fl S Ar bytes
+.Op Fl T Ar seconds
+.Op Fl N Ar file
+.Op Fl o Ar file
+.Op Fl w Ar seconds
+.Op Fl h Ar host
+.Op Fl c Ar dir
+.Op Fl f Ar file
+.Op Ar URL ...
+.Sh DESCRIPTION
+The
+.Nm
+utility provides a command-line interface to the
+.Xr fetch 3
+library.
+Its purpose is to retrieve the file(s) pointed to by the URL(s) on the
+command line.
+.Pp
+The following options are available:
+.Bl -tag -width Fl
+.It Fl \&1
+Stop and return exit code 0 at the first successfully retrieved file.
+.It Fl 4
+Forces
+.Nm
+to use IPv4 addresses only.
+.It Fl 6
+Forces
+.Nm
+to use IPv6 addresses only.
+.It Fl A
+Do not automatically follow ``temporary'' (302) redirects.
+Some broken Web sites will return a redirect instead of a not-found
+error when the requested object does not exist.
+.It Fl a
+Automatically retry the transfer upon soft failures.
+.It Fl B Ar bytes
+Specify the read buffer size in bytes.
+The default is 4096 bytes.
+Attempts to set a buffer size lower than this will be silently
+ignored.
+The number of reads actually performed is reported at verbosity level
+two or higher (see the
+.Fl v
+flag).
+.It Fl c Ar dir
+The file to retrieve is in directory
+.Ar dir
+on the remote host.
+This option is deprecated and is provided for backward compatibility
+only.
+.It Fl d
+Use a direct connection even if a proxy is configured.
+.It Fl F
+In combination with the
+.Fl r
+flag, forces a restart even if the local and remote files have
+different modification times.
+Implies
+.Fl R .
+.It Fl f Ar file
+The file to retrieve is named
+.Ar file
+on the remote host.
+This option is deprecated and is provided for backward compatibility
+only.
+.It Fl h Ar host
+The file to retrieve is located on the host
+.Ar host .
+This option is deprecated and is provided for backward compatibility
+only.
+.It Fl l
+If the target is a file-scheme URL, make a symbolic link to the target
+rather than trying to copy it.
+.It Fl M
+.It Fl m
+Mirror mode: if the file already exists locally and has the same size
+and modification time as the remote file, it will not be fetched.
+Note that the
+.Fl m
+and
+.Fl r
+flags are mutually exclusive.
+.It Fl N Ar file
+Use
+.Ar file
+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.
+.It Fl n
+Do not preserve the modification time of the transferred file.
+.It Fl o Ar file
+Set the output file name to
+.Ar file .
+By default, a ``pathname'' is extracted from the specified URI, and
+its basename is used as the name of the output file.
+A
+.Ar file
+argument of
+.Sq Li \&-
+indicates that results are to be directed to the standard output.
+If the
+.Ar file
+argument is a directory, fetched file(s) will be placed within the
+directory, with name(s) selected as in the default behaviour.
+.It Fl q
+Quiet mode.
+.It Fl R
+The output files are precious, and should not be deleted under any
+circumstances, even if the transfer failed or was incomplete.
+.It Fl r
+Restart a previously interrupted transfer.
+Note that the
+.Fl m
+and
+.Fl r
+flags are mutually exclusive.
+.It Fl S Ar bytes
+Require the file size reported by the server to match the specified
+value.
+If it does not, a message is printed and the file is not fetched.
+If the server does not support reporting file sizes, this option is
+ignored and the file is fetched unconditionally.
+.It Fl s
+Print the size in bytes of each requested file, without fetching it.
+.It Fl T Ar seconds
+Set timeout value to
+.Ar seconds .
+Overrides the environment variables
+.Ev FTP_TIMEOUT
+for FTP transfers or
+.Ev HTTP_TIMEOUT
+for HTTP transfers if set.
+.It Fl U
+When using passive FTP, allocate the port for the data connection from
+the low (default) port range.
+See
+.Xr ip 4
+for details on how to specify which port range this corresponds to.
+.It Fl v
+Increase verbosity level.
+.It Fl w Ar seconds
+When the
+.Fl a
+flag is specified, wait this many seconds between successive retries.
+.El
+.Pp
+If
+.Nm
+receives a
+.Dv SIGINFO
+signal (see the
+.Cm status
+argument for
+.Xr stty 1 ) ,
+the current transfer rate statistics will be written to the
+standard error output, in the same format as the standard completion
+message.
+.Sh ENVIRONMENT
+.Bl -tag -width HTTP_TIMEOUT
+.It Ev FTP_TIMEOUT
+Maximum time, in seconds, to wait before aborting an FTP connection.
+.It Ev HTTP_TIMEOUT
+Maximum time, in seconds, to wait before aborting an HTTP connection.
+.El
+.Pp
+See
+.Xr fetch 3
+for a description of additional environment variables, including
+.Ev FETCH_BIND_ADDRESS ,
+.Ev FTP_LOGIN ,
+.Ev FTP_PASSIVE_MODE ,
+.Ev FTP_PASSWORD ,
+.Ev FTP_PROXY ,
+.Ev ftp_proxy ,
+.Ev HTTP_AUTH ,
+.Ev HTTP_PROXY ,
+.Ev http_proxy ,
+.Ev HTTP_PROXY_AUTH ,
+.Ev HTTP_REFERER ,
+.Ev HTTP_USER_AGENT ,
+.Ev NETRC ,
+.Ev NO_PROXY and
+.Ev no_proxy .
+.Sh EXIT STATUS
+The