D.1.4.1 Conditions Command

The conditions command lists all known condition variables in use.

DECthreads may not know about condition variables that were statically initialized and have not been used recently. It cannot keep track of each pthread_cond_t structure within a program - only "auxiliary" structures that are allocated within DECthreads when a thread blocks on a condition variable. When metering, all condition variables that have ever been used are known.

Format:

conditions [condition-variable-number] [qualifier]

condition-variable-number

One or more object sequence numbers separated by spaces. If specified, only those condition variables whose sequence numbers are listed are displayed. Each argument that does not begin with "-" is interpreted as the sequence number of a condition variable.

Qualifier           Description

-a          Include internal condition variables created by DECthreads.

-f          Display complete information about the state of each
            condition variable, including whether there are deferred
            signal operations or pending wakeups that need to be
            processed.

-h          Display the history buffer of recent operations carried out
            on each condition variable. This history is maintained only
            when DECthreads is run with metering enabled. Each line in
            the history shows a specific operation (wait, signal, or
            broadcast) with additional information such as whether a
            signal or broadcast awakened another thread. It also shows
            the thread that invoked the function and the program PC from
            which DECthreads was called. This information is available
            when DECthreads is run with metering enabled.

-q          Display the sequence number of each thread that is waiting on
            a condition variable (if there are any waiters).

-s          Display statistics for each condition variable. This includes
            the number of waits, signals, and broadcasts, the number of
            times a thread actually blocked on the condition variable,
            the maximum and average number of threads blocked on the
            condition variable at any time. This information is available
            when DECthreads is run with metering enabled.

-w          List only condition variables that have threads waiting on
            them.