1lldptool(8)                          Linux                         lldptool(8)
2
3
4

NAME

6       evb22 - Show / manipulate EVB IEEE 802.1 Ratified Standard TLV configu‐
7       ration
8

SYNOPSIS

10       lldptool -t -i ethx -g ncb -V evb
11
12       lldptool -t -i ethx -g ncb -V evb -c
13
14       lldptool -t -i ethx -g ncb -V evb -c enabletx
15
16       lldptool -T -i ethx -g ncb -V evb -c enabletx=[yes|no]
17
18       lldptool -t -i ethx -g ncb -V evb -c evbmode
19
20       lldptool -T -i ethx -g ncb -V evb -c evbmode=[bridge|station]
21
22       lldptool -t -i ethx -g ncb -V evb -c evbrrreq
23
24       lldptool -T -i ethx -g ncb -V evb -c evbrrreq=[yes|no]
25
26       lldptool -t -i ethx -g ncb -V evb -c evbrrcap
27
28       lldptool -T -i ethx -g ncb -V evb -c evbrrcap=[yes|no]
29
30       lldptool -t -i ethx -g ncb -V evb -c evbgpid
31
32       lldptool -T -i ethx -g ncb -V evb -c evbgpid=[yes|no]
33
34       lldptool -t -i ethx -g ncb -V evb -c ecpretries
35
36       lldptool -T -i ethx -g ncb -V evb -c ecpretries=[0..7]
37
38       lldptool -t -i ethx -g ncb -V evb -c ecprte
39
40       lldptool -T -i ethx -g ncb -V evb -c ecprte=[0..31]
41
42       lldptool -t -i ethx -g ncb -V evb -c vdprwd
43
44       lldptool -T -i ethx -g ncb -V evb -c vdprwd=[0..31]
45
46       lldptool -t -i ethx -g ncb -V evb -c vdprka
47
48       lldptool -T -i ethx -g ncb -V evb -c vdprka=[0..31]
49

DESCRIPTION

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
59       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
75       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

ARGUMENTS

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
84       -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
91       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
97       evbmode
98              Display  the  current  role or sets the role the to given value.
99              Supported values are either "station" or "bridge".
100
101       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
108       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
115       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
120       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
125       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
130       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
134       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

Theory of Operation

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

EXAMPLE & USAGE

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
156       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
169       Display the currently requested forwarding mode for eth0
170              lldptool -t -g ncb -i eth0 -V evb -c evbrrreq
171
172       Display the locally configured value for RTE
173              lldptool -t -g ncb -i eth0 -V evb -c evbrte
174
175       Set the value for RTE to its maximum value
176              lldptool -T -g ncb -i eth0 -V evb -c rte=7
177
178       Set the value for enabletx to yes
179              lldptool -T -g ncb -i eth0 -V evb -c enabletx=yes
180

NOTES

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

SEE ALSO

189       lldptool-vdp(8), lldptool(8), lldpad(8)
190       IEEE 802.1Qbg (http://www.ieee802.org/1/pages/802.1bg.html)
191

AUTHOR

193       Thomas Richter
194
195
196
197open-lldp                        February 2013                     lldptool(8)
Impressum