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
|
/*!
\defgroup group_overview Overview Of Allocated Memory
\ingroup book_allocations
*/
/*!
\page page_overview
\ingroup group_overview
\section amo_detailed_description Detailed Description
An example output, using libcw-0.2.5, is given below.
Please follow the links to get a short explanation.
\htmlonly
<PRE class="output">
MALLOC : Allocated memory: 3100 bytes in 14 blocks.
<A HREF="#AMO_allocator">malloc</A> 0x819f068 sock.cc:92 sockaddr_in []; (sz = 16) <A HREF="#AMO_description">sockbuf_dbct::addr</A>
malloc 0x819dea0 <A HREF="#AMO_location">dbstreambuf.h:582</A> char []; (sz = 512) dbstreambuf_ct::dbstreambuf_block_dct::block
0x8122240 dbstreambuf.cc:68 dbstreambuf_ct::dbstreambuf_block_dct; (sz = 20)
0x81400e8 <A HREF="#AMO_location">streambuf::streambuf(int)</A> <unknown type>; <A HREF="#AMO_size">(sz = 24)</A>
0x8122400 sock.h:225 dbstreambuf_ct; (sz = 144)
malloc 0x8140678 dbstreambuf.h:582 char []; (sz = 2048) dbstreambuf_ct::dbstreambuf_block_dct::block
0x81405c8 dbstreambuf.cc:68 dbstreambuf_ct::dbstreambuf_block_dct; (sz = 20)
0x8140558 streambuf::streambuf(int) <unknown type>; (sz = 24)
0x8140428 sock.h:225 dbstreambuf_ct; (sz = 144)
0x8140320 reduce_tst.cc:263 sock_dtct<socket_input_ct, socket_ostream_ct>; (sz = 100)
<A HREF="#AMO_start">0x813fd80</A> select.cc:106 list_tct<sbll_list_ct, fd_dct>; (sz = 8) fd_dct::write_fd_list
0x8122360 select.cc:104 <A HREF="#AMO_type">list_tct<sbll_list_ct, fd_dct></A>; (sz = 8) fd_dct::readwrite_fd_list
0x81221e0 select.cc:102 list_tct<sbll_list_ct, fd_dct>; (sz = 8) fd_dct::read_fd_list
0x80545c8 libcw_app.h:140 reduce_tst_app_ct; (sz = 24) The application object
</PRE>
\endhtmlonly
\subsection AMO_allocator allocator type
A label in the first column of the Allocated memory Overview indicates
with which type of allocator the memory block was allocated.
Table 3 lists the labels that are being used for each of the
allocator types (see \link libcwd::memblk_types_nt memblk_types_nt \endlink for their meaning).
\htmlonly
<H5 ALIGN=CENTER>Table 3. The values of memblk_types_nt and the corresponding label in the Allocated memory Overview</H5>
<CENTER>
<TABLE BGCOLOR=Wheat BORDERCOLOR=#503c2c WIDTH=577 BORDER=1 CELLPADDING=4 CELLSPACING=0>
<TR>
<TD BGCOLOR="#a98061"><FONT COLOR="#ffffff">Type</FONT></TD>
<TD BGCOLOR="#a98061"><FONT COLOR="#ffffff">Label</FONT></TD>
</TR>
<TR>
<TD><CODE>memblk_type_new</CODE></TD>
<TD> </TD>
</TR>
<TR>
<TD><CODE>memblk_type_deleted</CODE></TD>
<TD><CODE>(deleted)</CODE></TD>
</TR>
<TR>
<TD><CODE>memblk_type_new_array</CODE></TD>
<TD><CODE>new[]</CODE></TD>
</TR>
<TR>
<TD><CODE>memblk_type_deleted_array</CODE></TD>
<TD><CODE>(deleted)</CODE></TD>
</TR>
<TR>
<TD><CODE>memblk_type_malloc</CODE></TD>
<TD><CODE>malloc</CODE></TD>
</TR>
<TR>
<TD><CODE>memblk_type_realloc</CODE></TD>
<TD><CODE>realloc</CODE></TD>
</TR>
<TR>
<TD><CODE>memblk_type_freed</CODE></TD>
<TD><CODE>(freed)</CODE></TD>
</TR>
<TR>
<TD><CODE>memblk_type_noheap</CODE></TD>
<TD><CODE>(NO HEAP)</CODE></TD>
</TR>
<TR>
<TD><CODE>memblk_type_removed</CODE></TD>
<TD><CODE>(No heap)</CODE></TD>
</TR>
<TR>
<TD><CODE>memblk_type_marker</CODE></TD>
<TD><CODE>(MARKER)</CODE></TD>
</TR>
<TR>
<TD><CODE>memblk_type_deleted_marker</CODE></TD>
<TD><CODE>(deleted)</CODE></TD>
</TR>
</TABLE>
</CENTER>
\endhtmlonly
\subsection AMO_start start address
The second column of the Allocated memory Overview gives the hexadecimal start address of the allocated memory block.
This is the value returned by the allocator (<CODE>malloc</CODE>, <CODE>new</CODE> etc).
Note that, when \ref enable_magic "CWDEBUG_MAGIC" is set, a magic number is
put <I>in front of</I> this hexadecimal start address.
The result is that you can ignore completely whether CWDEBUG_MAGIC is 0 or 1, in your own program.
\subsection AMO_location source file location
The third column of the Allocated memory Overview gives the source file
location where the memory was allocated, or reallocated in the case of
of <CODE>realloc</CODE>.
The format is <TT><filename>:<line number></TT>.
When the allocation is done in an object file without debug information
and no source file or line number is known, then instead the name of the
function in which the allocation was done is given.
\subsection AMO_type type
The fourth column of the Allocated memory Overview starts with the <TT>type</TT> of the allocated object
(i.e., the <CODE>class</CODE> name).
This information is only available when <CODE>AllocTag()</CODE>
was called correctly for this allocation.
Otherwise <TT><unknown type></TT> is shown instead.
The given <TT>type</TT> is derived, but different,
from what \ref libcwd::type_info_ct::demangled_name "type_info_ct::demangled_name()" returns.
The <CODE>*</CODE> at the end of the type of the pointer is omitted when the
memory block was allocated with <CODE>new</CODE>, it is replaced with
<CODE>[<I>size</I>]</CODE> when the memory block was allocated with
<CODE>new[]</CODE> and it is replaced with <CODE>[]</CODE> when the memory
block was allocated with <CODE>malloc</CODE>.
Examples were already given, but a summary is given in table 4 nonetheless.
The <I><length></I> that is given between square brackets is the <I>rounded down</I> value of the size
of the allocated memory block divided by the size of the object that is being pointed to.
This will always be accurate for an <CODE>operator new []</CODE> of course,
but its kinda fuzzy for an allocation with <CODE>malloc</CODE> et al.
\htmlonly
<H5 ALIGN=CENTER>Table 4. The format of the <I>type</I> field in the Allocated memory Overview, as function of the allocator.</H5>
<CENTER>
<TABLE BGCOLOR=Wheat BORDERCOLOR=#503c2c BORDER=1 CELLPADDING=4 CELLSPACING=0>
<TR>
<TR>
<TD BGCOLOR="#a98061">
<FONT COLOR="#ffffff">Allocator</FONT>
</TD>
<TD BGCOLOR="#a98061">
<FONT COLOR="#ffffff">Type</FONT>
</TD>
<TD BGCOLOR="#a98061">
<FONT COLOR="#ffffff">Format</FONT>
</TD>
</TR>
<TR>
<TD>
<CODE>malloc/calloc/realloc</CODE>
</TD>
<TD>
<CODE>void*</CODE>
</TD>
<TD>
<CODE>void*</CODE>
</TD>
</TR>
<TR>
<TD>
<CODE>malloc/calloc/realloc</CODE>
</TD>
<TD>
<CODE>int*</CODE>
</TD>
<TD>
<CODE>int [<I><length></I>]</CODE>
</TD>
</TR>
<TR>
<TD>
<CODE>new</CODE>
</TD>
<TD>
<CODE>MyClass*</CODE>
</TD>
<TD>
<CODE>MyClass</CODE>
</TD>
</TR>
<TR>
<TD>
<CODE>new []</CODE>
</TD>
<TD>
<CODE>MyClass*</CODE>
</TD>
<TD>
<CODE>MyClass [<I><length></I>]</CODE>
</TD>
</TR>
</TABLE>
</CENTER>
\endhtmlonly
\subsection AMO_size size
The number of allocated bytes is printed as
<TT>(sz = </TT><I><size></I><TT>)</TT>,
where <I><size></I> is the size of the returned memory block in bytes.
\subsection AMO_description description
Finally, the description that was passed along with <CODE>AllocTag()</CODE> is printed.
*/
|
