NAME

       ocamldebug - the OCaml source-level replay debugger.

SYNOPSIS

       ocamldebug [ options ] program [ arguments ]

DESCRIPTION

       ocamldebug is the OCaml source-level replay debugger.

       Before the debugger can be used, the program must be compiled and linked with the -g option: all .cmo and
       .cma files that are part of the program should have been created with ocamlc -g, and they must be  linked
       together with ocamlc -g.

       Compiling  with  -g  entails  no  penalty  on  the  running  time  of programs: object files and bytecode
       executable files are bigger and take longer to produce, but the executable files run at exactly the  same
       speed as if they had been compiled without -g.

OPTIONS

       A  summary  of options are included below.  For a complete description, see the html documentation in the
       ocaml-doc package.

       -c count
              Set the maximum number of simultaneously live checkpoints to count.

       -cd dir
              Run the debugger program from the working directory dir, instead of the current working directory.
              (See also the cd command.)

       -emacs Tell the debugger it is executed under Emacs.  (See The OCaml user's manual for information on how
              to run the debugger under Emacs.)  Implies -machine-readable.

       -I directory
              Add directory to the list of directories searched for source files and compiled files.  (See  also
              the directory command.)

       -machine-readable
              Print  information  in  a  format  more  suitable  for  machines  instead of human operators where
              applicable. For example, when describing a  location  in  a  program,  such  as  when  printing  a
              backtrace,  print the program counter and character offset in a file instead of the filename, line
              number, and character offset in that line.

       -s socket
              Use socket for communicating with the  debugged  program.  See  the  description  of  the  command
              set socket in The OCaml user's manual for the format of socket.

       -version
              Print version string and exit.

       -vnum  Print short version number and exit.

       -help or --help
              Display a short usage summary and exit.

INITIALIZATION FILE

       When ocamldebug(1) is invoked, it will read commands from an initialization file before giving control to
       the user. The default file is .ocamldebug in the current directory if it exists, otherwise .ocamldebug in
       the user's home directory.

       Note that you can also use the source file command to read commands from a file.

SEE ALSO

       ocamlc(1)
       The OCaml user's manual, chapter "The debugger".

AUTHOR

       This manual page was written by Sven LUTHER <luther@debian.org>, for the Debian GNU/Linux system (but may
       be used by others).

                                                                                                   OCAMLDEBUG(1)