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)