dl

Section: User Commands (1)
Updated: 13 February 1996
Index Return to Main Contents
 

NAME

dl - download binary files from UNIX anonymous FTP servers  

SYNOPSIS

dl [-f] [-l logfile] [-i inputfile] [-r retrycnt]

   [-p passwd] [-h] [URL]  

DESCRIPTION

dl is a simple yet powerful FTP client. It's main purpose is to be reliable and easy to use, especially in environments connected with slow links to the rest of the world. dl restarts interrupted transfer exactly where they stopped. It knows about all kinds of network timeouts and always does everything possible to download the files you requested. dl will attempt to reconnect many times before giving up.

You can use three different formats, when specifying what to download:


 hostname:pathname
 hostname pathname
 ftp://hostname/pathname (standard URL format)

Wildcards can be used in all of this formats to download multiple files at once. The rules for wildcards are the same as in the shell. Put wildcarded URLs in double quotes (unless URLs are in inputfile, see below). The other format is to prepend backslash '\' before wildcard characters. This is to prevent the shell from expanding those characters locally.

 

OPTIONS

-f
download in foreground, watching progress on screen. Default is background.
-l logfile
when downloading in the background, progress is logged in a file which resides in /tmp directory. The template for this logfile is dl_log.username.# . This behavior can be overridden with the -l switch. Just specify a path to custom logfile with it.
-i inputfile
if you want to download many files, you can list them in the inputfile, and dl will download them in succession.
-r retrycnt
this switch sets the retry count, that is how many times dl will try to reconnect and continue downloading before giving up. However, if a fatal error occurs (e.g. the requested file not found on FTP server) dl will abort or proceed to the next file. Retry count can be anywhere from 1 to 500, default is 50.
-p passwd
if you experience problems logging in with default username@localhost password, change it with this switch.
-h

 print short help. Useful in practice, when you don't want to read this whole manual.
 

EXAMPLES

This downloads the file named FILES which resides in /pub/msdos/djgpp directory on fly.cc.fer.hr:

% dl fly.cc.fer.hr:/pub/msdos/djgpp/FILES

This gets the very same file but in the foreground and with different format:

% dl -f ftp://fly.cc.fer.hr/pub/msdos/djgpp/FILES

You can download a whole directory, and have progress written to a file named log, like this:

% dl -l log -r 100 fly.cc.fer.hr "/pub/phrack/*"
 

SEE ALSO

ftp(1)  

NOTES

Doubtless there are bugs in this program. I welcome problem reports and any other comments about DownLoad.  

CREDITS

Thanks goes to:


 Hrvoje Niksic <hniksic@regoc.srce.hr>
 Tomislav Vujec <tvujec@barok.foi.hr>
 Zoran Rajic <zox@topaz.rasip.fer.hr>
 Denis Kapetanovic <dkapetan@gandalf.zel.fer.hr>
 Dobrisa Dobrenic <dobrisa@srce.hr>
 Hrvoje Dogan <hdogan@student.math.hr>
 Andrew T. Bilinsky <bilinsky@acsu.buffalo.edu>  

COPYRIGHT

Copyright (C) 1995, 1996 Zlatko Calusic

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.  

AUTHOR


 Zlatko Calusic
 maverick@fly.cc.fer.hr
 University of Zagreb, Croatia
 Faculty of Electrical Engineering and Computer Science


 

Index

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
EXAMPLES
SEE ALSO
NOTES
CREDITS
COPYRIGHT
AUTHOR

This document was created by man2html, using the manual pages.
Time: 21:56:58 GMT, August 23, 2022