Manpages

NAME

ifupdown-addons-interfaces - ifupdown2 addon modules interface configuration

DESCRIPTION

ifupdown2 addon modules add incremental functionality to core ifupdown2 tool.

All installed addon modules are executed on every interface listed in the interfaces file. Addon modules are installed under /usr/share/ifupdownaddons. To see the list of active addon modules, see ifaddon(8).

Addon modules add new attributes to the interfaces(5) file. Below is a list of attribute options provided by each module. These can be listed under each iface section in the interfaces(5) file.

EXAMPLES

Listed below are addon modules and their supported attributes. The attributes if applicable go under the iface section in the interfaces(5) file.

ethtool: ethtool configuration module for interfaces

link-duplex

help: set link duplex

required: False

default: half

validvals: half,full
example:

link-duplex full

link-autoneg

help: set autonegotiation

required: False

default: no

validvals: yes,no
example:

link-autoneg yes

link-speed

help: set link speed

required: False
example:

link-speed 1000

bridge: Bridge configuration module. Supports both vlan aware and non vlan aware bridges. For the vlan aware bridge, the port sp ecific attributes must be specified under the port. And for vlan u naware bridge port specific attributes must be specified under the bridge.

bridge-vlan-aware

help: vlan aware bridge. Setting this attribute to yes ena bles vlan filtering on the bridge

required: False
example:

bridge-vlan-aware yes/no

bridge-pathcosts

help: bridge set port path costs

required: False

default: 100
example:

bridge-pathcosts swp1=100 swp2=100

bridge-portprios

help: bridge port prios

required: False

default: 32
example:

bridge-portprios swp1=32 swp2=32

bridge-fd

help: bridge forward delay

required: False

default: 15
example:

bridge-fd 15

bridge-ageing

help: bridge ageing

required: False

default: 300
example:

bridge-ageing 300

bridge-hello

help: bridge set hello time

required: False

default: 2
example:

bridge-hello 2

bridge-gcint

help: bridge garbage collection interval in secs

required: False

default: 4
example:

bridge-gcint 4

bridge-mcquerier

help: set multicast querier

required: False

default: no

validvals: yes,no
example:

bridge-mcquerier no

bridge-mclmc

help: set multicast last member count

required: False

default: 2
example:

bridge-mclmc 2

bridge-mcsqc

help: set multicast startup query count

required: False

default: 2
example:

bridge-mcsqc 2

bridge-mcrouter

help: set multicast router

required: False

default: yes

validvals: yes,no
example:

bridge-mcrouter yes

bridge-stp

help: bridge-stp yes/no

required: False

default: no

validvals: yes,on,off,no
example:

bridge-stp no

bridge-pvid

help: bridge port pvid. Must be specified under the bridge port

required: False
example:

bridge-pvid 1

bridge-mcsqi

help: set multicast startup query interval (in secs)

required: False

default: 31
example:

bridge-mcsqi 31

bridge-mcmi

help: set multicast membership interval (in secs)

required: False

default: 260
example:

bridge-mcmi 260

bridge-mclmi

help: set multicast last member interval (in secs)

required: False

default: 1
example:

bridge-mclmi 1

bridge-vids

help: bridge port vids. Can be specified under the bridge or under the port. If specified under the bridge the ports inh erit it unless overridden by a bridge-vids attribuet under the port

required: False
example:

bridge-vids 4000

bridge-vids 2000 2200-3000

bridge-ports

help: bridge ports

required: True
example:

bridge-ports swp1.100 swp2.100 swp3.100

bridge-ports glob swp1-3.100

bridge-ports glob swp[1-3]s[0-4].100

bridge-ports regex (swp[1|2|3].100)

bridge-mcqifaddr

help: set multicast query to use ifaddr

required: False

default: no

validvals: yes,no
example:

bridge-mcqifaddr no

bridge-waitport

help: wait for a max of time secs for the specified ports to become available,if no ports are specified then those speci fied on bridge-ports will be used here. Specifying no ports he re should not be used if we are using regex or "all" on bridge _ports,as it wouldnt work.

required: False

default: 0
example:

bridge-waitport 4 swp1 swp2

bridge-mcqri

help: set multicast query response interval (in secs)

required: False

default: 10
example:

bridge-mcqri 10

bridge-hashel

help: set hash elasticity

required: False

default: 4096
example:

bridge-hashel 4096

bridge-mcqpi

help: set multicast querier interval (in secs)

required: False

default: 255
example:

bridge-mcqpi 255

bridge-hashmax

help: set hash max

required: False

default: 4096
example:

bridge-hashmax 4096

bridge-bridgeprio

help: bridge priority

required: False

default: 32768
example:

bridge-bridgeprio 32768

bridge-maxage

help: bridge set maxage

required: False

default: 20
example:

bridge-maxage 20

bridge-mcsnoop

help: set multicast snooping

required: False

default: yes

validvals: yes,no
example:

bridge-mcsnoop yes

bridge-access

help: bridge port access vlan. Must be specified under the bridge port

required: False
example:

bridge-access 300

bridge-maxwait

help: forces to time seconds the maximum time that the Deb ian bridge setup scripts will wait for the bridge ports to ge t to the forwarding status, doesn't allow factional part. If i t is equal to 0 then no waiting is done

required: False

default: 0
example:

bridge-maxwait 3

bridge-portmcrouter

help: set port multicast routers

required: False

default: 1
example:

under the bridge: bridge-portmcrouter swp1=1 swp2=1

under the port: bridge-portmcrouter 1

bridge-portmcfl

help: port multicast fast leave.

required: False

default: 0
example:

under the bridge: bridge-portmcfl swp1=0 swp2=0

under the port: bridge-portmcfl 0

bridge-mcqi

help: set multicast query interval (in secs)

required: False

default: 125
example:

bridge-mcqi 125

usercmds: user commands for interfaces

down

help: run command at interface down

required: False

post-up

help: run command after interface bring up

required: False

up

help: run command at interface bring up

required: False

pre-down

help: run command before bringing the interface down

required: False

pre-up

help: run command before bringing the interface up

required: False

post-down

help: run command after bringing interface down

required: False

mstpctl: mstp configuration module for bridges

mstpctl-portadminedge

help: enable/disable initial edge state of the port

required: False

default: no

validvals: yes,no
example:

mstpctl-portadminedge swp1=no swp2=no

mstpctl-portbpdufilter

help: enable/disable bpdu filter on a port. syntax varies when defined under a bridge vs under a port

required: False

default: no

validvals: yes,no
example:

under a bridge: mstpctl-portbpdufilter swp1=no swp2=no

under a port: mstpctl-portbpdufilter yes

mstpctl-fdelay

help: set forwarding delay

required: False

default: 15
example:

mstpctl-fdelay 15

mstpctl-portnetwork

help: enable/disable bridge assurance capability for a por t

required: False

default: no

validvals: yes,no
example:

mstpctl-portnetwork swp1=no swp2=no

mstpctl-txholdcount

help: bridge transmit holdcount

required: False

default: 6
example:

mstpctl-txholdcount 6

mstpctl-forcevers

help: bridge force stp version

required: False

default: rstp
example:

mstpctl-forcevers rstp

mstpctl-portautoedge

help: enable/disable auto transition to/from edge state of the port

required: False

default: yes

validvals: yes,no
example:

mstpctl-portautoedge swp1=yes swp2=yes

mstpctl-maxhops

help: bridge max hops

required: False

default: 15
example:

mstpctl-maxhops 15

mstpctl-treeprio

help: tree priority

required: False

default: 32768

validrange: 0-65535
example:

mstpctl-treeprio 32768

mstpctl-treeportprio

help: port priority for MSTI instance

required: False

default: 128

validrange: 0-240
example:

mstpctl-treeportprio swp1=128 swp2=128

mstpctl-portpathcost

help: bridge port path cost

required: False

default: 0
example:

mstpctl-portpathcost swp1=0 swp2=1

mstpctl-portrestrtcn

help: enable/disable port ability to propagate received to pology change notification of the port

required: False

default: no

validvals: yes,no
example:

mstpctl-portrestrtcn swp1=no swp2=no

mstpctl-maxage

help: max message age

required: False

default: 20
example:

mstpctl-maxage 20

mstpctl-hello

help: set hello time

required: False

default: 2
example:

mstpctl-hello 2

mstpctl-portrestrrole

help: enable/disable port ability to take root role of the port

required: False

default: no

validvals: yes,no
example:

mstpctl-portrestrrole swp1=no swp2=no

mstpctl-bpduguard

help: enable/disable bpduguard

required: False

default: no

validvals: yes,no
example:

mstpctl-bpduguard swp1=no swp2=no

mstpctl-ageing

help: ageing time

required: False

default: 300
example:

mstpctl-ageing 300

mstpctl-treeportcost

help: port tree cost

required: False

mstpctl-portp2p

help: bridge port p2p detection mode

required: False

default: auto

validvals: yes,no,auto
example:

mstpctl-portp2p swp1=no swp2=no

clagd: This module generates the clagd defaults file.

clagd-priority

help: The priority of this clagd switch

required: False
example:

clagd-priority 30000

clagd-backup-ip

help: Backup IP address of the clagd peer

required: False
example:

clagd-backup-ip 192.1.1.1

clagd-enable

help: enable clagd

required: False

validvals: yes,no
example:

clagd-enable yes

clag-id

help: multi-chassis lag id

required: False

default: 0

validrange: 0-65535
example:

clag-id 1

clagd-peer-ip

help: The IP address of the clagd peer

required: True
example:

clagd-peer 10.10.10.2

clagd-sys-mac

help: The system ID of the CLAG pair

required: True
example:

clagd-sys-mac 44:38:39:ff:00:00

clagd-args

help: Additional command line arguments for clagd

required: False
example:

clagd-args --log /var/log/clagd.log

clagd-args --verbose --lacpPoll 10

clagd-args --debug 0x4

vlan: vlan module configures vlan interfaces.This module under stands vlan interfaces with dot notations. eg swp1.100. Vlan inter faces with any other names need to have raw device and vlan id att ributes

vlan-id

help: vlan id

required: False

vlan-raw-device

help: vlan raw device

required: False

bridgevlan: bridgevlan module configures vlan attributes on a vlan aware bridge. This module only understands vlan interface name with dot notations. eg br0.100. where br0 is the vlan aware bridge this config is for.

bridge-igmp-querier-src

help: bridge igmp querier src. Must be specified under the vlan interface

required: False
example:

bridge-igmp-querier-src 172.16.101.1

bond: bond configuration module

bond-use-carrier

help: bond use carrier

required: False

default: yes

validvals: yes,no
example:

bond-use-carrier yes

bond-lacp-bypass-period

help: grace period (seconds) for lacp bypass

required: False

default: 0

validrange: 0-900
example:

bond-lacp-bypass-period 100

bond-miimon

help: bond miimon

required: False

default: 0

validrange: 0-255
example:

bond-miimon 0

bond-lacp-rate

help: bond lacp rate

required: False

default: 0

validvals: 0,1
example:

bond-lacp-rate 0

bond-lacp-bypass-priority

help: slave priority for lacp bypass

required: False
example:

bond-lacp-bypass-priority swp1=1 swp2=1 swp3=2

bond-min-links

help: bond min links

required: False

default: 0
example:

bond-min-links 0

bond-slaves

help: bond slaves

required: True
example:

bond-slaves swp1 swp2

bond-slaves glob swp1-2

bond-slaves regex (swp[1|2)

bond-lacp-bypass-allow

help: allow lacp bypass

required: False

default: no

validvals: yes,no
example:

bond-lacp-bypass-allow no

bond-mode

help: bond mode

required: False

default: balance-rr

validvals: balance-rr,active-backup,balance-xor,broadcast,802.3ad,balance-tlb,balance-alb
example:

bond-mode 802.3ad

bond-num-unsol-na

help: bond slave devices

required: False

default: 1

validrange: 0-255
example:

bond-num-unsol-na 1

bond-ad-sys-priority

help: 802.3ad system priority

required: False

default: 65535
example:

bond-ad-sys-priority 65535

bond-xmit-hash-policy

help: bond slave devices

required: False

default: layer2

validvals: layer2,layer3+4,layer2+3
example:

bond-xmit-hash-policy layer2

bond-num-grat-arp

help: bond use carrier

required: False

default: 1

validrange: 0-255
example:

bond-num-grat-arp 1

bond-ad-sys-mac-addr

help: 802.3ad system mac address

required: False

default: 00:00:00:00:00:00
example:

bond-ad-sys-mac-addr 00:00:00:00:00:00

address: address configuration module for interfaces

broadcast

help: broadcast address

required: False
example:

broadcast 10.0.1.255

hwaddress

help: hw address

required: False
example:

hwaddress 44:38:39:00:27:b8

alias

help: description/alias

required: False
example:

alias testnetwork

address

help: ipv4 or ipv6 addresses

required: False
example:

address 10.0.12.3/24

address 2000:1000:1000:1000:3::5/128

scope

help: scope

required: False
example:

scope host

address-purge

help: purge existing addresses. By default any existing ip addresses on an interface are purged to match persistent addre sses in the interfaces file. Set this attribute to 'no'if you want to preserve existing addresses

required: False

default: yes
example:

address-purge yes/no

preferred-lifetime

help: preferred lifetime

required: False
example:

preferred-lifetime forever

preferred-lifetime 10

gateway

help: default gateway

required: False
example:

gateway 255.255.255.0

mtu

help: interface mtu

required: False

default: 1500
example:

mtu 1600

addressvirtual: address module configures virtual addresses fo r interfaces. It creates a macvlan interface for every mac ip addr ess-virtual line

address-virtual

help: bridge router virtual mac and ip

required: False
example:

address-virtual 00:11:22:33:44:01 11.0.1.254/24 11.0.1.254/24

vxlan: vxlan module configures vxlan interfaces.

vxlan-learning

help: vxlan learning yes/no

required: False

default: yes

validvals: yes,no
example:

vxlan-learning no

vxlan-id

help: vxlan id

required: True
example:

vxlan-id 100

vxlan-remoteip

help: vxlan remote ip

required: False
example:

vxlan-remoteip 172.16.22.127

vxlan-svcnodeip

help: vxlan id

required: False
example:

vxlan-svcnodeip 172.16.22.125

vxlan-local-tunnelip

help: vxlan local tunnel ip

required: False
example:

vxlan-local-tunnelip 172.16.20.103

SEE ALSO

interfaces(5), ifup(8), ip(8), mstpctl(8), brctl(8), ethtool(8), clagctl(8)

AUTHOR

roopa [AT] cumulusnetworks.com

COPYRIGHT

Copyright 2013 Cumulus Networks, Inc. All rights reserved.