---
name: "fgrabcmd"
section: "1"
platform: "linux"
package: "fsp"
version: "2.81.b24-3"
release: "Debian 5.0 (Lenny)"
platforms: ["linux"]
url: "https://new.carta.tech/fgrabcmd"
---

# fgrabcmd(1)

download files from the FSP database

## NAME

fgrabcmd, fgrab - download files from the FSP database

## SYNOPSIS

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

**fgrab** \[-\[f\|o\]\|u\|t\|n\|a\|c\|r\|p\]\
 **fgrab** \[-\[f\|o\]\|u\|t\|n\|a\|c\|r\|p\] *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

**-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.

## ENVIRONMENT

See [fsp\_env(7)](/fsp_env/7.md) for list of used environment variables.

## BUGS

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

## SEE ALSO

[fcatcmd(1)](/fcatcmd/1.md), [fcdcmd(1)](/fcdcmd/1.md), [fgetcmd(1)](/fgetcmd/1.md), [fgrabcmd(1)](/fgrabcmd/1.md), [flscmd(1)](/flscmd/1.md), [fmkdir(1)](/fmkdir/1.md), [fprocmd(1)](/fprocmd/1.md), [fput(1)](/fput/1.md), [frmcmd(1)](/frmcmd/1.md), [frmdircmd(1)](/frmdircmd/1.md), [fver(1)](/fver/1.md), [fducmd(1)](/fducmd/1.md), [fhostcmd(1)](/fhostcmd/1.md), [fspd(1)](/fspd/1.md), [fsp\_prof(5)](/fsp_prof/5.md), [ffindcmd(1)](/ffindcmd/1.md), [fsp\_env(7)](/fsp_env/7.md)