View Source VintageNet.NameResolver (vintage_net v0.13.5)

This module manages the contents of "/etc/resolv.conf".

This file is used by the C standard library and by Erlang for resolving domain names. Since both C programs and Erlang can do resolution, debugging problems in this area can be confusing due to varying behavior based on who's resolving at the time. See the /etc/erl_inetrc file on the target to review Erlang's configuration.

This module assumes exclusive ownership on "/etc/resolv.conf", so if any other code in the system tries to modify the file, their changes will be lost on the next update.

It is expected that each network interface provides a configuration. This module will track configurations to network interfaces so that it can reflect which resolvers are around. Resolver order isn't handled.

Summary

Types

state()

Functions

child_spec(init_arg)

Returns a specification to start this module under a supervisor.

clear(ifname)

Clear all entries in "/etc/resolv.conf" that are associated with the specified interface.

clear_all()

Completely clear out "/etc/resolv.conf".

setup(ifname, domain, name_servers)

Set the search domain and name server list for the specified interface.

start_link(args)

Start the resolv.conf manager.

stop()

Stop the resolv.conf manager.

Types

Link to this type

state()

View Source 
@type state() :: %{
  path: String.t(),
  entries: VintageNet.Resolver.ResolvConf.entry_map(),
  additional_name_servers:
    VintageNet.Resolver.ResolvConf.additional_name_servers()
}

Functions

Link to this function

child_spec(init_arg)

View Source

Returns a specification to start this module under a supervisor.

See Supervisor.

Link to this function

clear(ifname)

View Source 
@spec clear(String.t()) :: :ok

Clear all entries in "/etc/resolv.conf" that are associated with the specified interface.

Link to this function

clear_all()

View Source 
@spec clear_all() :: :ok

Completely clear out "/etc/resolv.conf".

Link to this function

setup(ifname, domain, name_servers)

View Source 
@spec setup(String.t(), String.t() | nil, [:inet.ip_address()]) :: :ok

Set the search domain and name server list for the specified interface.

This replaces any entries in the /etc/resolv.conf for this interface.

Link to this function

start_link(args)

View Source 
@spec start_link(keyword()) :: GenServer.on_start()

Start the resolv.conf manager.

Accepted args:

  • resolvconf - path to the resolvconf file
  • additional_name_servers - list of additional servers
Link to this function

stop()

View Source 
@spec stop() :: :ok

Stop the resolv.conf manager.