'\" t
.\" Title: pegasus-gridftp
.\" Author: [see the "Author" section]
.\" Generator: DocBook XSL Stylesheets v1.79.1
.\" Date: 11/09/2018
.\" Manual: Pegasus Manual
.\" Source: Pegasus 4.4.0
.\" Language: English
.\"
.TH "PEGASUS\-GRIDFTP" "1" "11/09/2018" "Pegasus 4\&.4\&.0" "Pegasus Manual"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
pegasus-gridftp \- Perform file and directory operations on remote GridFTP servers
.SH "SYNOPSIS"
.sp
.nf
\fBpegasus\-gridftp\fR \fBls\fR [options] [\fIURL\&...\fR]
\fBpegasus\-gridftp\fR \fBmkdir\fR [options] [\fIURL\&...\fR]
\fBpegasus\-gridftp\fR \fBrm\fR [options] [\fIURL\&...\fR]
.fi
.SH "DESCRIPTION"
.sp
\fBpegasus\-gridftp\fR 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\&.
.SH "OPTIONS"
.SS "Global Options"
.PP
\fB\-v\fR
.RS 4
Turn on verbose output\&. Verbosity can be increased by specifying multiple \-v arguments\&.
.RE
.PP
\fB\-i\fR \fIFILE\fR
.RS 4
Read a list of URLs to operate on from FILE\&.
.RE
.SS "rm Options"
.PP
\fB\-f\fR
.RS 4
If the URL does not exist, then ignore the error\&.
.RE
.PP
\fB\-r\fR
.RS 4
Recursively delete files and directories\&.
.RE
.SS "ls Options"
.PP
\fB\-a\fR
.RS 4
List files beginning with a "\&."\&.
.RE
.PP
\fB\-l\fR
.RS 4
Create a long\-format listing with file size, creation date, type, permissions, etc\&.
.RE
.SS "mkdir Options"
.PP
\fB\-p\fR
.RS 4
Create intermediate directories as necessary\&.
.RE
.PP
\fB\-f\fR
.RS 4
Ignore error if directory already exists
.RE
.SH "SUBCOMMANDS"
.sp
\fBpegasus\-gridftp\fR has several subcommands to implement different operations\&.
.PP
\fBls\fR
.RS 4
The
\fBls\fR
subcommand lists the details of a file, or the contents of a directory on the remote server\&.
.RE
.PP
\fBmkdir\fR
.RS 4
The
\fBmkdir\fR
subcommand creates one or more directories on the remote server\&.
.RE
.PP
\fBrm\fR
.RS 4
The
\fBrm\fR
subcommand deletes one or more files and directories from the remote server\&.
.RE
.SH "URL FORMAT"
.sp
All URLs supplied to \fBpegasus\-gridftp\fR should begin with "gsiftp://"\&.
.SH "CONFIGURATION"
.sp
\fBpegasus\-gridftp\fR 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\(cqs proxy, etc\&.
.SH "RETURN VALUE"
.sp
\fBpegasus\-gridftp\fR returns a zero exist status if the operation is successful\&. A non\-zero exit status is returned in case of failure\&.
.SH "AUTHOR"
.sp
Gideon Juve
.sp
Pegasus Team \m[blue]\fBhttp://pegasus\&.isi\&.edu\fR\m[]