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