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


pegasus-gridftp ls [options] [URL…]
pegasus-gridftp mkdir [options] [URL…]
pegasus-gridftp rm [options] [URL…]


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.


Global Options

Turn on verbose output. Verbosity can be increased by specifying multiple -v arguments.
Read a list of URLs to operate on from FILE.

rm Options

If the URL does not exist, then ignore the error.
Recursively delete files and directories.

ls Options

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

mkdir Options

Create intermediate directories as necessary.
Ignore error if directory already exists


pegasus-gridftp has several subcommands to implement different operations.

The ls subcommand lists the details of a file, or the contents of a directory on the remote server.
The mkdir subcommand creates one or more directories on the remote server.
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://".


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.


Gideon Juve <>

Pegasus Team