NAME

       ocamlcp, ocamloptp - The OCaml profiling compilers

SYNOPSIS

       ocamlcp [ ocamlc options ] [ -P flags ] filename ...

       ocamloptp [ ocamlopt options ] [ -P flags ] filename ...

DESCRIPTION

       The  ocamlcp  and  ocamloptp  commands  are  front-ends  to ocamlc(1) and ocamlopt(1) that
       instrument the source code, adding code to record how many  times  functions  are  called,
       branches  of  conditionals  are  taken,  etc.   Execution of instrumented code produces an
       execution profile in the file ocamlprof.dump, which can be read using ocamlprof(1).

       ocamlcp accepts the same arguments and options as ocamlc(1) and ocamloptp accepts the same
       arguments and options as ocamlopt(1).  There is only one exception: in both cases, the -pp
       option is not supported.  If you need to preprocess your source files, you will have to do
       it separately before calling ocamlcp or ocamloptp.

OPTIONS

       In  addition  to  the  ocamlc(1)  or ocamlopt(1) options, ocamlcp and ocamloptp accept one
       option to control the kind of profiling information, the -P letters  option.  The  letters
       indicate which parts of the program should be profiled:

       a      all options

       f      function calls : a count point is set at the beginning of each function body

       i      if ... then ... else: count points are set in both then and else branches

       l      while, for loops: a count point is set at the beginning of the loop body

       m      match branches: a count point is set at the beginning of the body of each branch of
              a pattern-matching

       t      try ... with branches: a count point is set at the beginning of the  body  of  each
              branch of an exception catcher

       For    instance,    compiling    with   ocamlcp   -P   film   profiles   function   calls,
       if ... then ... else ..., loops, and pattern matching.

       Calling ocamlcp(1) or ocamloptp(1) without the -P option defaults to -P fm,  meaning  that
       only function calls and pattern matching are profiled.

       Note: for compatibility with previous versions, ocamlcp(1) also accepts the option -p with
       the same argument and meaning as -P.

SEE ALSO

       ocamlc(1), ocamlopt(1), ocamlprof(1).
       The OCaml user's manual, chapter "Profiling".

                                                                                       OCAMLCP(1)