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

NAME

6       vdp - Show / manipulate VDP TLV configuration
7

SYNOPSIS

9       lldptool -t -i ethx -V vdp -c enableTx
10
11       lldptool -T -i ethx -V vdp -c enableTx=[yes|no]
12
13       lldptool -t -i ethx -V vdp -c mode
14
15       lldptool  -T -i ethx -V vdp -c mode=<mode>,<mgrid>,<typeid>,<typeidver‐
16       sion>,<instanceid>,<mac>,<vlan>
17
18       lldptool -t -i ethx -V vdp -c role
19
20       lldptool -T -i ethx -V vdp -c role=[station|bridge]
21
22

DESCRIPTION

24       The VSI discovery protocol (VDP) is NOT a TLV in  the  LLDP  sense  but
25       rather  a  protocol to manage the association and deassociation of vir‐
26       tual station interfaces (VSIs) between  the  station  and  an  adjacent
27       switch.  VDP  uses ECP as transport for VDP TLVs. An ECP frame may con‐
28       tain multiple VDP TLVs. Each VDP TLVs contains a mode, typeid, version,
29       instanceid, mac and vlan for a VSI.
30
31

ARGUMENTS

33       enableTx
34              Enables or disables VDP
35
36       mode   shows or sets modes for VSIs with the following parameters:
37
38              <mode> mode  (0=preassociate,  1=preassociate  with  RR, 2=asso‐
39                     ciate, 3=deassociate)
40
41              <mgrid>
42                     manager (database) id
43
44              <typeid>
45                     VSI type id
46
47              <version>
48                     VSI type id version
49
50              <instanceid>
51                     VSI instance id
52
53              <format>
54                     VDP filter info format
55
56              <mac>  VSI mac address
57
58              <vlan> VSI vlan id
59
60
61       role   shows or sets the role of the local machine  to  act  as  either
62              station (default) or bridge.
63
64

Theory of Operation

66       The  VDP  protocol  is  used to pre-associate, associate or deassociate
67       VSIs to and adjacent switch. Information about the  VSIs  is  formatted
68       into  VDP  TLVs which are then handed to ECP for lower-level transport.
69       Each ECP frame may contain multiple VDP TLVs.
70
71       Two ways to receive VSI information exist in  llpdad:  via  netlink  or
72       with  lldptool.  netlink is used by libvirt to communicate VSIs to lld‐
73       pad. lldptool can be used to associate/deassociate VSIs from  the  com‐
74       mand line. This is especially helpful for testing purposes.
75
76

EXAMPLE & USAGE

78       Display if vdp is enabled on eth8
79              lldptool -t -i eth8 -V vdp -c enableTx
80
81       Enable vdp on eth8
82              lldptool -T -i eth8 -V vdp -c enableTx=yes
83
84       Display the currently configured VSIs for eth8
85              lldptool -t -i eth8 -V vdp -c mode
86
87       Associate a VSI on eth8
88              lldptool  -T  -i  eth8  -V  vdp -c mode=2,12,1193046,1,fa9b7fff-
89              b0a0-4893-8e0e-beef4ff18f8f,2,52:54:00:C7:3E:CE,3
90
91       Display the locally configured role for VDP on eth8
92              lldptool -t -i eth8 -V vdp -c role
93
94       Set the local role for VDP on eth8
95              lldptool -T -i eth8 -V vdp -c role=bridge
96
97

SOURCE

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

NOTES

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

SEE ALSO

108       lldptool-evb(8), lldptool(8), lldpad(8)
109
110

AUTHOR

112       Jens Osterkamp
113
114
115
116open-lldp                        February 2010                     lldptool(8)
Impressum