package ocaml-probes

You can search for identifiers within the package.

in-package search v0.2.0

USDT probes for OCaml: command line tool

Install

Dune Dependency

github.com Readme Changelog MIT License Edit opam file Versions (3)

Authors

J

Jane Street Group, LLC

Maintainers

J

Jane Street developers

Sources

v0.17.0.tar.gz

sha256=e3587acc8c957181030a4c9daac7041f44c3faf908707b9cb3b808173e19d380

doc/ocaml-probes.probes_lib/Probes_lib/With_ptrace/index.html

Module `Probes_lib.With_ptrace`Source

For expert use only. Use trace_existing_process ~atomically:true and trace_new_process if possible, they do With_ptrace under the hood.

Atomically get and update the state of probes using ptrace. A simple state machine checks that the process is stopped before trying to get or update the state of probes:

(attach . (update | get_probe_state)* . detach

Sourceval attach : t -> pid -> unit

Attach to the process with pid, and stop it to allow probe update.

Sourceval start : t -> args:string list -> pid

Sourceval update : ?force:bool -> t -> actions:actions -> unit

Enable/disable probes. Raise if not attached to any process. update writes to memory of the process that must have been already stopped by attach. update does not continue process execution and can be invoked more than once. Invoke detach to continue process execution after all updates are done.

force see trace_existing_process

Sourceval get_probe_states : ?probe_names:probe_name array -> t -> probe_state array

Check which probes are enabled in the current process. Raise if not attached.

Sourceval detach : t -> unit

Let the process continue its execution and detach from it.