OS/2 Shareware BBS: 35 Internet/35-Internet.zip/get107.zip/readme

Text File | 1999-04-20 | 8KB | 190 lines

April 2, 1999

get.exe is copyright of keith cotroneo, 1997-99.
All Rights Reserved.
Please treat it accordingly.
If you choose to use get.exe, you do so at your
own risk. I guarantee nothing, and you agree to
hold me harmless for any damages associated with
its use.

I would appreciate your suggestions and feedback. Get.exe is the
first step in a broader project. The intent of the project
is to provide ftp capability as an add on to applications
that people develop. I had to figure out the ftp stuff first,
before moving on.

You can use get.exe to add external ftp capabilities to
applications. To do so, you must call get.exe from your
pplication and use the right get paramters.

get.exe is tiny, powerful batch ftp program. You
can use it to automate uploads to or downloads from ftp sites and
perform several functions on a remote server. With the
included getit.exe, you can use get to automate downloads
from popular email clients like MR2 ICE.

If you find get.exe useful and use it for more than 30 days,
or would like to include it in your applications (you may not
distribute with your applications without my permission).
You may register it for personal use by sending me $10.00.
including your name, address, and email address.
You may register it for commercial use by sending me $30.00.
including your name, address, and email address.


Please share your ideas and thoughts with me.

Keith Cotroneo
716 Monterey Drive
Endwell, NY 13760

[e-mail]


Changes in version 1.07:
Functions now recognize a drive designator in the remotefile parameter.
For example:
get -l cotroneo.stny.com/e:/new NULL anonymous [e-mail]
will get the directory list for the e:/new directory on a drive. Previous
version of get did not allow drive designators.
Also, added significant speed enhancements.

Changes in version 1.06:
The archive now includes getit.exe to simplify the download process.
Added -s paramter for date sorted directory listing - most recent files first.

GETIT.EXE:

get106.zip archives and beyond contain the main app get.exe written in C.
It also contains getit.exe, a compiled rexx program. getit.exe calls get.exe
and is useful if you want to use get.exe in email programs such as MR ICE.
You can reference getit.exe as the ftp client in MR ICE and
use it to download programs from your email window. Make sure that the text file
GPATH contains your download path. Also, make sure that get.exe and gpath are
in a path referenced in your config.sys. The path contained in gpath must NOT contain
a / at the end of the path.

Example -
If GPATH = c:/test then

getit hobbes.nmsu.edu/pub/incoming/00index.txt
will download 00index.txt and place it in the c:\test directory

If you include a download path as the second parameter to getit, the download path
in GPATH will be overwritten.

Example -
If GPATH = c:/test then

getit hobbes.nmsu.edu/pub/incoming/00index.txt c:/new
will download 00index.txt and place it in the c:\new directory


GET.EXE:

Use of get is simple. It takes the following command line
parameters:

ftpparamter remoteftpsite/remotedirectory/fileyouwant localdirectory\localfilename username password

The ftpparameters are:

-a append a file - this is a reget type function. -a will check the file size of the local machine
specified by the localdirectory\localfilename parameter against the file size of the remote file
specified by the fileyouwant parameter. If the fileyouwant is larger than the local file, the download
will append the missing bytes, starting from the local file size.

-d delete a file - will delete the fileyouwant. The localdirectory\localfilename parameter is ignored, but
something must be specified in the localdirectory\localfilename parameter to keep things consistent. The
word NULL will do.

-g get a file - downloads the file specified by the remoteftpsite/remotedirectory/fileyouwant parameter to
the localdirectory\localfilename parameter.

-l list files - lists files to the screen as specified by the remoteftpsite/remotedirectory/fileyouwant
parameter. *.* will get the full list.

-p put a file - uploads the localdirectory\localfilename to the remoteftpsite/remotedirectory/fileyouwant
location.

-r rename a file - renames the remoteftpsite/remotedirectory/fileyouwant to the file specified in the
localdirectory\localfilename parameter location.

-s list files sort order (date) - lists files to the screen as specified by the
remoteftpsite/remotedirectory/fileyouwant parameter in sort order from newest to oldest. *.*
will get the full list. -s uses LIST -lt on the server. It should work with most unix servers.

Additional options:

? - You may substitute a ? for the localdirectory\localfilename when doing a download. In this case
get.exe will use the filename from the remoteftpsite/remotedirectory/fileyouwant parameter as
the filename for the download.

NULL - Use NULL in place of localdirectory\localfilename when doing a -l list or -s list.

Anonymous logon - if you leave ther USER and PASSWORD off, get will attempt anonymous logon.

You can also direct the get.exe client/server dialogue to a text file for perusal afterwords.
To do so, call get from a .cmd file like this:

getfile > output.txt


In the above example, gefile is getfile.cmd which contains the appropriate get command line.
output.txt will have all the server/client dialogue instead of it appearing on the screen
in the vio session.

Command files are also useful with the MORE command. For example, the getdir.cmd file and
getsort.cmd, included in the archive will direct directory lists to the screen.

getdir | more

The above command will page the listing one screen at a time.

getdir and getsort are currently set up for the hobbes download directory. Modify them to
get the directory listing you want.


Here are some examples of how to use get.exe:


get -g hobbes.nmsu.edu/pub/incoming/00index.txt c:\new\hobbes.txt anonymous [e-mail]

will logon to the hobbes ftp site and get the file 00index.txt from the
/pub/incoming directory. It will place the file in the c:\new directory with
the name hobbes.txt. Anonymous is the username for logon. Change this to
your username for the ftp site. [e-mail] is the password.
Change this to your password if needed. The - before the password tells the
ftp site to use cryptic return messages so that you don't see all the welcome
stuff. This only works on some servers. If you do not supply a username and password,
get will attempt to logon anonymously.

get -d hobbes.nmsu.edu/pub/incoming/00index.txt NULL anonymous [e-mail]

will delete 00index.txt from the hobbes incoming directory (if allowed - actually hobbes does not allow
deletion). The localdirectory\localfilename parameter is unnecessary here, but something must be there
to keep the program straight. NULL is used in this case.

get -r hobbes.nmsu.edu/pub/incoming/00index.txt newindex.txt anonymous [e-mail]

will rename the remote file in remoteftpsite/remotedirectory/fileyouwant to the filename specified
in the localdirectory\localfilename parameter. In this case 00index.txt is renamed to newindex.txt.
newindex.txt is not a local file, it is the new name for the remote file. Hope this isn't confusing.

get -a hobbes.nmsu.edu/pub/incoming/00index.txt c:\new\hobbes.txt anonymous [e-mail]

will do an append download the file 00index.txt in the hobbes incoming directory to your local
machine using REGET. If the file hobbes.txt on your C:\ drive in \new is smaller than the file
on the remote machine, the difference in bytes are appended to the local file. This is useful if
you are doing a big download that becomes interrupted. Instead of having to start over, you can
only get the missing data.

get -p hobbes.nmsu.edu/pub/incoming/00index.txt c:\new\hobbes.txt anonymous [e-mail]

will upload the file hobbes.txt as 00index.txt in the hobbes pub/incoming directory.

You can string together several downloads by placing the get command and
parameters in an os/2 command file. Several .cmd are provided in this archive
as examples.