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
|
'\" t
.\" Title: Callgrind Control
.\" Author: [see the "Author" section]
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
.\" Date: 11/01/2024
.\" Manual: callgrind_control
.\" Source: Release 3.24.0
.\" Language: English
.\"
.TH "CALLGRIND CONTROL" "1" "11/01/2024" "Release 3\&.24\&.0" "callgrind_control"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
callgrind_control \- observe and control programs being run by Callgrind
.SH "SYNOPSIS"
.HP \w'\fBcallgrind_control\fR\ 'u
\fBcallgrind_control\fR [\fIoptions\fR] [\fIpid|program\-name\fR...]
.SH "DESCRIPTION"
.PP
\fBcallgrind_control\fR
controls programs being run by the Valgrind tool Callgrind\&. When a
\fBpid/program name\fR
argument is not specified, all applications currently being run by Callgrind on this system will be used for actions given by the specified option(s)\&. The default action is to give some brief information about the applications being run by Callgrind\&.
.SH "OPTIONS"
.PP
\fB\-h \-\-help\fR
.RS 4
Show a short description, usage, and summary of options\&.
.RE
.PP
\fB\-\-version\fR
.RS 4
Show version of callgrind_control\&.
.RE
.PP
\fB\-l \-\-long\fR
.RS 4
Show also the working directory, in addition to the brief information given by default\&.
.RE
.PP
\fB\-s \-\-stat\fR
.RS 4
Show statistics information about active Callgrind runs\&.
.RE
.PP
\fB\-b \-\-back\fR
.RS 4
Show stack/back traces of each thread in active Callgrind runs\&. For each active function in the stack trace, also the number of invocations since program start (or last dump) is shown\&. This option can be combined with \-e to show inclusive cost of active functions\&.
.RE
.PP
\fB\-e [A,B,\&.\&.\&.] \fR (default: all)
.RS 4
Show the current per\-thread, exclusive cost values of event counters\&. If no explicit event names are given, figures for all event types which are collected in the given Callgrind run are shown\&. Otherwise, only figures for event types A, B, \&.\&.\&. are shown\&. If this option is combined with \-b, inclusive cost for the functions of each active stack frame is provided, too\&.
.RE
.PP
\fB\-\-dump[=<desc>] \fR (default: no description)
.RS 4
Request the dumping of profile information\&. Optionally, a description can be specified which is written into the dump as part of the information giving the reason which triggered the dump action\&. This can be used to distinguish multiple dumps\&.
.RE
.PP
\fB\-z \-\-zero\fR
.RS 4
Zero all event counters\&.
.RE
.PP
\fB\-k \-\-kill\fR
.RS 4
Force a Callgrind run to be terminated\&.
.RE
.PP
\fB\-\-instr=<on|off>\fR
.RS 4
Switch instrumentation mode on or off\&. If a Callgrind run has instrumentation disabled, no simulation is done and no events are counted\&. This is useful to skip uninteresting program parts, as there is much less slowdown (same as with the Valgrind tool "none")\&. See also the Callgrind option
\fB\-\-instr\-atstart\fR\&.
.RE
.PP
\fB\-\-vgdb\-prefix=<prefix>\fR
.RS 4
Specify the vgdb prefix to use by callgrind_control\&. callgrind_control internally uses vgdb to find and control the active Callgrind runs\&. If the
\fB\-\-vgdb\-prefix\fR
option was used for launching valgrind, then the same option must be given to callgrind_control\&.
.RE
.SH "SEE ALSO"
.PP
valgrind(1),
$INSTALL/share/doc/valgrind/html/index\&.html
or
http://www\&.valgrind\&.org/docs/manual/index\&.html\&.
.SH "AUTHOR"
.PP
Josef Weidendorfer <Josef\&.Weidendorfer@gmx\&.de>\&.
|
