lldptool-vdp

lldptool(8)                          Linux                         lldptool(8)



NAME
       vdp - Show / manipulate VDP TLV configuration

SYNOPSIS
       lldptool -t -i ethx -V vdp -c enableTx

       lldptool -T -i ethx -V vdp -c enableTx=[yes|no]

       lldptool -t -i ethx -V vdp -c mode

       lldptool -T -i ethx -V vdp -c
       mode=<mode>,<mgrid>,<typeid>,<typeidversion>,<instanceid>,<mac>,<vlan>

       lldptool -t -i ethx -V vdp -c role

       lldptool -T -i ethx -V vdp -c role=[station|bridge]


DESCRIPTION
       The VSI discovery protocol (VDP) is NOT a TLV in the LLDP sense but
       rather a protocol to manage the association and deassociation of
       virtual station interfaces (VSIs) between the station and an adjacent
       switch. VDP uses ECP as transport for VDP TLVs. An ECP frame may
       contain multiple VDP TLVs. Each VDP TLVs contains a mode, typeid,
       version, instanceid, mac and vlan for a VSI.


ARGUMENTS
       enableTx
              Enables or disables VDP

       mode   shows or sets modes for VSIs with the following parameters:

              <mode> mode (0=preassociate, 1=preassociate with RR,
                     2=associate, 3=deassociate)

              <mgrid>
                     manager (database) id

              <typeid>
                     VSI type id

              <version>
                     VSI type id version

              <instanceid>
                     VSI instance id

              <format>
                     VDP filter info format

              <mac>  VSI mac address

              <vlan> VSI vlan id


       role   shows or sets the role of the local machine to act as either
              station (default) or bridge.


Theory of Operation
       The VDP protocol is used to pre-associate, associate or deassociate
       VSIs to and adjacent switch. Information about the VSIs is formatted
       into VDP TLVs which are then handed to ECP for lower-level transport.
       Each ECP frame may contain multiple VDP TLVs.

       Two ways to receive VSI information exist in llpdad: via netlink or
       with lldptool. netlink is used by libvirt to communicate VSIs to
       lldpad. lldptool can be used to associate/deassociate VSIs from the
       command line. This is especially helpful for testing purposes.


EXAMPLE & USAGE
       Display if vdp is enabled on eth8
              lldptool -t -i eth8 -V vdp -c enableTx

       Enable vdp on eth8
              lldptool -T -i eth8 -V vdp -c enableTx=yes

       Display the currently configured VSIs for eth8
              lldptool -t -i eth8 -V vdp -c mode

       Associate a VSI on eth8
              lldptool -T -i eth8 -V vdp -c mode=2,12,1193046,1,fa9b7fff-
              b0a0-4893-8e0e-beef4ff18f8f,2,52:54:00:C7:3E:CE,3

       Display the locally configured role for VDP on eth8
              lldptool -t -i eth8 -V vdp -c role

       Set the local role for VDP on eth8
              lldptool -T -i eth8 -V vdp -c role=bridge


SOURCE
       o      IEEE 802.1Qbg (http://www.ieee802.org/1/pages/802.1bg.html)


NOTES
       Currently the code in lldpad reflects draft 0 of the upcoming standard.
       ECP/VDP TLVs on the wire can be decoded with wireshark > v1.8.


SEE ALSO
       lldptool-evb(8), lldptool(8), lldpad(8)


AUTHOR
       Jens Osterkamp



open-lldp                        February 2010                     lldptool(8)