December 14, 1994

        **********   *********  *********          ***  ********* 
        **********  **********  **********        ***   **********
        ***         ***         ***    ***       ***           ***
        ***         ***         ***    ***      ***            ***
        ******      *********   **********     ***       *********
        ******       *********  *********     ***       ********* 
        ***                ***  ***          ***        ***
        ***                ***  ***         ***         ***
        ***         **********  ***        ***          **********
        ***         *********   ***       ***           **********

        This is FSP/2 version 1.0a. I no longer consider this beta code but I
also do not consider it to be perfect either. I Just don't have a lot of time
to test every little thing but since the code is based on the UNIX FSP 2.7.1
code I assume that most things should work fine. So, if something doesn't work
as it should, let me know; it might be a bug. Also, don't blame me for any
nasty problems that might occur; I just can't imagine that these programs could
cause any major damage but I don't plan to take the blame if they do.

        If you are wondering what FSP is or what the point of FSP is, please
refer to the fsp.faq and info files.

        This release of FSP/2 fixes a problem with WARP V3's IAK TCP/IP. I don't
know if it is a bug or a "feature" but IAK select() returns incorrect values.
I made an assumption about the IAK select() that seems to have worked but I'm
not totally sure if my solution was correct. So, please let me know if there
are any problems with these clients. I am also interested in bug reports of any
kind as well as ideas for improvements.

        This archive contains 15 files:

                fhost.cmd       :       use to set server address and port
                fcd.cmd         :       REXX code to set FSP_DIR
                fmore.cmd       :       pipes output of fcat to more
                f1.cmd          :       example cmd file to set fsp server info
                fsp.faq         :       FSP Frequently Asked Questions
                info            :       FSP info file
                readme          :       this file
                fcat.exe        :       Send remote file to standard output
                fcdcmd.exe      :       use with fcd.cmd to change remote dir
                fget.exe        :       get remote file(s).
                fls.exe         :       display remote files
                fmkdir.exe      :       make directory on remote
                frm.exe         :       remove file(s) from remote
                frmdir.exe      :       remove remote directory
                fver.exe        :       get server's version & important info


FSP/2 will recognize the following environment variables:

                FSP_HOST                : address of host system
                FSP_PORT                : port on host system
                FSP_DIR                 : current dir on host system
                FSP_TRACE               : controlls output of xfer status
                -----------------------------------------------------------
                FSP_LOCALPORT           : I have not checked these out, so
                FSP_PASSWORD            : I don't know if they work or what
                FSP_BUF_SIZE            : they will do under OS/2. Try 'em
                FSP_DELAY               : and let me know if they work
                FSP_LOCAL_DIR           :
                FSP_TIMEOUT             :

NOTE: If FSP_TRACE exists (See f1.cmd), transfer status info will be displayed.

USAGE:  I'll get around to adding more usefull info to the usage section later.

        FVER
                Poll server for FSP version and configuration information.

        FLS  [-1ACFLRacdfgiklqrstu] [file ...]
                Get directory listing from server. Use -l for single column
                display, and -lt for single col. sorted by date, etc...

        FCDCMD  [directory]
                Returns protection values of the specified directory or the
                current directory if no dir specified. Remember that the UNIX
                world used the forward slash / instead of the back slash \.

        FGET  [-futnar4l?] [files...]
                Get file(s) from server.
                -f : force overwrite of file
                -u : use unique names. This only works under HPFS. This will
                     append a .### (number in a sequence) to the file name if
                     the downloaded file already exists. i.e. If you have the
                     file thing.tar.gz and you download it again, -u will save
                     it as thing.tar.gz.1 if thing.tar.gz.0 already exists.
                -t : use temporary file (fsp_### where ### is the process ID)
                     for download. After download, the file is renamed to the
                     correct filename.
                -n : Skip the file if a file by that name already exists.
                -a : append to file. This will perform simple crash recovery
                     by continuing where you left off. It does not perform any
                     CRC type checks.
                -r : Recurse subdirectories. This will create local subdirs to
                     mirror the remote.
                -4 : This will save long filenames as longname.### (see -u) and
                     store the real name in the 4DOS/4OS2 descript.ion file.
                -l : Same as -4 EXCEPT it will save the realname to longname.log
                -? : Displays simple help
                
        FMKDIR  [remote directory]
                Make a directory on server

        FPUT  [local file(s)]
                Upload a file to server

        FRM  [remote file(s)]
                Remove file(s) on server if you have permission.

        FRMDIR  [remote directory]
                Remove a directory on server if you have permission.

IMPORTANT INFO IF YOU USE THIS WITH A FAT HARD DISK! I highly recomend that you
do not use FAT with FSP. FSP is mostly hosted by UNIX or VMS systems that are
not restricted to the 8.3 of FAT. If you try to get a file that does not
conform to 8.3, fget will ignore it. The only way that you can get long name
files is to call fget with either -4, -l or both (-4l). If you don't like this
and you would like an automatic truncation or something like that, tough. The
fget client fully supports HPFS and I highly recomend that you take advantage
of it.

Well, good luck. I don't have a lot of time to test everything so I would like
some feedback. I need some specific bug reports.

                                        Larkin Lowrey
                                        llowrey@ucsd.edu


My port uses code copyrighted by Wen-King Su and The Regents of the
University of California. Thanks guys!
