Lines Matching +full:a +full:- +full:9

1 .\" Copyright (c) 2017 George V. Neville-Neil <gnn@FreeBSD.org>
15 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
30 .Nd a DTrace provider for tracing CPU scheduling events
32 .Fn lockstat:::adaptive-acquire "struct mtx *"
33 .Fn lockstat:::adaptive-release "struct mtx *"
34 .Fn lockstat:::adaptive-spin "struct mtx *" "uint64_t"
35 .Fn lockstat:::adaptive-block "struct mtx *" "uint64_t"
36 .Fn lockstat:::spin-acquire "struct mtx *"
37 .Fn lockstat:::spin-release "struct mtx *"
38 .Fn lockstat:::spin-spin "struct mtx *" "uint64_t"
39 .Fn lockstat:::rw-acquire "struct rwlock *" "int"
40 .Fn lockstat:::rw-release "struct rwlock *" "int"
41 .Fn lockstat:::rw-block "struct rwlock *" "uint64_t" "int" "int" "int"
42 .Fn lockstat:::rw-spin "struct rwlock *" "uint64_t"
43 .Fn lockstat:::rw-upgrade "struct rwlock *"
44 .Fn lockstat:::rw-downgrade "struct rwlock *"
45 .Fn lockstat:::sx-acquire "struct sx *" "int"
46 .Fn lockstat:::sx-release "struct sx *" "int"
47 .Fn lockstat:::sx-block "struct sx *" "uint64_t" "int" "int" "int"
48 .Fn lockstat:::sx-spin "struct sx *" "uint64_t"
49 .Fn lockstat:::sx-upgrade "struct sx *"
50 .Fn lockstat:::sx-downgrade "struct sx *"
51 .Fn lockstat:::lockmgr-acquire "struct lock *" "int"
52 .Fn lockstat:::lockmgr-release "struct lock *" "int"
53 .Fn lockstat:::lockmgr-disown "struct lock *" "int"
54 .Fn lockstat:::lockmgr-block "struct lock *" "uint64_t" "int" "int" "int"
55 .Fn lockstat:::lockmgr-upgrade "struct lock *"
56 .Fn lockstat:::lockmgr-downgrade "struct lock *"
57 .Fn lockstat:::thread-spin "struct mtx *" "uint64"
69 .Xr lockmgr 9 ,
70 .Xr mutex 9 ,
71 .Xr rwlock 9 ,
73 .Xr sx 9
85 as well as probes which fire when a thread contends with other threads
86 for ownership of a lock.
89 .Fn lockstat:::adaptive-acquire
91 .Fn lockstat:::adaptive-release
94 .Xr mutex 9
96 The only argument is a pointer to the lock structure which describes
100 .Fn lockstat:::adaptive-spin
101 probe fires when a thread spins while waiting for a
103 .Xr mutex 9
105 The first argument is a pointer to the lock structure that describes
109 .Fn lockstat:::adaptive-block
110 probe fires when a thread takes itself off the CPU while trying to acquire an
112 .Xr mutex 9
114 The first argument is a pointer to the lock structure that describes
118 .Fn lockstat:::adaptive-block
120 .Fn lockstat:::adaptive-spin
123 .Fn lockstat:::adaptive-acquire
127 .Fn lockstat:::spin-acquire
129 .Fn lockstat:::spin-release
130 probes fire when a
132 .Xr mutex 9
134 The only argument is a pointer to the lock structure which describes
138 .Fn lockstat:::spin-spin
139 probe fires when a thread spins while waiting for a
141 .Xr mutex 9
143 The first argument is a pointer to the lock structure that describes
147 .Fn lockstat:::spin-spin
150 .Fn lockstat:::spin-acquire
154 .Fn lockstat:::rw-acquire
156 .Fn lockstat:::rw-release
157 probes fire when a
158 .Xr rwlock 9
160 The first argument is a pointer to the structure which describes
164 if the lock is being acquired or released as a writer, and
166 if it is being acquired or released as a reader.
168 .Fn lockstat:::sx-acquire
170 .Fn lockstat:::sx-release ,
172 .Fn lockstat:::lockmgr-acquire
174 .Fn lockstat:::lockmgr-release
176 .Xr sx 9
178 .Xr lockmgr 9
181 .Fn lockstat:::lockmgr-disown
182 probe fires when a
183 .Xr lockmgr 9
186 released by a different thread.
188 .Fn lockstat:::lockmgr-release
189 probe does not fire when releasing a disowned lock.
190 The first argument is a pointer to the structure which describes
195 .Fn lockstat:::lockmgr-release .
198 .Fn lockstat:::rw-block ,
199 .Fn lockstat:::sx-block ,
201 .Fn lockstat:::lockmgr-block
202 probes fire when a thread removes itself from the CPU while
203 waiting to acquire a lock of the corresponding type.
205 .Fn lockstat:::rw-spin
207 .Fn lockstat:::sx-spin
208 probes fire when a thread spins while waiting to acquire a lock
211 The first argument is a pointer to the lock structure that describes
217 if the thread is attempting to acquire the lock as a writer, and
219 if the thread is attempting to acquire the lock as a reader.
222 if the thread is waiting for a reader to release the lock, and
224 if the thread is waiting for a writer to release the lock.
233 .Fn lockstat:::lockmgr-upgrade ,
234 .Fn lockstat:::rw-upgrade ,
236 .Fn lockstat:::sx-upgrade
237 probes fire when a thread successfully upgrades a held
238 .Xr lockmgr 9 ,
239 .Xr rwlock 9 ,
241 .Xr sx 9
243 The only argument is a pointer to the structure which describes
246 .Fn lockstat:::lockmgr-downgrade ,
247 .Fn lockstat:::rw-downgrade ,
249 .Fn lockstat:::sx-downgrade
250 probes fire when a thread downgrades a held
251 .Xr lockmgr 9 ,
252 .Xr rwlock 9 ,
254 .Xr sx 9
255 exclusive/writer lock to a shared/reader lock.
258 .Fn lockstat:::thread-spin
259 probe fires when a thread spins on a thread lock, which is a specialized
261 .Xr mutex 9 .
262 The first argument is a pointer to the structure that describes
268 .Xr locking 9 ,
269 .Xr mutex 9 ,
270 .Xr rwlock 9 ,
271 .Xr SDT 9 ,
272 .Xr sx 9
282 .Fx 9 .
285 .An George V. Neville-Neil Aq Mt gnn@FreeBSD.org
287 .An -nosplit
291 .Xr rmlock 9