# ⁣⁣lldp command

### Description <a href="#id-lldpcommand-description" id="id-lldpcommand-description"></a>

Link Layer Discovery Protocol (LLDP) allows network devices to advertise their identity, capabilities, and to receive same information from neighbors on an local area network. Information can be requested from the device by services via SNMP.

Nodes may share information about:

* network device name;
* network device description;
* system capabilities (switching, routing, etc.);
* port name;
* port description;
* MTU;
* management IP address;
* the last update time and the time during which the information will be saved (TTL).

**Syntax:**

```
usage: lldp [IFNAME] { disable | { enable [ tx | rx | txrx ] }}
       lldp [IFNAME] mgmtip IP [mgmtvid VID]
       lldp [IFNAME] [-]vlan VID NAME
       lldp [IFNAME] chassis serial | [mac]
       lldp [IFNAME] report | local
       lldp forward { disable | enable }
       lldp tagged  { disable | enable }
       lldp reset
```

### Parameters <a href="#id-lldpcommand-parameters" id="id-lldpcommand-parameters"></a>

<table><thead><tr><th width="224">Parameter</th><th>Description</th></tr></thead><tbody><tr><td><em><strong>[IFNAME]</strong></em></td><td>Name of the network interface to which parameters are referred.</td></tr><tr><td><em><strong>{ disable | { enable [ tx | rx | txrx ] }}</strong></em></td><td><p>Allows to control the LLDP messages exchange, by default this function is enabled for both incoming and outgoing messages.</p><ul><li><p><em>"enable" –</em> enable the LLDP messages exchange:</p><ul><li><em>"tx"</em> <em>–</em> outgoing LLDP messages only no incoming messages are allowed;</li><li><em>"rx" –</em> incoming LLDP messages only no outgoing messages are allowed;</li><li><em>"txrx"</em> – both incoming and outgoing messages.</li></ul></li><li><em>"disable"</em> – disable the LLDP messages exchange.</li></ul></td></tr><tr><td><em><strong>mgmtip IP [mgmtvid VID]</strong></em></td><td><p>Set the management IP address.</p><ul><li>"<em>mgmtvid VID</em>" <em>–</em> VLAN ID which contains the management IP address, if the address is set manually.</li></ul></td></tr><tr><td><em><strong>[-]vlan VID NAME</strong></em></td><td>Set the VLAN name. Some systems are operating with VLAN names to automatically configure their services.</td></tr><tr><td><em><strong>lldp [IFNAME] chassis serial | [mac]</strong></em></td><td>Allows to change value which is displayed in the "<em>ChassisID</em>" field to the device serial number. By default MAC address is displayed.</td></tr><tr><td><em><strong>report | local</strong></em></td><td><ul><li>"<em>report</em>" – shows the information device receives from its neighbors.</li><li>"<em>local</em>"  – shows information device sends to its neighbors.</li></ul></td></tr><tr><td><em><strong>forward { disable | enable }</strong></em></td><td>Enables/disables packet switching to other ports.The standard protocol LLDP does not allow such an opportunity. By default, this function is disabled.</td></tr><tr><td><em><strong>lldp tagged { disable | enable }</strong></em></td><td>Enables/disables tagged packets processing. By default, this function is disabled.</td></tr><tr><td><em><strong>lldp reset</strong></em></td><td>Removes accumulated statistics.</td></tr></tbody></table>

### Examples <a href="#id-lldpcommand-examples" id="id-lldpcommand-examples"></a>

Set the management IP address "*192.168.103.35*" on the network interface "*eth0*".

```
lldp eth0 mgmtip 192.168.103.35
```

Device information will appear while using command "*lldp eth0 local*":

```
LLDP Local info on eth0
+---------------+-------------------------------------------------------------+
| ChassisID:    | AW-173332 (local)                                           |
| SysName:      | ST-25                                                       |
| SysDescr:     | E5000 AstraFleX H22S01-TDMAv0.20.29                         |
| Caps:         | Repeater*, Bridge*, Router*                                 |
| PortID:       | 00:04:35:02:A5:14 (mac)                                     |
| PortDescr:    | eth0, ST-25                                                 |
| MFS:          | 1728 bytes                                                  |
| MgmtIP:       | 192.168.103.35                                              |
+---------------+-------------------------------------------------------------+
```

Enable the packet switching to other ports.

```
lldp forward enable
```

Display an information about all neighbors in the local area, accessible through the network interface "*eth0*" using "*lldp eth0 report*" command.

```
LLDP Neighbors Table on eth0
+---------------+-------------------------------------------------------------+
|                     LLDP Mode: TxRx,  Forward: enabled                      |
+---------------+-------------------------------------------------------------+
| ChassisID:    | AW-220750 (local)                                           |
| SysName:      | E5-BSI                                                      |
| SysDescr:     | E5000 AstraFleX H16S01-TDMAv0.20.29                         |
| Caps:         | Repeater*, Bridge*, Router*                                 |
| PortID:       | 00:04:35:03:5E:4E (mac)                                     |
| PortDescr:    | eth0, E5-BSI                                                |
| MFS:          | 1728 bytes                                                  |
| MgmtIP:       | 192.168.103.36, 10.10.10.16                                 |
| Last report:  | 26 seconds ago, TTL 180 seconds, Age 01:04:58               |
+---------------+-------------------------------------------------------------+
| ChassisID:    | AW-260061 (local)                                           |
| SysName:      | ST-23                                                       |
| SysDescr:     | E5000 AstraFleX H22S01-TDMAv0.20.29                         |
| Caps:         | Repeater*, Bridge*, Router*                                 |
| PortID:       | 00:04:35:03:F7:DD (mac)                                     |
| PortDescr:    | eth0, ST-23                                                 |
| MFS:          | 1728 bytes                                                  |
| MgmtIP:       | 192.168.103.37, 10.10.10.14                                 |
| Last report:  | 25 seconds ago, TTL 181 seconds, Age 01:04:57               |
+---------------+-------------------------------------------------------------+
| ChassisID:    | 00:04:35:07:A8:39 (mac)                                     |
| SysName:      | Q5-25                                                       |
| SysDescr:     | AstraFleX H18S55v1.7.1 AW-501817                            |
| Caps:         | Repeater*, Bridge*                                          |
| PortID:       | ge0 (local)                                                 |
| PortDescr:    | ge0, Q5-25                                                  |
| MFS:          | 1728 bytes                                                  |
| MgmtIP:       | 10.10.10.13, 192.168.103.39                                 |
| Last report:  | 41 seconds ago, TTL 183 seconds, Age 01:04:56               |
+---------------+-------------------------------------------------------------+
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://wiki.astrawireless.net/astra-wireless-documentation/technical-documentation/astraflex-technical-user-manual/layer-2-commands-set-phy-and-mac/lldp-command.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.