NAME

       mutextrace - LD_PRELOAD wrapper for tracing pthread mutex acquisition

SYNOPSIS

       mutextrace program options

DESCRIPTION

       This  tool allows you to wrap an existing program and wrap calls to pthread_create and pthread_mutex_* 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 pthread_mutex_trylock.
       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 mutextrace utility sets up the LD_PRELOAD 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.

SEE ALSO

       pthread_create(3)       pthread_mutex_init(3)        pthread_mutex_lock(3)        pthread_mutex_unlock(3)
       pthread_mutex_destroy(3)

AUTHOR

       mutextrace  was  written  by  Simon  Richter <Simon.Richter@hogyros.de>.  This manual page was written by
       Helmut Grohne <helmut@subdivi.de> for the Debian system (but may be used by others).

                                                   Mar 11 2013                                     mutextrace(1)