reduce-lock-contention

Examine specified annotated sites for opportunities to reduce lock contention or find deadlocks in a Suitability report.

GUI Equivalent

Suitability > Lock Contention

Syntax

--reduce-lock-contention=<string>

Arguments

<string> is a comma-separated list of annotated sites (no spaces).

Default

No default argument

Actions Modified

report=suitability

Usage

Lock contention is the time one thread spends waiting for a lock to be released while another thread holds that lock (as opposed to lock overhead, which is the time spent creating, destroying, acquiring, and releasing locks). You can reduce lock contention by using different locks for unrelated data when you convert to a parallel framework.

Usage of this option simulates parallel execution with the assumption that lock contention is zero for a specified site.

Example

Generate a Suitability report. Examine the annotated sites myAnnotatedSiteJ and myAnnotatedSiteX for opportunities to reduce lock contention. Write the report to stdout.

advisor --report=suitability --reduce-lock-contention=myAnnotatedSiteJ,myAnnotatedSiteX --project-dir=./advi_results