vintage_net v0.7.3 VintageNet.Interface View Source

Manage a network interface at a very high level

This module handles configuring network interfaces, making sure that configuration failures get retried, and then cleaning up after it's not needed.

The actual code that supplies the configuration implements the VintageNet.Technology behaviour.

Link to this section Summary

Functions

Returns a specification to start this module under a supervisor.

Configure an interface the low level way with a "raw_config"

Set a configuration on an interface

Return the current configuration

Run an I/O command on the specified interface

Start up an interface

Stop the interface

Convert a configuration to a raw one

Unconfigure the interface

Wait for the interface to be configured

Link to this section Functions

Returns a specification to start this module under a supervisor.

See Supervisor in Elixir v1.6+.

Configure an interface the low level way with a "raw_config"

Link to this function

configure(ifname, config)

View Source
configure(VintageNet.ifname(), map()) :: :ok

Set a configuration on an interface

Configurations with invalid parameters raise exceptions. It's still possible that network configurations won't work even if they don't raise, but it should be due to something in the environment. For example, a network cable isn't plugged in or a WiFi access point is out of range.

Link to this function

get_configuration(ifname)

View Source
get_configuration(VintageNet.ifname()) :: map()

Return the current configuration

Link to this function

ioctl(ifname, command, args)

View Source
ioctl(VintageNet.ifname(), atom(), any()) ::
  :ok | {:ok, any()} | {:error, any()}

Run an I/O command on the specified interface

Start up an interface

Parameters:

  • ifname - which interface

Stop the interface

Note that this doesn't unconfigure it.

Link to this function

to_raw_config(ifname, config)

View Source
to_raw_config(VintageNet.ifname(), map()) ::
  {:ok, VintageNet.Interface.RawConfig.t()} | {:error, any()}

Convert a configuration to a raw one

This can be used to validate a configuration without applying it.

Link to this function

unconfigure(ifname)

View Source
unconfigure(VintageNet.ifname()) :: :ok

Unconfigure the interface

This doesn't exit this GenServer, but the interface won't be usable in any real way until it's configured again.

This function is not normally called.

Link to this function

wait_until_configured(ifname)

View Source
wait_until_configured(VintageNet.ifname()) :: :ok

Wait for the interface to be configured