1EDG-GRIDFTP-LS(1)              European DataGrid             EDG-GRIDFTP-LS(1)
2
3
4

NAME

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

SYNOPSIS

9       edg-gridftp-ls [--proxy=proxy] [--timeout=timeout] [--verbose]
10       [--noauth] URL
11
12       edg-gridftp-ls --usage
13
14       edg-gridftp-ls --help
15

DESCRIPTION

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

OPTIONS

23       --proxy=proxy
24           Set the proxy to use for the GridFTP operation.  If this is unset,
25           then the underlying GridFTP library will try to find the proxy in
26           the usual locations.  This is useful if the proxy is in a non-
27           standard location, or the caller is a daemon which must act on the
28           behalf of a user.
29
30       --timeout=timeout
31           Set the time (in seconds) within which the listing must complete.
32           If no timeout is specified a default 120 second timeout will be
33           used. A negative or zero timeout will report a timeout error before
34           attempting to contact the FTP server.
35
36       --verbose
37           If this flag is set, then the listing will include more information
38           about the status of the file in addition to the filename.
39
40       --noauth
41           If this flag is set, then the authentication of the data channel
42           will be turned off.  It is on by default.
43
44       --usage
45           Short description of the usage of this command is given.
46
47       --help
48           A description of the usage of this command and information on all
49           of the options is given.
50
51       URL URLs of the following formats are accepted:
52
53           ftp://ftp.server.org//absolute/file/name
54           gsiftp://gridftp.server.org/~/home/relative/name.txt
55           gridftp://gridftp.server.org/home/relative/name.txt
56
57           Note: for the URLs without a tilde, the server configuration
58           determines whether the filename is absolute or relative.  On
59           servers which do not restrict users to their home areas, the tilde
60           notation will not work.
61

AUTHOR

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

LICENSE

67       Copyright (c) 2002 by Charles A. Loomis, Jr. and Le Centre National de
68       la Recherche Scientifique (CNRS).  All rights reserved.
69
70       The software was distributed with and is covered by the European
71       DataGrid License.  A copy of this license can be found in the included
72       LICENSE file.  This license can also be obtained from
73       http://www.eu-datagrid.org/license.
74
75       The underlying GridFTP library is part of the Globus Toolkit (TM) and
76       is covered by the Globus Toolkit Public License.  See
77       http://www.globus.org for more information.
78
79
80
811.2.9.2                           2008-02-25                 EDG-GRIDFTP-LS(1)
Impressum