fget

FGET(1)                     General Commands Manual                    FGET(1)



NAME
       fgetcmd, fget - download files from the FSP database

SYNOPSIS
       fgetcmd [-f|u|t|n|a|r]
       fgetcmd [-f|u|t|n|a|r] filename ...

       fget [-f|u|t|n|a|r]
       fget [-f|u|t|n|a|r] filename ...

DESCRIPTION
       When used without arguments, a list of file names is read from the
       standard input.  When arguments are given, the arguments are taken to
       be the list of file names.  For each file named in the list, fgetcmd
       copies the file to the client's current working directory in the client
       machine.  fgetcmd will perform csh file name globbing based on file and
       directory information obtained from the FSP database.

       Since user's command shells generally cannot do the proper globbing for
       this program, it is recommended that user defines a shell alias or
       function to turn off command shell globbing before running this
       program.  csh example:

       alias fget \(set noglob\; exec fgetcmd \!\*\)

ARGUMENTS
       -f -- forces overwriting of files during an fget.

       -u -- forces unique filenames (appends a unique integer to each copy)

       -t -- forces overwrite of local file if download is successful.

       -n -- forces fgetcmd to refuse to overwrite files with identical names.

       -a -- forces fgetcmd to try and append data to a partial file.

       -r -- forces fgetcmd to recursively get all files in given directories.

       The default mode is for fgetcmd to overwrite files after a successful
       download.  This has the drawback of possibly leaving behind temporary
       files with names like .fsp.####

ENVIRONMENT
       The following variables associate this program with a FSP database:

       FSP_HOST
              The name or internet number of the machine with the FSP server.

       FSP_PORT
              The port number of the UDP socket used by the FSP server.

       FSP_LOCALPORT
              The port number of the UDP socket used by FSP client utilities.
              The only reason to define this variable is to ensure mutual
              exclusion of client commands when none of the udp packet
              multiplexing mechanisms are enabled during compile time.  You
              may pick any number not currently used for other purposes.

       FSP_DIR
              The current working directory of the client in the FSP database.
              The root of the database is /.

       FSP_TRACE
              If this variable is set, fgetcmd will display the number of
              kilo-byte blocks transferred as transfer progresses.  Also shown
              will be an indication of the network speed in the form of
              characters per second.

       FSP_LOCAL_DIR
              If this variable is set, it contains the local working directory
              where all incoming files will be placed.

       FSP_TIMEOUT
              If this variable is set, it contains the timeout value.  The
              default value is 4.  No function if program was compiled without
              the client timeout code.

SEE ALSO
       fcatcmd(1), fcdcmd(1), fgetcmd(1), fgrabcmd(1), flscmd(1), fmkdir(1),
       fprocmd(1), fput(1), frmcmd(1), frmdircmd(1), fver(1), fducmd(1),
       fhostcmd(1), fspd(1), fsp_prof(5), ffindcmd(1)




                                27 January 1993                        FGET(1)