mutextrace(1)

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).