Control: tags -1 patch Dear mutextrace maintainer,
On Wed, Dec 02, 2009 at 04:04:27PM +0100, Helmut Grohne wrote: > The mutextrace package does not contain any documentation. According to > policy section 12.1. a bug should be reported for a missing manual page > which is the case. As there is no other documentation in the package it > degrades the usability and thus the bug is marked as important. I wrote a manual page for the mutextrace utility. Please consider including it under the very same license as the rest of the source. You'll find it attached to this mail. Helmut
.Dd Mar 11 2013 .Dt mutextrace 1 .Sh NAME mutextrace - LD_PRELOAD wrapper for tracing pthread mutex acquisition .Sh SYNOPSIS .nf \fBmutextrace\fP \fIprogram options\fP .fi .Sh DESCRIPTION This tool allows you to wrap an existing program and wrap calls to \fBpthread_create\fP and \fBpthread_mutex_*\fP to display what is happening. Specifically creation, locking, unlocking and destruction of mutexes as well as creation and termination of threads is displayed. Note that it does replace \fBpthread_mutex_trylock\fP. Objects are numbered sequentially numbered at creation and those numbers are used to identify them later on. When a lock is acquired in one thread which is currently held by another thread, the ownership transfer is explained. The \fBmutextrace\fP utility sets up the \fBLD_PRELOAD\fP environment variable to load the library into a program to be debugged. It takes no options on its own and assumes that the first parameter refers to a program to be executed. All further parameters are passed on to the wrapped program. .Sh SEE ALSO .Xr pthread_create 3 .Xr pthread_mutex_init 3 .Xr pthread_mutex_lock 3 .Xr pthread_mutex_unlock 3 .Xr pthread_mutex_destroy 3 .Sh AUTHOR \fBmutextrace\fP was written by Simon Richter <simon.rich...@hogyros.de>. This manual page was written by Helmut Grohne <hel...@subdivi.de> for the Debian system (but may be used by others).
