1PQ2-LS(1)                   General Commands Manual                  PQ2-LS(1)
2
3
4

NAME

6       pq2-ls - List the available datasets in a dataset meta-repository based
7       on ROOT files
8

SYNOPSIS

10       pq2-ls [options] [datasets]
11

DESCRIPTION

13       This manual page documents briefly the pq2-ls program.
14
15       pq2-ls is a script invoking the pq2 ROOT application to list the avail‐
16       able  datasets  in  a  dataset meta-repository based on ROOT files; the
17       repository can be accessed via the local file system or a  remote  file
18       server daemon or a PROOF facility.
19
20       More details about the underlying 'pq2' application can be found in the
21       man page pq2(1).
22

ARGUMENTS

24       datasets
25              The dataset or the datasets to be listed; the wildcards  '*'  is
26              supported.  By  default,  all the datasets in the repository are
27              listed.
28

OPTIONS

30       -h, --help
31              Display help information.
32
33       -k, --keep
34              Keep the temporary  files  created  during  the  analysis  under
35              $TMPDIR
36
37       -v     Verbose mode
38
39       --forcescan
40              Force  opening  of the datasets are open to get the information;
41              by default the pre-processed information is used, if any.
42
43       --noupdate
44              In the case a cache is used, do not update  the  cache  (may  be
45              slow on some servers).
46
47       --refresh
48              Refresh the information (requires appropriate credentials; typi‐
49              cally it can be done only for owned datasets).
50
51       -d <dataset>, --dataset=<dataset>
52              Alternative way to define the dataset  or  the  datasets  to  be
53              listed.
54
55       -u <serverurl>, --url=<serverurl>
56              URL  of  the  PROOF master or data server providing the informa‐
57              tion; for data servers, it must include the directory.  Can also
58              be  specified  via  the  environment  variables  PQ2PROOFURL  or
59              PQ2DSSRVURL (see ENVIRONMENT VARIABLES)."
60
61       -t <dir>, --tmpdir=<dir>
62              Directory for temporary files; defualt is /tmp/<username>.
63

FORMAT OF THE OUTPUT

65       The information printed by pq2-ls has the following format:
66
67       /group/user/dsname                        | # files |  /<def-tree> | # evts   | size     | staged fraction
68
69       for example
70
71       Dataset URI                               | # Files | Default tree | # Events |   Disk   | Staged
72       /PWG2/akisiel/Therminator_c2030           |     952 | /esdTree     |      927 |     4 GB |   97 %
73
74
75       The space reserved for the default tree  name  is  14  characters:  for
76       longer names the last character is substituded with a '>'.
77
78

ENVIRONMENT VARIABLES

80       See setup-pq2(1).
81

SEE ALSO

83       pq2(1),    setup-pq2(1),    pq2-ls-files(1),    pq2-ls-files-server(1),
84       pq2-info-server(1),   pq2-ana-dist(1),    pq2-put(1),    pq2-verify(1),
85       pq2-rm(1), pq2-cache(1)
86
87       For   more   information   on   the   ROOT   system,  please  refer  to
88       http://root.cern.ch
89

ORIGINAL AUTHORS

91       Gerardo Ganis for the ROOT team.
92

94       This library is free software; you can redistribute it and/or modify it
95       under  the  terms of the GNU Lesser General Public License as published
96       by the Free Software Foundation; either version 2.1 of the License,  or
97       (at your option) any later version.
98
99       This  library  is  distributed  in the hope that it will be useful, but
100       WITHOUT ANY  WARRANTY;  without  even  the  implied  warranty  of  MER‐
101       CHANTABILITY  or  FITNESS FOR A PARTICULAR PURPOSE.  See the GNU Lesser
102       General Public License for more details.
103
104       You should have received a  copy  of  the  GNU  Lesser  General  Public
105       License  along  with  this  library; if not, write to the Free Software
106       Foundation, Inc., 51 Franklin St, Fifth Floor, Boston,  MA   02110-1301
107       USA
108

AUTHOR

110       This  manual  page  was  originally  written  by  Gerardo  Ganis  <ger‐
111       ardo.ganis@cern.ch>, for ROOT version 5.
112
113
114
115ROOT                               Version 5                         PQ2-LS(1)
Impressum