arcrename(1)

1ARCRENAME(1)                NorduGrid Users Manual                ARCRENAME(1)
2
3
4

NAME

6       arcrename - rename file or directory
7
8

DESCRIPTION

10       The arcrename renames files or directories on grid storage elements and
11       indexing services.
12
13

SYNOPSIS

15       arcrename [options] oldurl newurl
16
17

OPTIONS

19       -P, --listplugins
20              list the available plugins (protocols supported)
21
22       -t, --timeout=seconds
23              timeout in seconds (default 20)
24
25       -z, --conffile=filename
26              configuration file (default ~/.arc/client.conf)
27
28       -d, --debug=debuglevel
29              FATAL, ERROR, WARNING, INFO, VERBOSE or DEBUG
30
31       -v, --version
32              print version information
33
34       -?, --help
35              print help
36
37

ARGUMENTS

39       oldurl current name of file or directory
40
41       newurl new name for file or directory
42

EXTENDED DESCRIPTION

44       The arcrename command renames files or directories on grid storage ele‐
45       ments  and  indexing  services. The path component of oldurl and newurl
46       must differ and it must be the only component of  both  URLs  which  is
47       different.   arcrename will exit with an error if the paths are equiva‐
48       lent or other components of the URLs are different. Renaming a  URL  to
49       an existing URL will either fail or overwrite the existing URL, depend‐
50       ing on the protocol.  arcrename works purely at the namespace level and
51       does not perform data transfer.
52
53       For  more information on ARC URL syntax please read "Protocols, Uniform
54       Resource Locators (URL) and Extensions Supported  in  ARC"  [NORDUGRID-
55       TECH-7]
56
57       Depending  on  the  installed libraries (check with -P ), the following
58       protocols may be used: file  (file://  prefix  may  be omitted),  http,
59       https, httpg, ftp, gsiftp, srm, root. However renaming is not supported
60       or implemented for some of those protocols.
61
62

FILES

64       ~/.arc/client.conf
65              Some options can be given default values by specifying  them  in
66              the  ARC  client configuration file. By using the --conffile op‐
67              tion a different configuration file can be  used  than  the  de‐
68              fault.
69
70

ENVIRONMENT VARIABLES

72       X509_USER_PROXY
73              The location of the user's Grid proxy file. Shouldn't be set un‐
74              less the proxy is in a non-standard location.
75
76
77       ARC_LOCATION
78              The location where ARC is installed can  be  specified  by  this
79              variable.  If  not specified the install location will be deter‐
80              mined from the path to the command being executed, and  if  this
81              fails a WARNING will be given stating the location which will be
82              used.
83
84
85       ARC_PLUGIN_PATH
86              The location of ARC plugins can be specified by  this  variable.
87              Multiple  locations  can be specified by separating them by : (;
88              in Windows). The default location is $ARC_LOCATION/lib/arc (\ in
89              Windows).
90
91

EXAMPLE

93       arcrename       gsiftp://example.com/grid/file.dat       gsiftp://exam‐
94       ple.com/grid/new.file.dat
95
96

COPYRIGHT

98       APACHE LICENSE Version 2.0
99
100

AUTHOR

102       ARC   software   is   developed   by   the   NorduGrid    Collaboration
103       (http://www.nordugrid.org), please consult the AUTHORS file distributed
104       with   ARC.   Please   report   bugs   and    feature    requests    to
105       http://bugzilla.nordugrid.org
106
107