edg-gridftp-ls man page

edg-gridftp-ls — List a file or contents of directory.


edg-gridftp-ls [--proxy=proxy] [--timeout=timeout] [--verbose] [--noauth] URL

edg-gridftp-ls --usage

edg-gridftp-ls --help


edg-gridftp-ls will list (to the standard output) a file or the contents of a directory for the given URL. It will return a zero status on success. In all other cases, it will return a non-zero value and print an error message to the standard error.


Set the proxy to use for the GridFTP operation. If this is unset, then the underlying GridFTP library will try to find the proxy in the usual locations. This is useful if the proxy is in a non-standard location, or the caller is a daemon which must act on the behalf of a user.
Set the time (in seconds) within which the listing must complete. If no timeout is specified a default 120 second timeout will be used. A negative or zero timeout will report a timeout error before attempting to contact the FTP server.
If this flag is set, then the listing will include more information about the status of the file in addition to the filename.
If this flag is set, then the authentication of the data channel will be turned off. It is on by default.
Short description of the usage of this command is given.
A description of the usage of this command and information on all of the options is given.
URLs of the following formats are accepted:

ftp://ftp.server.org//absolute/file/name gsiftp://gridftp.server.org/~/home/relative/name.txt gridftp://gridftp.server.org/home/relative/name.txt

Note: for the URLs without a tilde, the server configuration determines whether the filename is absolute or relative. On servers which do not restrict users to their home areas, the tilde notation will not work.


Charles Loomis (charles.loomis@cern.ch). Later modifications by CERN IT-DM/SMD.


Copyright (c) 2002 by Charles A. Loomis, Jr. and Le Centre National de la Recherche Scientifique (CNRS). All rights reserved.

The software was distributed with and is covered by the European DataGrid License. A copy of this license can be found in the included License file. This license can also be obtained from http://www.eu-datagrid.org/license.

The underlying GridFTP library is part of the Globus Toolkit (TM) and is covered by the Globus Toolkit Public License. See http://www.globus.org for more information.


European DataGrid 2008-02-25