5 The Oz Profiler: ozd -p

# 5 The Oz Profiler: `ozd -p`

The Oz profiler is extensively documented in ``The Mozart Profiler''. We describe it here merely in its incarnation as a command line application. Furthermore, we only document its options.

If you have created an Oz application which you normally start from the shell as follows:

> `Foo` Args`...`

Then you can run it under control of the Oz profiler by using the following command instead:

> `ozd -p Foo --` Args`...`

Any Oz application can be run in the profiler, but you only get the full benefit of the profiling interface when the code being executed was compiled with the `-p` option to include profiling instrumentation code. The profiler and the debugger share the same interface.

The double dash `--` separates the arguments intended for `ozd` from those intended for the application being run under the profiler.

`--help`, `-h`, `-?`

  Display information on legal options, then exit

`-p`, `--profiler`, `--mode=profiler`

  You must supply this option in order to start the profiler; otherwise the debugger is started instead (see Chapter 4).

`-g`, `--debugger`, `--mode=debugger`

  This is the default option: it starts the debugger (see Chapter 4). As mentioned above, in order to actually start the profiler, you must supply the `-p` option.

`-E`, `--(no)useemacs`

  Starts a subordinate Emacs process. This will be used to display the source code corresponding to the profile data being examined.

`--emacs=`FILE

  Specifies the Emacs binary to run for option `-E`. The default is $`OZEMACS` if set, else `emacs`.