chiark / gitweb /
use libinn logging where applicable - debugged
[inn-innduct.git] / doc / pod / simpleftp.pod
1 =head1 NAME
2
3 simpleftp - Rudimentary FTP client
4
5 =head1 SYNOPSIS
6
7 B<simpleftp> I<url> [...]
8
9 =head1 DESCRIPTION
10
11 B<simpleftp> is a Perl script that provides basic support for
12 fetching files with FTP in a batch oriented fashion.  It takes one or more
13 FTP URLs on the command line.  The file(s) will be retrieved from the
14 remote server and placed in the current directory with the same basename
15 as on the remote; e.g., L<ftp://ftp.isc.org/pub/usenet/CONFIG/active.gz>
16 is stored as F<active.gz> in the current directory.
17
18 The script properly understands usernames, passwords and ports specified
19 as follows:
20
21     ftp://user:password@host:port/path/file
22
23 =head1 BUGS
24
25 B<simpleftp> is an extremely poor substitute for more complete programs
26 like the freely available B<wget> or B<ncftp> utilities.  It was written
27 only to provide elementary support in INN for non-interactive fetching of
28 the files in L<ftp://ftp.isc.org/pub/pgpcontrol/> or
29 L<ftp://ftp.isc.org/pub/usenet/CONFIG/> without requiring
30 administrators to install yet another package.  Its shortcomings as a
31 general purpose program are too numerous to mention, but one that stands
32 out is that downloaded files by B<simpleftp> override existing files
33 with the same name in the local directory.
34
35 =head1 HISTORY
36
37 Tossed off by David C Lawrence <tale@isc.org> for InterNetNews.
38 Rewritten to use Net::FTP by Julien Elie <julien@trigofacile.com>.
39
40 $Id: simpleftp.pod 7739 2008-04-06 09:38:31Z iulius $
41
42 =head1 SEE ALSO
43
44 actsync(8).
45
46 =cut