Linux Certif

Toute la documentation sur la certification Linux LPI

lldpd

BSD mandoc

NAME

lldpd - LLDP daemon

SYNOPSIS

[-dvxcsei ] [-m management ] [-p probe time ] [-M class ] [-L location ]

DESCRIPTION

is a daemon able to receive and send LLDP frames. The Link Layer Discovery Protocol is a vendor-neutral Layer 2 protocol that allows a network device to advertise its identity and capabilities on the local network.

also implements an SNMP subagent using AgentX protocol to interface to a regular SNMP agent like Net-SNMP. To enable this subagent, you need something like that in your snmpd.conf5:

 master agentx
 

This daemon implements both reception and sending. It will collect various information to send LLDP frames to all Ethernet interfaces, including management address, speed and VLAN names.

The options are as follows:

-d

Do not daemonize. If this option is specified, will run in the foreground and log to stderr This option can be specified many times to increase verbosity.

-v

Listen on VLAN as well. This option might be needed if your equipment send frames on VLAN instead of physical interface. This option enables to receive frames on VLAN interfaces as well. If you don't need this option, do not set it.

-x

Enable SNMP subagent With this option, will enable an SNMP subagent using AgentX protocol. This allows to get information about local system and remote systems through SNMP.

-c

Enable the support of CDP protocol to deal with Cisco routers that do not speak LLDP.

-f

Enable the support of FDP protocol to deal with Foundry routers that do not speak LLDP.

-s

Enable the support of SONMP protocol to deal with Nortel routers and switches that do not speak LLDP.

-e

Enable the support of EDP protocol to deal with Extreme routers and switches that do not speak LLDP.

-m management

Specify the management address of this system. only sends one management address. It will use the first one that it finds or the one that you specify with this option. This option can use wildcards.

-p probe time

Specify the time to wait (in seconds) before accepting a given protocol. This time will be used by to detect false positives like SONMP frames running through a switch only supporting CDP. This value is only used when multiple protocols are enabled.

-M class

Enable emission of LLDP-MED frame. The class should be one of the following value:

1

Generic Endpoint (Class I)

2

Media Endpoint (Class II)

3

Communication Device Endpoints (Class III)

4

Network Connectivity Device

-i

Disable LLDP-MED inventory TLV transmission. will still receive (and publish using SNMP if enabled) those LLDP-MED TLV but will not send them. Use this option if you don't want to transmit sensible information like serial numbers.

-L location

Enable the transmission of LLDP-MED location TLV. This option can be repeated several times to enable the transmission of the location in several formats. Several formats are accepted:

Coordinate based location

The format of location is 1:48.85667:N:2.2014:E:117.47:m:1 The first digit is always 1 It is followed by the latitude, a letter for the direction ( E or W for East or West), the longitude and a letter for the direction ( N or S ). The next figure is the altitude. It can be expressed in meters (the next letter is then m ) or in floors (the letter should be f ). The last digit is the datum. It can either be 1 (WGS84), 2 (NAD83) or 3 (NAD83/MLLW).

Civic address

The location can be expressed as an address. The format of the location is then 2:FR:6:Commercial Rd:3:Roseville:19:4 The first digit is always 2 The next two letters are the country code. Then, arguments are paired to form the address. The first member of the pair is a digit indicating the type of the second member. Here is the list of valid types:

0

Language

1

National subdivisions

2

County, parish, district

3

City, township

4

City division, borough, ward

5

Neighborhood, block

6

Street

16

Leading street direction

17

Trailing street suffix

18

Street suffix

19

House number

20

House number suffix

21

Landmark or vanity address

22

Additional location info

23

Name

24

Postal/ZIP code

25

Building

26

Unit

27

Floor

28

Room number

29

Place type

128

Script

ECS ELIN

This is a numerical string using for setting up emergency call. The format of the location is then the following: 3:0000000911 where the first digit should be 3 and the second argument is the ELIN number.

Locations set using this option are set for all ports. There is currently no way to affect different locations to different ports. Using this TLV, network connectivity devices usually advertise the location of a class III device. Since it is unlikely that all devices are in the same location, the location TLV should be different for each port. This is not possible actually.

Therefore, this option is likely to be removed in the future and will moved into lldpctl(8).

FILES

/var/run/lldpd.socket

Unix-domain socket used for communication with lldpctl(8).

SEE ALSO

lldpctl(8), snmpd(8)

HISTORY

The program is inspired from a preliminary work of Reyk Floeter.

AUTHORS

An -nosplit The program was written by An Pierre-Yves Ritschard Aq pyr@openbsd.org , and An Vincent Bernat Aq bernat@luffy.cx .