FGET(1)

NAME
fgrabcmd, fgrab - download files from the FSP database

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

fgrab [-f|u|t|n|a]
fgrab [-f|u|t|n|a] 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, fgrabcmd copies the file to the client's current working directory in the client machine, and deletes it from the FSP database. It is guaranteed that multiple concurrent grab actions appear to be mutually exclusive. fgrabcmd 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 fgrab \(set noglob\; exec fgrabcmd \!\*\)

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.

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.temp.####

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, fgrabcmd will display the number of kilo-byte blocks transferred as transfer progresses. Also shown is an indicator of network speed in the form of characters per second.

BUGS
If fgrab is interrupted, the file being copied is deleted nonetheless.

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)