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

NOTA BENE

6       The PQ2 tools are deprecated and will be removed in ROOT v6.16/00.
7
8       Please  contact  the  ROOT  team at http://root.cern.ch in the unlikely
9       event this change is disruptive for your workflow.
10

NAME

12       pq2-ls - List the available datasets in a dataset meta-repository based
13       on ROOT files
14

SYNOPSIS

16       pq2-ls [options] [datasets]
17

DESCRIPTION

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

ARGUMENTS

30       datasets
31              The  dataset  or the datasets to be listed; the wildcards '*' is
32              supported. By default, all the datasets in  the  repository  are
33              listed.
34

OPTIONS

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

FORMAT OF THE OUTPUT

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

ENVIRONMENT VARIABLES

86       See setup-pq2(1).
87

SEE ALSO

89       pq2(1),    setup-pq2(1),    pq2-ls-files(1),    pq2-ls-files-server(1),
90       pq2-info-server(1),    pq2-ana-dist(1),    pq2-put(1),   pq2-verify(1),
91       pq2-rm(1), pq2-cache(1)
92
93       For  more  information  on   the   ROOT   system,   please   refer   to
94       http://root.cern.ch
95

ORIGINAL AUTHORS

97       Gerardo Ganis for the ROOT team.
98

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

AUTHOR

116       This  manual  page  was  originally  written  by  Gerardo  Ganis  <ger‐
117       ardo.ganis@cern.ch>, for ROOT version 5.
118
119
120
121ROOT                               Version 5                         PQ2-LS(1)
Impressum