1QMCSOURCE(3) Library Functions Manual QMCSOURCE(3)
2
3
4
6 QmcSource - manages contexts created by all groups
7
9 #include <QmcSource.h>
10
11 CC ... -lqmc -lpcp
12
14 The QmcSource class maintains a unique list of all metric sources in
15 use to minimize the creation of new contexts (see pmNewContext(3)) when
16 the context could have been duplicated (see pmDupContext(3)). This
17 also reduces the duplication of descriptions of each source.
18
19 In general, QMC users should only need to access QmcSource methods to
20 obtain source descriptions for a QmcContext(3) object. All context
21 creation by the user should be handled through QmcGroup(3).
22
24 ~QmcSource();
25 Destructor.
26
28 static QmcSource* getSource(int type, const char* source,
29 bool matchHosts)
30
31 This method will return a QmcSource object that represents a con‐
32 text of type to source. The QmcSource object may be a new object
33 if the source has not been previously requested. Memory management
34 of the QmcSource objects is handled by QmcSource. If all QmcCon‐
35 text(3)s to the QmcSource have been deleted, the QmcSource object
36 will also be deleted.
37
38 The matchHosts flag controls the algorithm that is used to match
39 hosts to archives. If matchHosts is equal to false then no attempt
40 will be made by this method to match a host context to an existing
41 source context. A QmcSource object will always be returned in this
42 case, although the QmcSource::status method may indicate that a
43 context to source failed.
44
45 If matchHosts is equal to true, host contexts will be matched to a
46 pre-defined archive source collected from that source. If no ar‐
47 chive sources for the source have been previous specified, get‐
48 Source will return a NULL pointer.
49
51 PMAPI(3), QMC(3), QmcContext(3), QmcGroup(3), pmDupContext(3),
52 pmflush(3), pmNewContext(3) and pmprintf(3).
53
55 Error messages are generated using pmprintf(3) but are not flushed. It
56 is the responsibility of the user to call pmflush(3) to output any mes‐
57 sages.
58
59 Additional diagnostics may be activated by adding the option pmc to the
60 global debugging specification, as described in pmSetDebug(3).
61
62
63
64Performance Co-Pilot SGI QMCSOURCE(3)