Inertial provides system event notifications for network interface changes such as link status and IP address assignments, on Linux and OSX.
It uses the OS's native event notification mechanisms to provide real-time
updates with minimal overhead. A connection is made to a 'system' socket
using the Erlang :socket module, and a NIF is used to set the appropriate
event filters and decode the received packets.
Example
iex> ref = Inertial.subscribe()
#Reference<0.1234567890.1234567890.123456>
iex> receive do
...> {^ref, event} -> IO.inspect(event)
...> end
%{type: :new_addr, ifname: "eth0", addr: {192, 168, 1, 100}}Summary
Functions
Subscribes the calling process to Inertial events.
Unsubscribes the calling process from Inertial events.
Types
@type addr_event() :: %{ type: :new_addr | :del_addr, ifname: String.t(), addr: :inet.ip_address() }
@type event_msg() :: {reference(), link_event() | addr_event()}
@type link_event() :: %{type: :link_up | :link_down, ifname: String.t()}
Functions
@spec subscribe() :: reference()
Subscribes the calling process to Inertial events.
Returns a reference that can be used to unsubscribe later, and identifies the event when
it arrives in the caller's mailbox. Messages will be of type event_msg/0.
Example
iex> ref = Inertial.subscribe()
#Reference<0.1234567890.1234567890.123456>
iex> receive do
...> {^ref, event} -> IO.inspect(event)
...> end
%{type: :new_addr, ifname: "eth0", addr: {192, 168, 1, 100}}@spec unsubscribe(reference()) :: :ok
Unsubscribes the calling process from Inertial events.
Takes the reference returned by subscribe/0, and unsubscribes. Should be called by the same
process that called subscribe/0.
Guarantees that no further messages with the given reference will be received after this call.
Example
iex> ref = Inertial.subscribe()
#Reference<0.1234567890.1234567890.123456>
iex> Inertial.unsubscribe(ref)
:ok