1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
|
'\"macro stdmacro
.\"
.\" Copyright (c) 2000-2004 Silicon Graphics, Inc. All Rights Reserved.
.\"
.\" This program is free software; you can redistribute it and/or modify it
.\" under the terms of the GNU General Public License as published by the
.\" Free Software Foundation; either version 2 of the License, or (at your
.\" option) any later version.
.\"
.\" This program is distributed in the hope that it will be useful, but
.\" WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
.\" or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
.\" for more details.
.\"
.\"
.TH PMDADSO 3 "PCP" "Performance Co-Pilot"
.SH NAME
\f3pmdaDSO\f1 \- initialize the PMDA to run as a DSO
.SH "C SYNOPSIS"
.ft 3
#include <pcp/pmapi.h>
.br
#include <pcp/impl.h>
.br
#include <pcp/pmda.h>
.sp
.ad l
.hy 0
.in +8n
.ti -8n
int pmdaDSO(pmdaInterface *\fIdispatch\fP, int \fIinterface\fP, char\ *\fIname\fP, char\ *\fIhelptext\fP);
.sp
.in
.hy
.ad
cc ... \-lpcp_pmda \-lpcp
.ft 1
.SH DESCRIPTION
.B pmdaDSO
initializes the
.B pmdaInterface
structure to use the
.I interface
extensions,
assuming the
.BR PMDA (3)
is to be run as a DSO. The
.B pmdaInterface
structure is initialized with:
.TP 15
.I name
The name of the agent.
.TP
.I helptext
The default path to the help text (see
.BR pmdaText (3).
If no help text is installed, or you are not using
.BR pmdaText (3),
then this should be set to NULL.
.PP
The callbacks are initialized to
.BR pmdaProfile (3),
.BR pmdaFetch (3),
.BR pmdaDesc (3),
.BR pmdaText (3),
.BR pmdaInstance (3)
and
.BR pmdaStore (3).
.PP
The
.I interface
structure also contains the
.I domain
of the
.BR PMDA (3),
which is defined in the
.BR pmcd (1)
configuration file. The
.I domain
is used to initialize the metric and instance descriptors (see
.BR pmdaInit (3)).
.SH DIAGNOSTICS
.TP 15
.B Incompatible version of pmcd detected
When
.BR pmcd (1)
creates the
.B pmdaInterface
structure, the
.I dispatch.comm.version
field is set to the highest protocol that
.BR pmcd (1)
understands. This message indicates that the
.BR pmcd (1)
process does not understand the protocol used by
.BR pmdaDSO .
.TP
.B Unable to allocate memory for pmdaExt structure
In addition,
.I dispatch->status
is set to a value less than zero.
.SH CAVEAT
The PMDA must be using
.B PMDA_INTERFACE_2
or later.
.SH SEE ALSO
.BR pmcd (1),
.BR PMAPI (3),
.BR PMDA (3),
.BR pmdaDaemon (3),
.BR pmdaInit (3)
and
.BR pmdaText (3).
|
