arcls(1) - f37

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

NAME

6       arcls - list files or directories
7
8

DESCRIPTION

10       The  arcls  command  is used for listing files in grid storage elements
11       and file index catalogues.
12
13

SYNOPSIS

15       arcls [options] url
16
17

OPTIONS

19       -l, --long
20              long format (like ls -l). The name of the object is followed  by
21              these  elements: filetype of object, size in bytes, modification
22              time, checksum and access latency (ONLINE or NEARLINE). The ele‐
23              ments for which information is available is protocol-dependent.
24
25       -L, --locations
26              show  URLs of file locations (replicas) registered in index ser‐
27              vices.
28
29       -m, --metadata
30              list all available metadata.
31
32       -r, --recursive
33              operate recursively
34
35       -D, --depth=level
36              operate recursively up to specified level
37
38       -n, --nolist
39              show only description of requested object, do not  list  content
40              of directories (like ls -d).
41
42       -f, --forcelist
43              treat  requested object as directory and always try to list con‐
44              tent
45
46       -c, --checkaccess
47              check readability of object. Retrieving and showing  information
48              about object is suppressed.
49
50       -P, --listplugins
51              list the available plugins (protocols supported)
52
53       -t, --timeout=seconds
54              timeout in seconds (default 20)
55
56       -z, --conffile=filename
57              configuration file (default ~/.arc/client.conf)
58
59       -d, --debug=debuglevel
60              FATAL, ERROR, WARNING, INFO, VERBOSE or DEBUG
61
62       -v, --version
63              print version information
64
65       -?, --help
66              print help
67
68

ARGUMENTS

70       url    the location to list
71

EXTENDED DESCRIPTION

73       The  arcls command lists files and directories on grid storage elements
74       and in file index catalogues.  Depending  on  the  installed  libraries
75       (check  with  -P ), the following protocols may be used: file  (file://
76       prefix  may  be omitted), http, https, httpg, ftp, gsiftp, srm, root.
77
78       In the case of a directory/fileset, attributes of objects belonging  to
79       it will be retrieved, unless --nolist is specified.
80
81       If  url starts from '@', the remainder should be a path to a local file
82       containing list of URLs, one per line. Then arcls acts  as  if  it  was
83       called  multiple  times, once for each URL. For more information on ARC
84       URL syntax please read "Protocols, Uniform Resource Locators (URL)  and
85       Extensions Supported in ARC" [NORDUGRID-TECH-7]
86
87

FILES

89       ~/.arc/client.conf
90              Some  options  can be given default values by specifying them in
91              the ARC client configuration file. By using the  --conffile  op‐
92              tion  a  different  configuration  file can be used than the de‐
93              fault.
94
95

ENVIRONMENT VARIABLES

97       X509_USER_PROXY
98              The location of the user's Grid proxy file. Shouldn't be set un‐
99              less the proxy is in a non-standard location.
100
101
102       ARC_LOCATION
103              The  location  where  ARC  is installed can be specified by this
104              variable. If not specified the install location will  be  deter‐
105              mined  from  the path to the command being executed, and if this
106              fails a WARNING will be given stating the location which will be
107              used.
108
109
110       ARC_PLUGIN_PATH
111              The  location  of ARC plugins can be specified by this variable.
112              Multiple locations can be specified by separating them by  :  (;
113              in Windows). The default location is $ARC_LOCATION/lib/arc (\ in
114              Windows).
115
116

EXAMPLE

118       arcls -l gsiftp://example.com/grid/file.dat
119
120

COPYRIGHT

122       APACHE LICENSE Version 2.0
123
124

AUTHOR

126       ARC   software   is   developed   by   the   NorduGrid    Collaboration
127       (http://www.nordugrid.org), please consult the AUTHORS file distributed
128       with   ARC.   Please   report   bugs   and    feature    requests    to
129       http://bugzilla.nordugrid.org
130
131