ocamldebug (1)

Leading comments

**************************************************************************
*                                                                        *
*                                 OCaml                                  *
*                                                                        *
*             Xavier Leroy, projet Cristal, INRIA Rocquencourt           *
*                                                                        *
*   Copyright 2001 Institut National de Recherc...

(The comments found at the beginning of the groff file "man1/ocamldebug.1".)

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).