This file is indexed.

/usr/share/gtk-doc/html/libgtop/libgtop-proctime.html is in libgtop2-doc 2.28.4-2.

This file is owned by root:root, with mode 0o644.

The actual contents of the file can be viewed below.

  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
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>proctime</title>
<meta name="generator" content="DocBook XSL Stylesheets V1.75.2">
<link rel="home" href="index.html" title="Libgtop Reference Manual">
<link rel="up" href="libgtop-lib.html" title="Libgtop Library Reference">
<link rel="prev" href="libgtop-procuid.html" title="procuid">
<link rel="next" href="libgtop-signal.html" title="signal">
<meta name="generator" content="GTK-Doc V1.17.1 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
<tr valign="middle">
<td><a accesskey="p" href="libgtop-procuid.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
<td><a accesskey="u" href="libgtop-lib.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
<th width="100%" align="center">Libgtop Reference Manual</th>
<td><a accesskey="n" href="libgtop-signal.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
</tr>
<tr><td colspan="5" class="shortcuts">
<a href="#libgtop-proctime.synopsis" class="shortcut">Top</a>
                   | 
                  <a href="#libgtop-proctime.description" class="shortcut">Description</a>
</td></tr>
</table>
<div class="refentry">
<a name="libgtop-proctime"></a><div class="titlepage"></div>
<div class="refnamediv"><table width="100%"><tr>
<td valign="top">
<h2><span class="refentrytitle"><a name="libgtop-proctime.top_of_page"></a>proctime</span></h2>
<p>proctime</p>
</td>
<td valign="top" align="right"></td>
</tr></table></div>
<div class="refsynopsisdiv">
<a name="libgtop-proctime.synopsis"></a><h2>Synopsis</h2>
<pre class="synopsis">
#include &lt;glibtop/proctime.h&gt;

#define             <a class="link" href="libgtop-proctime.html#GLIBTOP-PROC-TIME-START-TIME:CAPS" title="GLIBTOP_PROC_TIME_START_TIME">GLIBTOP_PROC_TIME_START_TIME</a>
#define             <a class="link" href="libgtop-proctime.html#GLIBTOP-PROC-TIME-RTIME:CAPS" title="GLIBTOP_PROC_TIME_RTIME">GLIBTOP_PROC_TIME_RTIME</a>
#define             <a class="link" href="libgtop-proctime.html#GLIBTOP-PROC-TIME-UTIME:CAPS" title="GLIBTOP_PROC_TIME_UTIME">GLIBTOP_PROC_TIME_UTIME</a>
#define             <a class="link" href="libgtop-proctime.html#GLIBTOP-PROC-TIME-STIME:CAPS" title="GLIBTOP_PROC_TIME_STIME">GLIBTOP_PROC_TIME_STIME</a>
#define             <a class="link" href="libgtop-proctime.html#GLIBTOP-PROC-TIME-CUTIME:CAPS" title="GLIBTOP_PROC_TIME_CUTIME">GLIBTOP_PROC_TIME_CUTIME</a>
#define             <a class="link" href="libgtop-proctime.html#GLIBTOP-PROC-TIME-CSTIME:CAPS" title="GLIBTOP_PROC_TIME_CSTIME">GLIBTOP_PROC_TIME_CSTIME</a>
#define             <a class="link" href="libgtop-proctime.html#GLIBTOP-PROC-TIME-TIMEOUT:CAPS" title="GLIBTOP_PROC_TIME_TIMEOUT">GLIBTOP_PROC_TIME_TIMEOUT</a>
#define             <a class="link" href="libgtop-proctime.html#GLIBTOP-PROC-TIME-IT-REAL-VALUE:CAPS" title="GLIBTOP_PROC_TIME_IT_REAL_VALUE">GLIBTOP_PROC_TIME_IT_REAL_VALUE</a>
#define             <a class="link" href="libgtop-proctime.html#GLIBTOP-PROC-TIME-FREQUENCY:CAPS" title="GLIBTOP_PROC_TIME_FREQUENCY">GLIBTOP_PROC_TIME_FREQUENCY</a>
#define             <a class="link" href="libgtop-proctime.html#GLIBTOP-PROC-TIME-XCPU-UTIME:CAPS" title="GLIBTOP_PROC_TIME_XCPU_UTIME">GLIBTOP_PROC_TIME_XCPU_UTIME</a>
#define             <a class="link" href="libgtop-proctime.html#GLIBTOP-PROC-TIME-XCPU-STIME:CAPS" title="GLIBTOP_PROC_TIME_XCPU_STIME">GLIBTOP_PROC_TIME_XCPU_STIME</a>
#define             <a class="link" href="libgtop-proctime.html#GLIBTOP-MAX-PROC-TIME:CAPS" title="GLIBTOP_MAX_PROC_TIME">GLIBTOP_MAX_PROC_TIME</a>
struct              <a class="link" href="libgtop-proctime.html#glibtop-proc-time" title="struct glibtop_proc_time">glibtop_proc_time</a>;
<span class="returnvalue">void</span>                <a class="link" href="libgtop-proctime.html#glibtop-get-proc-time" title="glibtop_get_proc_time ()">glibtop_get_proc_time</a>               (<em class="parameter"><code><a class="link" href="libgtop-proctime.html#glibtop-proc-time" title="struct glibtop_proc_time"><span class="type">glibtop_proc_time</span></a> *buf</code></em>,
                                                         <em class="parameter"><code><span class="type">pid_t</span> pid</code></em>);
#define             <a class="link" href="libgtop-proctime.html#glibtop-get-proc-time-r" title="glibtop_get_proc_time_r">glibtop_get_proc_time_r</a>
<span class="returnvalue">void</span>                <a class="link" href="libgtop-proctime.html#glibtop-get-proc-time-l" title="glibtop_get_proc_time_l ()">glibtop_get_proc_time_l</a>             (<em class="parameter"><code><a class="link" href="libgtop-GlibTop.html#glibtop" title="struct glibtop"><span class="type">glibtop</span></a> *server</code></em>,
                                                         <em class="parameter"><code><a class="link" href="libgtop-proctime.html#glibtop-proc-time" title="struct glibtop_proc_time"><span class="type">glibtop_proc_time</span></a> *buf</code></em>,
                                                         <em class="parameter"><code><span class="type">pid_t</span> pid</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="libgtop-proctime.html#glibtop-get-proc-time-p" title="glibtop_get_proc_time_p ()">glibtop_get_proc_time_p</a>             (<em class="parameter"><code><a class="link" href="libgtop-GlibTop.html#glibtop" title="struct glibtop"><span class="type">glibtop</span></a> *server</code></em>,
                                                         <em class="parameter"><code><a class="link" href="libgtop-proctime.html#glibtop-proc-time" title="struct glibtop_proc_time"><span class="type">glibtop_proc_time</span></a> *buf</code></em>,
                                                         <em class="parameter"><code><span class="type">pid_t</span> pid</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="libgtop-proctime.html#glibtop-get-proc-time-s" title="glibtop_get_proc_time_s ()">glibtop_get_proc_time_s</a>             (<em class="parameter"><code><a class="link" href="libgtop-GlibTop.html#glibtop" title="struct glibtop"><span class="type">glibtop</span></a> *server</code></em>,
                                                         <em class="parameter"><code><a class="link" href="libgtop-proctime.html#glibtop-proc-time" title="struct glibtop_proc_time"><span class="type">glibtop_proc_time</span></a> *buf</code></em>,
                                                         <em class="parameter"><code><span class="type">pid_t</span> pid</code></em>);
</pre>
</div>
<div class="refsect1">
<a name="libgtop-proctime.description"></a><h2>Description</h2>
<p>
</p>
</div>
<div class="refsect1">
<a name="libgtop-proctime.details"></a><h2>Details</h2>
<div class="refsect2">
<a name="GLIBTOP-PROC-TIME-START-TIME:CAPS"></a><h3>GLIBTOP_PROC_TIME_START_TIME</h3>
<pre class="programlisting">#define GLIBTOP_PROC_TIME_START_TIME 0
</pre>
<p>
</p>
</div>
<hr>
<div class="refsect2">
<a name="GLIBTOP-PROC-TIME-RTIME:CAPS"></a><h3>GLIBTOP_PROC_TIME_RTIME</h3>
<pre class="programlisting">#define GLIBTOP_PROC_TIME_RTIME		1
</pre>
<p>
</p>
</div>
<hr>
<div class="refsect2">
<a name="GLIBTOP-PROC-TIME-UTIME:CAPS"></a><h3>GLIBTOP_PROC_TIME_UTIME</h3>
<pre class="programlisting">#define GLIBTOP_PROC_TIME_UTIME		2
</pre>
<p>
</p>
</div>
<hr>
<div class="refsect2">
<a name="GLIBTOP-PROC-TIME-STIME:CAPS"></a><h3>GLIBTOP_PROC_TIME_STIME</h3>
<pre class="programlisting">#define GLIBTOP_PROC_TIME_STIME		3
</pre>
<p>
</p>
</div>
<hr>
<div class="refsect2">
<a name="GLIBTOP-PROC-TIME-CUTIME:CAPS"></a><h3>GLIBTOP_PROC_TIME_CUTIME</h3>
<pre class="programlisting">#define GLIBTOP_PROC_TIME_CUTIME 4
</pre>
<p>
</p>
</div>
<hr>
<div class="refsect2">
<a name="GLIBTOP-PROC-TIME-CSTIME:CAPS"></a><h3>GLIBTOP_PROC_TIME_CSTIME</h3>
<pre class="programlisting">#define GLIBTOP_PROC_TIME_CSTIME 5
</pre>
<p>
</p>
</div>
<hr>
<div class="refsect2">
<a name="GLIBTOP-PROC-TIME-TIMEOUT:CAPS"></a><h3>GLIBTOP_PROC_TIME_TIMEOUT</h3>
<pre class="programlisting">#define GLIBTOP_PROC_TIME_TIMEOUT 6
</pre>
<p>
</p>
</div>
<hr>
<div class="refsect2">
<a name="GLIBTOP-PROC-TIME-IT-REAL-VALUE:CAPS"></a><h3>GLIBTOP_PROC_TIME_IT_REAL_VALUE</h3>
<pre class="programlisting">#define GLIBTOP_PROC_TIME_IT_REAL_VALUE 7
</pre>
<p>
</p>
</div>
<hr>
<div class="refsect2">
<a name="GLIBTOP-PROC-TIME-FREQUENCY:CAPS"></a><h3>GLIBTOP_PROC_TIME_FREQUENCY</h3>
<pre class="programlisting">#define GLIBTOP_PROC_TIME_FREQUENCY 8
</pre>
<p>
</p>
</div>
<hr>
<div class="refsect2">
<a name="GLIBTOP-PROC-TIME-XCPU-UTIME:CAPS"></a><h3>GLIBTOP_PROC_TIME_XCPU_UTIME</h3>
<pre class="programlisting">#define GLIBTOP_PROC_TIME_XCPU_UTIME 9
</pre>
<p>
</p>
</div>
<hr>
<div class="refsect2">
<a name="GLIBTOP-PROC-TIME-XCPU-STIME:CAPS"></a><h3>GLIBTOP_PROC_TIME_XCPU_STIME</h3>
<pre class="programlisting">#define GLIBTOP_PROC_TIME_XCPU_STIME 10
</pre>
<p>
</p>
</div>
<hr>
<div class="refsect2">
<a name="GLIBTOP-MAX-PROC-TIME:CAPS"></a><h3>GLIBTOP_MAX_PROC_TIME</h3>
<pre class="programlisting">#define GLIBTOP_MAX_PROC_TIME		11
</pre>
<p>
</p>
</div>
<hr>
<div class="refsect2">
<a name="glibtop-proc-time"></a><h3>struct glibtop_proc_time</h3>
<pre class="programlisting">struct glibtop_proc_time {
	guint64 flags;
	guint64 start_time; /* start time of process --
				 * seconds since 1-1-70 */
	guint64 rtime;		/* real time accumulated by process */
	guint64 utime;		/* user-mode CPU time accumulated by process */
	guint64 stime;		/* kernel-mode CPU time accumulated by process */
	guint64 cutime;		/* cumulative utime of process and
				 * reaped children */
	guint64 cstime;		/* cumulative stime of process and
				 * reaped children */
	guint64 timeout; /* The time (in jiffies) of the process's
				 * next timeout */
	guint64 it_real_value; /* The time (in jiffies) before the
				 * next SIGALRM is sent to the process
				 * due to an interval timer. */
	guint64 frequency; /* Tick frequency. */
	guint64 xcpu_utime [GLIBTOP_NCPU]; /* utime and stime for all CPUs on */
	guint64 xcpu_stime [GLIBTOP_NCPU]; /* SMP machines. */
};
</pre>
<p>
</p>
</div>
<hr>
<div class="refsect2">
<a name="glibtop-get-proc-time"></a><h3>glibtop_get_proc_time ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                glibtop_get_proc_time               (<em class="parameter"><code><a class="link" href="libgtop-proctime.html#glibtop-proc-time" title="struct glibtop_proc_time"><span class="type">glibtop_proc_time</span></a> *buf</code></em>,
                                                         <em class="parameter"><code><span class="type">pid_t</span> pid</code></em>);</pre>
<p>
Please note that under Linux, <span class="type">start_time</span> value may be strange.
Linux kernel defines <span class="type">INITIAL_JIFFIES</span> which implies a time
shift. Because <span class="type">INITIAL_JIFFIES</span> is not user-space defined,
we cannot use it to compute accurate <em class="parameter"><code>code</code></em>{start_time}. On Linux2.6,
<span class="type">INITIAL_JIFFIES</span> is 300 so <span class="type">start_time</span> is 
always 3s different from real start time of the given process. You 
may also get shift results if your system clock is not synchronised 
with your hardware clock. See <span class="command"><strong>man hwclock</strong></span>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td><p><span class="term"><em class="parameter"><code>pid</code></em> :</span></p></td>
<td>Process id to get the user and tty information</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="glibtop-get-proc-time-r"></a><h3>glibtop_get_proc_time_r</h3>
<pre class="programlisting">#define glibtop_get_proc_time_r glibtop_get_proc_time_p
</pre>
<p>
</p>
</div>
<hr>
<div class="refsect2">
<a name="glibtop-get-proc-time-l"></a><h3>glibtop_get_proc_time_l ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                glibtop_get_proc_time_l             (<em class="parameter"><code><a class="link" href="libgtop-GlibTop.html#glibtop" title="struct glibtop"><span class="type">glibtop</span></a> *server</code></em>,
                                                         <em class="parameter"><code><a class="link" href="libgtop-proctime.html#glibtop-proc-time" title="struct glibtop_proc_time"><span class="type">glibtop_proc_time</span></a> *buf</code></em>,
                                                         <em class="parameter"><code><span class="type">pid_t</span> pid</code></em>);</pre>
<p>
</p>
</div>
<hr>
<div class="refsect2">
<a name="glibtop-get-proc-time-p"></a><h3>glibtop_get_proc_time_p ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                glibtop_get_proc_time_p             (<em class="parameter"><code><a class="link" href="libgtop-GlibTop.html#glibtop" title="struct glibtop"><span class="type">glibtop</span></a> *server</code></em>,
                                                         <em class="parameter"><code><a class="link" href="libgtop-proctime.html#glibtop-proc-time" title="struct glibtop_proc_time"><span class="type">glibtop_proc_time</span></a> *buf</code></em>,
                                                         <em class="parameter"><code><span class="type">pid_t</span> pid</code></em>);</pre>
<p>
</p>
</div>
<hr>
<div class="refsect2">
<a name="glibtop-get-proc-time-s"></a><h3>glibtop_get_proc_time_s ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                glibtop_get_proc_time_s             (<em class="parameter"><code><a class="link" href="libgtop-GlibTop.html#glibtop" title="struct glibtop"><span class="type">glibtop</span></a> *server</code></em>,
                                                         <em class="parameter"><code><a class="link" href="libgtop-proctime.html#glibtop-proc-time" title="struct glibtop_proc_time"><span class="type">glibtop_proc_time</span></a> *buf</code></em>,
                                                         <em class="parameter"><code><span class="type">pid_t</span> pid</code></em>);</pre>
<p>
</p>
</div>
</div>
</div>
<div class="footer">
<hr>
          Generated by GTK-Doc V1.17.1</div>
</body>
</html>