lldptool(8) Linux lldptool(8)NAME
LLDP-MED - Show / manipulate MED TLV configurations
SYNOPSIS
lldptool -t -i ethx -V [ TLV_TYPE ] enableTx
lldptool -T -i ethx -V [ TLV_TYPE ] enableTx = { yes | no }
lldptool -T -i ethx -V LLDP-MED devtype = { class1 | class2 | class3 }
lldptool -t -i ethx -V LLDP-MED devtype
TLV_TYPE : = {LLDP-MED | medCap | medPolicy | medLoc | medPower | medHwRev | medFwRev | medSwRev | medSerNum | medManuf | medModel | medAssetID }
DESCRIPTION
The LLDP-MED extensions support the Link Layer Discovery Protocol for Media Endpoint Devices defined in the ANSI/TIA-1057-2006 document.
Each TLV can be configured as a class1 , class2 or class3 device. Class I devices are the most basic class of Endpoint Device, Class II
devices support media stream capabilities and Class III devices directly support end users of the IP communication system. See ANS-TIA-1057
for clarification of class types.
ARGUMENTS
enableTx
Enables the TLV to be transmitted
devtype
Set or query the class type of the device.
TLV_TYPE
List of supported TLV specifiers applicable to Media Endpoint Devices.
LLDP-MED
apply arguments to all supported MED TLVs.
medCAP LLDP-MED Capabilities TLV
medPolicy
LLDP-MED Network Policy TLV
medLoc LLDP-MED Location TLV
medPower
LLDP-MED Extended Power-via-MDI TLV
medHwRev
LLDP-MED Hardware Revision TLV
medFwRev
LLDP-MED Firmware Revision TLV
medSwRev
LLDP-MED Software Revision TLV
medSerNum
LLDP-MED Serial Number TLV
medManuf
LLDP-MED Manufacturer Name TL
medModel
LLDP-MED Model Name TLV
medAssetID
LLDP-MED Asset ID TLV
EXAMPLE & USAGE
Enable class1 MED device on eth2
lldptool -T -i eth2 -V LLDP-MED enableTx=yes devtype=class1
Query class type of MED on eth2
lldptool -t -i eth2 -V LLDP-MED -c devtype
Query transmit state of medPolicy on device eth2
lldptool -t -i eth2 -V medPolicy -c enableTx
SOURCE
o Link Layer Discovery Protocol for Media Endpoint Devices (http://www.tiaonline.org/standards/technology/voip/documents/ANSI-
TIA-1057_final_for_publication.pdf)
NOTES SEE ALSO lldptool(8), lldpad(8)AUTHOR
John Fastabend
open-lldp June 2011 lldptool(8)
Check Out this Related Man Page
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 vir-
tual 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 lld-
pad. 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)