.\" Man page generated from reStructuredText.
.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.TH "IFUPDOWN-ADDONS-INTERFACES" 5 "2013-09-25" "0.1" ""
.SH NAME
ifupdown-addons-interfaces \- ifupdown2 addon modules interface configuration
.SH DESCRIPTION
.INDENT 0.0
.INDENT 3.5
ifupdown2 addon modules add incremental functionality to
core ifupdown2 tool.
.sp
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).
.sp
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.
.UNINDENT
.UNINDENT
.SH EXAMPLES
.INDENT 0.0
.INDENT 3.5
Listed below are addon modules and their supported attributes.
The attributes if applicable go under the iface section in the
interfaces(5) file.
.sp
\fBethtool\fP: ethtool configuration module for interfaces
.INDENT 0.0
.INDENT 3.5
\fBlink\-duplex\fP
.INDENT 0.0
.INDENT 3.5
\fBhelp\fP: set link duplex
.sp
\fBrequired\fP: False
.sp
\fBdefault\fP: half
.sp
\fBvalidvals\fP: half,full
.INDENT 0.0
.TP
.B \fBexample\fP:
link\-duplex full
.UNINDENT
.UNINDENT
.UNINDENT
.sp
\fBlink\-autoneg\fP
.INDENT 0.0
.INDENT 3.5
\fBhelp\fP: set autonegotiation
.sp
\fBrequired\fP: False
.sp
\fBdefault\fP: no
.sp
\fBvalidvals\fP: yes,no
.INDENT 0.0
.TP
.B \fBexample\fP:
link\-autoneg yes
.UNINDENT
.UNINDENT
.UNINDENT
.sp
\fBlink\-speed\fP
.INDENT 0.0
.INDENT 3.5
\fBhelp\fP: set link speed
.sp
\fBrequired\fP: False
.INDENT 0.0
.TP
.B \fBexample\fP:
link\-speed 1000
.UNINDENT
.UNINDENT
.UNINDENT
.UNINDENT
.UNINDENT
.sp
\fBbridge\fP: 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.
.INDENT 0.0
.INDENT 3.5
\fBbridge\-vlan\-aware\fP
.INDENT 0.0
.INDENT 3.5
\fBhelp\fP: vlan aware bridge. Setting this attribute to yes ena
bles vlan filtering on the bridge
.sp
\fBrequired\fP: False
.INDENT 0.0
.TP
.B \fBexample\fP:
bridge\-vlan\-aware yes/no
.UNINDENT
.UNINDENT
.UNINDENT
.sp
\fBbridge\-pathcosts\fP
.INDENT 0.0
.INDENT 3.5
\fBhelp\fP: bridge set port path costs
.sp
\fBrequired\fP: False
.sp
\fBdefault\fP: 100
.INDENT 0.0
.TP
.B \fBexample\fP:
bridge\-pathcosts swp1=100 swp2=100
.UNINDENT
.UNINDENT
.UNINDENT
.sp
\fBbridge\-portprios\fP
.INDENT 0.0
.INDENT 3.5
\fBhelp\fP: bridge port prios
.sp
\fBrequired\fP: False
.sp
\fBdefault\fP: 32
.INDENT 0.0
.TP
.B \fBexample\fP:
bridge\-portprios swp1=32 swp2=32
.UNINDENT
.UNINDENT
.UNINDENT
.sp
\fBbridge\-fd\fP
.INDENT 0.0
.INDENT 3.5
\fBhelp\fP: bridge forward delay
.sp
\fBrequired\fP: False
.sp
\fBdefault\fP: 15
.INDENT 0.0
.TP
.B \fBexample\fP:
bridge\-fd 15
.UNINDENT
.UNINDENT
.UNINDENT
.sp
\fBbridge\-ageing\fP
.INDENT 0.0
.INDENT 3.5
\fBhelp\fP: bridge ageing
.sp
\fBrequired\fP: False
.sp
\fBdefault\fP: 300
.INDENT 0.0
.TP
.B \fBexample\fP:
bridge\-ageing 300
.UNINDENT
.UNINDENT
.UNINDENT
.sp
\fBbridge\-hello\fP
.INDENT 0.0
.INDENT 3.5
\fBhelp\fP: bridge set hello time
.sp
\fBrequired\fP: False
.sp
\fBdefault\fP: 2
.INDENT 0.0
.TP
.B \fBexample\fP:
bridge\-hello 2
.UNINDENT
.UNINDENT
.UNINDENT
.sp
\fBbridge\-gcint\fP
.INDENT 0.0
.INDENT 3.5
\fBhelp\fP: bridge garbage collection interval in secs
.sp
\fBrequired\fP: False
.sp
\fBdefault\fP: 4
.INDENT 0.0
.TP
.B \fBexample\fP:
bridge\-gcint 4
.UNINDENT
.UNINDENT
.UNINDENT
.sp
\fBbridge\-mcquerier\fP
.INDENT 0.0
.INDENT 3.5
\fBhelp\fP: set multicast querier
.sp
\fBrequired\fP: False
.sp
\fBdefault\fP: no
.sp
\fBvalidvals\fP: yes,no
.INDENT 0.0
.TP
.B \fBexample\fP:
bridge\-mcquerier no
.UNINDENT
.UNINDENT
.UNINDENT
.sp
\fBbridge\-mclmc\fP
.INDENT 0.0
.INDENT 3.5
\fBhelp\fP: set multicast last member count
.sp
\fBrequired\fP: False
.sp
\fBdefault\fP: 2
.INDENT 0.0
.TP
.B \fBexample\fP:
bridge\-mclmc 2
.UNINDENT
.UNINDENT
.UNINDENT
.sp
\fBbridge\-mcsqc\fP
.INDENT 0.0
.INDENT 3.5
\fBhelp\fP: set multicast startup query count
.sp
\fBrequired\fP: False
.sp
\fBdefault\fP: 2
.INDENT 0.0
.TP
.B \fBexample\fP:
bridge\-mcsqc 2
.UNINDENT
.UNINDENT
.UNINDENT
.sp
\fBbridge\-mcrouter\fP
.INDENT 0.0
.INDENT 3.5
\fBhelp\fP: set multicast router
.sp
\fBrequired\fP: False
.sp
\fBdefault\fP: yes
.sp
\fBvalidvals\fP: yes,no
.INDENT 0.0
.TP
.B \fBexample\fP:
bridge\-mcrouter yes
.UNINDENT
.UNINDENT
.UNINDENT
.sp
\fBbridge\-stp\fP
.INDENT 0.0
.INDENT 3.5
\fBhelp\fP: bridge\-stp yes/no
.sp
\fBrequired\fP: False
.sp
\fBdefault\fP: no
.sp
\fBvalidvals\fP: yes,on,off,no
.INDENT 0.0
.TP
.B \fBexample\fP:
bridge\-stp no
.UNINDENT
.UNINDENT
.UNINDENT
.sp
\fBbridge\-pvid\fP
.INDENT 0.0
.INDENT 3.5
\fBhelp\fP: bridge port pvid. Must be specified under the bridge
port
.sp
\fBrequired\fP: False
.INDENT 0.0
.TP
.B \fBexample\fP:
bridge\-pvid 1
.UNINDENT
.UNINDENT
.UNINDENT
.sp
\fBbridge\-mcsqi\fP
.INDENT 0.0
.INDENT 3.5
\fBhelp\fP: set multicast startup query interval (in secs)
.sp
\fBrequired\fP: False
.sp
\fBdefault\fP: 31
.INDENT 0.0
.TP
.B \fBexample\fP:
bridge\-mcsqi 31
.UNINDENT
.UNINDENT
.UNINDENT
.sp
\fBbridge\-mcmi\fP
.INDENT 0.0
.INDENT 3.5
\fBhelp\fP: set multicast membership interval (in secs)
.sp
\fBrequired\fP: False
.sp
\fBdefault\fP: 260
.INDENT 0.0
.TP
.B \fBexample\fP:
bridge\-mcmi 260
.UNINDENT
.UNINDENT
.UNINDENT
.sp
\fBbridge\-mclmi\fP
.INDENT 0.0
.INDENT 3.5
\fBhelp\fP: set multicast last member interval (in secs)
.sp
\fBrequired\fP: False
.sp
\fBdefault\fP: 1
.INDENT 0.0
.TP
.B \fBexample\fP:
bridge\-mclmi 1
.UNINDENT
.UNINDENT
.UNINDENT
.sp
\fBbridge\-vids\fP
.INDENT 0.0
.INDENT 3.5
\fBhelp\fP: 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
.sp
\fBrequired\fP: False
.INDENT 0.0
.TP
.B \fBexample\fP:
bridge\-vids 4000
.sp
bridge\-vids 2000 2200\-3000
.UNINDENT
.UNINDENT
.UNINDENT
.sp
\fBbridge\-ports\fP
.INDENT 0.0
.INDENT 3.5
\fBhelp\fP: bridge ports
.sp
\fBrequired\fP: True
.INDENT 0.0
.TP
.B \fBexample\fP:
bridge\-ports swp1.100 swp2.100 swp3.100
.sp
bridge\-ports glob swp1\-3.100
.sp
bridge\-ports glob swp[1\-3]s[0\-4].100
.sp
bridge\-ports regex (swp[1|2|3].100)
.UNINDENT
.UNINDENT
.UNINDENT
.sp
\fBbridge\-mcqifaddr\fP
.INDENT 0.0
.INDENT 3.5
\fBhelp\fP: set multicast query to use ifaddr
.sp
\fBrequired\fP: False
.sp
\fBdefault\fP: no
.sp
\fBvalidvals\fP: yes,no
.INDENT 0.0
.TP
.B \fBexample\fP:
bridge\-mcqifaddr no
.UNINDENT
.UNINDENT
.UNINDENT
.sp
\fBbridge\-waitport\fP
.INDENT 0.0
.INDENT 3.5
\fBhelp\fP: 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.
.sp
\fBrequired\fP: False
.sp
\fBdefault\fP: 0
.INDENT 0.0
.TP
.B \fBexample\fP:
bridge\-waitport 4 swp1 swp2
.UNINDENT
.UNINDENT
.UNINDENT
.sp
\fBbridge\-mcqri\fP
.INDENT 0.0
.INDENT 3.5
\fBhelp\fP: set multicast query response interval (in secs)
.sp
\fBrequired\fP: False
.sp
\fBdefault\fP: 10
.INDENT 0.0
.TP
.B \fBexample\fP:
bridge\-mcqri 10
.UNINDENT
.UNINDENT
.UNINDENT
.sp
\fBbridge\-hashel\fP
.INDENT 0.0
.INDENT 3.5
\fBhelp\fP: set hash elasticity
.sp
\fBrequired\fP: False
.sp
\fBdefault\fP: 4096
.INDENT 0.0
.TP
.B \fBexample\fP:
bridge\-hashel 4096
.UNINDENT
.UNINDENT
.UNINDENT
.sp
\fBbridge\-mcqpi\fP
.INDENT 0.0
.INDENT 3.5
\fBhelp\fP: set multicast querier interval (in secs)
.sp
\fBrequired\fP: False
.sp
\fBdefault\fP: 255
.INDENT 0.0
.TP
.B \fBexample\fP:
bridge\-mcqpi 255
.UNINDENT
.UNINDENT
.UNINDENT
.sp
\fBbridge\-hashmax\fP
.INDENT 0.0
.INDENT 3.5
\fBhelp\fP: set hash max
.sp
\fBrequired\fP: False
.sp
\fBdefault\fP: 4096
.INDENT 0.0
.TP
.B \fBexample\fP:
bridge\-hashmax 4096
.UNINDENT
.UNINDENT
.UNINDENT
.sp
\fBbridge\-bridgeprio\fP
.INDENT 0.0
.INDENT 3.5
\fBhelp\fP: bridge priority
.sp
\fBrequired\fP: False
.sp
\fBdefault\fP: 32768
.INDENT 0.0
.TP
.B \fBexample\fP:
bridge\-bridgeprio 32768
.UNINDENT
.UNINDENT
.UNINDENT
.sp
\fBbridge\-maxage\fP
.INDENT 0.0
.INDENT 3.5
\fBhelp\fP: bridge set maxage
.sp
\fBrequired\fP: False
.sp
\fBdefault\fP: 20
.INDENT 0.0
.TP
.B \fBexample\fP:
bridge\-maxage 20
.UNINDENT
.UNINDENT
.UNINDENT
.sp
\fBbridge\-mcsnoop\fP
.INDENT 0.0
.INDENT 3.5
\fBhelp\fP: set multicast snooping
.sp
\fBrequired\fP: False
.sp
\fBdefault\fP: yes
.sp
\fBvalidvals\fP: yes,no
.INDENT 0.0
.TP
.B \fBexample\fP:
bridge\-mcsnoop yes
.UNINDENT
.UNINDENT
.UNINDENT
.sp
\fBbridge\-access\fP
.INDENT 0.0
.INDENT 3.5
\fBhelp\fP: bridge port access vlan. Must be specified under the
bridge port
.sp
\fBrequired\fP: False
.INDENT 0.0
.TP
.B \fBexample\fP:
bridge\-access 300
.UNINDENT
.UNINDENT
.UNINDENT
.sp
\fBbridge\-maxwait\fP
.INDENT 0.0
.INDENT 3.5
\fBhelp\fP: 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\(aqt allow factional part. If i
t is equal to 0 then no waiting is done
.sp
\fBrequired\fP: False
.sp
\fBdefault\fP: 0
.INDENT 0.0
.TP
.B \fBexample\fP:
bridge\-maxwait 3
.UNINDENT
.UNINDENT
.UNINDENT
.sp
\fBbridge\-portmcrouter\fP
.INDENT 0.0
.INDENT 3.5
\fBhelp\fP: set port multicast routers
.sp
\fBrequired\fP: False
.sp
\fBdefault\fP: 1
.INDENT 0.0
.TP
.B \fBexample\fP:
under the bridge: bridge\-portmcrouter swp1=1 swp2=1
.sp
under the port: bridge\-portmcrouter 1
.UNINDENT
.UNINDENT
.UNINDENT
.sp
\fBbridge\-portmcfl\fP
.INDENT 0.0
.INDENT 3.5
\fBhelp\fP: port multicast fast leave.
.sp
\fBrequired\fP: False
.sp
\fBdefault\fP: 0
.INDENT 0.0
.TP
.B \fBexample\fP:
under the bridge: bridge\-portmcfl swp1=0 swp2=0
.sp
under the port: bridge\-portmcfl 0
.UNINDENT
.UNINDENT
.UNINDENT
.sp
\fBbridge\-mcqi\fP
.INDENT 0.0
.INDENT 3.5
\fBhelp\fP: set multicast query interval (in secs)
.sp
\fBrequired\fP: False
.sp
\fBdefault\fP: 125
.INDENT 0.0
.TP
.B \fBexample\fP:
bridge\-mcqi 125
.UNINDENT
.UNINDENT
.UNINDENT
.UNINDENT
.UNINDENT
.sp
\fBusercmds\fP: user commands for interfaces
.INDENT 0.0
.INDENT 3.5
\fBdown\fP
.INDENT 0.0
.INDENT 3.5
\fBhelp\fP: run command at interface down
.sp
\fBrequired\fP: False
.UNINDENT
.UNINDENT
.sp
\fBpost\-up\fP
.INDENT 0.0
.INDENT 3.5
\fBhelp\fP: run command after interface bring up
.sp
\fBrequired\fP: False
.UNINDENT
.UNINDENT
.sp
\fBup\fP
.INDENT 0.0
.INDENT 3.5
\fBhelp\fP: run command at interface bring up
.sp
\fBrequired\fP: False
.UNINDENT
.UNINDENT
.sp
\fBpre\-down\fP
.INDENT 0.0
.INDENT 3.5
\fBhelp\fP: run command before bringing the interface down
.sp
\fBrequired\fP: False
.UNINDENT
.UNINDENT
.sp
\fBpre\-up\fP
.INDENT 0.0
.INDENT 3.5
\fBhelp\fP: run command before bringing the interface up
.sp
\fBrequired\fP: False
.UNINDENT
.UNINDENT
.sp
\fBpost\-down\fP
.INDENT 0.0
.INDENT 3.5
\fBhelp\fP: run command after bringing interface down
.sp
\fBrequired\fP: False
.UNINDENT
.UNINDENT
.UNINDENT
.UNINDENT
.sp
\fBmstpctl\fP: mstp configuration module for bridges
.INDENT 0.0
.INDENT 3.5
\fBmstpctl\-portadminedge\fP
.INDENT 0.0
.INDENT 3.5
\fBhelp\fP: enable/disable initial edge state of the port
.sp
\fBrequired\fP: False
.sp
\fBdefault\fP: no
.sp
\fBvalidvals\fP: yes,no
.INDENT 0.0
.TP
.B \fBexample\fP:
mstpctl\-portadminedge swp1=no swp2=no
.UNINDENT
.UNINDENT
.UNINDENT
.sp
\fBmstpctl\-portbpdufilter\fP
.INDENT 0.0
.INDENT 3.5
\fBhelp\fP: enable/disable bpdu filter on a port. syntax varies
when defined under a bridge vs under a port
.sp
\fBrequired\fP: False
.sp
\fBdefault\fP: no
.sp
\fBvalidvals\fP: yes,no
.INDENT 0.0
.TP
.B \fBexample\fP:
under a bridge: mstpctl\-portbpdufilter swp1=no swp2=no
.sp
under a port: mstpctl\-portbpdufilter yes
.UNINDENT
.UNINDENT
.UNINDENT
.sp
\fBmstpctl\-fdelay\fP
.INDENT 0.0
.INDENT 3.5
\fBhelp\fP: set forwarding delay
.sp
\fBrequired\fP: False
.sp
\fBdefault\fP: 15
.INDENT 0.0
.TP
.B \fBexample\fP:
mstpctl\-fdelay 15
.UNINDENT
.UNINDENT
.UNINDENT
.sp
\fBmstpctl\-portnetwork\fP
.INDENT 0.0
.INDENT 3.5
\fBhelp\fP: enable/disable bridge assurance capability for a por
t
.sp
\fBrequired\fP: False
.sp
\fBdefault\fP: no
.sp
\fBvalidvals\fP: yes,no
.INDENT 0.0
.TP
.B \fBexample\fP:
mstpctl\-portnetwork swp1=no swp2=no
.UNINDENT
.UNINDENT
.UNINDENT
.sp
\fBmstpctl\-txholdcount\fP
.INDENT 0.0
.INDENT 3.5
\fBhelp\fP: bridge transmit holdcount
.sp
\fBrequired\fP: False
.sp
\fBdefault\fP: 6
.INDENT 0.0
.TP
.B \fBexample\fP:
mstpctl\-txholdcount 6
.UNINDENT
.UNINDENT
.UNINDENT
.sp
\fBmstpctl\-forcevers\fP
.INDENT 0.0
.INDENT 3.5
\fBhelp\fP: bridge force stp version
.sp
\fBrequired\fP: False
.sp
\fBdefault\fP: rstp
.INDENT 0.0
.TP
.B \fBexample\fP:
mstpctl\-forcevers rstp
.UNINDENT
.UNINDENT
.UNINDENT
.sp
\fBmstpctl\-portautoedge\fP
.INDENT 0.0
.INDENT 3.5
\fBhelp\fP: enable/disable auto transition to/from edge state of
the port
.sp
\fBrequired\fP: False
.sp
\fBdefault\fP: yes
.sp
\fBvalidvals\fP: yes,no
.INDENT 0.0
.TP
.B \fBexample\fP:
mstpctl\-portautoedge swp1=yes swp2=yes
.UNINDENT
.UNINDENT
.UNINDENT
.sp
\fBmstpctl\-maxhops\fP
.INDENT 0.0
.INDENT 3.5
\fBhelp\fP: bridge max hops
.sp
\fBrequired\fP: False
.sp
\fBdefault\fP: 15
.INDENT 0.0
.TP
.B \fBexample\fP:
mstpctl\-maxhops 15
.UNINDENT
.UNINDENT
.UNINDENT
.sp
\fBmstpctl\-treeprio\fP
.INDENT 0.0
.INDENT 3.5
\fBhelp\fP: tree priority
.sp
\fBrequired\fP: False
.sp
\fBdefault\fP: 32768
.sp
validrange: 0\-65535
.INDENT 0.0
.TP
.B \fBexample\fP:
mstpctl\-treeprio 32768
.UNINDENT
.UNINDENT
.UNINDENT
.sp
\fBmstpctl\-treeportprio\fP
.INDENT 0.0
.INDENT 3.5
\fBhelp\fP: port priority for MSTI instance
.sp
\fBrequired\fP: False
.sp
\fBdefault\fP: 128
.sp
validrange: 0\-240
.INDENT 0.0
.TP
.B \fBexample\fP:
mstpctl\-treeportprio swp1=128 swp2=128
.UNINDENT
.UNINDENT
.UNINDENT
.sp
\fBmstpctl\-portpathcost\fP
.INDENT 0.0
.INDENT 3.5
\fBhelp\fP: bridge port path cost
.sp
\fBrequired\fP: False
.sp
\fBdefault\fP: 0
.INDENT 0.0
.TP
.B \fBexample\fP:
mstpctl\-portpathcost swp1=0 swp2=1
.UNINDENT
.UNINDENT
.UNINDENT
.sp
\fBmstpctl\-portrestrtcn\fP
.INDENT 0.0
.INDENT 3.5
\fBhelp\fP: enable/disable port ability to propagate received to
pology change notification of the port
.sp
\fBrequired\fP: False
.sp
\fBdefault\fP: no
.sp
\fBvalidvals\fP: yes,no
.INDENT 0.0
.TP
.B \fBexample\fP:
mstpctl\-portrestrtcn swp1=no swp2=no
.UNINDENT
.UNINDENT
.UNINDENT
.sp
\fBmstpctl\-maxage\fP
.INDENT 0.0
.INDENT 3.5
\fBhelp\fP: max message age
.sp
\fBrequired\fP: False
.sp
\fBdefault\fP: 20
.INDENT 0.0
.TP
.B \fBexample\fP:
mstpctl\-maxage 20
.UNINDENT
.UNINDENT
.UNINDENT
.sp
\fBmstpctl\-hello\fP
.INDENT 0.0
.INDENT 3.5
\fBhelp\fP: set hello time
.sp
\fBrequired\fP: False
.sp
\fBdefault\fP: 2
.INDENT 0.0
.TP
.B \fBexample\fP:
mstpctl\-hello 2
.UNINDENT
.UNINDENT
.UNINDENT
.sp
\fBmstpctl\-portrestrrole\fP
.INDENT 0.0
.INDENT 3.5
\fBhelp\fP: enable/disable port ability to take root role of the
port
.sp
\fBrequired\fP: False
.sp
\fBdefault\fP: no
.sp
\fBvalidvals\fP: yes,no
.INDENT 0.0
.TP
.B \fBexample\fP:
mstpctl\-portrestrrole swp1=no swp2=no
.UNINDENT
.UNINDENT
.UNINDENT
.sp
\fBmstpctl\-bpduguard\fP
.INDENT 0.0
.INDENT 3.5
\fBhelp\fP: enable/disable bpduguard
.sp
\fBrequired\fP: False
.sp
\fBdefault\fP: no
.sp
\fBvalidvals\fP: yes,no
.INDENT 0.0
.TP
.B \fBexample\fP:
mstpctl\-bpduguard swp1=no swp2=no
.UNINDENT
.UNINDENT
.UNINDENT
.sp
\fBmstpctl\-ageing\fP
.INDENT 0.0
.INDENT 3.5
\fBhelp\fP: ageing time
.sp
\fBrequired\fP: False
.sp
\fBdefault\fP: 300
.INDENT 0.0
.TP
.B \fBexample\fP:
mstpctl\-ageing 300
.UNINDENT
.UNINDENT
.UNINDENT
.sp
\fBmstpctl\-treeportcost\fP
.INDENT 0.0
.INDENT 3.5
\fBhelp\fP: port tree cost
.sp
\fBrequired\fP: False
.UNINDENT
.UNINDENT
.sp
\fBmstpctl\-portp2p\fP
.INDENT 0.0
.INDENT 3.5
\fBhelp\fP: bridge port p2p detection mode
.sp
\fBrequired\fP: False
.sp
\fBdefault\fP: auto
.sp
\fBvalidvals\fP: yes,no,auto
.INDENT 0.0
.TP
.B \fBexample\fP:
mstpctl\-portp2p swp1=no swp2=no
.UNINDENT
.UNINDENT
.UNINDENT
.UNINDENT
.UNINDENT
.sp
\fBclagd\fP: This module generates the clagd defaults file.
.INDENT 0.0
.INDENT 3.5
\fBclagd\-priority\fP
.INDENT 0.0
.INDENT 3.5
\fBhelp\fP: The priority of this clagd switch
.sp
\fBrequired\fP: False
.INDENT 0.0
.TP
.B \fBexample\fP:
clagd\-priority 30000
.UNINDENT
.UNINDENT
.UNINDENT
.sp
\fBclagd\-backup\-ip\fP
.INDENT 0.0
.INDENT 3.5
\fBhelp\fP: Backup IP address of the clagd peer
.sp
\fBrequired\fP: False
.INDENT 0.0
.TP
.B \fBexample\fP:
clagd\-backup\-ip 192.1.1.1
.UNINDENT
.UNINDENT
.UNINDENT
.sp
\fBclagd\-enable\fP
.INDENT 0.0
.INDENT 3.5
\fBhelp\fP: enable clagd
.sp
\fBrequired\fP: False
.sp
\fBvalidvals\fP: yes,no
.INDENT 0.0
.TP
.B \fBexample\fP:
clagd\-enable yes
.UNINDENT
.UNINDENT
.UNINDENT
.sp
\fBclag\-id\fP
.INDENT 0.0
.INDENT 3.5
\fBhelp\fP: multi\-chassis lag id
.sp
\fBrequired\fP: False
.sp
\fBdefault\fP: 0
.sp
validrange: 0\-65535
.INDENT 0.0
.TP
.B \fBexample\fP:
clag\-id 1
.UNINDENT
.UNINDENT
.UNINDENT
.sp
\fBclagd\-peer\-ip\fP
.INDENT 0.0
.INDENT 3.5
\fBhelp\fP: The IP address of the clagd peer
.sp
\fBrequired\fP: True
.INDENT 0.0
.TP
.B \fBexample\fP:
clagd\-peer 10.10.10.2
.UNINDENT
.UNINDENT
.UNINDENT
.sp
\fBclagd\-sys\-mac\fP
.INDENT 0.0
.INDENT 3.5
\fBhelp\fP: The system ID of the CLAG pair
.sp
\fBrequired\fP: True
.INDENT 0.0
.TP
.B \fBexample\fP:
clagd\-sys\-mac 44:38:39:ff:00:00
.UNINDENT
.UNINDENT
.UNINDENT
.sp
\fBclagd\-args\fP
.INDENT 0.0
.INDENT 3.5
\fBhelp\fP: Additional command line arguments for clagd
.sp
\fBrequired\fP: False
.INDENT 0.0
.TP
.B \fBexample\fP:
clagd\-args \-\-log /var/log/clagd.log
.sp
clagd\-args \-\-verbose \-\-lacpPoll 10
.sp
clagd\-args \-\-debug 0x4
.UNINDENT
.UNINDENT
.UNINDENT
.UNINDENT
.UNINDENT
.sp
\fBvlan\fP: 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
.INDENT 0.0
.INDENT 3.5
\fBvlan\-id\fP
.INDENT 0.0
.INDENT 3.5
\fBhelp\fP: vlan id
.sp
\fBrequired\fP: False
.UNINDENT
.UNINDENT
.sp
\fBvlan\-raw\-device\fP
.INDENT 0.0
.INDENT 3.5
\fBhelp\fP: vlan raw device
.sp
\fBrequired\fP: False
.UNINDENT
.UNINDENT
.UNINDENT
.UNINDENT
.sp
\fBbridgevlan\fP: 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.
.INDENT 0.0
.INDENT 3.5
\fBbridge\-igmp\-querier\-src\fP
.INDENT 0.0
.INDENT 3.5
\fBhelp\fP: bridge igmp querier src. Must be specified under the
vlan interface
.sp
\fBrequired\fP: False
.INDENT 0.0
.TP
.B \fBexample\fP:
bridge\-igmp\-querier\-src 172.16.101.1
.UNINDENT
.UNINDENT
.UNINDENT
.UNINDENT
.UNINDENT
.sp
\fBbond\fP: bond configuration module
.INDENT 0.0
.INDENT 3.5
\fBbond\-use\-carrier\fP
.INDENT 0.0
.INDENT 3.5
\fBhelp\fP: bond use carrier
.sp
\fBrequired\fP: False
.sp
\fBdefault\fP: yes
.sp
\fBvalidvals\fP: yes,no
.INDENT 0.0
.TP
.B \fBexample\fP:
bond\-use\-carrier yes
.UNINDENT
.UNINDENT
.UNINDENT
.sp
\fBbond\-lacp\-bypass\-period\fP
.INDENT 0.0
.INDENT 3.5
\fBhelp\fP: grace period (seconds) for lacp bypass
.sp
\fBrequired\fP: False
.sp
\fBdefault\fP: 0
.sp
validrange: 0\-900
.INDENT 0.0
.TP
.B \fBexample\fP:
bond\-lacp\-bypass\-period 100
.UNINDENT
.UNINDENT
.UNINDENT
.sp
\fBbond\-miimon\fP
.INDENT 0.0
.INDENT 3.5
\fBhelp\fP: bond miimon
.sp
\fBrequired\fP: False
.sp
\fBdefault\fP: 0
.sp
validrange: 0\-255
.INDENT 0.0
.TP
.B \fBexample\fP:
bond\-miimon 0
.UNINDENT
.UNINDENT
.UNINDENT
.sp
\fBbond\-lacp\-rate\fP
.INDENT 0.0
.INDENT 3.5
\fBhelp\fP: bond lacp rate
.sp
\fBrequired\fP: False
.sp
\fBdefault\fP: 0
.sp
\fBvalidvals\fP: 0,1
.INDENT 0.0
.TP
.B \fBexample\fP:
bond\-lacp\-rate 0
.UNINDENT
.UNINDENT
.UNINDENT
.sp
\fBbond\-lacp\-bypass\-priority\fP
.INDENT 0.0
.INDENT 3.5
\fBhelp\fP: slave priority for lacp bypass
.sp
\fBrequired\fP: False
.INDENT 0.0
.TP
.B \fBexample\fP:
bond\-lacp\-bypass\-priority swp1=1 swp2=1 swp3=2
.UNINDENT
.UNINDENT
.UNINDENT
.sp
\fBbond\-min\-links\fP
.INDENT 0.0
.INDENT 3.5
\fBhelp\fP: bond min links
.sp
\fBrequired\fP: False
.sp
\fBdefault\fP: 0
.INDENT 0.0
.TP
.B \fBexample\fP:
bond\-min\-links 0
.UNINDENT
.UNINDENT
.UNINDENT
.sp
\fBbond\-slaves\fP
.INDENT 0.0
.INDENT 3.5
\fBhelp\fP: bond slaves
.sp
\fBrequired\fP: True
.INDENT 0.0
.TP
.B \fBexample\fP:
bond\-slaves swp1 swp2
.sp
bond\-slaves glob swp1\-2
.sp
bond\-slaves regex (swp[1|2)
.UNINDENT
.UNINDENT
.UNINDENT
.sp
\fBbond\-lacp\-bypass\-allow\fP
.INDENT 0.0
.INDENT 3.5
\fBhelp\fP: allow lacp bypass
.sp
\fBrequired\fP: False
.sp
\fBdefault\fP: no
.sp
\fBvalidvals\fP: yes,no
.INDENT 0.0
.TP
.B \fBexample\fP:
bond\-lacp\-bypass\-allow no
.UNINDENT
.UNINDENT
.UNINDENT
.sp
\fBbond\-mode\fP
.INDENT 0.0
.INDENT 3.5
\fBhelp\fP: bond mode
.sp
\fBrequired\fP: False
.sp
\fBdefault\fP: balance\-rr
.sp
\fBvalidvals\fP: balance\-rr,active\-backup,balance\-xor,broadcast,802.3ad,balance\-tlb,balance\-alb
.INDENT 0.0
.TP
.B \fBexample\fP:
bond\-mode 802.3ad
.UNINDENT
.UNINDENT
.UNINDENT
.sp
\fBbond\-num\-unsol\-na\fP
.INDENT 0.0
.INDENT 3.5
\fBhelp\fP: bond slave devices
.sp
\fBrequired\fP: False
.sp
\fBdefault\fP: 1
.sp
validrange: 0\-255
.INDENT 0.0
.TP
.B \fBexample\fP:
bond\-num\-unsol\-na 1
.UNINDENT
.UNINDENT
.UNINDENT
.sp
\fBbond\-ad\-sys\-priority\fP
.INDENT 0.0
.INDENT 3.5
\fBhelp\fP: 802.3ad system priority
.sp
\fBrequired\fP: False
.sp
\fBdefault\fP: 65535
.INDENT 0.0
.TP
.B \fBexample\fP:
bond\-ad\-sys\-priority 65535
.UNINDENT
.UNINDENT
.UNINDENT
.sp
\fBbond\-xmit\-hash\-policy\fP
.INDENT 0.0
.INDENT 3.5
\fBhelp\fP: bond slave devices
.sp
\fBrequired\fP: False
.sp
\fBdefault\fP: layer2
.sp
\fBvalidvals\fP: layer2,layer3+4,layer2+3
.INDENT 0.0
.TP
.B \fBexample\fP:
bond\-xmit\-hash\-policy layer2
.UNINDENT
.UNINDENT
.UNINDENT
.sp
\fBbond\-num\-grat\-arp\fP
.INDENT 0.0
.INDENT 3.5
\fBhelp\fP: bond use carrier
.sp
\fBrequired\fP: False
.sp
\fBdefault\fP: 1
.sp
validrange: 0\-255
.INDENT 0.0
.TP
.B \fBexample\fP:
bond\-num\-grat\-arp 1
.UNINDENT
.UNINDENT
.UNINDENT
.sp
\fBbond\-ad\-sys\-mac\-addr\fP
.INDENT 0.0
.INDENT 3.5
\fBhelp\fP: 802.3ad system mac address
.sp
\fBrequired\fP: False
.sp
\fBdefault\fP: 00:00:00:00:00:00
.INDENT 0.0
.TP
.B \fBexample\fP:
bond\-ad\-sys\-mac\-addr 00:00:00:00:00:00
.UNINDENT
.UNINDENT
.UNINDENT
.UNINDENT
.UNINDENT
.sp
\fBaddress\fP: address configuration module for interfaces
.INDENT 0.0
.INDENT 3.5
\fBbroadcast\fP
.INDENT 0.0
.INDENT 3.5
\fBhelp\fP: broadcast address
.sp
\fBrequired\fP: False
.INDENT 0.0
.TP
.B \fBexample\fP:
broadcast 10.0.1.255
.UNINDENT
.UNINDENT
.UNINDENT
.sp
\fBhwaddress\fP
.INDENT 0.0
.INDENT 3.5
\fBhelp\fP: hw address
.sp
\fBrequired\fP: False
.INDENT 0.0
.TP
.B \fBexample\fP:
hwaddress 44:38:39:00:27:b8
.UNINDENT
.UNINDENT
.UNINDENT
.sp
\fBalias\fP
.INDENT 0.0
.INDENT 3.5
\fBhelp\fP: description/alias
.sp
\fBrequired\fP: False
.INDENT 0.0
.TP
.B \fBexample\fP:
alias testnetwork
.UNINDENT
.UNINDENT
.UNINDENT
.sp
\fBaddress\fP
.INDENT 0.0
.INDENT 3.5
\fBhelp\fP: ipv4 or ipv6 addresses
.sp
\fBrequired\fP: False
.INDENT 0.0
.TP
.B \fBexample\fP:
address 10.0.12.3/24
.sp
address 2000:1000:1000:1000:3::5/128
.UNINDENT
.UNINDENT
.UNINDENT
.sp
\fBscope\fP
.INDENT 0.0
.INDENT 3.5
\fBhelp\fP: scope
.sp
\fBrequired\fP: False
.INDENT 0.0
.TP
.B \fBexample\fP:
scope host
.UNINDENT
.UNINDENT
.UNINDENT
.sp
\fBaddress\-purge\fP
.INDENT 0.0
.INDENT 3.5
\fBhelp\fP: 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 \(aqno\(aqif you
want to preserve existing addresses
.sp
\fBrequired\fP: False
.sp
\fBdefault\fP: yes
.INDENT 0.0
.TP
.B \fBexample\fP:
address\-purge yes/no
.UNINDENT
.UNINDENT
.UNINDENT
.sp
\fBpreferred\-lifetime\fP
.INDENT 0.0
.INDENT 3.5
\fBhelp\fP: preferred lifetime
.sp
\fBrequired\fP: False
.INDENT 0.0
.TP
.B \fBexample\fP:
preferred\-lifetime forever
.sp
preferred\-lifetime 10
.UNINDENT
.UNINDENT
.UNINDENT
.sp
\fBgateway\fP
.INDENT 0.0
.INDENT 3.5
\fBhelp\fP: default gateway
.sp
\fBrequired\fP: False
.INDENT 0.0
.TP
.B \fBexample\fP:
gateway 255.255.255.0
.UNINDENT
.UNINDENT
.UNINDENT
.sp
\fBmtu\fP
.INDENT 0.0
.INDENT 3.5
\fBhelp\fP: interface mtu
.sp
\fBrequired\fP: False
.sp
\fBdefault\fP: 1500
.INDENT 0.0
.TP
.B \fBexample\fP:
mtu 1600
.UNINDENT
.UNINDENT
.UNINDENT
.UNINDENT
.UNINDENT
.sp
\fBaddressvirtual\fP: address module configures virtual addresses fo
r interfaces. It creates a macvlan interface for every mac ip addr
ess\-virtual line
.INDENT 0.0
.INDENT 3.5
\fBaddress\-virtual\fP
.INDENT 0.0
.INDENT 3.5
\fBhelp\fP: bridge router virtual mac and ip
.sp
\fBrequired\fP: False
.INDENT 0.0
.TP
.B \fBexample\fP:
address\-virtual 00:11:22:33:44:01 11.0.1.254/24 11.0.1.254/24
.UNINDENT
.UNINDENT
.UNINDENT
.UNINDENT
.UNINDENT
.sp
\fBvxlan\fP: vxlan module configures vxlan interfaces.
.INDENT 0.0
.INDENT 3.5
\fBvxlan\-learning\fP
.INDENT 0.0
.INDENT 3.5
\fBhelp\fP: vxlan learning yes/no
.sp
\fBrequired\fP: False
.sp
\fBdefault\fP: yes
.sp
\fBvalidvals\fP: yes,no
.INDENT 0.0
.TP
.B \fBexample\fP:
vxlan\-learning no
.UNINDENT
.UNINDENT
.UNINDENT
.sp
\fBvxlan\-id\fP
.INDENT 0.0
.INDENT 3.5
\fBhelp\fP: vxlan id
.sp
\fBrequired\fP: True
.INDENT 0.0
.TP
.B \fBexample\fP:
vxlan\-id 100
.UNINDENT
.UNINDENT
.UNINDENT
.sp
\fBvxlan\-remoteip\fP
.INDENT 0.0
.INDENT 3.5
\fBhelp\fP: vxlan remote ip
.sp
\fBrequired\fP: False
.INDENT 0.0
.TP
.B \fBexample\fP:
vxlan\-remoteip 172.16.22.127
.UNINDENT
.UNINDENT
.UNINDENT
.sp
\fBvxlan\-svcnodeip\fP
.INDENT 0.0
.INDENT 3.5
\fBhelp\fP: vxlan id
.sp
\fBrequired\fP: False
.INDENT 0.0
.TP
.B \fBexample\fP:
vxlan\-svcnodeip 172.16.22.125
.UNINDENT
.UNINDENT
.UNINDENT
.sp
\fBvxlan\-local\-tunnelip\fP
.INDENT 0.0
.INDENT 3.5
\fBhelp\fP: vxlan local tunnel ip
.sp
\fBrequired\fP: False
.INDENT 0.0
.TP
.B \fBexample\fP:
vxlan\-local\-tunnelip 172.16.20.103
.UNINDENT
.UNINDENT
.UNINDENT
.UNINDENT
.UNINDENT
.UNINDENT
.UNINDENT
.SH SEE ALSO
.INDENT 0.0
.INDENT 3.5
interfaces(5),
ifup(8),
ip(8),
mstpctl(8),
brctl(8),
ethtool(8),
clagctl(8)
.UNINDENT
.UNINDENT
.SH AUTHOR
roopa@cumulusnetworks.com
.SH COPYRIGHT
Copyright 2013 Cumulus Networks, Inc.  All rights reserved.
.\" Generated by docutils manpage writer.
.