Scroll to navigation

COZ(1) User Commands COZ(1)

NAME

coz - profiler running experiements on multithreaded code

SYNOPSIS

coz run [profiling options] --- <command> [args]

coz plot [-h]

DESCRIPTION

Coz is a new kind of profiler that unlocks optimization opportunities missed by traditional profilers. Coz employs a novel technique we call causal profiling that measures optimization potential. This measurement matches developers' assumptions about profilers: that optimizing highly-ranked code will have the greatest impact on performance. Causal profiling measures optimization potential for serial, parallel, and asynchronous programs without instrumentation of special handling for library calls and concurrency primitives. Instead, a causal profiler uses performance experiments to predict the effect of optimizations. This allows the profiler to establish causality: "optimizing function X will have effect Y," exactly the measurement developers had assumed they were getting all along.

OPTIONS

show this help message and exit
Profile matching executables. Use '%' as a wildcard, or 'MAIN' to include the main executable (default=MAIN)
Profile matching source files. Use '%' as a wildcard. (default=%)

[NOT SUPPORTED] Add a sampling-based progress point

Profiler output (default=`profile.coz`)
Run a single performance experiment per-execution

Evaluate optimizations of a specific source line
Evaluate optimizations of a specific amount

SEE ALSO


AUTHOR

Petter Reinholdtsen - pere@hungry.com

COPYRIGHT

public domain

2016-08-15 0.1