JavaScript is required to for searching.
Skip Navigation Links
Exit Print View
Multithreaded Programming Guide     Oracle Solaris 11.1 Information Library
search filter icon
search icon

Document Information

Preface

1.  Covering Multithreading Basics

2.  Basic Threads Programming

3.  Thread Attributes

4.  Programming with Synchronization Objects

5.  Programming With the Oracle Solaris Software

6.  Programming With Oracle Solaris Threads

7.  Safe and Unsafe Interfaces

8.  Compiling and Debugging

Setting Up the Oracle Solaris Environment for Developing Multithreaded Applications

Compiling a Multithreaded Application

Preparing for Compilation

Choosing Oracle Solaris or POSIX Threads

Including <thread.h> or <pthread.h>

Compiling and Linking a Multithreaded Program

Compiling and Linking in the POSIX Threads Environment

Compiling and Linking in the Oracle Solaris Threads Environment

Compiling and Linking in a Mixed Threads Environment

Linking With -lrt for POSIX Semaphores

Alternate Threads Library

Debugging a Multithreaded Program

Common Oversights in Multithreaded Programs

Tracing and Debugging with DTrace

Profiling with Performance Analyzer

Detecting Data Races and Deadlocks Using Thread Analyzer

Using dbx

Tracing and Debugging With the TNF Utilities

Using truss

Using mdb

9.  Programming Guidelines

A.  Extended Example: A Thread Pool Implementation

Index

Debugging a Multithreaded Program

The following discussion describes characteristics that can cause bugs in multithreaded programs. Utilities that you can use to help debug your program are also described.

Common Oversights in Multithreaded Programs

The following list points out some of the more frequent oversights that can cause bugs in multithreaded programs.

Multithreaded programs, especially those containing bugs, often behave differently in two successive runs, even with identical inputs. This behavior is caused by differences in the order that threads are scheduled.

In general, multithreading bugs are statistical instead of deterministic. Tracing is usually a more effective method of finding the order of execution problems than is breakpoint-based debugging.

Tracing and Debugging with DTrace

DTrace is a comprehensive dynamic tracing facility that is built into the Oracle Solaris OS. The DTrace facility can be used to examine the behavior of your multithreaded program. DTrace inserts probes into running programs to collect data at points in the execution path that you specify. The collected data can be examined to determine problem areas. See the Oracle Solaris 11.1 Dynamic Tracing Guide for more information about using DTrace.

Profiling with Performance Analyzer

The Performance Analyzer tool, included in the Oracle Solaris Studio Studio software, can be used for extensive profiling of multithreaded and single threaded programs. The tool enables you to see in detail what a thread is doing at any given point. See the Oracle Solaris Studio 12.3: Performance Analyzer guide for more information.

Detecting Data Races and Deadlocks Using Thread Analyzer

The Oracle Solaris Studio software includes a tool called the Thread Analyzer. This tool enables you to analyze the execution of a multithreaded program. It can detect multithreaded programming errors such as data races or deadlocks in code that is written using the Pthread API, the Oracle Solaris thread API, OpenMP directives, Oracle parallel directives, Cray parallel directives, or a mix of these technologies.

See the Oracle Solaris Studio 12.3: Debugging a Program With dbx guide for more information.

Using dbx

The dbx utility is a debugger included in the Oracle Solaris Studio developer tools, available from http://www.oracle.com/technetwork/server-storage/solarisstudio/downloads/index.html. With the Oracle Solaris Studio dbx command-line debugger, you can debug and execute source programs that are written in C, C++, and Fortran. You can use dbx by starting it in a terminal window and interactively debugging your program with dbx commands. If you prefer a graphical interface, you can use the same dbx functionality in the Debugging windows of the Oracle Solaris Studio IDE (Integrated Development Environment). For a description of how to start dbx, see the dbx(1) man page. See the manual Oracle Solaris Studio 12.3: Debugging a Program With dbx for an overview of dbx. The Debugging features in the Oracle Solaris Studio IDE are described in the IDE online help.

See Chapter 11, Debugging Multithreaded Applications, in Oracle Solaris Studio 12.3: Debugging a Program With dbx for detailed information about debugging multithreaded programs. The dbx debugger provides commands to manipulate event handlers for thread events, which are described in Appendix B, Event Management, in Oracle Solaris Studio 12.3: Debugging a Program With dbx.

All the dbx options that are listed in Table 8-1 can support multithreaded applications.

Table 8-1 dbx Options for MT Programs

Option
Action
cont at line [-sig signo id]
Continues execution at line with signal signo. The id, if present, specifies which thread or LWP to continue. The default value is all.
lwp [lwpid]
Displays current LWP. Switches to given LWP [lwpid].
lwps
Lists all LWPs in the current process.
next ... tid
Steps the given thread. When a function call is skipped, all LWPs are implicitly resumed for the duration of that function call. Nonactive threads cannot be stepped.
next ... lwpid
Steps the given LWP. Does not implicitly resume all LWPs when skipping a function. The LWP on which the given thread is active. Does not implicitly resume all LWP when skipping a function.
step... tid
Steps the given thread. When a function call is skipped, all LWPs are implicitly resumed for the duration of that function call. Nonactive threads cannot be stepped.
step... lwpid
Steps the given LWP. Does not implicitly resume all LWPs when skipping a function.
stepi... lwpid
Steps machine instructions (stepping into calls) in the given LWP.
stepi... tid
Steps machine instructions in the LWP on which the given thread is active.
thread [ tid ]
Displays current thread, or switches to thread tid. In all the following variations, omitting the l tid implies the current thread.
thread -info [ tid ]
Prints everything known about the given thread.
thread -blocks [ tid ]
Prints all locks held by the given thread blocking other threads.
thread -suspend [ tid ]
Puts the given thread into suspended state, which prevents it from running. A suspended thread displays with an “S” in the threads listing.
thread -resume [ tid ]
Unsuspends the given thread so it resumes running.
thread -hide [ tid ]
Hides the given or current thread. The thread does not appear in the generic threads listing.
thread -unhide [ tid ]
Unhides the given or current thread.
thread -unhide all
Unhides all threads.
threads
Prints the list of all known threads.
threads -all
Prints threads that are not usually printed (zombies).
threads -mode all|filter
Controls whether threads prints all threads or filters threads by default. When filtering is on, threads that have been hidden by the thread -hide command are not listed.
threads -mode auto|manual
Enables automatic updating of the thread listing.
threads -mode
Echoes the current modes. Any of the previous forms can be followed by a thread or LWP ID to get the traceback for the specified entity.

Tracing and Debugging With the TNF Utilities

Although Dtrace, Performance Analyzer, Thread Analyzer, and dbx are more modern tools, you can also still use the older TNF utilities to trace, debug, and gather performance analysis information from your applications and libraries. The TNF utilities integrate trace information from the kernel as well as from multiple user processes and threads. The TNF utilities have long been included as part of the Solaris software. See the tracing(3TNF) man page for information about these utilities.

Using truss

See the truss(1)man page for information on tracing system calls, signals and user-level function calls.

Using mdb

For information about mdb, see the Oracle Solaris Modular Debugger Guide.

The following mdb commands can be used to access the LWPs of a multithreaded program.

$l

Prints the LWP ID of the representative thread if the target is a user process.

$L

Prints the LWP IDs of each LWP in the target if the target is a user process.

pid::attach

Attaches to process # pid.

::release

Releases the previously attached process or core file. The process can subsequently be continued by prun(1) or it can be resumed by applying MDB or another debugger.

These commands to set conditional breakpoints are often useful.

[ addr ] ::bp [+/-dDestT] [-c cmd] [-n count] sym ...

Set a breakpoint at the specified locations.

addr ::delete [ id | all]

Delete the event specifiers with the given ID number.