package magic-trace

You can search for identifiers within the package.

in-package search v0.2.0

Collects and displays high-resolution traces of what a process is doing

Install

Dune Dependency

magic-trace.org Readme MIT License Edit opam file Versions (1)

Authors

J

Jane Street Group, LLC

Maintainers

J

Jane Street developers

Sources

v1.0.1.tar.gz

sha256=77b2e4b3bc769910656d0fdee4839250548aa49486fd3554f6c057f1d64abe99

sha512=1f111db6348673c22a110611182a92c8aa999668dc077c44bc4abcaa72ccb197899ff2577047888627b50fcc9890824de6c82b4fe9f06129190b8b487ec3f716

doc/magic-trace.magic_trace/Magic_trace/index.html

Module `Magic_trace`Source

The magic-trace tool can work with any binary, but using these functions allows you to easily mark places in your code to take a snapshot, and enables additional features like passing a value and marking the start of a duration.

Sourceval take_snapshot : unit -> unit

This is the default symbol that the magic-trace command will attach to and use to take a snapshot. Use it if you want to take a snapshot based on custom logic, and it will save you the step of selecting the symbol you want to stop on.

It's an external C function that does nothing and should be very fast to call. It's only a C function to ensure it has a stable and exact symbol.

Sourceval take_snapshot_with_arg : int -> unit

Passes an integer along that will show up in the resulting trace

Sourceval take_snapshot_with_time_and_arg : Time_stamp_counter.t -> int -> unit

Passes both the start tsc for the operation and an argument.

Sourceval mark_start : unit -> unit

Mark the start time of some operation which may lead to a snapshot.

Sourcemodule Min_duration : sig ... end

Intended for use like so:

Sourcemodule Private : sig ... end

Internal details about how to interact with the snapshot function from outside