SIMPLE SOLUTIONS

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

Ifupdown2 addon modules interface configuration.

Chapter
2013-09-25
IFUPDOWN-ADDONS-INTERFACES(5) IFUPDOWN-ADDONS-INTERFACES(5)

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 sec‐ tion 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: off validvals: on,off example: link-autoneg on 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: 0 example: bridge-mcquerier 0 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: 1 example: bridge-mcrouter 1 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: 0 example: bridge-mcqifaddr 0 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: 1 example: bridge-mcsnoop 1 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 notifi‐ cation 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: 1 validvals: 0,1 example: bond-use-carrier 1 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: 0 validvals: 0,1 example: bond-lacp-bypass-allow 0 bond-lacp-bypass-allow-all-active help: allow all slaves to be active in lacp bypass irrespective of priority required: False default: 0 validvals: 0,1 example: bond-lacp-bypass-all-active 1 bond-mode help: bond mode required: False default: balance-rr validvals: balance-rr,active-backup,balance-xor,broadcast,802.3ad,bal‐ ance-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 on/off required: False default: on example: vxlan-learning off 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

@cumulusnetworks.com
Copyright 2013 Cumulus Networks, Inc. All rights reserved.
0.1 2013-09-25 IFUPDOWN-ADDONS-INTERFACES(5)
This manual Reference Other manuals
ifupdown-addons-interfaces(5) referred by ifquery(8) | ifreload(8) | ifup(8) | interfaces(5)
refer to brctl(8) | ethtool(8) | ifup(8) | interfaces(5) | ip(8)
Download raw manual
Main page 0.1 (+24) № 5 (+2141)
Go top