IFUPDOWN-MULTI-INTERFACES(5) - Linux man page online | File formats

Ifupdown-multi extension for the interfaces(5) file format.

17 September 2013


ifupdown-multi-interfaces - ifupdown-multi extension for the interfaces(5) file format


/etc/network/interfaces contains network interface information for the ifup(8) and ifdown(8) commands. This manpage describes the ifupdown-multi extensions to the the stan‐ dard interfaces(5) file format. The ifupdown-multi extensions to ifupdown integrate Linux's policy routing based support for multiple default gateways on independent network connections. These extensions can replace a typical shell script based approach that directly invokes a sequence of ip(8) commands for configuring multiple uplinks with declarative syntax in the /etc/net‐ work/interfaces file. ifupdown-multi records the policy information used to bring up each network interface when ifup(8) is run and removes the same policy routing information when ifdown(8) is run.


The standard address and netmask options must be set for each interface. The gateway option must NOT be set. The new multi_gateway and multi_table options must be set to configure policy routing with ifupdown-multi. Additionally, the multi_gateway_weight and multi_preferred_prefixes options can be speci‐ fied in order to control optional policy routing features. multi_gateway address Default gateway for this interface. (Required.) multi_table id Table identifier. This must be a numeric value, and each interface must have a unique value. Recommended range: 1-1000. (Required.) multi_gateway_weight weight Set this gateway's weight. This value is directly passed as the weight parameter to the nexthop part of an ip-route(8) route object. Higher values indicate higher rel‐ ative bandwidth or quality. (Optional.) multi_preferred_prefixes prefix [prefix]... Prefer this connection for the given prefixes. This option configures the routing policy database using the ip-rule(8) command to use this connection for the speci‐ fied prefixes. (Optional.)


The following example shows a basic configuration with two network interfaces. eth0 is on the network, while eth1 is on the network. Each interface stanza has a "multi_gateway" option, as opposed to the usual "gateway" option. Each inter‐ face stanza also needs a "multi_table" option, whose parameter is a small, unique non-neg‐ ative integer. (This number will be used internally to uniquely identify an inter‐ face-specific routing table.) auto eth0 iface eth0 inet static address netmask multi_table 1 multi_gateway auto eth1 iface eth1 inet static address netmask multi_table 2 multi_gateway The following example shows a more complicated setup using optional ifupdown-multi parame‐ ters. It is similar to the first example, but the network connection on eth0 is preferred for most connections, and several network prefixes prefer to use one or the other network connection. auto eth0 iface eth0 inet static address netmask multi_table 1 multi_gateway multi_gateway_weight 5 multi_preferred_prefixes auto eth1 iface eth1 inet static address netmask multi_table 2 multi_gateway multi_gateway_weight 1 multi_preferred_prefixes


/etc/network/interfaces System-wide network interface configuration. See interfaces(5). /var/run/network/ifupdown-multi.* State information used by ifupdown-multi.


interfaces(5), ifup(8), ip(8), ip-route(8), ip-rule(8). Linux Advanced Routing & Traffic Control HOWTO -- Chapter 4: Rules.
0.1.0 17 September 2013 IFUPDOWN-MULTI-INTERFACES(5)
This manual Reference Other manuals
ifupdown-multi-interfaces(5) referred by
refer to ifup(8) | interfaces(5) | ip(8) | ip-route(8) | ip-rule(8) | netscript(8)
Download raw manual
Index File Formats (+47) 0.1.0 (+1) № 5 (+2141)
Go top