1lldptool(8) Linux lldptool(8)
2
6 evb22 - Show / manipulate EVB IEEE 802.1 Ratified Standard TLV configu‐
7 ration
8
10 lldptool -t -i ethx -g ncb -V evb
11 lldptool -t -i ethx -g ncb -V evb -c
13 lldptool -t -i ethx -g ncb -V evb -c enabletx
15 lldptool -T -i ethx -g ncb -V evb -c enabletx=[yes|no]
17 lldptool -t -i ethx -g ncb -V evb -c evbmode
19 lldptool -T -i ethx -g ncb -V evb -c evbmode=[bridge|station]
21 lldptool -t -i ethx -g ncb -V evb -c evbrrreq
23 lldptool -T -i ethx -g ncb -V evb -c evbrrreq=[yes|no]
25 lldptool -t -i ethx -g ncb -V evb -c evbrrcap
27 lldptool -T -i ethx -g ncb -V evb -c evbrrcap=[yes|no]
29 lldptool -t -i ethx -g ncb -V evb -c evbgpid
31 lldptool -T -i ethx -g ncb -V evb -c evbgpid=[yes|no]
33 lldptool -t -i ethx -g ncb -V evb -c ecpretries
35 lldptool -T -i ethx -g ncb -V evb -c ecpretries=[0..7]
37 lldptool -t -i ethx -g ncb -V evb -c ecprte
39 lldptool -T -i ethx -g ncb -V evb -c ecprte=[0..31]
41 lldptool -t -i ethx -g ncb -V evb -c vdprwd
43 lldptool -T -i ethx -g ncb -V evb -c vdprwd=[0..31]
45 lldptool -t -i ethx -g ncb -V evb -c vdprka
47 lldptool -T -i ethx -g ncb -V evb -c vdprka=[0..31]
49
51 The Edge Virtual Bridge (EVB) TLV is a TLV to announce the station and
52 bridge's edge virtual bridging (EVB) capabilities and may request the
53 bridge port to be set into reflective relay (hairpin) mode. If both
54 sides agree on the modes and time out values, the edge control protocol
55 (ECP) will be used to exchange VSI discovery protocol (VDP) data using
56 ECP frames between the host interface and the adjacent switch port fac‐
57 ing the host interface.
58 This man pages describes the IEEE 802.1 Qbg ratified standard dated
60 from July 5th, 2012. The arguments and parameters differ from the IEEE
61 802.1 Qbg draft 0.2, which is also implemented. The EVB protocol ver‐
62 sion to be used depends on the organizational unique identifier (OUI)
63 of the EVB TLV in the LLDP data stream. A OUI value of 0x001b3f stands
64 for the IEEE 802.1 Qbg draft 0.2, a OUI value of 0x0080c2 stands for
65 the IEEE 802.1 Qbg ratified standard. The version of the ECP and VDP
66 protocols are determined by the ethernet type field in the ethernet
67 header. The ethernet type value for IEEE 802.1 Qbg draft 0.2 is
68 0x88b7, the value for IEEE 802.1 Qbg ratified standard is 0x8890. Note
69 that the EVB protocol is exchanged between nearest customer bridges
70 only, employing the reserved multicast MAC address 01:80:c2:00:00:00 as
71 destination MAC address. lldpad(8) supports both versions, the switch
72 port configuration determines which version will be used. The switch
73 port configuration should select only one protocol version, never both.
74 The command line options and arguments are explained in the lldptool(8)
76 man pages. Only the EVB, ECP and VDP protocol specific parameters are
77 detailed in this manual page.
78
80 The invocation without command line option '-c' and argument displays
81 the complete EVB, ECP and VDP protocol settings in a pretty print out.
82 See below for a detailed description on how to interpret the output.
83 -c text
85 Use of the command line option '-c' without any argument dis‐
86 plays all known parameters in the format of key=value, which is
87 suitable for post processing. Use command line option '-c' and
88 one of the following arguments to display and set individual
89 parameters. Text can be one of the following values:
90 enabletx
92 Enables or disables the EVB TLV to be transmitted. When set to
93 disabled no EVB TLV will be included in the LLDP data stream.
94 Furthermore the output of the complete EVB settings without
95 option '-c' will be empty.
96 evbmode
98 Display the current role or sets the role the to given value.
99 Supported values are either "station" or "bridge".
100 evbrrreq
102 Shows the current reflective relay (hairpin) request mode or
103 sets the reflective relay (hairpin) request mode. If the value
104 is "yes", the station requests the interface facing switch port
105 to be set in reflective relay (hairpin) mode. This field is
106 only valid for stations, the output of evbmode equals "station".
107 evbrrcap
109 Shows the current reflective relay (hairpin) capabilities or
110 sets the reflective relay (hairpin) capabilities. If the value
111 is "yes", the switch port will be set in reflective relay (hair‐
112 pin) mode. This field is only valid for switches, the output of
113 evbmode equals "bridge".
114 gpid Shows the current station or switch support for grouping or
116 turns on/off the station or switch support for grouping. If set
117 to true, the station or switch wants to use group identifiers in
118 VDP protocols.
119 ecpretries
121 Shows or sets the maximum number of retries for ECP frames to be
122 retransmitted. A retransmit occurs when no ECP acknowledgement
123 message has been received during a given time period.
124 ecprte Shows or sets the local run time exponent (RTE). The RTE will
126 be used as the base for the timing of the ECP protocol time outs
127 and retransmits. The wait time is calculated as 10*2ecprte
128 micro seconds.
129 vdprwd Shows or sets the number of resource wait delay value. This
131 value is calculated as 10*2vdprwd micro seconds and determines
132 the maximum wait time for VDP protocol acknowledgements.
133 vdprka Shows or sets the number of re-init keep alive value. This
135 value is calculated as 10*2vdprka micro seconds and determines
136 the wait time for VDP protocol to send a keep alive message.
137
139 The EVB TLV is used to announce and exchange supported parameters
140 between the station and an adjacent switch. If reflectiverelay is
141 active, the switch sends back ethernet frames on the very same port it
142 received the frame on. This is an extension to the current bridging
143 standard and allows communication between virtual machines on the same
144 host through the switch port.
145
147 Display locally configured values for eth0
148 lldptool -t -g ncb -i eth0 -V evb
149 EVB Configuration TLV
150 bridge:(00)
151 station:rrreq,rrstat(0x5)
152 retries:7 rte:31
153 mode:station r/l:0 rwd:31
154 r/l:0 rka:8
155 This output is displayed when enabletx has been enabled. The first
157 line shows the currently known status of the bridge. The second line
158 shows the currently known status of the station. The status is dis‐
159 played verbose appended by the hexadecimal value in parenthesis. The
160 verbose output uses the bit naming convention used in the standard doc‐
161 ument. The third line displays the values for the ECP protocol number
162 of retransmits (retries) and the retransmit timeout exponent. The
163 forth line shows the current mode of operation, either bridge or sta‐
164 tion, the resource wait delay value (rwd) and an indication if the
165 local (0) or remote (1) rwd value is used. The fifth line displays the
166 value of the re-init keep alive counter (rka) and an indication if the
167 local (0) or remote (1) rka value is used.
168 Display the currently requested forwarding mode for eth0
170 lldptool -t -g ncb -i eth0 -V evb -c evbrrreq
171 Display the locally configured value for RTE
173 lldptool -t -g ncb -i eth0 -V evb -c evbrte
174 Set the value for RTE to its maximum value
176 lldptool -T -g ncb -i eth0 -V evb -c rte=7
177 Set the value for enabletx to yes
179 lldptool -T -g ncb -i eth0 -V evb -c enabletx=yes
180
182 Currently the code in lldpad reflects IEEE 802.1 Qbg draft 0.2 of the
183 upcoming standard. Wireshark support for IEEE 802.1 Qbg ratified stan‐
184 dard TLVs is currently missing. Support for the IEEE 802.1 Qbg rati‐
185 fied standard protocols ECP and VDP is currently under development and
186 not fully functional.
187
189 lldptool-vdp(8), lldptool(8), lldpad(8)
190 IEEE 802.1Qbg (http://www.ieee802.org/1/pages/802.1bg.html)
191
193 Thomas Richter
194open-lldp February 2013 lldptool(8)