ides (ides v0.2.0)

View Source

Beware the Ides of March — find the supervisors and siblings that could kill your Erlang process.

Given any PID, this module shows:

  • Ancestors: the chain of supervisors above the process
  • Siblings: all children of the same supervisor
  • Kill graph: every process that could cause this PID to be killed
  • Restart logic: whether a terminated child will be restarted
  • Affected siblings: which siblings a supervisor would kill/restart if this PID dies

Uses OTP primitives: erlang:process_info/2 for $ancestors, supervisor:which_children/1, and proc_lib:translate_initial_call/1

Summary

Types

child_process()
child_restart_type()
exit_reason()
kill_source()
link_info()
monitor_info()
process()
supervisor_process()
supervisor_strategy()

Functions

affected_siblings(TargetPid)
ancestors(TargetPid)
format(TargetPid, Tree)
format_detail(TargetPid, Tree, KillSources)
kill_graph(TargetPid)
kill_graph_detail(TargetPid)
link_info(Pid)
monitor_info(Pid)
print(TargetPid, Tree)
print_detail(TargetPid, Tree, KillSources)
should_restart(Pid, Reason)

Types

child_process()

-type child_process() :: ides_family:child_process().

child_restart_type()

-type child_restart_type() :: ides_family:child_restart_type().

exit_reason()

-type exit_reason() :: ides_march:exit_reason().

kill_source()

-type kill_source() :: ides_family:kill_source().

monitor_info()

-type monitor_info() :: ides_family:monitor_info().

process()

-type process() :: ides_family:process().

supervisor_process()

-type supervisor_process() :: ides_family:supervisor_process().

supervisor_strategy()

-type supervisor_strategy() :: ides_family:supervisor_strategy().

Functions

affected_siblings(TargetPid)

-spec affected_siblings(TargetPid :: pid()) -> {ok, [pid()]} | {error, term()}.

ancestors(TargetPid)

-spec ancestors(TargetPid :: pid()) -> {ok, process()} | {error, term()}.

format(TargetPid, Tree)

-spec format(TargetPid :: pid(), Tree :: process()) -> iolist().

format_detail(TargetPid, Tree, KillSources)

-spec format_detail(TargetPid :: pid(), Tree :: process(), KillSources :: [kill_source()]) -> iolist().

kill_graph(TargetPid)

-spec kill_graph(TargetPid :: pid()) -> {ok, [pid()]} | {error, term()}.

kill_graph_detail(TargetPid)

-spec kill_graph_detail(TargetPid :: pid()) -> {ok, [kill_source()]} | {error, term()}.

monitor_info(Pid)

-spec monitor_info(Pid :: pid()) -> {ok, monitor_info()} | {error, term()}.

print(TargetPid, Tree)

-spec print(TargetPid :: pid(), Tree :: process()) -> ok.

should_restart(Pid, Reason)

-spec should_restart(Pid :: pid(), Reason :: exit_reason()) -> boolean().