Provided by: lldpad_1.1+git20221028.aa18720-2_amd64 bug

NAME

       evb22 - Show / manipulate EVB IEEE 802.1 Ratified Standard TLV configuration

SYNOPSIS

       lldptool -t -i ethx -g ncb -V evb

       lldptool -t -i ethx -g ncb -V evb -c

       lldptool -t -i ethx -g ncb -V evb -c enabletx

       lldptool -T -i ethx -g ncb -V evb -c enabletx=[yes|no]

       lldptool -t -i ethx -g ncb -V evb -c evbmode

       lldptool -T -i ethx -g ncb -V evb -c evbmode=[bridge|station]

       lldptool -t -i ethx -g ncb -V evb -c evbrrreq

       lldptool -T -i ethx -g ncb -V evb -c evbrrreq=[yes|no]

       lldptool -t -i ethx -g ncb -V evb -c evbrrcap

       lldptool -T -i ethx -g ncb -V evb -c evbrrcap=[yes|no]

       lldptool -t -i ethx -g ncb -V evb -c evbgpid

       lldptool -T -i ethx -g ncb -V evb -c evbgpid=[yes|no]

       lldptool -t -i ethx -g ncb -V evb -c ecpretries

       lldptool -T -i ethx -g ncb -V evb -c ecpretries=[0..7]

       lldptool -t -i ethx -g ncb -V evb -c ecprte

       lldptool -T -i ethx -g ncb -V evb -c ecprte=[0..31]

       lldptool -t -i ethx -g ncb -V evb -c vdprwd

       lldptool -T -i ethx -g ncb -V evb -c vdprwd=[0..31]

       lldptool -t -i ethx -g ncb -V evb -c vdprka

       lldptool -T -i ethx -g ncb -V evb -c vdprka=[0..31]

DESCRIPTION

       The  Edge  Virtual  Bridge  (EVB)  TLV  is a TLV to announce the station and bridge's edge
       virtual bridging (EVB) capabilities and may  request  the  bridge  port  to  be  set  into
       reflective  relay  (hairpin)  mode.  If both sides agree on the modes and time out values,
       the edge control protocol (ECP) will be used to exchange VSI discovery protocol (VDP) data
       using  ECP  frames between the host interface and the adjacent switch port facing the host
       interface.

       This man pages describes the IEEE 802.1 Qbg ratified standard dated from July  5th,  2012.
       The  arguments  and  parameters  differ  from  the IEEE 802.1 Qbg draft 0.2, which is also
       implemented.  The EVB protocol version to be used depends  on  the  organizational  unique
       identifier  (OUI)  of the EVB TLV in the LLDP data stream.  A OUI value of 0x001b3f stands
       for the IEEE 802.1 Qbg draft 0.2, a OUI value of 0x0080c2 stands for the  IEEE  802.1  Qbg
       ratified  standard.   The  version  of  the  ECP  and  VDP protocols are determined by the
       ethernet type field in the ethernet header.  The ethernet type value for  IEEE  802.1  Qbg
       draft  0.2 is 0x88b7, the value for IEEE 802.1 Qbg ratified standard is 0x8890.  Note that
       the EVB protocol is  exchanged  between  nearest  customer  bridges  only,  employing  the
       reserved  multicast  MAC  address 01:80:c2:00:00:00 as destination MAC address.  lldpad(8)
       supports both versions, the switch port configuration determines  which  version  will  be
       used.  The switch port configuration should select only one protocol version, never both.

       The  command  line options and arguments are explained in the lldptool(8) man pages.  Only
       the EVB, ECP and VDP protocol specific parameters are detailed in this manual page.

ARGUMENTS

       The invocation without command line option '-c' and argument displays  the  complete  EVB,
       ECP and VDP protocol settings in a pretty print out.  See below for a detailed description
       on how to interpret the output.

       -c text
              Use of the command line  option  '-c'  without  any  argument  displays  all  known
              parameters  in the format of key=value, which is suitable for post processing.  Use
              command line option '-c' and one of the following  arguments  to  display  and  set
              individual parameters.  Text can be one of the following values:

       enabletx
              Enables or disables the EVB TLV to be transmitted.  When set to disabled no EVB TLV
              will be included in the LLDP data stream.  Furthermore the output of  the  complete
              EVB settings without option '-c' will be empty.

       evbmode
              Display the current role or sets the role the to given value.  Supported values are
              either "station" or "bridge".

       evbrrreq
              Shows the current reflective relay (hairpin) request mode or  sets  the  reflective
              relay  (hairpin)  request  mode.   If  the value is "yes", the station requests the
              interface facing switch port to be set in reflective relay  (hairpin)  mode.   This
              field is only valid for stations, the output of evbmode equals "station".

       evbrrcap
              Shows  the  current  reflective relay (hairpin) capabilities or sets the reflective
              relay (hairpin) capabilities.  If the value is "yes", the switch port will  be  set
              in  reflective  relay  (hairpin)  mode.  This field is only valid for switches, the
              output of evbmode equals "bridge".

       gpid   Shows the current station or switch  support  for  grouping  or  turns  on/off  the
              station  or  switch  support  for  grouping.  If set to true, the station or switch
              wants to use group identifiers in VDP protocols.

       ecpretries
              Shows or sets the maximum number of retries for ECP frames to be retransmitted.   A
              retransmit  occurs  when  no ECP acknowledgement message has been received during a
              given time period.

       ecprte Shows or sets the local run time exponent (RTE).  The RTE will be used as the  base
              for  the  timing  of  the ECP protocol time outs and retransmits.  The wait time is
              calculated as 10*2ecprte micro seconds.

       vdprwd Shows or sets the number of resource wait delay value.  This value is calculated as
              10*2vdprwd  micro  seconds  and  determines the maximum  wait time for VDP protocol
              acknowledgements.

       vdprka Shows or sets the number of re-init keep alive value.  This value is calculated  as
              10*2vdprka  micro  seconds  and determines the wait time for VDP protocol to send a
              keep alive message.

Theory of Operation

       The EVB TLV is used to announce and exchange supported parameters between the station  and
       an  adjacent  switch.  If reflectiverelay is active, the switch sends back ethernet frames
       on the very same port it received the frame on.  This  is  an  extension  to  the  current
       bridging  standard  and  allows  communication  between  virtual machines on the same host
       through the switch port.

EXAMPLE & USAGE

       Display locally configured values for eth0
              lldptool -t -g ncb -i eth0 -V evb
              EVB Configuration TLV
                   bridge:(00)
                   station:rrreq,rrstat(0x5)
                   retries:7 rte:31
                   mode:station r/l:0 rwd:31
                   r/l:0 rka:8

       This output is displayed when enabletx  has  been  enabled.   The  first  line  shows  the
       currently known status of the bridge.  The second line shows the currently known status of
       the station.  The status is  displayed  verbose  appended  by  the  hexadecimal  value  in
       parenthesis.   The  verbose  output  uses  the  bit naming convention used in the standard
       document.  The third line displays the values for the ECP protocol number  of  retransmits
       (retries)  and  the retransmit timeout exponent.  The forth line shows the current mode of
       operation, either bridge or station, the resource wait delay value (rwd) and an indication
       if  the  local  (0) or remote (1) rwd value is used.  The fifth line displays the value of
       the re-init keep alive counter (rka) and an indication if the local (0) or remote (1)  rka
       value is used.

       Display the currently requested forwarding mode for eth0
              lldptool -t -g ncb -i eth0 -V evb -c evbrrreq

       Display the locally configured value for RTE
              lldptool -t -g ncb -i eth0 -V evb -c evbrte

       Set the value for RTE to its maximum value
              lldptool -T -g ncb -i eth0 -V evb -c rte=7

       Set the value for enabletx to yes
              lldptool -T -g ncb -i eth0 -V evb -c enabletx=yes

NOTES

       Currently  the  code in lldpad reflects IEEE 802.1 Qbg draft 0.2 of the upcoming standard.
       Wireshark support for IEEE 802.1 Qbg ratified standard TLVs is currently missing.  Support
       for  the  IEEE  802.1  Qbg  ratified  standard  protocols  ECP  and VDP is currently under
       development and not fully functional.

SEE ALSO

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

AUTHOR

       Thomas Richter