fgrabcmd, fgrab − download files from the FSP database


fgrabcmd [-[f|o]|u|t|n|a|c|r|p]
[-[f|o]|u|t|n|a|c|r|p] filename ...

fgrab [-[f|o]|u|t|n|a|c|r|p]
[-[f|o]|u|t|n|a|c|r|p] filename ...


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 \!\*\)


-p -- preserve date/times of original file.

-f | -o -- forces overwriting of files during an fgrab.

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

-t -- forces overwrite of local file if download is successful. This has the drawback of possibly leaving behind temporary files with names like .fsp.####

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

-a | -c -- forces fgrabcmd 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 fgrabcmd is to create unique file names.


See fsp_env(7) for list of used environment variables.


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


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), fsp_env(7)