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
|
/*##############################################################################
FUNNNELWEB COPYRIGHT
====================
FunnelWeb is a literate-programming macro preprocessor.
The FunnelWeb web is at http://www.ross.net/funnelweb/
Copyright (c) Ross N. Williams 1992. All rights reserved.
This program is free software; you can redistribute it and/or modify
it under the terms of Version 2 of the GNU General Public License as
published by the Free Software Foundation (http://www.gnu.org/).
This program is distributed WITHOUT ANY WARRANTY; without even the implied
warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
See Version 2 of the GNU General Public License for more details.
You should have received a copy of Version 2 of the GNU General Public
License along with this program. If not, you can obtain a copy as follows:
ftp://prep.ai.mit.edu/pub/gnu/COPYING-2.0
or write to:
Free Software Foundation, Inc.,
59 Temple Place - Suite 330, Boston, MA 02111-1307, USA
Section 2a of the license requires that all changes to this file be
recorded prominently in this file. Please record all changes here.
Programmers:
RNW Ross N. Williams (ross@ross.net)
Changes:
07-May-1992 RNW Program prepared for release under GNU GPL V2.
##############################################################################*/
/******************************************************************************/
/* CLOCK.H */
/******************************************************************************/
/* */
/* This package implements a clock abstraction that is used to generate */
/* timing statistics which are useful for performance tuning. The package */
/* allows the measurement of both real and CPU time. This package gets its */
/* raw information from the tim_cpu() and tim_real() functions of the machine */
/* dependent module "machin". */
/* */
/******************************************************************************/
/* Ensure that the body of this header file is included at most once. */
#ifndef DONE_CLOCK
#define DONE_CLOCK
/******************************************************************************/
#include "style.h"
/******************************************************************************/
/* The following clock type is supposed to be an ADT so don't frob any of its */
/* fields manually! */
typedef struct
{
ulong ck_mhead; /* Magic number helps detect corruptions. */
bool ck_run; /* TRUE iff the clock is running. */
float ck_csum; /* Accumulated CPU time. */
float ck_rsum; /* Accumulated real time. */
float ck_csta; /* ck_run => CPU time when clock was started. */
float ck_rsta; /* ck_run => Real time when clock was started. */
ulong ck_mtail; /* Magic number helps detect corruptions. */
} ck_t;
typedef ck_t *p_ck_t;
/******************************************************************************/
EXPORT void ck_ini P_((p_ck_t));
/* Initializes the clock. After this call, the argument clock will be in the */
/* STOPPED state and all its registers will be zero. A clock must be */
/* initialized before any other operations are performed on it. */
EXPORT void ck_start P_((p_ck_t));
/* Changes the clock from the STOPPED state to the RUNNING state. Starts */
/* accumulating real time and CPU time on its registers. */
/* Raises an error if the clock is not in the STOPPED state. */
EXPORT void ck_stop P_((p_ck_t));
/* Changes the clock from the RUNNING state to the STOPPED state. Stops */
/* accumulating real time and CPU time on its registers. */
/* Raises an error if the clock is not in the RUNNING state. */
EXPORT float ck_cpu P_((p_ck_t));
/* Returns the number of seconds of CPU time accumulated on the clock. */
/* Raises an error if the clock is not in the STOPPED state. */
EXPORT float ck_real P_((p_ck_t));
/* Returns the number of seconds of real time accumulated on the clock. */
/* Raises an error if the clock is not in the STOPPED state. */
/******************************************************************************/
/* For #ifndef preventing multiple inclusion of the body of this header file. */
#endif
/******************************************************************************/
/* End of CLOCK.H */
/******************************************************************************/
|
