Unreviewed, rolling out r234489.
[WebKit-https.git] / Source / WTF / wtf / StackStats.h
1 /*
2  * Copyright (C) 2012 Apple Inc. All rights reserved.
3  *
4  * Redistribution and use in source and binary forms, with or without
5  * modification, are permitted provided that the following conditions
6  * are met:
7  * 1. Redistributions of source code must retain the above copyright
8  *    notice, this list of conditions and the following disclaimer.
9  * 2. Redistributions in binary form must reproduce the above copyright
10  *    notice, this list of conditions and the following disclaimer in the
11  *    documentation and/or other materials provided with the distribution.
12  *
13  * THIS SOFTWARE IS PROVIDED BY APPLE INC. ``AS IS'' AND ANY
14  * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
15  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
16  * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL APPLE INC. OR
17  * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
18  * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
19  * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
20  * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY
21  * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
22  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
23  * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 
24  */
25
26 #ifndef StackStats_h
27 #define StackStats_h
28
29 #include "ExportMacros.h"
30 #include <mutex>
31
32
33 // Define this flag to enable Stack stats collection. This feature is useful
34 // for getting a sample of native stack usage sizes.
35 //
36 // Enabling this will cause stats to be collected and written to a log file at
37 // various  instrumented points in the code. It will result in noticeable
38 // performance loss. Hence, this should only be enable when you want to do
39 // some stats location in your local build. This code is provided here as a
40 // convenience for collecting that data. It is not meant to be enabled by
41 // default on release or debug builds.
42
43 #define ENABLE_STACK_STATS 0
44
45
46 namespace WTF {
47
48 #if !ENABLE(STACK_STATS) 
49
50 class StackStats {
51 public:
52     // The CheckPoint class is for marking check points corresponding
53     // each location in code where a stack recursion check is being done.
54
55     class CheckPoint {
56     public:
57         CheckPoint() { }
58     };
59
60     class PerThreadStats {
61     public:
62         PerThreadStats() { }
63     };
64
65     class LayoutCheckPoint {
66     public:
67         LayoutCheckPoint() { }
68     };
69
70     static void probe() { }
71 };
72
73 #else // ENABLE(STACK_STATS)
74
75 class StackStats {
76 public:
77     // The CheckPoint class is for marking check points corresponding
78     // each location in code where a stack recursion check is being done.
79
80     class CheckPoint {
81     public:
82         CheckPoint();
83         ~CheckPoint();
84     private:
85         CheckPoint* m_prev;
86     };
87
88     class PerThreadStats {
89     public:
90         PerThreadStats();
91
92     private:
93         int m_reentryDepth;
94         char* m_stackStart;
95         CheckPoint* m_currentCheckPoint;
96
97         friend class CheckPoint;
98         friend class StackStats;
99     };
100
101     class LayoutCheckPoint {
102     public:
103         WTF_EXPORT_PRIVATE LayoutCheckPoint();
104         WTF_EXPORT_PRIVATE ~LayoutCheckPoint();
105
106     private:
107         LayoutCheckPoint* m_prev;
108         int m_depth;
109     };
110
111     // Used for probing the stack at places where we suspect to be high
112     // points of stack usage but are NOT check points where stack recursion
113     // is checked.
114     //
115     // The more places where we add this probe, the more accurate our
116     // stats data will be. However, adding too many probes will also
117     // result in unnecessary performance loss. So, only add these probes
118     // judiciously where appropriate.
119     static void probe();
120
121 private:
122     // CheckPoint management:
123     static Lock s_sharedMutex;
124     static CheckPoint* s_topCheckPoint;
125     static LayoutCheckPoint* s_firstLayoutCheckPoint;
126     static LayoutCheckPoint* s_topLayoutCheckPoint;
127
128     // High watermark stats:
129     static int s_maxCheckPointDiff;
130     static int s_maxStackHeight;
131     static int s_maxReentryDepth;
132
133     static int s_maxLayoutCheckPointDiff;
134     static int s_maxTotalLayoutCheckPointDiff;
135     static int s_maxLayoutReentryDepth;
136
137     friend class CheckPoint;
138     friend class LayoutCheckPoint;
139 };
140
141 #endif // ENABLE(STACK_STATS) 
142
143 } // namespace WTF
144
145 using WTF::StackStats;
146
147 #endif // StackStats_h