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

NAME

6       edg-gridftp-rename - Rename a file or directory on a GridFTP server.
7

SYNOPSIS

9       edg-gridftp-rename [--proxy=proxy] [--timeout=timeout] SourceURL
10       DestinationURL
11
12       edg-gridftp-rename --usage
13
14       edg-gridftp-rename --help
15

DESCRIPTION

17       edg-gridftp-rename renames a file or directory on a GridFTP server.
18       Everything but the filename is ignored on the destination URL meaning
19       that files will not be moved between servers.  This command will return
20       a status of 0 if the file or directory was renamed. In all other cases,
21       it will return a non-zero value and print an error message to the
22       standard error.
23

OPTIONS

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

AUTHOR

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

LICENSE

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