Propellor.Property.Network

Documentation

type Interface = String

type InterfaceOptions = [(String, String)]

Options to put in a stanza of an ifupdown interfaces file.

type InterfaceStanza = ([String], InterfaceOptions)

Stanza of an ifupdown interfaces file, with header lines and options.

ifUp :: Interface -> Property DebianLike

cleanInterfacesFile :: Property DebianLike

Resets etcnetwork/interfaces to a clean and empty state, containing just the standard loopback interface, and with interfacesD enabled.

This can be used as a starting point to defining other interfaces.

No interfaces are brought up or down by this property.

dhcp :: Interface -> Property DebianLike

Configures an interface to get its address via dhcp.

dhcp' :: Interface -> InterfaceOptions -> Property DebianLike

newtype Gateway

Constructors

Gateway IPAddr

static :: Interface -> IPAddr -> Maybe Gateway -> Property DebianLike

Configures an interface with a static address and gateway.

static' :: Interface -> IPAddr -> Maybe Gateway -> InterfaceOptions -> Property DebianLike

static'' :: Interface -> [(IPAddr, Maybe Gateway, InterfaceOptions)] -> Property DebianLike

Configures an interface with several stanzas (IPv4 and IPv6 for example).

preserveStatic :: Interface -> Property DebianLike

Writes a static interface file for the specified interface to preserve its current configuration.

The interface has to be up already. It could have been brought up by DHCP, or by other means. The current ipv4 addresses and routing configuration of the interface are written into the file.

If the interface file already exists, this property does nothing, no matter its content.

(ipv6 addresses are not included because it's assumed they come up automatically in most situations.)

ipv6to4 :: Property DebianLike

6to4 ipv6 connection, should work anywhere

interfacesFile :: FilePath

interfaceDFile :: Interface -> FilePath

A file in the interfaces.d directory.

escapeInterfaceDName :: Interface -> FilePath

etcnetworkinterfaces.d files have to match -- ^[a-zA-Z0-9_-]+$ see "man 5 interfaces"

interfacesDEnabled :: Property DebianLike

Ensures that files in the the interfaces.d directory are used. interfacesDEnabled :: Property DebianLike

interfaceFileContains :: FilePath -> [String] -> InterfaceOptions -> Property DebianLike

interfaceFileContains' :: FilePath -> [InterfaceStanza] -> Property DebianLike