pmrep: update TODO, man page
[pcp.git] / qa / 728.out
blob8a32f3fc442e76e1549b56000fb27f162c588688
1 QA output created by 728
2 == Arguments: none
3 End of option processing
4 Options structure dump:
5     version: 2
6     flags: 0x3 (init,done)
7     errors: 0
8     context: 0x0 (-)
9     nhosts: 0
10     narchives: 0
11     start: -
12     finish: -
13     origin: -
14     interval: -
15     align_optarg: -
16     start_optarg: -
17     finish_optarg: -
18     origin_optarg: -
19     guiport_optarg: -
20     timezone: -
21     samples: 0
22     guiport: 0
23     guiflag: 0
24     tzflag: 0
25     Lflag: 0
26 == Arguments: usage (x2)
27 Warning: usage error detected
28 Usage: getoptions [options]
30 General options:
31   -A TIME, --align=TIME align sample times on natural boundaries
32   -a FILE, --archive=FILE
33                         metrics source is a PCP log archive
34   -g, --guimode         start in GUI mode with new time control
35   -h HOST, --host=HOST  metrics source is PMCD on host
36   -n FILE, --namespace=FILE
37                         use an alternative PMNS
38   -O TIME, --origin=TIME
39                         initial sample time within the time window
40   -p N, --guiport=N     port for connection to existing time control
41   -S TIME, --start=TIME start of the time window
42   -s N, --samples=N     terminate after this many samples
43   -T TIME, --finish=TIME
44                         end of the time window
45   -t DELTA, --interval=DELTA
46                         sampling interval
47   -Z TZ, --timezone=TZ  set reporting timezone
48   -z, --hostzone        set reporting timezone to local time of metrics source
49   -V, --version         display version number and exit
50   -?, --help            show this usage message and exit
52 Context options:
53   -K SPEC, --spec-local=SPEC
54                         optional additional PMDA spec for local connection
55   -L, --local-PMDA      metrics source is local connection to a PMDA
56   -H FILE, --hostsfile=FILE
57                         read metric source hosts from a file
58   --host-list=HOSTS     comma-separated list of metric source hosts
59   --archive-list=FILES  comma-separated list of metric source archives
60   --archive-folio=FILE  read metric source archives from a folio
62 Testing options:
63   -x, --extra           an extra option, for testing
64   -X ARG, --eXtra=ARG   an extra option with an argument
65   -y                    a short-option-only without argument
66   -Y N                  a short-option-only with an argument
67   --fubar               a long-option-only without argument
68   --foobar=N            a long-option-only with an argument
69 End of option processing
70 Options structure dump:
71     version: 2
72     flags: 0xb (init,done,usage_err)
73     errors: 1
74     context: 0x0 (-)
75     nhosts: 0
76     narchives: 0
77     start: -
78     finish: -
79     origin: -
80     interval: -
81     align_optarg: -
82     start_optarg: -
83     finish_optarg: -
84     origin_optarg: -
85     guiport_optarg: -
86     timezone: -
87     samples: 0
88     guiport: 0
89     guiflag: 0
90     tzflag: 0
91     Lflag: 0
92 Warning: usage error detected
93 Usage: getoptions [options]
95 General options:
96   -A TIME, --align=TIME align sample times on natural boundaries
97   -a FILE, --archive=FILE
98                         metrics source is a PCP log archive
99   -g, --guimode         start in GUI mode with new time control
100   -h HOST, --host=HOST  metrics source is PMCD on host
101   -n FILE, --namespace=FILE
102                         use an alternative PMNS
103   -O TIME, --origin=TIME
104                         initial sample time within the time window
105   -p N, --guiport=N     port for connection to existing time control
106   -S TIME, --start=TIME start of the time window
107   -s N, --samples=N     terminate after this many samples
108   -T TIME, --finish=TIME
109                         end of the time window
110   -t DELTA, --interval=DELTA
111                         sampling interval
112   -Z TZ, --timezone=TZ  set reporting timezone
113   -z, --hostzone        set reporting timezone to local time of metrics source
114   -V, --version         display version number and exit
115   -?, --help            show this usage message and exit
117 Context options:
118   -K SPEC, --spec-local=SPEC
119                         optional additional PMDA spec for local connection
120   -L, --local-PMDA      metrics source is local connection to a PMDA
121   -H FILE, --hostsfile=FILE
122                         read metric source hosts from a file
123   --host-list=HOSTS     comma-separated list of metric source hosts
124   --archive-list=FILES  comma-separated list of metric source archives
125   --archive-folio=FILE  read metric source archives from a folio
127 Testing options:
128   -x, --extra           an extra option, for testing
129   -X ARG, --eXtra=ARG   an extra option with an argument
130   -y                    a short-option-only without argument
131   -Y N                  a short-option-only with an argument
132   --fubar               a long-option-only without argument
133   --foobar=N            a long-option-only with an argument
134 End of option processing
135 Options structure dump:
136     version: 2
137     flags: 0xb (init,done,usage_err)
138     errors: 1
139     context: 0x0 (-)
140     nhosts: 0
141     narchives: 0
142     start: -
143     finish: -
144     origin: -
145     interval: -
146     align_optarg: -
147     start_optarg: -
148     finish_optarg: -
149     origin_optarg: -
150     guiport_optarg: -
151     timezone: -
152     samples: 0
153     guiport: 0
154     guiflag: 0
155     tzflag: 0
156     Lflag: 0
157 == Arguments: own options (x2)
158 Got option: x index=0 [errors=0]
159  -> x option has no argument
160 Got option: X index=0 [errors=0]
161  -> X option argument was: '(null)'
162 End of option processing
163 Options structure dump:
164     version: 2
165     flags: 0x3 (init,done)
166     errors: 0
167     context: 0x0 (-)
168     nhosts: 0
169     narchives: 0
170     start: -
171     finish: -
172     origin: -
173     interval: -
174     align_optarg: -
175     start_optarg: -
176     finish_optarg: -
177     origin_optarg: -
178     guiport_optarg: -
179     timezone: -
180     samples: 0
181     guiport: 0
182     guiflag: 0
183     tzflag: 0
184     Lflag: 0
185 Got option: x index=25 [errors=0]
186  -> x option has no argument
187 Got option: X index=26 [errors=0]
188  -> X option argument was: 'goodness'
189 End of option processing
190 Options structure dump:
191     version: 2
192     flags: 0x3 (init,done)
193     errors: 0
194     context: 0x0 (-)
195     nhosts: 0
196     narchives: 0
197     start: -
198     finish: -
199     origin: -
200     interval: -
201     align_optarg: -
202     start_optarg: -
203     finish_optarg: -
204     origin_optarg: -
205     guiport_optarg: -
206     timezone: -
207     samples: 0
208     guiport: 0
209     guiflag: 0
210     tzflag: 0
211     Lflag: 0
212 == Arguments: own short-only options
213 Got option: y index=0 [errors=0]
214  -> y option has no argument
215 Got option: Y index=0 [errors=0]
216  -> Y option argument was: '(null)'
217 End of option processing
218 Options structure dump:
219     version: 2
220     flags: 0x3 (init,done)
221     errors: 0
222     context: 0x0 (-)
223     nhosts: 0
224     narchives: 0
225     start: -
226     finish: -
227     origin: -
228     interval: -
229     align_optarg: -
230     start_optarg: -
231     finish_optarg: -
232     origin_optarg: -
233     guiport_optarg: -
234     timezone: -
235     samples: 0
236     guiport: 0
237     guiflag: 0
238     tzflag: 0
239     Lflag: 0
240 == Arguments: own long-only options
241 Got option: - index=29 [errors=0]
242  -> long-only option index=29
243 Got option: - index=30 [errors=0]
244  -> long-only option index=30
245 End of option processing
246 Options structure dump:
247     version: 2
248     flags: 0x3 (init,done)
249     errors: 0
250     context: 0x0 (-)
251     nhosts: 0
252     narchives: 0
253     start: -
254     finish: -
255     origin: -
256     interval: -
257     align_optarg: -
258     start_optarg: -
259     finish_optarg: -
260     origin_optarg: -
261     guiport_optarg: -
262     timezone: -
263     samples: 0
264     guiport: 0
265     guiflag: 0
266     tzflag: 0
267     Lflag: 0
268 == Arguments: one archive, all time options (x2)
269 End of option processing
270 Options structure dump:
271     version: 2
272     flags: 0x3 (init,done)
273     errors: 0
274     context: 0x2 (archive)
275     nhosts: 0
276     narchives: 1
277     archives: archives/20041125.0
278     start: -
279     finish: -
280     origin: -
281     interval: -
282     align_optarg: 1 minute
283     start_optarg: @10:15
284     finish_optarg: @10:30
285     origin_optarg: @10:10:10
286     guiport_optarg: -
287     timezone: -
288     samples: 0
289     guiport: 0
290     guiflag: 0
291     tzflag: 1
292     Lflag: 0
293 End of option processing
294 Options structure dump:
295     version: 2
296     flags: 0x3 (init,done)
297     errors: 0
298     context: 0x2 (archive)
299     nhosts: 0
300     narchives: 1
301     archives: archives/20041125.0
302     start: -
303     finish: -
304     origin: -
305     interval: -
306     align_optarg: 1 minute
307     start_optarg: @10:15
308     finish_optarg: @10:30
309     origin_optarg: @10:10:10
310     guiport_optarg: -
311     timezone: -
312     samples: 0
313     guiport: 0
314     guiflag: 0
315     tzflag: 1
316     Lflag: 0
317 == Arguments: one host (x2)
318 End of option processing
319 Options structure dump:
320     version: 2
321     flags: 0x3 (init,done)
322     errors: 0
323     context: 0x1 (host)
324     nhosts: 1
325     hosts: foo.bar.com
326     narchives: 0
327     start: -
328     finish: -
329     origin: -
330     interval: 00:01.000
331     align_optarg: -
332     start_optarg: -
333     finish_optarg: -
334     origin_optarg: -
335     guiport_optarg: -
336     timezone: -
337     samples: 5
338     guiport: 0
339     guiflag: 0
340     tzflag: 0
341     Lflag: 0
342 End of option processing
343 Options structure dump:
344     version: 2
345     flags: 0x3 (init,done)
346     errors: 0
347     context: 0x1 (host)
348     nhosts: 1
349     hosts: foo.bar.com
350     narchives: 0
351     start: -
352     finish: -
353     origin: -
354     interval: 00:01.000
355     align_optarg: -
356     start_optarg: -
357     finish_optarg: -
358     origin_optarg: -
359     guiport_optarg: -
360     timezone: -
361     samples: 5
362     guiport: 0
363     guiflag: 0
364     tzflag: 0
365     Lflag: 0
366 == Arguments: environment variables only
367 End of option processing
368 Options structure dump:
369     version: 2
370     flags: 0x103 (init,done,env_only)
371     errors: 0
372     context: 0x1 (host)
373     nhosts: 1
374     hosts: pcp.org
375     narchives: 0
376     start: -
377     finish: -
378     origin: -
379     interval: -
380     align_optarg: -
381     start_optarg: -
382     finish_optarg: -
383     origin_optarg: -
384     guiport_optarg: -
385     timezone: -
386     samples: 0
387     guiport: 0
388     guiflag: 0
389     tzflag: 0
390     Lflag: 0
391 == Arguments: host, interval and samples env vars
392 End of option processing
393 Options structure dump:
394     version: 2
395     flags: 0x3 (init,done)
396     errors: 0
397     context: 0x1 (host)
398     nhosts: 1
399     hosts: pcp.org
400     narchives: 0
401     start: -
402     finish: -
403     origin: -
404     interval: 00:02.000
405     align_optarg: -
406     start_optarg: -
407     finish_optarg: -
408     origin_optarg: -
409     guiport_optarg: -
410     timezone: -
411     samples: 5
412     guiport: 0
413     guiflag: 0
414     tzflag: 0
415     Lflag: 0
416 == Arguments: host list env var
417 Warning: usage error detected
418 getoptions: too many hosts requested: foo.com,bar.org
419 Usage: getoptions [options]
421 General options:
422   -A TIME, --align=TIME align sample times on natural boundaries
423   -a FILE, --archive=FILE
424                         metrics source is a PCP log archive
425   -g, --guimode         start in GUI mode with new time control
426   -h HOST, --host=HOST  metrics source is PMCD on host
427   -n FILE, --namespace=FILE
428                         use an alternative PMNS
429   -O TIME, --origin=TIME
430                         initial sample time within the time window
431   -p N, --guiport=N     port for connection to existing time control
432   -S TIME, --start=TIME start of the time window
433   -s N, --samples=N     terminate after this many samples
434   -T TIME, --finish=TIME
435                         end of the time window
436   -t DELTA, --interval=DELTA
437                         sampling interval
438   -Z TZ, --timezone=TZ  set reporting timezone
439   -z, --hostzone        set reporting timezone to local time of metrics source
440   -V, --version         display version number and exit
441   -?, --help            show this usage message and exit
443 Context options:
444   -K SPEC, --spec-local=SPEC
445                         optional additional PMDA spec for local connection
446   -L, --local-PMDA      metrics source is local connection to a PMDA
447   -H FILE, --hostsfile=FILE
448                         read metric source hosts from a file
449   --host-list=HOSTS     comma-separated list of metric source hosts
450   --archive-list=FILES  comma-separated list of metric source archives
451   --archive-folio=FILE  read metric source archives from a folio
453 Testing options:
454   -x, --extra           an extra option, for testing
455   -X ARG, --eXtra=ARG   an extra option with an argument
456   -y                    a short-option-only without argument
457   -Y N                  a short-option-only with an argument
458   --fubar               a long-option-only without argument
459   --foobar=N            a long-option-only with an argument
460 End of option processing
461 Options structure dump:
462     version: 2
463     flags: 0xb (init,done,usage_err)
464     errors: 1
465     context: 0x1 (host)
466     nhosts: 2
467     hosts: foo.com,bar.org
468     narchives: 0
469     start: -
470     finish: -
471     origin: -
472     interval: -
473     align_optarg: -
474     start_optarg: -
475     finish_optarg: -
476     origin_optarg: -
477     guiport_optarg: -
478     timezone: -
479     samples: 0
480     guiport: 0
481     guiflag: 0
482     tzflag: 0
483     Lflag: 0
484 == Arguments: archive, time window env vars
485 End of option processing
486 Options structure dump:
487     version: 2
488     flags: 0x3 (init,done)
489     errors: 0
490     context: 0x2 (archive)
491     nhosts: 0
492     narchives: 1
493     archives: archives/20041125.0
494     start: -
495     finish: -
496     origin: -
497     interval: -
498     align_optarg: -
499     start_optarg: @10:15
500     finish_optarg: @10:30
501     origin_optarg: @10:10:10
502     guiport_optarg: -
503     timezone: -
504     samples: 0
505     guiport: 0
506     guiflag: 0
507     tzflag: 1
508     Lflag: 0
509 == Arguments: archive list env var
510 Warning: usage error detected
511 getoptions: too many archives requested: foo,bar,moo
512 Usage: getoptions [options]
514 General options:
515   -A TIME, --align=TIME align sample times on natural boundaries
516   -a FILE, --archive=FILE
517                         metrics source is a PCP log archive
518   -g, --guimode         start in GUI mode with new time control
519   -h HOST, --host=HOST  metrics source is PMCD on host
520   -n FILE, --namespace=FILE
521                         use an alternative PMNS
522   -O TIME, --origin=TIME
523                         initial sample time within the time window
524   -p N, --guiport=N     port for connection to existing time control
525   -S TIME, --start=TIME start of the time window
526   -s N, --samples=N     terminate after this many samples
527   -T TIME, --finish=TIME
528                         end of the time window
529   -t DELTA, --interval=DELTA
530                         sampling interval
531   -Z TZ, --timezone=TZ  set reporting timezone
532   -z, --hostzone        set reporting timezone to local time of metrics source
533   -V, --version         display version number and exit
534   -?, --help            show this usage message and exit
536 Context options:
537   -K SPEC, --spec-local=SPEC
538                         optional additional PMDA spec for local connection
539   -L, --local-PMDA      metrics source is local connection to a PMDA
540   -H FILE, --hostsfile=FILE
541                         read metric source hosts from a file
542   --host-list=HOSTS     comma-separated list of metric source hosts
543   --archive-list=FILES  comma-separated list of metric source archives
544   --archive-folio=FILE  read metric source archives from a folio
546 Testing options:
547   -x, --extra           an extra option, for testing
548   -X ARG, --eXtra=ARG   an extra option with an argument
549   -y                    a short-option-only without argument
550   -Y N                  a short-option-only with an argument
551   --fubar               a long-option-only without argument
552   --foobar=N            a long-option-only with an argument
553 End of option processing
554 Options structure dump:
555     version: 2
556     flags: 0xb (init,done,usage_err)
557     errors: 1
558     context: 0x2 (archive)
559     nhosts: 0
560     narchives: 3
561     archives: foo,bar,moo
562     start: -
563     finish: -
564     origin: -
565     interval: -
566     align_optarg: -
567     start_optarg: -
568     finish_optarg: -
569     origin_optarg: -
570     guiport_optarg: -
571     timezone: -
572     samples: 0
573     guiport: 0
574     guiflag: 0
575     tzflag: 0
576     Lflag: 0
577 == Arguments: one archive env var
578 End of option processing
579 Options structure dump:
580     version: 2
581     flags: 0x3 (init,done)
582     errors: 0
583     context: 0x2 (archive)
584     nhosts: 0
585     narchives: 1
586     archives: foo
587     start: -
588     finish: -
589     origin: -
590     interval: -
591     align_optarg: -
592     start_optarg: -
593     finish_optarg: -
594     origin_optarg: -
595     guiport_optarg: -
596     timezone: -
597     samples: 0
598     guiport: 0
599     guiflag: 0
600     tzflag: 0
601     Lflag: 0
602 == Arguments: timezone env var
603 End of option processing
604 Options structure dump:
605     version: 2
606     flags: 0x3 (init,done)
607     errors: 0
608     context: 0x0 (-)
609     nhosts: 0
610     narchives: 0
611     start: -
612     finish: -
613     origin: -
614     interval: -
615     align_optarg: -
616     start_optarg: -
617     finish_optarg: -
618     origin_optarg: -
619     guiport_optarg: -
620     timezone: UTC
621     samples: 0
622     guiport: 0
623     guiflag: 0
624     tzflag: 0
625     Lflag: 0
626 == Arguments: hostzone env var
627 Warning: usage error detected
628 getoptions: use of timezone from metric source requires a source
629 Usage: getoptions [options]
631 General options:
632   -A TIME, --align=TIME align sample times on natural boundaries
633   -a FILE, --archive=FILE
634                         metrics source is a PCP log archive
635   -g, --guimode         start in GUI mode with new time control
636   -h HOST, --host=HOST  metrics source is PMCD on host
637   -n FILE, --namespace=FILE
638                         use an alternative PMNS
639   -O TIME, --origin=TIME
640                         initial sample time within the time window
641   -p N, --guiport=N     port for connection to existing time control
642   -S TIME, --start=TIME start of the time window
643   -s N, --samples=N     terminate after this many samples
644   -T TIME, --finish=TIME
645                         end of the time window
646   -t DELTA, --interval=DELTA
647                         sampling interval
648   -Z TZ, --timezone=TZ  set reporting timezone
649   -z, --hostzone        set reporting timezone to local time of metrics source
650   -V, --version         display version number and exit
651   -?, --help            show this usage message and exit
653 Context options:
654   -K SPEC, --spec-local=SPEC
655                         optional additional PMDA spec for local connection
656   -L, --local-PMDA      metrics source is local connection to a PMDA
657   -H FILE, --hostsfile=FILE
658                         read metric source hosts from a file
659   --host-list=HOSTS     comma-separated list of metric source hosts
660   --archive-list=FILES  comma-separated list of metric source archives
661   --archive-folio=FILE  read metric source archives from a folio
663 Testing options:
664   -x, --extra           an extra option, for testing
665   -X ARG, --eXtra=ARG   an extra option with an argument
666   -y                    a short-option-only without argument
667   -Y N                  a short-option-only with an argument
668   --fubar               a long-option-only without argument
669   --foobar=N            a long-option-only with an argument
670 End of option processing
671 Options structure dump:
672     version: 2
673     flags: 0xb (init,done,usage_err)
674     errors: 1
675     context: 0x0 (-)
676     nhosts: 0
677     narchives: 0
678     start: -
679     finish: -
680     origin: -
681     interval: -
682     align_optarg: -
683     start_optarg: -
684     finish_optarg: -
685     origin_optarg: -
686     guiport_optarg: -
687     timezone: -
688     samples: 0
689     guiport: 0
690     guiflag: 0
691     tzflag: 1
692     Lflag: 0
693 == Arguments: gui port env var (x2)
694 End of option processing
695 Options structure dump:
696     version: 2
697     flags: 0x3 (init,done)
698     errors: 0
699     context: 0x0 (-)
700     nhosts: 0
701     narchives: 0
702     start: -
703     finish: -
704     origin: -
705     interval: -
706     align_optarg: -
707     start_optarg: -
708     finish_optarg: -
709     origin_optarg: -
710     guiport_optarg: 42
711     timezone: -
712     samples: 0
713     guiport: 42
714     guiflag: 0
715     tzflag: 0
716     Lflag: 0
717 End of option processing
718 Options structure dump:
719     version: 2
720     flags: 0x3 (init,done)
721     errors: 0
722     context: 0x0 (-)
723     nhosts: 0
724     narchives: 0
725     start: -
726     finish: -
727     origin: -
728     interval: -
729     align_optarg: -
730     start_optarg: -
731     finish_optarg: -
732     origin_optarg: -
733     guiport_optarg: /tmp/socket
734     timezone: -
735     samples: 0
736     guiport: 0
737     guiflag: 0
738     tzflag: 0
739     Lflag: 0
740 == Arguments: gui mode env var
741 End of option processing
742 Options structure dump:
743     version: 2
744     flags: 0x3 (init,done)
745     errors: 0
746     context: 0x0 (-)
747     nhosts: 0
748     narchives: 0
749     start: -
750     finish: -
751     origin: -
752     interval: -
753     align_optarg: -
754     start_optarg: -
755     finish_optarg: -
756     origin_optarg: -
757     guiport_optarg: -
758     timezone: -
759     samples: 0
760     guiport: 0
761     guiflag: 0
762     tzflag: 0
763     Lflag: 0
764 == Arguments: allow mixed hosts and archives
765 End of option processing
766 Options structure dump:
767     version: 2
768     flags: 0x83 (init,done,mixed)
769     errors: 0
770     context: 0x0 (-)
771     nhosts: 1
772     hosts: acme.com
773     narchives: 1
774     archives: log
775     start: -
776     finish: -
777     origin: -
778     interval: -
779     align_optarg: -
780     start_optarg: -
781     finish_optarg: -
782     origin_optarg: -
783     guiport_optarg: -
784     timezone: -
785     samples: 0
786     guiport: 0
787     guiflag: 0
788     tzflag: 0
789     Lflag: 0
790 == Arguments: hosts file
791 End of option processing
792 Options structure dump:
793     version: 2
794     flags: 0x7 (init,done,multi)
795     errors: 0
796     context: 0x1 (host)
797     nhosts: 2
798     hosts: foo.bar.com,acme.com
799     narchives: 0
800     start: -
801     finish: -
802     origin: -
803     interval: -
804     align_optarg: -
805     start_optarg: -
806     finish_optarg: -
807     origin_optarg: -
808     guiport_optarg: -
809     timezone: -
810     samples: 0
811     guiport: 0
812     guiflag: 0
813     tzflag: 0
814     Lflag: 0