View Source ProcessHub.Service.ProcessRegistry (ProcessHub v0.3.2-alpha)

The process registry service provides API functions for managing the process registry.

Summary

Functions

Deletes information about multiple child processes from the registry.

Inserts information about multiple child processes into the registry.

Deletes all objects from the process registry.

Returns a list of child_ids that match the given child_ids variable.

Deletes information about a child process from the registry.

Returns the first pid for the given child_id.

Returns a list of pids for the given child_id.

Inserts information about a child process into the registry.

Returns a list of child specs registered under the local node.

Returns information on all processes that are running on the local node.

Return the child_spec, nodes, and pids for the given child_id.

Returns information about all registered processes.

Types

@type registry() :: %{
  required(ProcessHub.child_id()) =>
    {ProcessHub.child_spec(), [{node(), pid()}]}
}

Functions

Link to this function

bulk_delete(hub_id, children)

View Source
@spec bulk_delete(ProcessHub.hub_id(), %{
  required(ProcessHub.child_id()) =>
    {ProcessHub.child_spec(), [{node(), pid()}]}
}) :: :ok

Deletes information about multiple child processes from the registry.

Calling this function will dispatch the :registry_pid_remove_hook hooks unless the :skip_hooks option is set to true.

Link to this function

bulk_insert(hub_id, children)

View Source
@spec bulk_insert(ProcessHub.hub_id(), %{
  required(ProcessHub.child_id()) =>
    {ProcessHub.child_spec(), [{node(), pid()}]}
}) :: :ok

Inserts information about multiple child processes into the registry.

Calling this function will dispatch the :registry_pid_insert_hook hook unless the :skip_hooks option is set to true.

@spec clear_all(ProcessHub.hub_id()) :: boolean()

Deletes all objects from the process registry.

Link to this function

contains_children(hub_id, child_ids)

View Source
@spec contains_children(ProcessHub.hub_id(), [ProcessHub.child_id()]) :: [
  ProcessHub.child_id()
]

Returns a list of child_ids that match the given child_ids variable.

Link to this function

delete(hub_id, child_id, opts \\ [])

View Source
@spec delete(ProcessHub.hub_id(), ProcessHub.child_id(), keyword() | nil) :: :ok

Deletes information about a child process from the registry.

Calling this function will dispatch the :registry_pid_remove_hook hook unless the :skip_hooks option is set to true.

Link to this function

get_pid(hub_id, child_id)

View Source
@spec get_pid(ProcessHub.hub_id(), ProcessHub.child_id()) :: pid() | nil

Returns the first pid for the given child_id.

Link to this function

get_pids(hub_id, child_id)

View Source
@spec get_pids(ProcessHub.hub_id(), ProcessHub.child_id()) :: [pid()]

Returns a list of pids for the given child_id.

Link to this function

insert(hub_id, child_spec, child_nodes, opts \\ [])

View Source
@spec insert(
  ProcessHub.hub_id(),
  ProcessHub.child_spec(),
  [{node(), pid()}],
  keyword() | nil
) :: :ok

Inserts information about a child process into the registry.

Calling this function will dispatch the :registry_pid_insert_hook hook unless the :skip_hooks option is set to true.

Link to this function

local_child_specs(hub_id)

View Source
@spec local_child_specs(ProcessHub.hub_id()) :: [ProcessHub.child_spec()]

Returns a list of child specs registered under the local node.

@spec local_data(ProcessHub.hub_id()) :: [
  {ProcessHub.child_id(), {ProcessHub.child_spec(), [{node(), pid()}]}}
]

Returns information on all processes that are running on the local node.

Link to this function

lookup(hub_id, child_id)

View Source
Link to this function

lookup(hub_id, child_id, opts)

View Source
@spec lookup(ProcessHub.hub_id(), ProcessHub.child_id(), [{:table, atom()}] | nil) ::
  nil | {ProcessHub.child_spec(), [{node(), pid()}]}

Return the child_spec, nodes, and pids for the given child_id.

Link to this function

process_list(hub_id, atom)

View Source
@spec process_list(atom(), :global | :local) :: [
  {ProcessHub.child_id(), [{node(), pid()}] | pid()}
]
@spec registry(ProcessHub.hub_id()) :: registry()

Returns information about all registered processes.