MSTPCTL(8)

NAME
mstpctl - mstpd configuration

SYNOPSIS
mstpctl [command]

DESCRIPTION
mstpctl is used to configure Multiple Spanning Tree daemon (mstpd). MSTPCTL is used for configuring STP parameters on bridges which have user-space STP enabled. Currently, STP is disabled by default on the bridge. To enable user-space STP, configure "brctl stp <bridge> on" or "ip link set <bridge> type bridge stp_state 1" while ensuring that /sbin/bridge-stp kernel helper script will return success (0) for this operation.

SPANNING TREE PROTOCOL CONFIGURATION

mstpctl(8) can be used for configuring certain spanning tree protocol parameters. For an explanation of these parameters, see the IEEE 802.1D-2004 and 802.1Q-2005(-2011) standards.

mstpctl setmaxage <bridge> <max_age> sets the <bridge>'s 'maximum age' to <max_age> seconds, default is 20.

mstpctl setfdelay <bridge> <time> sets the <bridge>'s 'forward delay' to <time> seconds, default is 15.

mstpctl setmaxhops <bridge> <max_hops> sets the <bridge>'s 'maximum hops' to <max_hops>, default is 20.

mstpctl setforcevers <bridge> {mstp|rstp|stp} forces the <bridge> to use specific STP protocol version. mstp is the default.

mstpctl settxholdcount <bridge> <tx_hold_count> sets the <bridge>'s 'transmit hold count' to <tx_hold_count>.

mstpctl settreeprio <bridge> <mstid> <priority> set <bridge>'s priority for the tree with id = <mstid>, <priority> is between 0 and 15. Bridge priority affects bridge id, lowest priority bridge will be the (regional) root. Note that traditionally bridge priority is a multiple of 4096 and ranges from 0 to 15*4096 = 61440. mstpd is different - it throws out that useless "multiple of 4096" rule and expresses bridge priority in natural units (0-15). Default is 8.

mstpctl setportpathcost <bridge> <port> <cost> sets the port cost of the <port> in <bridge> to <cost>. Default is 0 (= auto).

mstpctl setportadminedge <bridge> <port> {yes|no} Enables/disables the admin edge state of the <port> in <bridge>, default is no.

mstpctl setportautoedge <bridge> <port> {yes|no} Enables/disables the auto transition to/from edge state of the <port> in <bridge>, default is yes.

mstpctl setportp2p <bridge> <port> {yes|no|auto} Enables/disables the point2point detection mode of the <port> in <bridge>, default is auto.

mstpctl setportrestrrole <bridge> <port> {yes|no} Enables/disables the restrictions on the <port>'s ability to take root role in <bridge>, default is no (i.e. no restrictions on the port's role).

mstpctl setportrestrtcn <bridge> <port> {yes|no} Enables/disables the restrictions on the <port>'s ability to propagate received topology change notification in <bridge>, default is no (i.e. no restrictions on the TCN propagation).

mstpctl setbpduguard <bridge> <port> {yes|no} Enables/disables the bpduguard configuration of the <port> in <bridge>, default is no.

mstpctl settreeportprio <bridge> <port> <mstid> <priority> sets the <port>'s priority in <bridge> to <priority> for the MSTI with id = <mstid>. The priority value is a number between 0 and 15. Note that traditionally port priority is a multiple of 16 and ranges from 0 to 15*16 = 240. mstpd is different - it throws out that useless "multiple of 16" rule and expresses port priority in natural units (0-15). Default is 8.

mstpctl sethello <bridge> <time> sets the <bridge>'s 'hello time' to <time> seconds, default is 2.

mstpctl setageing <bridge> <time> sets the ethernet (MAC) address ageing <time>, in seconds, for the <bridge>. Used only when protocol version is forced to STP, default is 300s. Note that this parameter differs from the other ones: it is only informational parameter. By setting it in the mstpd one do not change the real bridge's Ageing Time; it is supposed to be set as information to the mstpd that real Ageing Time in the real bridge was changed.

mstpctl setportnetwork <bridge> <port> {yes|no} Enables/disables the bridge assurance capability for a <port> in <bridge>, default is no.

mstpctl setportbpdufilter <bridge> <port> {yes|no} Enables/disables the BPDU filter capability for a port <port> in bridge <bridge>, i.e. discard any ingress BPDUs and do not issue any BPDUs for this port. The default is no.

SPANNING TREE PROTOCOL SHOW COMMANDS
mstpctl showbridge [<bridge>] will show information of the <bridge>'s CIST instance. If <bridge> parameter is omitted - shows info for all bridges.

mstpctl showport <bridge> [<port>] will show short (one-line) information about the <port> of the <bridge>'s CIST instance. If <port> parameters is omitted - shows info for all ports.

mstpctl showportdetail <bridge> [<port>] will show detailed information about the <port> of the <bridge>'s CIST instance. If <port> parameters is omitted - shows info for all ports.

mstpctl showtree <bridge> <mstid> will show information of the <bridge>'s MST instance with id = <mstid>.

mstpctl showtreeport <bridge> <port> <mstid> will show detailed information about the <port> of the <bridge>'s MST instance with id = <mstid>.

SEE ALSO
brctl(8) ip(8)

AUTHOR
The source code for mstpctl was written by Vitalii Demianets <dvitasgs@gmail.com>. This manpage was written by Satish Ashok <sashok@cumulusnetworks.com> based on brctl(8).