---
name: "pegasus-gridftp"
section: "1"
platform: "linux"
package: "pegasus-wms"
version: "4.4.0+dfsg-8"
release: "Debian 10 (Buster)"
platforms: ["linux"]
url: "https://new.carta.tech/pegasus-gridftp"
---

# pegasus-gridftp(1)

Perform file and directory operations on remote GridFTP servers

## NAME

pegasus-gridftp - Perform file and directory operations on remote GridFTP servers

## SYNOPSIS

```
pegasus-gridftp ls [options] [URL...]
pegasus-gridftp mkdir [options] [URL...]
pegasus-gridftp rm [options] [URL...]
```

## DESCRIPTION

**pegasus-gridftp** is a client for Globus GridFTP servers. It enables remote operations on files and directories via the GridFTP protocol. This tool was created to enable more efficient remote directory creation and file cleanup tasks in Pegasus.

## OPTIONS

### Global Options

- **-v**

  Turn on verbose output. Verbosity can be increased by specifying multiple -v arguments.

- **-i** *FILE*

  Read a list of URLs to operate on from FILE.

### rm Options

- **-f**

  If the URL does not exist, then ignore the error.

- **-r**

  Recursively delete files and directories.

### ls Options

- **-a**

  List files beginning with a ".".

- **-l**

  Create a long-format listing with file size, creation date, type, permissions, etc.

### mkdir Options

- **-p**

  Create intermediate directories as necessary.

- **-f**

  Ignore error if directory already exists

## SUBCOMMANDS

**pegasus-gridftp** has several subcommands to implement different operations.

**ls**

The **ls** subcommand lists the details of a file, or the contents of a directory on the remote server.

**mkdir**

The **mkdir** subcommand creates one or more directories on the remote server.

**rm**

The **rm** subcommand deletes one or more files and directories from the remote server.

## URL FORMAT

All URLs supplied to **pegasus-gridftp** should begin with "gsiftp://".

## CONFIGURATION

**pegasus-gridftp** uses the CoG JGlobus API to communicate with remote GridFTP servers. Refer to the CoG JGlobus documentation for information about configuring the API, such as how to specify the user’s proxy, etc.

## RETURN VALUE

**pegasus-gridftp** returns a zero exist status if the operation is successful. A non-zero exit status is returned in case of failure.

## AUTHOR

Gideon Juve \<gideon@isi.edu\>

Pegasus Team **http://pegasus.isi.edu**