xenial (1) mutextrace.1.gz

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