1 /**************************************************************************
3 * Copyright 2010 Luca Barbieri
5 * Permission is hereby granted, free of charge, to any person obtaining
6 * a copy of this software and associated documentation files (the
7 * "Software"), to deal in the Software without restriction, including
8 * without limitation the rights to use, copy, modify, merge, publish,
9 * distribute, sublicense, and/or sell copies of the Software, and to
10 * permit persons to whom the Software is furnished to do so, subject to
11 * the following conditions:
13 * The above copyright notice and this permission notice (including the
14 * next paragraph) shall be included in all copies or substantial
15 * portions of the Software.
17 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
18 * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
19 * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
20 * IN NO EVENT SHALL THE COPYRIGHT OWNER(S) AND/OR ITS SUPPLIERS BE
21 * LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
22 * OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
23 * WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
25 **************************************************************************/
30 * If the GALLIUM_REFCNT_LOG env var is defined as a filename, gallium
31 * reference counting will be logged to the file.
33 * See http://www-archive.mozilla.org/performance/refcnt-balancer.html
34 * for what to do with the output on Linux, use tools/addr2line.sh to
35 * postprocess it before anything else.
40 #include "util/u_debug.h"
41 #include "util/u_debug_refcnt.h"
42 #include "util/u_debug_stack.h"
43 #include "util/u_debug_symbol.h"
44 #include "util/u_string.h"
45 #include "util/u_hash_table.h"
46 #include "os/os_thread.h"
47 #include "pipe/p_config.h"
49 int debug_refcnt_state
;
53 /* TODO: maybe move this serial machinery to a stand-alone module and
56 static mtx_t serials_mutex
= _MTX_INITIALIZER_NP
;
58 static struct hash_table
*serials_hash
;
59 static unsigned serials_last
;
63 * Return a small integer serial number for the given pointer.
66 debug_serial(void *p
, unsigned *pserial
)
70 #ifdef PIPE_OS_WINDOWS
71 static boolean first
= TRUE
;
74 (void) mtx_init(&serials_mutex
, mtx_plain
);
79 mtx_lock(&serials_mutex
);
81 serials_hash
= util_hash_table_create_ptr_keys();
83 serial
= (unsigned) (uintptr_t) util_hash_table_get(serials_hash
, p
);
85 /* time to stop logging... (you'll have a 100 GB logfile at least at
86 * this point) TODO: avoid this
88 serial
= ++serials_last
;
90 debug_error("More than 2^32 objects detected, aborting.\n");
94 _mesa_hash_table_insert(serials_hash
, p
, (void *) (uintptr_t) serial
);
97 mtx_unlock(&serials_mutex
);
106 * Free the serial number for the given pointer.
109 debug_serial_delete(void *p
)
111 mtx_lock(&serials_mutex
);
112 _mesa_hash_table_remove_key(serials_hash
, p
);
113 mtx_unlock(&serials_mutex
);
117 #if defined(PIPE_OS_WINDOWS)
124 * Log a reference count change to the log file (if enabled).
125 * This is called via the pipe_reference() and debug_reference() functions,
126 * basically whenever a reference count is initialized or changed.
128 * \param p the refcount being changed (the value is not changed here)
129 * \param get_desc a function which will be called to print an object's
130 * name/pointer into a string buffer during logging
131 * \param change the reference count change which must be +/-1 or 0 when
132 * creating the object and initializing the refcount.
135 debug_reference_slowpath(const struct pipe_reference
*p
,
136 debug_reference_descriptor get_desc
, int change
)
138 assert(change
>= -1);
141 if (debug_refcnt_state
< 0)
144 if (!debug_refcnt_state
) {
145 const char *filename
= debug_get_option("GALLIUM_REFCNT_LOG", NULL
);
146 if (filename
&& filename
[0])
147 stream
= fopen(filename
, "wt");
150 debug_refcnt_state
= 1;
152 debug_refcnt_state
= -1;
155 if (debug_refcnt_state
> 0) {
156 struct debug_stack_frame frames
[STACK_LEN
];
159 unsigned refcnt
= p
->count
;
161 boolean existing
= debug_serial((void *) p
, &serial
);
163 debug_backtrace_capture(frames
, 1, STACK_LEN
);
168 fprintf(stream
, "<%s> %p %u Create\n", buf
, (void *) p
, serial
);
169 debug_backtrace_print(stream
, frames
, STACK_LEN
);
171 /* this is here to provide a gradual change even if we don't see
174 for (i
= 1; i
<= refcnt
- change
; ++i
) {
175 fprintf(stream
, "<%s> %p %u AddRef %u\n", buf
, (void *) p
,
177 debug_backtrace_print(stream
, frames
, STACK_LEN
);
182 fprintf(stream
, "<%s> %p %u %s %u\n", buf
, (void *) p
, serial
,
183 change
> 0 ? "AddRef" : "Release", refcnt
);
184 debug_backtrace_print(stream
, frames
, STACK_LEN
);
188 debug_serial_delete((void *) p
);
189 fprintf(stream
, "<%s> %p %u Destroy\n", buf
, (void *) p
, serial
);
190 debug_backtrace_print(stream
, frames
, STACK_LEN
);