lldptool-evb22

lldptool(8)                          Linux                         lldptool(8)



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



open-lldp                        February 2013                     lldptool(8)