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
|
#!/bin/bash
# This file is part of mutrace.
#
# Copyright 2009 Lennart Poettering
#
# mutrace is free software: you can redistribute it and/or modify it
# under the terms of the GNU Lesser General Public License as
# published by the Free Software Foundation, either version 3 of the
# License, or (at your option) any later version.
#
# mutrace is distributed in the hope that it will be useful, but
# WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
# Lesser General Public License for more details.
#
# You should have received a copy of the GNU Lesser General Public
# License along with mutrace. If not, see <http://www.gnu.org/licenses/>.
if ! TEMP=`getopt -o +ardh --long hash-size:,frames:,locked-min:,owner-changed-min:,contended-min:,max:,order:,trap,help,all,debug-info -n mutrace -- "$@"` ; then
exit 1
fi
eval set -- "$TEMP"
debug_info=0
while : ; do
case $1 in
--hash-size)
export MUTRACE_HASH_SIZE="$2"
shift 2
;;
--frames)
export MUTRACE_FRAMES="$2"
shift 2
;;
--locked-min)
export MUTRACE_LOCKED_MIN="$2"
shift 2
;;
--owner-changed-min)
export MUTRACE_OWNER_CHANGED_MIN="$2"
shift 2
;;
--contended-min)
export MUTRACE_CONTENDED_MIN="$2"
shift 2
;;
--max)
export MUTRACE_MAX="$2"
shift 2
;;
--order)
export MUTRACE_SUMMARY_ORDER="$2"
shift 2
;;
--trap)
export MUTRACE_TRAP=1
shift 1
;;
-r|--track-rt)
export MUTRACE_TRACK_RT=1
shift 1
;;
-d|--debug-info)
debug_info=1
shift 1
;;
-a|--all)
export MUTRACE_LOCKED_MIN=0
export MUTRACE_OWNER_CHANGED_MIN=0
export MUTRACE_CONTENDED_MIN=0
export MUTRACE_MAX=0
shift 1
;;
-h|--help)
cat <<EOF
@PACKAGE_STRING@
Usage: mutrace [OPTIONS...] APPLICATION [ARGUMENTS...]
COMMANDS:
-h, --help Show this help
OPTIONS:
--hash-size=INTEGER Set size of mutex hash table
--frames=INTEGER Set number of frames to show in stack traces
-d, --debug-info Make use of debug information in stack traces
--max=INTEGER Show this many mutexes at maximum
--order=STRING Order the summary table by this column (see
below for valid column names)
--locked-min=INTEGER Only show mutexes that have been locked at
least this often
--owner-changed-min=INTEGER Only show mutexes whose owning thread changed
at least this often
--contended-min=INTEGER Only show mutexes which have been contended
at least this often
--all Show all mutexes, overrides the values of the
three values above
-r, --track-rt Track for each mutex if it was accessed from
a realtime thread
--trap Trigger a debugger trap each time a mutex
inconsistency is detected (for use in
conjunction with gdb)
ORDER COLUMN NAMES:
id Mutex number
n-locked Total number of times mutex was locked
n-owner-changed Total number of times mutex ownership changed
n-contended Total number of times mutex was contested
nsec-locked-total Total time mutex was locked for writing
nsec-locked-max Maximum time mutex was continuously locked for
writing
nsec-locked-avg Average time mutex was continuously locked for
writing
nsec-contended-total Total time mutex was contended for writing
nsec-contended-avg Average time mutex was continuously contended
for writing
nsec-read-contended-total Total time mutex was contended for reading
EOF
exit 0
;;
--)
shift
break
;;
*)
echo "Parsing failed!" >&2
exit 1
;;
esac
done
shift $(($OPTIND-1))
if [ x"$1" = x ] ; then
echo "Please specify an application to profile!" >&2
exit 1
fi
if [ x"$LD_PRELOAD" = x ] ; then
export LD_PRELOAD="libmutrace.so"
else
export LD_PRELOAD="$LD_PRELOAD:libmutrace.so"
fi
if [ x"$debug_info" = x1 ] ; then
export LD_PRELOAD="$LD_PRELOAD:libmutrace-backtrace-symbols.so"
fi
exec "$@"
|