pmrep: update TODO, man page
[pcp.git] / qa / 344.out
blobae4fa80ee9037f28bed856266aea71fa2109376a
1 QA output created by 344
3 qa.colour
4     inst [0 or "red"] value 101
5     inst [1 or "green"] value 202
6     inst [2 or "blue"] value 303
8 PID check passes
10 === expect no sample metrics ===
12 qa.colour PMID: 400.0.5
13     inst [0 or "red"] value 101
14     inst [1 or "green"] value 202
15     inst [2 or "blue"] value 303
16 sample.colour: pmLookupDesc: No PMCD agent for domain of request
18 === sample metrics this time ===
20 qa.colour PMID: 400.0.5
21     inst [0 or "red"] value 101
22     inst [1 or "green"] value 202
23     inst [2 or "blue"] value 303
25 sample.colour PMID: 30.0.5
26     inst [0 or "red"] value 101
27     inst [1 or "green"] value 202
28     inst [2 or "blue"] value 303
30 === -K spec parsing in pminfo ===
31 +++ -K clear +++
32 sample.string.write_me: pmLookupDesc: No PMCD agent for domain of request
33 qa.string.write_me: pmLookupDesc: No PMCD agent for domain of request
34 +++ -K clear, +++
35 pminfo: __pmSpecLocalPMDA failed: unexpected text after clear op in spec
36 Usage: pminfo [options] [metricname ...]
38 General options:
39   -a FILE, --archive=FILE
40                         metrics source is a PCP log archive
41   -h HOST, --host=HOST  metrics source is PMCD on host
42   --container=NAME      specify an individual container to be queried
43   -L, --local-PMDA      metrics source is local connection to a PMDA
44   -K SPEC, --spec-local=SPEC
45                         optional additional PMDA spec for local connection
46   -n FILE, --namespace=FILE
47                         use an alternative PMNS
48   -N FILE, --uniqnames=FILE
49                         like -n but only one name allowed for each PMID
50   -O TIME, --origin=TIME
51                         initial sample time within the time window
52   -Z TZ, --timezone=TZ  set reporting timezone
53   -z, --hostzone        set reporting timezone to local time of metrics source
54   -V, --version         display version number and exit
55   -?, --help            show this usage message and exit
57 Protocol options:
58   -b N, --batch=N       fetch N metrics at a time for -f and -v [20]
59   -d, --desc            get and print metric description
60   -f, --fetch           fetch and print values for all instances
61   -F, --fetchall        fetch and print values for non-enumerable indoms
62   -m, --pmid            print PMID
63   -M, --fullpmid        print PMID in verbose format
64   -t, --oneline         get and display (terse) oneline text
65   -T, --helptext        get and display (verbose) help text
67 Metrics options:
68   -c FILE, --derived=FILE
69                         load derived metric definitions from FILE(s)
70   -x, --events          unpack and report on any fetched event records
71   -v, --verify          verify mode, be quiet and only report errors
72 +++ -K clear,400 +++
73 pminfo: __pmSpecLocalPMDA failed: unexpected text after clear op in spec
74 Usage: pminfo [options] [metricname ...]
76 General options:
77   -a FILE, --archive=FILE
78                         metrics source is a PCP log archive
79   -h HOST, --host=HOST  metrics source is PMCD on host
80   --container=NAME      specify an individual container to be queried
81   -L, --local-PMDA      metrics source is local connection to a PMDA
82   -K SPEC, --spec-local=SPEC
83                         optional additional PMDA spec for local connection
84   -n FILE, --namespace=FILE
85                         use an alternative PMNS
86   -N FILE, --uniqnames=FILE
87                         like -n but only one name allowed for each PMID
88   -O TIME, --origin=TIME
89                         initial sample time within the time window
90   -Z TZ, --timezone=TZ  set reporting timezone
91   -z, --hostzone        set reporting timezone to local time of metrics source
92   -V, --version         display version number and exit
93   -?, --help            show this usage message and exit
95 Protocol options:
96   -b N, --batch=N       fetch N metrics at a time for -f and -v [20]
97   -d, --desc            get and print metric description
98   -f, --fetch           fetch and print values for all instances
99   -F, --fetchall        fetch and print values for non-enumerable indoms
100   -m, --pmid            print PMID
101   -M, --fullpmid        print PMID in verbose format
102   -t, --oneline         get and display (terse) oneline text
103   -T, --helptext        get and display (verbose) help text
105 Metrics options:
106   -c FILE, --derived=FILE
107                         load derived metric definitions from FILE(s)
108   -x, --events          unpack and report on any fetched event records
109   -v, --verify          verify mode, be quiet and only report errors
110 +++ -K clear,400, +++
111 pminfo: __pmSpecLocalPMDA failed: unexpected text after clear op in spec
112 Usage: pminfo [options] [metricname ...]
114 General options:
115   -a FILE, --archive=FILE
116                         metrics source is a PCP log archive
117   -h HOST, --host=HOST  metrics source is PMCD on host
118   --container=NAME      specify an individual container to be queried
119   -L, --local-PMDA      metrics source is local connection to a PMDA
120   -K SPEC, --spec-local=SPEC
121                         optional additional PMDA spec for local connection
122   -n FILE, --namespace=FILE
123                         use an alternative PMNS
124   -N FILE, --uniqnames=FILE
125                         like -n but only one name allowed for each PMID
126   -O TIME, --origin=TIME
127                         initial sample time within the time window
128   -Z TZ, --timezone=TZ  set reporting timezone
129   -z, --hostzone        set reporting timezone to local time of metrics source
130   -V, --version         display version number and exit
131   -?, --help            show this usage message and exit
133 Protocol options:
134   -b N, --batch=N       fetch N metrics at a time for -f and -v [20]
135   -d, --desc            get and print metric description
136   -f, --fetch           fetch and print values for all instances
137   -F, --fetchall        fetch and print values for non-enumerable indoms
138   -m, --pmid            print PMID
139   -M, --fullpmid        print PMID in verbose format
140   -t, --oneline         get and display (terse) oneline text
141   -T, --helptext        get and display (verbose) help text
143 Metrics options:
144   -c FILE, --derived=FILE
145                         load derived metric definitions from FILE(s)
146   -x, --events          unpack and report on any fetched event records
147   -v, --verify          verify mode, be quiet and only report errors
148 +++ -K clear,400,TMP.$DSO_SUFFIX +++
149 pminfo: __pmSpecLocalPMDA failed: unexpected text after clear op in spec
150 Usage: pminfo [options] [metricname ...]
152 General options:
153   -a FILE, --archive=FILE
154                         metrics source is a PCP log archive
155   -h HOST, --host=HOST  metrics source is PMCD on host
156   --container=NAME      specify an individual container to be queried
157   -L, --local-PMDA      metrics source is local connection to a PMDA
158   -K SPEC, --spec-local=SPEC
159                         optional additional PMDA spec for local connection
160   -n FILE, --namespace=FILE
161                         use an alternative PMNS
162   -N FILE, --uniqnames=FILE
163                         like -n but only one name allowed for each PMID
164   -O TIME, --origin=TIME
165                         initial sample time within the time window
166   -Z TZ, --timezone=TZ  set reporting timezone
167   -z, --hostzone        set reporting timezone to local time of metrics source
168   -V, --version         display version number and exit
169   -?, --help            show this usage message and exit
171 Protocol options:
172   -b N, --batch=N       fetch N metrics at a time for -f and -v [20]
173   -d, --desc            get and print metric description
174   -f, --fetch           fetch and print values for all instances
175   -F, --fetchall        fetch and print values for non-enumerable indoms
176   -m, --pmid            print PMID
177   -M, --fullpmid        print PMID in verbose format
178   -t, --oneline         get and display (terse) oneline text
179   -T, --helptext        get and display (verbose) help text
181 Metrics options:
182   -c FILE, --derived=FILE
183                         load derived metric definitions from FILE(s)
184   -x, --events          unpack and report on any fetched event records
185   -v, --verify          verify mode, be quiet and only report errors
186 +++ -K clear,400,TMP.$DSO_SUFFIX, +++
187 pminfo: __pmSpecLocalPMDA failed: unexpected text after clear op in spec
188 Usage: pminfo [options] [metricname ...]
190 General options:
191   -a FILE, --archive=FILE
192                         metrics source is a PCP log archive
193   -h HOST, --host=HOST  metrics source is PMCD on host
194   --container=NAME      specify an individual container to be queried
195   -L, --local-PMDA      metrics source is local connection to a PMDA
196   -K SPEC, --spec-local=SPEC
197                         optional additional PMDA spec for local connection
198   -n FILE, --namespace=FILE
199                         use an alternative PMNS
200   -N FILE, --uniqnames=FILE
201                         like -n but only one name allowed for each PMID
202   -O TIME, --origin=TIME
203                         initial sample time within the time window
204   -Z TZ, --timezone=TZ  set reporting timezone
205   -z, --hostzone        set reporting timezone to local time of metrics source
206   -V, --version         display version number and exit
207   -?, --help            show this usage message and exit
209 Protocol options:
210   -b N, --batch=N       fetch N metrics at a time for -f and -v [20]
211   -d, --desc            get and print metric description
212   -f, --fetch           fetch and print values for all instances
213   -F, --fetchall        fetch and print values for non-enumerable indoms
214   -m, --pmid            print PMID
215   -M, --fullpmid        print PMID in verbose format
216   -t, --oneline         get and display (terse) oneline text
217   -T, --helptext        get and display (verbose) help text
219 Metrics options:
220   -c FILE, --derived=FILE
221                         load derived metric definitions from FILE(s)
222   -x, --events          unpack and report on any fetched event records
223   -v, --verify          verify mode, be quiet and only report errors
224 +++ -K clear,400,TMP.$DSO_SUFFIX,sample_init +++
225 pminfo: __pmSpecLocalPMDA failed: unexpected text after clear op in spec
226 Usage: pminfo [options] [metricname ...]
228 General options:
229   -a FILE, --archive=FILE
230                         metrics source is a PCP log archive
231   -h HOST, --host=HOST  metrics source is PMCD on host
232   --container=NAME      specify an individual container to be queried
233   -L, --local-PMDA      metrics source is local connection to a PMDA
234   -K SPEC, --spec-local=SPEC
235                         optional additional PMDA spec for local connection
236   -n FILE, --namespace=FILE
237                         use an alternative PMNS
238   -N FILE, --uniqnames=FILE
239                         like -n but only one name allowed for each PMID
240   -O TIME, --origin=TIME
241                         initial sample time within the time window
242   -Z TZ, --timezone=TZ  set reporting timezone
243   -z, --hostzone        set reporting timezone to local time of metrics source
244   -V, --version         display version number and exit
245   -?, --help            show this usage message and exit
247 Protocol options:
248   -b N, --batch=N       fetch N metrics at a time for -f and -v [20]
249   -d, --desc            get and print metric description
250   -f, --fetch           fetch and print values for all instances
251   -F, --fetchall        fetch and print values for non-enumerable indoms
252   -m, --pmid            print PMID
253   -M, --fullpmid        print PMID in verbose format
254   -t, --oneline         get and display (terse) oneline text
255   -T, --helptext        get and display (verbose) help text
257 Metrics options:
258   -c FILE, --derived=FILE
259                         load derived metric definitions from FILE(s)
260   -x, --events          unpack and report on any fetched event records
261   -v, --verify          verify mode, be quiet and only report errors
262 +++ -K clear,,TMP.$DSO_SUFFIX,sample_init +++
263 pminfo: __pmSpecLocalPMDA failed: unexpected text after clear op in spec
264 Usage: pminfo [options] [metricname ...]
266 General options:
267   -a FILE, --archive=FILE
268                         metrics source is a PCP log archive
269   -h HOST, --host=HOST  metrics source is PMCD on host
270   --container=NAME      specify an individual container to be queried
271   -L, --local-PMDA      metrics source is local connection to a PMDA
272   -K SPEC, --spec-local=SPEC
273                         optional additional PMDA spec for local connection
274   -n FILE, --namespace=FILE
275                         use an alternative PMNS
276   -N FILE, --uniqnames=FILE
277                         like -n but only one name allowed for each PMID
278   -O TIME, --origin=TIME
279                         initial sample time within the time window
280   -Z TZ, --timezone=TZ  set reporting timezone
281   -z, --hostzone        set reporting timezone to local time of metrics source
282   -V, --version         display version number and exit
283   -?, --help            show this usage message and exit
285 Protocol options:
286   -b N, --batch=N       fetch N metrics at a time for -f and -v [20]
287   -d, --desc            get and print metric description
288   -f, --fetch           fetch and print values for all instances
289   -F, --fetchall        fetch and print values for non-enumerable indoms
290   -m, --pmid            print PMID
291   -M, --fullpmid        print PMID in verbose format
292   -t, --oneline         get and display (terse) oneline text
293   -T, --helptext        get and display (verbose) help text
295 Metrics options:
296   -c FILE, --derived=FILE
297                         load derived metric definitions from FILE(s)
298   -x, --events          unpack and report on any fetched event records
299   -v, --verify          verify mode, be quiet and only report errors
300 +++ -K clear,,,sample_init +++
301 pminfo: __pmSpecLocalPMDA failed: unexpected text after clear op in spec
302 Usage: pminfo [options] [metricname ...]
304 General options:
305   -a FILE, --archive=FILE
306                         metrics source is a PCP log archive
307   -h HOST, --host=HOST  metrics source is PMCD on host
308   --container=NAME      specify an individual container to be queried
309   -L, --local-PMDA      metrics source is local connection to a PMDA
310   -K SPEC, --spec-local=SPEC
311                         optional additional PMDA spec for local connection
312   -n FILE, --namespace=FILE
313                         use an alternative PMNS
314   -N FILE, --uniqnames=FILE
315                         like -n but only one name allowed for each PMID
316   -O TIME, --origin=TIME
317                         initial sample time within the time window
318   -Z TZ, --timezone=TZ  set reporting timezone
319   -z, --hostzone        set reporting timezone to local time of metrics source
320   -V, --version         display version number and exit
321   -?, --help            show this usage message and exit
323 Protocol options:
324   -b N, --batch=N       fetch N metrics at a time for -f and -v [20]
325   -d, --desc            get and print metric description
326   -f, --fetch           fetch and print values for all instances
327   -F, --fetchall        fetch and print values for non-enumerable indoms
328   -m, --pmid            print PMID
329   -M, --fullpmid        print PMID in verbose format
330   -t, --oneline         get and display (terse) oneline text
331   -T, --helptext        get and display (verbose) help text
333 Metrics options:
334   -c FILE, --derived=FILE
335                         load derived metric definitions from FILE(s)
336   -x, --events          unpack and report on any fetched event records
337   -v, --verify          verify mode, be quiet and only report errors
338 +++ -K clear,,TMP.$DSO_SUFFIX,sample_init +++
339 pminfo: __pmSpecLocalPMDA failed: unexpected text after clear op in spec
340 Usage: pminfo [options] [metricname ...]
342 General options:
343   -a FILE, --archive=FILE
344                         metrics source is a PCP log archive
345   -h HOST, --host=HOST  metrics source is PMCD on host
346   --container=NAME      specify an individual container to be queried
347   -L, --local-PMDA      metrics source is local connection to a PMDA
348   -K SPEC, --spec-local=SPEC
349                         optional additional PMDA spec for local connection
350   -n FILE, --namespace=FILE
351                         use an alternative PMNS
352   -N FILE, --uniqnames=FILE
353                         like -n but only one name allowed for each PMID
354   -O TIME, --origin=TIME
355                         initial sample time within the time window
356   -Z TZ, --timezone=TZ  set reporting timezone
357   -z, --hostzone        set reporting timezone to local time of metrics source
358   -V, --version         display version number and exit
359   -?, --help            show this usage message and exit
361 Protocol options:
362   -b N, --batch=N       fetch N metrics at a time for -f and -v [20]
363   -d, --desc            get and print metric description
364   -f, --fetch           fetch and print values for all instances
365   -F, --fetchall        fetch and print values for non-enumerable indoms
366   -m, --pmid            print PMID
367   -M, --fullpmid        print PMID in verbose format
368   -t, --oneline         get and display (terse) oneline text
369   -T, --helptext        get and display (verbose) help text
371 Metrics options:
372   -c FILE, --derived=FILE
373                         load derived metric definitions from FILE(s)
374   -x, --events          unpack and report on any fetched event records
375   -v, --verify          verify mode, be quiet and only report errors
376 +++ -K clear,400,,sample_init +++
377 pminfo: __pmSpecLocalPMDA failed: unexpected text after clear op in spec
378 Usage: pminfo [options] [metricname ...]
380 General options:
381   -a FILE, --archive=FILE
382                         metrics source is a PCP log archive
383   -h HOST, --host=HOST  metrics source is PMCD on host
384   --container=NAME      specify an individual container to be queried
385   -L, --local-PMDA      metrics source is local connection to a PMDA
386   -K SPEC, --spec-local=SPEC
387                         optional additional PMDA spec for local connection
388   -n FILE, --namespace=FILE
389                         use an alternative PMNS
390   -N FILE, --uniqnames=FILE
391                         like -n but only one name allowed for each PMID
392   -O TIME, --origin=TIME
393                         initial sample time within the time window
394   -Z TZ, --timezone=TZ  set reporting timezone
395   -z, --hostzone        set reporting timezone to local time of metrics source
396   -V, --version         display version number and exit
397   -?, --help            show this usage message and exit
399 Protocol options:
400   -b N, --batch=N       fetch N metrics at a time for -f and -v [20]
401   -d, --desc            get and print metric description
402   -f, --fetch           fetch and print values for all instances
403   -F, --fetchall        fetch and print values for non-enumerable indoms
404   -m, --pmid            print PMID
405   -M, --fullpmid        print PMID in verbose format
406   -t, --oneline         get and display (terse) oneline text
407   -T, --helptext        get and display (verbose) help text
409 Metrics options:
410   -c FILE, --derived=FILE
411                         load derived metric definitions from FILE(s)
412   -x, --events          unpack and report on any fetched event records
413   -v, --verify          verify mode, be quiet and only report errors
414 +++ -K add +++
415 pminfo: __pmSpecLocalPMDA failed: expected , after op in spec
416 Usage: pminfo [options] [metricname ...]
418 General options:
419   -a FILE, --archive=FILE
420                         metrics source is a PCP log archive
421   -h HOST, --host=HOST  metrics source is PMCD on host
422   --container=NAME      specify an individual container to be queried
423   -L, --local-PMDA      metrics source is local connection to a PMDA
424   -K SPEC, --spec-local=SPEC
425                         optional additional PMDA spec for local connection
426   -n FILE, --namespace=FILE
427                         use an alternative PMNS
428   -N FILE, --uniqnames=FILE
429                         like -n but only one name allowed for each PMID
430   -O TIME, --origin=TIME
431                         initial sample time within the time window
432   -Z TZ, --timezone=TZ  set reporting timezone
433   -z, --hostzone        set reporting timezone to local time of metrics source
434   -V, --version         display version number and exit
435   -?, --help            show this usage message and exit
437 Protocol options:
438   -b N, --batch=N       fetch N metrics at a time for -f and -v [20]
439   -d, --desc            get and print metric description
440   -f, --fetch           fetch and print values for all instances
441   -F, --fetchall        fetch and print values for non-enumerable indoms
442   -m, --pmid            print PMID
443   -M, --fullpmid        print PMID in verbose format
444   -t, --oneline         get and display (terse) oneline text
445   -T, --helptext        get and display (verbose) help text
447 Metrics options:
448   -c FILE, --derived=FILE
449                         load derived metric definitions from FILE(s)
450   -x, --events          unpack and report on any fetched event records
451   -v, --verify          verify mode, be quiet and only report errors
452 +++ -K add, +++
453 pminfo: __pmSpecLocalPMDA failed: missing domain in spec
454 Usage: pminfo [options] [metricname ...]
456 General options:
457   -a FILE, --archive=FILE
458                         metrics source is a PCP log archive
459   -h HOST, --host=HOST  metrics source is PMCD on host
460   --container=NAME      specify an individual container to be queried
461   -L, --local-PMDA      metrics source is local connection to a PMDA
462   -K SPEC, --spec-local=SPEC
463                         optional additional PMDA spec for local connection
464   -n FILE, --namespace=FILE
465                         use an alternative PMNS
466   -N FILE, --uniqnames=FILE
467                         like -n but only one name allowed for each PMID
468   -O TIME, --origin=TIME
469                         initial sample time within the time window
470   -Z TZ, --timezone=TZ  set reporting timezone
471   -z, --hostzone        set reporting timezone to local time of metrics source
472   -V, --version         display version number and exit
473   -?, --help            show this usage message and exit
475 Protocol options:
476   -b N, --batch=N       fetch N metrics at a time for -f and -v [20]
477   -d, --desc            get and print metric description
478   -f, --fetch           fetch and print values for all instances
479   -F, --fetchall        fetch and print values for non-enumerable indoms
480   -m, --pmid            print PMID
481   -M, --fullpmid        print PMID in verbose format
482   -t, --oneline         get and display (terse) oneline text
483   -T, --helptext        get and display (verbose) help text
485 Metrics options:
486   -c FILE, --derived=FILE
487                         load derived metric definitions from FILE(s)
488   -x, --events          unpack and report on any fetched event records
489   -v, --verify          verify mode, be quiet and only report errors
490 +++ -K add,400 +++
491 pminfo: __pmSpecLocalPMDA failed: missing dso-path in spec
492 Usage: pminfo [options] [metricname ...]
494 General options:
495   -a FILE, --archive=FILE
496                         metrics source is a PCP log archive
497   -h HOST, --host=HOST  metrics source is PMCD on host
498   --container=NAME      specify an individual container to be queried
499   -L, --local-PMDA      metrics source is local connection to a PMDA
500   -K SPEC, --spec-local=SPEC
501                         optional additional PMDA spec for local connection
502   -n FILE, --namespace=FILE
503                         use an alternative PMNS
504   -N FILE, --uniqnames=FILE
505                         like -n but only one name allowed for each PMID
506   -O TIME, --origin=TIME
507                         initial sample time within the time window
508   -Z TZ, --timezone=TZ  set reporting timezone
509   -z, --hostzone        set reporting timezone to local time of metrics source
510   -V, --version         display version number and exit
511   -?, --help            show this usage message and exit
513 Protocol options:
514   -b N, --batch=N       fetch N metrics at a time for -f and -v [20]
515   -d, --desc            get and print metric description
516   -f, --fetch           fetch and print values for all instances
517   -F, --fetchall        fetch and print values for non-enumerable indoms
518   -m, --pmid            print PMID
519   -M, --fullpmid        print PMID in verbose format
520   -t, --oneline         get and display (terse) oneline text
521   -T, --helptext        get and display (verbose) help text
523 Metrics options:
524   -c FILE, --derived=FILE
525                         load derived metric definitions from FILE(s)
526   -x, --events          unpack and report on any fetched event records
527   -v, --verify          verify mode, be quiet and only report errors
528 +++ -K add,400, +++
529 pminfo: __pmSpecLocalPMDA failed: missing dso-path in spec
530 Usage: pminfo [options] [metricname ...]
532 General options:
533   -a FILE, --archive=FILE
534                         metrics source is a PCP log archive
535   -h HOST, --host=HOST  metrics source is PMCD on host
536   --container=NAME      specify an individual container to be queried
537   -L, --local-PMDA      metrics source is local connection to a PMDA
538   -K SPEC, --spec-local=SPEC
539                         optional additional PMDA spec for local connection
540   -n FILE, --namespace=FILE
541                         use an alternative PMNS
542   -N FILE, --uniqnames=FILE
543                         like -n but only one name allowed for each PMID
544   -O TIME, --origin=TIME
545                         initial sample time within the time window
546   -Z TZ, --timezone=TZ  set reporting timezone
547   -z, --hostzone        set reporting timezone to local time of metrics source
548   -V, --version         display version number and exit
549   -?, --help            show this usage message and exit
551 Protocol options:
552   -b N, --batch=N       fetch N metrics at a time for -f and -v [20]
553   -d, --desc            get and print metric description
554   -f, --fetch           fetch and print values for all instances
555   -F, --fetchall        fetch and print values for non-enumerable indoms
556   -m, --pmid            print PMID
557   -M, --fullpmid        print PMID in verbose format
558   -t, --oneline         get and display (terse) oneline text
559   -T, --helptext        get and display (verbose) help text
561 Metrics options:
562   -c FILE, --derived=FILE
563                         load derived metric definitions from FILE(s)
564   -x, --events          unpack and report on any fetched event records
565   -v, --verify          verify mode, be quiet and only report errors
566 +++ -K add,400,TMP.$DSO_SUFFIX +++
567 pminfo: __pmSpecLocalPMDA failed: missing init-routine in spec
568 Usage: pminfo [options] [metricname ...]
570 General options:
571   -a FILE, --archive=FILE
572                         metrics source is a PCP log archive
573   -h HOST, --host=HOST  metrics source is PMCD on host
574   --container=NAME      specify an individual container to be queried
575   -L, --local-PMDA      metrics source is local connection to a PMDA
576   -K SPEC, --spec-local=SPEC
577                         optional additional PMDA spec for local connection
578   -n FILE, --namespace=FILE
579                         use an alternative PMNS
580   -N FILE, --uniqnames=FILE
581                         like -n but only one name allowed for each PMID
582   -O TIME, --origin=TIME
583                         initial sample time within the time window
584   -Z TZ, --timezone=TZ  set reporting timezone
585   -z, --hostzone        set reporting timezone to local time of metrics source
586   -V, --version         display version number and exit
587   -?, --help            show this usage message and exit
589 Protocol options:
590   -b N, --batch=N       fetch N metrics at a time for -f and -v [20]
591   -d, --desc            get and print metric description
592   -f, --fetch           fetch and print values for all instances
593   -F, --fetchall        fetch and print values for non-enumerable indoms
594   -m, --pmid            print PMID
595   -M, --fullpmid        print PMID in verbose format
596   -t, --oneline         get and display (terse) oneline text
597   -T, --helptext        get and display (verbose) help text
599 Metrics options:
600   -c FILE, --derived=FILE
601                         load derived metric definitions from FILE(s)
602   -x, --events          unpack and report on any fetched event records
603   -v, --verify          verify mode, be quiet and only report errors
604 +++ -K add,400,TMP.$DSO_SUFFIX, +++
605 pminfo: __pmSpecLocalPMDA failed: missing init-routine in spec
606 Usage: pminfo [options] [metricname ...]
608 General options:
609   -a FILE, --archive=FILE
610                         metrics source is a PCP log archive
611   -h HOST, --host=HOST  metrics source is PMCD on host
612   --container=NAME      specify an individual container to be queried
613   -L, --local-PMDA      metrics source is local connection to a PMDA
614   -K SPEC, --spec-local=SPEC
615                         optional additional PMDA spec for local connection
616   -n FILE, --namespace=FILE
617                         use an alternative PMNS
618   -N FILE, --uniqnames=FILE
619                         like -n but only one name allowed for each PMID
620   -O TIME, --origin=TIME
621                         initial sample time within the time window
622   -Z TZ, --timezone=TZ  set reporting timezone
623   -z, --hostzone        set reporting timezone to local time of metrics source
624   -V, --version         display version number and exit
625   -?, --help            show this usage message and exit
627 Protocol options:
628   -b N, --batch=N       fetch N metrics at a time for -f and -v [20]
629   -d, --desc            get and print metric description
630   -f, --fetch           fetch and print values for all instances
631   -F, --fetchall        fetch and print values for non-enumerable indoms
632   -m, --pmid            print PMID
633   -M, --fullpmid        print PMID in verbose format
634   -t, --oneline         get and display (terse) oneline text
635   -T, --helptext        get and display (verbose) help text
637 Metrics options:
638   -c FILE, --derived=FILE
639                         load derived metric definitions from FILE(s)
640   -x, --events          unpack and report on any fetched event records
641   -v, --verify          verify mode, be quiet and only report errors
642 +++ -K add,400,TMP.$DSO_SUFFIX,sample_init +++
643 build_dsotab: parsing $PCP_PMCDCONF_PATH
644 NotifyEndLocalContext: DSO PMDA $PCP_VAR_DIR/pmdas/sample/pmda_sample.$DSO_SUFFIX (30) notified of context 0 close
645 NotifyEndLocalContext: DSO PMDA $PCP_VAR_DIR/pmdas/linux/pmda_linux.$DSO_SUFFIX (60) notified of context 0 close
646 NotifyEndLocalContext: DSO PMDA TMP.$DSO_SUFFIX (400) notified of context 0 close
648 sample.string.write_me PMID: 30.0.29
649     value 13
651 qa.string.write_me PMID: 400.0.29
652     value 13
653 +++ -K del +++
654 pminfo: __pmSpecLocalPMDA failed: expected , after op in spec
655 Usage: pminfo [options] [metricname ...]
657 General options:
658   -a FILE, --archive=FILE
659                         metrics source is a PCP log archive
660   -h HOST, --host=HOST  metrics source is PMCD on host
661   --container=NAME      specify an individual container to be queried
662   -L, --local-PMDA      metrics source is local connection to a PMDA
663   -K SPEC, --spec-local=SPEC
664                         optional additional PMDA spec for local connection
665   -n FILE, --namespace=FILE
666                         use an alternative PMNS
667   -N FILE, --uniqnames=FILE
668                         like -n but only one name allowed for each PMID
669   -O TIME, --origin=TIME
670                         initial sample time within the time window
671   -Z TZ, --timezone=TZ  set reporting timezone
672   -z, --hostzone        set reporting timezone to local time of metrics source
673   -V, --version         display version number and exit
674   -?, --help            show this usage message and exit
676 Protocol options:
677   -b N, --batch=N       fetch N metrics at a time for -f and -v [20]
678   -d, --desc            get and print metric description
679   -f, --fetch           fetch and print values for all instances
680   -F, --fetchall        fetch and print values for non-enumerable indoms
681   -m, --pmid            print PMID
682   -M, --fullpmid        print PMID in verbose format
683   -t, --oneline         get and display (terse) oneline text
684   -T, --helptext        get and display (verbose) help text
686 Metrics options:
687   -c FILE, --derived=FILE
688                         load derived metric definitions from FILE(s)
689   -x, --events          unpack and report on any fetched event records
690   -v, --verify          verify mode, be quiet and only report errors
691 +++ -K del, +++
692 pminfo: __pmSpecLocalPMDA failed: missing domain in spec
693 Usage: pminfo [options] [metricname ...]
695 General options:
696   -a FILE, --archive=FILE
697                         metrics source is a PCP log archive
698   -h HOST, --host=HOST  metrics source is PMCD on host
699   --container=NAME      specify an individual container to be queried
700   -L, --local-PMDA      metrics source is local connection to a PMDA
701   -K SPEC, --spec-local=SPEC
702                         optional additional PMDA spec for local connection
703   -n FILE, --namespace=FILE
704                         use an alternative PMNS
705   -N FILE, --uniqnames=FILE
706                         like -n but only one name allowed for each PMID
707   -O TIME, --origin=TIME
708                         initial sample time within the time window
709   -Z TZ, --timezone=TZ  set reporting timezone
710   -z, --hostzone        set reporting timezone to local time of metrics source
711   -V, --version         display version number and exit
712   -?, --help            show this usage message and exit
714 Protocol options:
715   -b N, --batch=N       fetch N metrics at a time for -f and -v [20]
716   -d, --desc            get and print metric description
717   -f, --fetch           fetch and print values for all instances
718   -F, --fetchall        fetch and print values for non-enumerable indoms
719   -m, --pmid            print PMID
720   -M, --fullpmid        print PMID in verbose format
721   -t, --oneline         get and display (terse) oneline text
722   -T, --helptext        get and display (verbose) help text
724 Metrics options:
725   -c FILE, --derived=FILE
726                         load derived metric definitions from FILE(s)
727   -x, --events          unpack and report on any fetched event records
728   -v, --verify          verify mode, be quiet and only report errors
729 +++ -K del,30 +++
730 build_dsotab: parsing $PCP_PMCDCONF_PATH
731 NotifyEndLocalContext: DSO PMDA $PCP_VAR_DIR/pmdas/linux/pmda_linux.$DSO_SUFFIX (60) notified of context 0 close
732 sample.string.write_me: pmLookupDesc: No PMCD agent for domain of request
733 qa.string.write_me: pmLookupDesc: No PMCD agent for domain of request
734 +++ -K del,30, +++
735 build_dsotab: parsing $PCP_PMCDCONF_PATH
736 NotifyEndLocalContext: DSO PMDA $PCP_VAR_DIR/pmdas/linux/pmda_linux.$DSO_SUFFIX (60) notified of context 0 close
737 sample.string.write_me: pmLookupDesc: No PMCD agent for domain of request
738 qa.string.write_me: pmLookupDesc: No PMCD agent for domain of request
739 +++ -K del,,sample/pmda_sample.$DSO_SUFFIX +++
740 build_dsotab: parsing $PCP_PMCDCONF_PATH
741 __pmLocalPMDA -> Unknown or illegal instance domain identifier
742 pminfo: __pmSpecLocalPMDA failed: __pmLocalPMDA: Unknown or illegal instance domain identifier
743 Usage: pminfo [options] [metricname ...]
745 General options:
746   -a FILE, --archive=FILE
747                         metrics source is a PCP log archive
748   -h HOST, --host=HOST  metrics source is PMCD on host
749   --container=NAME      specify an individual container to be queried
750   -L, --local-PMDA      metrics source is local connection to a PMDA
751   -K SPEC, --spec-local=SPEC
752                         optional additional PMDA spec for local connection
753   -n FILE, --namespace=FILE
754                         use an alternative PMNS
755   -N FILE, --uniqnames=FILE
756                         like -n but only one name allowed for each PMID
757   -O TIME, --origin=TIME
758                         initial sample time within the time window
759   -Z TZ, --timezone=TZ  set reporting timezone
760   -z, --hostzone        set reporting timezone to local time of metrics source
761   -V, --version         display version number and exit
762   -?, --help            show this usage message and exit
764 Protocol options:
765   -b N, --batch=N       fetch N metrics at a time for -f and -v [20]
766   -d, --desc            get and print metric description
767   -f, --fetch           fetch and print values for all instances
768   -F, --fetchall        fetch and print values for non-enumerable indoms
769   -m, --pmid            print PMID
770   -M, --fullpmid        print PMID in verbose format
771   -t, --oneline         get and display (terse) oneline text
772   -T, --helptext        get and display (verbose) help text
774 Metrics options:
775   -c FILE, --derived=FILE
776                         load derived metric definitions from FILE(s)
777   -x, --events          unpack and report on any fetched event records
778   -v, --verify          verify mode, be quiet and only report errors
779 +++ -K del,30,sample/pmda_sample.$DSO_SUFFIX, +++
780 build_dsotab: parsing $PCP_PMCDCONF_PATH
781 NotifyEndLocalContext: DSO PMDA $PCP_VAR_DIR/pmdas/linux/pmda_linux.$DSO_SUFFIX (60) notified of context 0 close
782 sample.string.write_me: pmLookupDesc: No PMCD agent for domain of request
783 qa.string.write_me: pmLookupDesc: No PMCD agent for domain of request
784 +++ -K del,30,sample/pmda_sample.$DSO_SUFFIX,sample_init +++
785 build_dsotab: parsing $PCP_PMCDCONF_PATH
786 NotifyEndLocalContext: DSO PMDA $PCP_VAR_DIR/pmdas/linux/pmda_linux.$DSO_SUFFIX (60) notified of context 0 close
787 sample.string.write_me: pmLookupDesc: No PMCD agent for domain of request
788 qa.string.write_me: pmLookupDesc: No PMCD agent for domain of request
789 +++ -K del,, +++
790 pminfo: __pmSpecLocalPMDA failed: missing domain and dso-path in spec
791 Usage: pminfo [options] [metricname ...]
793 General options:
794   -a FILE, --archive=FILE
795                         metrics source is a PCP log archive
796   -h HOST, --host=HOST  metrics source is PMCD on host
797   --container=NAME      specify an individual container to be queried
798   -L, --local-PMDA      metrics source is local connection to a PMDA
799   -K SPEC, --spec-local=SPEC
800                         optional additional PMDA spec for local connection
801   -n FILE, --namespace=FILE
802                         use an alternative PMNS
803   -N FILE, --uniqnames=FILE
804                         like -n but only one name allowed for each PMID
805   -O TIME, --origin=TIME
806                         initial sample time within the time window
807   -Z TZ, --timezone=TZ  set reporting timezone
808   -z, --hostzone        set reporting timezone to local time of metrics source
809   -V, --version         display version number and exit
810   -?, --help            show this usage message and exit
812 Protocol options:
813   -b N, --batch=N       fetch N metrics at a time for -f and -v [20]
814   -d, --desc            get and print metric description
815   -f, --fetch           fetch and print values for all instances
816   -F, --fetchall        fetch and print values for non-enumerable indoms
817   -m, --pmid            print PMID
818   -M, --fullpmid        print PMID in verbose format
819   -t, --oneline         get and display (terse) oneline text
820   -T, --helptext        get and display (verbose) help text
822 Metrics options:
823   -c FILE, --derived=FILE
824                         load derived metric definitions from FILE(s)
825   -x, --events          unpack and report on any fetched event records
826   -v, --verify          verify mode, be quiet and only report errors
827 +++ -K del,,, +++
828 pminfo: __pmSpecLocalPMDA failed: missing domain and dso-path in spec
829 Usage: pminfo [options] [metricname ...]
831 General options:
832   -a FILE, --archive=FILE
833                         metrics source is a PCP log archive
834   -h HOST, --host=HOST  metrics source is PMCD on host
835   --container=NAME      specify an individual container to be queried
836   -L, --local-PMDA      metrics source is local connection to a PMDA
837   -K SPEC, --spec-local=SPEC
838                         optional additional PMDA spec for local connection
839   -n FILE, --namespace=FILE
840                         use an alternative PMNS
841   -N FILE, --uniqnames=FILE
842                         like -n but only one name allowed for each PMID
843   -O TIME, --origin=TIME
844                         initial sample time within the time window
845   -Z TZ, --timezone=TZ  set reporting timezone
846   -z, --hostzone        set reporting timezone to local time of metrics source
847   -V, --version         display version number and exit
848   -?, --help            show this usage message and exit
850 Protocol options:
851   -b N, --batch=N       fetch N metrics at a time for -f and -v [20]
852   -d, --desc            get and print metric description
853   -f, --fetch           fetch and print values for all instances
854   -F, --fetchall        fetch and print values for non-enumerable indoms
855   -m, --pmid            print PMID
856   -M, --fullpmid        print PMID in verbose format
857   -t, --oneline         get and display (terse) oneline text
858   -T, --helptext        get and display (verbose) help text
860 Metrics options:
861   -c FILE, --derived=FILE
862                         load derived metric definitions from FILE(s)
863   -x, --events          unpack and report on any fetched event records
864   -v, --verify          verify mode, be quiet and only report errors
865 +++ -K del,,,sample_init +++
866 pminfo: __pmSpecLocalPMDA failed: missing domain and dso-path in spec
867 Usage: pminfo [options] [metricname ...]
869 General options:
870   -a FILE, --archive=FILE
871                         metrics source is a PCP log archive
872   -h HOST, --host=HOST  metrics source is PMCD on host
873   --container=NAME      specify an individual container to be queried
874   -L, --local-PMDA      metrics source is local connection to a PMDA
875   -K SPEC, --spec-local=SPEC
876                         optional additional PMDA spec for local connection
877   -n FILE, --namespace=FILE
878                         use an alternative PMNS
879   -N FILE, --uniqnames=FILE
880                         like -n but only one name allowed for each PMID
881   -O TIME, --origin=TIME
882                         initial sample time within the time window
883   -Z TZ, --timezone=TZ  set reporting timezone
884   -z, --hostzone        set reporting timezone to local time of metrics source
885   -V, --version         display version number and exit
886   -?, --help            show this usage message and exit
888 Protocol options:
889   -b N, --batch=N       fetch N metrics at a time for -f and -v [20]
890   -d, --desc            get and print metric description
891   -f, --fetch           fetch and print values for all instances
892   -F, --fetchall        fetch and print values for non-enumerable indoms
893   -m, --pmid            print PMID
894   -M, --fullpmid        print PMID in verbose format
895   -t, --oneline         get and display (terse) oneline text
896   -T, --helptext        get and display (verbose) help text
898 Metrics options:
899   -c FILE, --derived=FILE
900                         load derived metric definitions from FILE(s)
901   -x, --events          unpack and report on any fetched event records
902   -v, --verify          verify mode, be quiet and only report errors
904 === some __pmLocalPMDA() exercises ===
905 NotifyEndLocalContext: DSO PMDA $PCP_VAR_DIR/pmdas/sample/pmda_sample.$DSO_SUFFIX (130) notified of context 0 close
906 NotifyEndLocalContext: DSO PMDA TMP.$DSO_SUFFIX (400) notified of context 0 close
908 tmpsample.bin PMID: 130.0.6
909     inst [100 or "bin-100"] value 100
910     inst [200 or "bin-200"] value 200
911     inst [300 or "bin-300"] value 300
912     inst [400 or "bin-400"] value 400
913     inst [500 or "bin-500"] value 500
914     inst [600 or "bin-600"] value 600
915     inst [700 or "bin-700"] value 700
916     inst [800 or "bin-800"] value 800
917     inst [900 or "bin-900"] value 900
919 === other tools than know about -K ...
921 metric:    sampledso.bin
922 host:      HOST
923 semantics: instantaneous value
924 units:     none
925 samples:   3
926 interval:  0.10 sec
928     bin-100     bin-900 
929         100         900 
930         100         900 
931         100         900 
933 sampledso.bin 9 "bin-100" "bin-200" "bin-300" "bin-400" "bin-500" "bin-600" "bin-700" "bin-800" "bin-900"