.\"" dl.1 Copyright 02/13/1996 by Zlatko Calusic .TH dl 1 "13 February 1996" .SH NAME \fBdl\fP \- download binary files from UNIX anonymous FTP servers .SH SYNOPSIS \fBdl\fP [\fB\-f\fP] [\fB\-l\fP\fI logfile\fP] [\fB\-i\fP\fI inputfile\fP] [\fB\-r\fP\fI retrycnt\fP] .br [\fB\-p\fP\fI passwd\fP] [\fB\-h\fP] [\fBURL\fP] .SH DESCRIPTION .LP .B 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. .B 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. .B dl will attempt to reconnect many times before giving up. You can use three different formats, when specifying what to download: \fBhostname:pathname\fP \fBhostname pathname\fP \fBftp://hostname/pathname\fP (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 \fIinputfile\fP, see below). The other format is to prepend backslash '\\' before wildcard characters. This is to prevent the shell from expanding those characters locally. .LP .SH OPTIONS .TP .B \-f download in foreground, watching progress on screen. Default is background. .TP .BI "\-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.\fIusername\fP.# . This behavior can be overridden with the .B \-l switch. Just specify a path to custom logfile with it. .TP .BI "\-i " inputfile if you want to download many files, you can list them in the \fIinputfile\fP, and .B dl will download them in succession. .TP .BI "\-r " retrycnt this switch sets the retry count, that is how many times .B 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) .B dl will abort or proceed to the next file. Retry count can be anywhere from 1 to 500, default is 50. .TP .BI "\-p " passwd if you experience problems logging in with default \fIusername\fP@\fIlocalhost\fP password, change it with this switch. .TP .BI "\-h " print short help. Useful in practice, when you don't want to read this whole manual. .SH "EXAMPLES" .LP This downloads the file named FILES which resides in /pub/msdos/djgpp directory on fly.cc.fer.hr: .IP % dl fly.cc.fer.hr:/pub/msdos/djgpp/FILES .LP This gets the very same file but in the foreground and with different format: .IP % dl -f ftp://fly.cc.fer.hr/pub/msdos/djgpp/FILES .LP You can download a whole directory, and have progress written to a file named \fIlog\fP, like this: .IP % dl -l log -r 100 fly.cc.fer.hr "/pub/phrack/*" .SH "SEE ALSO" .BR ftp (1) .SH "NOTES" .LP Doubtless there are bugs in this program. I welcome problem reports and any other comments about DownLoad. .SH "CREDITS" .LP Thanks goes to: Hrvoje Niksic Tomislav Vujec Zoran Rajic Denis Kapetanovic Dobrisa Dobrenic Hrvoje Dogan Andrew T. Bilinsky .SH "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. .SH "AUTHOR" Zlatko Calusic maverick@fly.cc.fer.hr University of Zagreb, Croatia Faculty of Electrical Engineering and Computer Science