FTPpipe 1.00 (Sat Jan  8 15:49:48 2000)
Copyright (C) 2000 Chris Elving.  All rights reserved.


FTPpipe
_______

FTPpipe is a simple program that makes it possible to pipe to/from a file on an
FTP server or redirect an FTP server directory listing.  If you don't know what
this means, you probably don't need FTPpipe.

Outgoing file data is read from stdin (file handle 0) and incoming file data 
and directory listings are written to stdout (file handle 1).  Error messages 
and interactive prompts are written to stderr (file handle 2).

FTPpipe returns 0 on success.  A non-0 return code indicates a failure.

FTPpipe is Copyright (C) 2000 Chris Elving.  All rights reserved.


Licence
_______

The program and its associated materials, including the program documentation,
are herein referred to as "the Software".

YOU MUST AGREE TO THE CONDITIONS BELOW TO USE OR DISTRIBUTE THE SOFTWARE.

Licence is granted to use and distribute the Software provided that:

1) the Software is not modified in any way
2) the Software is distributed in its entirety
3) the origin or ownership of the Software is not misrepresented.

The Software is Copyright (C) 2000 Chris Elving.  Chris Elving retains 
exclusive ownership of the Software.  Use or distribution of the Software 
outside or in excess of the conditions established above requires written 
authorization from Chris Elving.


Usage
_____

Syntax:
  ftppipe cmd [opt] ftp://[[username][:password]@]hostname[:port]/filespec

cmd is one of:
  PUT        Store the file specified by filespec
  GET        Retrieve the file specified by filespec
  NLST       List filenames of files specific by filespec
  LIST       Get a directory listing of filespec

opt is zero or more of:
  /PASV      Use passive (PASV) mode
  /ASCII     Transfer files in ASCII (TYPE A) instead of binary (TYPE I) mode

where:
  username   Name used to login, default "anonymous"
  password   Password used to login, default "ftppipe@"
  hostname   Hostname or IP address of the FTP server
  port       Port of the FTP server, default 21
  filespec   Filespec to store/retrieve/list


Usage Examples
______________

Retrieve the file /pub/incoming/00files.txt from Hobbes:

  ftppipe GET ftp://hobbes.nmsu.edu/pub/incoming/00files.txt > 00files.txt

List the directory /pub on Hobbes, logging in as user anonymous with password 
chris@elving.com:

  ftppipe LIST /ASCII ftp://anonymous:chris@elving.com@hobbes.nmsu.edu/pub/

View the file /pub/incoming/00files.txt on Hobbes a page at a time:

  ftppipe GET /ASCII ftp://hobbes.nmsu.edu/pub/incoming/00files.txt | more

Store a local directory listing in the file dir.txt on ftp.elving.com, 
prompting for password:

  dir /s | ftppipe PUT ftp://elving:@ftp.elving.com/dir.txt


Contacting the Author
_____________________

I would appreciate hearing from you if you find FTPpipe useful.

You may contact me via Internet email at "Chris Elving" <chris@elving.com>

