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

       -h, --help
              show this help message and exit

       --binary-scope <filepattern>, -b <filepattern>
              Profile matching executables. Use '%' as a wildcard, or 'MAIN'  to  include  the  main  executable
              (default=MAIN)

       --source-scope <filepattern>, -s <filepattern>
              Profile matching source files. Use '%' as a wildcard.  (default=%)

       --progress <source file>:<line number>, -p <source file>:<line number>
              [NOT SUPPORTED] Add a sampling-based progress point

       --output <profileoutput>, -o <profileoutput>
              Profiler output (default=`profile.coz`)

       --end-to-end
              Run a single performance experiment per-execution

       --fixed-line <source file>:<line number>
              Evaluate optimizations of a specific source line

       --fixed-speedup <speedup> (0-100)
              Evaluate optimizations of a specific amount

SEE ALSO

       • http://coz-profiler.org

       • man gdb

AUTHOR

       Petter Reinholdtsen - pere@hungry.com

COPYRIGHT

       public domain