]>
Commit | Line | Data |
---|---|---|
fe80711e VB |
1 | .\" Copyright (c) 2006 Pierre-Yves Ritschard <pyr@openbsd.org> |
2 | .\" Copyright (c) 2008 Vincent Bernat <bernat@luffy.cx> | |
3 | .\" | |
4 | .\" Permission to use, copy, modify, and/or distribute this software for any | |
5 | .\" purpose with or without fee is hereby granted, provided that the above | |
6 | .\" copyright notice and this permission notice appear in all copies. | |
7 | .\" | |
8 | .\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES | |
9 | .\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF | |
10 | .\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR | |
11 | .\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES | |
12 | .\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN | |
13 | .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF | |
14 | .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. | |
15 | .\" | |
16 | .Dd $Mdocdate: July 16 2008 $ | |
17 | .Dt LLDPCLI 8 | |
18 | .Os | |
19 | .Sh NAME | |
20 | .Nm lldpcli , | |
21 | .Nm lldpctl | |
22 | .Nd control LLDP daemon | |
23 | .Sh SYNOPSIS | |
24 | .Nm | |
25 | .Op Fl dv | |
baaa96d1 | 26 | .Op Fl u Ar socket |
fe80711e | 27 | .Op Fl f Ar format |
6402fd2c | 28 | .Op Fl c Ar file |
fe80711e VB |
29 | .Op Ar command ... |
30 | .Nm lldpctl | |
31 | .Op Fl dv | |
baaa96d1 | 32 | .Op Fl u Ar socket |
fe80711e VB |
33 | .Op Fl f Ar format |
34 | .Op Ar interfaces ... | |
35 | .Sh DESCRIPTION | |
36 | The | |
37 | .Nm | |
38 | program controls | |
39 | .Xr lldpd 8 | |
40 | daemon. | |
41 | .Pp | |
42 | When no command is specified, | |
43 | .Nm | |
44 | will start an interactive shell which can be used to input arbitrary | |
45 | commands as if they were specified on the command line. This | |
46 | interactive shell should provide completion and history support. | |
47 | .Pp | |
48 | The options are as follows: | |
49 | .Bl -tag -width Ds | |
50 | .It Fl d | |
9856f279 | 51 | Enable more debugging information. This flag can be repeated. |
baaa96d1 | 52 | .It Fl u Ar socket |
0262adbb ZM |
53 | Specify the Unix-domain socket used for communication with |
54 | .Xr lldpd 8 . | |
fe80711e VB |
55 | .It Fl v |
56 | Show | |
57 | .Nm | |
efa6a7a3 | 58 | version. When repeated, show more build information. |
fe80711e VB |
59 | .It Fl f Ar format |
60 | Choose the output format. Currently | |
61 | .Em plain , | |
62 | .Em xml , | |
479d4985 VB |
63 | .Em json , |
64 | .Em json0 | |
fe80711e VB |
65 | and |
66 | .Em keyvalue | |
67 | formats are available. The default is | |
68 | .Em plain . | |
479d4985 VB |
69 | .Em json0 |
70 | is more verbose than | |
71 | .Em json | |
72 | but the structure of the JSON object is not affected by the number of | |
73 | interfaces or the number of neighbors. It is therefore easier to | |
74 | parse. | |
6402fd2c VB |
75 | .It Fl c Ar file |
76 | Read the given configuration file. This option may be repeated several | |
6003c0d6 | 77 | times. If a directory is provided, each file therein suffixed with |
6402fd2c | 78 | .Li .conf . |
6003c0d6 | 79 | will be read. Order is alphabetical. |
fe80711e | 80 | .El |
fe80711e VB |
81 | .Pp |
82 | When invoked as | |
83 | .Nm lldpctl , | |
84 | .Nm | |
6003c0d6 | 85 | will display detailed information about each neighbor on the |
fe80711e VB |
86 | specified interfaces or on all interfaces if none are specified. This |
87 | command is mostly kept for backward compatibility with older versions. | |
fe80711e VB |
88 | .Pp |
89 | The following commands are supported by | |
90 | .Nm . | |
91 | When there is no ambiguity, the keywords can be abbreviated. For | |
92 | example, | |
93 | .Cd show neighbors ports eth0 summary | |
94 | and | |
95 | .Cd sh neigh p eth0 sum | |
96 | are the same command. | |
fe80711e VB |
97 | .Bd -ragged -offset XX |
98 | .Cd exit | |
99 | .Bd -ragged -offset XXXXXX | |
100 | Quit | |
101 | .Nm . | |
102 | .Ed | |
103 | ||
72706acd VB |
104 | .Cd help Op ... |
105 | .Bd -ragged -offset XXXXXX | |
106 | Display general help or help about a command. Also, you can get help | |
107 | using the completion or by pressing the | |
108 | .Ic ? | |
6003c0d6 | 109 | key. Completion and inline help may be unavailable, however, if |
72706acd VB |
110 | .Nm |
111 | was compiled without readline support but | |
112 | .Cd help | |
113 | command is always available. | |
114 | .Ed | |
115 | ||
fe80711e | 116 | .Cd show neighbors |
97772619 | 117 | .Op ports Ar ethX Op ,... |
fe80711e VB |
118 | .Op Cd details | summary |
119 | .Op Cd hidden | |
120 | .Bd -ragged -offset XXXXXX | |
121 | Display information about each neighbor known by | |
122 | .Xr lldpd 8 | |
123 | daemon. With | |
124 | .Cd summary , | |
a6d1d023 | 125 | only the name and the port description of each remote host will be |
fe80711e VB |
126 | displayed. On the other hand, with |
127 | .Cd details , | |
128 | all available information will be displayed, giving a verbose | |
129 | view. When using | |
130 | .Cd hidden , | |
131 | also display remote ports hidden by the smart filter. When specifying | |
132 | one or several ports, the information displayed is limited to the | |
133 | given list of ports. | |
134 | .Ed | |
135 | ||
a54f6012 SW |
136 | .Cd show interfaces |
137 | .Op ports Ar ethX Op ,... | |
138 | .Op Cd details | summary | |
139 | .Op Cd hidden | |
140 | .Bd -ragged -offset XXXXXX | |
141 | Display information about each local interface known by | |
142 | .Xr lldpd 8 | |
143 | daemon. With | |
144 | .Cd summary , | |
145 | only the name and the port description of each local interface will be | |
146 | displayed. On the other hand, with | |
147 | .Cd details , | |
148 | all available information will be displayed, giving a verbose | |
149 | view. When using | |
150 | .Cd hidden , | |
151 | also display local ports hidden by the smart filter. When specifying | |
152 | one or several ports, the information displayed is limited to the | |
153 | given list of ports. | |
154 | .Ed | |
155 | ||
3407e638 VB |
156 | .Cd show chassis |
157 | .Op Cd details | summary | |
158 | .Bd -ragged -offset XXXXXX | |
159 | Display information about local chassis. With | |
160 | .Cd summary , | |
161 | most details are skipped. On the other hand, with | |
162 | .Cd details , | |
163 | all available information will be displayed, giving a verbose | |
164 | view. | |
165 | .Ed | |
166 | ||
fe80711e | 167 | .Cd watch |
97772619 | 168 | .Op ports Ar ethX Op ,... |
fe80711e VB |
169 | .Op Cd details | summary |
170 | .Op Cd hidden | |
a7c54949 | 171 | .Op Cd limit Ar X |
fe80711e VB |
172 | .Bd -ragged -offset XXXXXX |
173 | Watch for any neighbor changes and report them as soon as they | |
174 | happen. When specifying ports, the changes are only reported when | |
175 | happening on the given ports. | |
176 | .Cd hidden , summary | |
177 | and | |
178 | .Cd details | |
6003c0d6 | 179 | have the same meaning as previously described. If |
a7c54949 | 180 | .Cd limit |
a6d1d023 | 181 | is specified, |
a7c54949 VB |
182 | .Nm |
183 | will exit after receiving the specified number of events. | |
fe80711e VB |
184 | .Ed |
185 | ||
186 | .Cd show configuration | |
187 | .Bd -ragged -offset XXXXXX | |
188 | Display global configuration of | |
189 | .Xr lldpd 8 | |
190 | daemon. | |
191 | .Ed | |
192 | ||
885aa4f4 VB |
193 | .Cd show statistics |
194 | .Op ports Ar ethX Op ,... | |
195 | .Op Cd summary | |
196 | .Bd -ragged -offset XXXXXX | |
197 | Report LLDP-related statistics, like the number of LLDPDU transmitted, | |
198 | received, discarded or unrecognized. When specifying ports, only the | |
199 | statistics from the given port are reported. With | |
200 | .Cd summary | |
6003c0d6 | 201 | the statistics of each port are summed. |
885aa4f4 VB |
202 | .Ed |
203 | ||
fe80711e VB |
204 | .Cd update |
205 | .Bd -ragged -offset XXXXXX | |
206 | Make | |
207 | .Xr lldpd 8 | |
208 | update its information and send new LLDP PDU on all interfaces. | |
209 | .Ed | |
210 | ||
17a90fc0 VB |
211 | .Cd configure |
212 | .Cd system hostname Ar name | |
213 | .Bd -ragged -offset XXXXXX | |
214 | Override system hostname with the provided value. By default, the | |
a9d00cbd | 215 | system name is the FQDN found from the resolved value of |
17a90fc0 | 216 | .Ic uname -n . |
a9d00cbd VB |
217 | As a special value, use "." (dot) to use the short hostname instead of |
218 | a FQDN. | |
17a90fc0 VB |
219 | .Ed |
220 | ||
6dd83015 VB |
221 | .Cd unconfigure |
222 | .Cd system hostname | |
223 | .Bd -ragged -offset XXXXXX | |
224 | Do not override system hostname and restore the use of the node name. | |
225 | .Ed | |
226 | ||
decaec0d VB |
227 | .Cd configure |
228 | .Cd system description Ar description | |
229 | .Bd -ragged -offset XXXXXX | |
230 | Override chassis description with the provided value instead of using | |
231 | kernel name, node name, kernel version, build date and architecture. | |
232 | .Ed | |
233 | ||
6dd83015 VB |
234 | .Cd unconfigure |
235 | .Cd system description | |
236 | .Bd -ragged -offset XXXXXX | |
237 | Do not override chassis description and use a value computed from node | |
238 | name, kernel name, kernel version, build date and architecture instead. | |
239 | .Ed | |
240 | ||
8481f490 VB |
241 | .Cd configure |
242 | .Cd system chassisid Ar description | |
243 | .Bd -ragged -offset XXXXXX | |
244 | Override chassis ID with the provided value instead of using MAC address | |
245 | from one interface or host name. | |
246 | .Ed | |
247 | ||
248 | .Cd unconfigure | |
249 | .Cd system chassisid | |
250 | .Bd -ragged -offset XXXXXX | |
6003c0d6 PD |
251 | Do not override chassis ID, but instead use a value computed from one of the interface |
252 | MAC addresses (or host name if none is found). | |
8481f490 VB |
253 | .Ed |
254 | ||
3f70e118 VB |
255 | .Cd configure |
256 | .Cd system platform Ar description | |
257 | .Bd -ragged -offset XXXXXX | |
258 | Override platform description with the provided value instead of using | |
259 | kernel name. This value is currently only used for CDP. | |
260 | .Ed | |
261 | ||
6dd83015 VB |
262 | .Cd unconfigure |
263 | .Cd system platform | |
264 | .Bd -ragged -offset XXXXXX | |
265 | Do not override platform description and use the kernel name. This | |
266 | option undoes the previous one. | |
267 | .Ed | |
268 | ||
4c8e6e37 ISN |
269 | .Cd configure |
270 | .Cd system capabilities enabled Ar capabilities | |
271 | .Bd -ragged -offset XXXXXX | |
272 | Override system capabilities with the provided value instead of using | |
6003c0d6 | 273 | kernel information. Several capabilities can be specified, separated by |
4c8e6e37 ISN |
274 | commas. Only available capabilities can be enabled. Valid capabilities are: |
275 | .Bl -tag -width "XXX." -compact -offset XX | |
c23713a8 PD |
276 | .It Sy bridge |
277 | .It Sy docsis | |
4c8e6e37 ISN |
278 | .It Sy other |
279 | .It Sy repeater | |
4c8e6e37 | 280 | .It Sy router |
4c8e6e37 | 281 | .It Sy station |
c23713a8 PD |
282 | .It Sy telephone |
283 | .It Sy wlan | |
4c8e6e37 ISN |
284 | .El |
285 | Here is an example of use: | |
286 | .D1 configure system capabilities enabled bridge,router | |
287 | .Pp | |
288 | .Ed | |
289 | ||
290 | .Cd unconfigure | |
291 | .Cd system capabilities enabled | |
292 | .Bd -ragged -offset XXXXXX | |
6003c0d6 | 293 | Do not override capabilities, but instead use the kernel information. This option |
4c8e6e37 ISN |
294 | undoes the previous one. |
295 | .Ed | |
296 | ||
f88442ac | 297 | .Cd configure |
48d0a4b0 | 298 | .Cd system interface pattern Ar pattern |
0093777b | 299 | .Bd -ragged -offset XXXXXX |
c23713a8 PD |
300 | Specify as comma separated values (CSV) which interfaces to listen upon and send |
301 | LLDPDU from. Without this option, | |
0093777b | 302 | .Nm lldpd |
5a1f4586 | 303 | will use all available physical interfaces. This option can use |
0093777b | 304 | wildcards. Several interfaces can be specified separated by commas. |
28fb4885 VB |
305 | It is also possible to remove an interface by prefixing it with an |
306 | exclamation mark. It is possible to allow an interface by | |
307 | prefixing it with two exclamation marks. An allowed interface beats | |
6003c0d6 | 308 | a forbidden interface which beats a simple matched interface. For |
3b0273ee | 309 | example, with |
0093777b VB |
310 | .Em eth*,!eth1,!eth2 |
311 | .Nm lldpd | |
6003c0d6 | 312 | will only use interfaces starting with |
0093777b VB |
313 | .Em eth |
314 | with the exception of | |
315 | .Em eth1 | |
316 | and | |
317 | .Em eth2 . | |
3b0273ee VB |
318 | While with |
319 | .Em *,!eth*,!!eth1 | |
320 | .Nm | |
6003c0d6 | 321 | will use all interfaces, except interfaces starting with |
3b0273ee VB |
322 | .Em eth |
323 | with the exception of | |
324 | .Em eth1 . | |
325 | When an exact match is found, it will circumvent some tests. For example, if | |
326 | .Em eth0.12 | |
327 | is specified, it will be accepted even if this is a VLAN interface. | |
0093777b VB |
328 | .Ed |
329 | ||
6dd83015 VB |
330 | .Cd unconfigure |
331 | .Cd system interface pattern | |
332 | .Bd -ragged -offset XXXXXX | |
5a1f4586 | 333 | Remove any previously configured interface pattern and use all |
a6d1d023 | 334 | physical interfaces. This option undoes the previous one. |
6dd83015 VB |
335 | .Ed |
336 | ||
0a78e14f VB |
337 | .Cd configure |
338 | .Cd system interface permanent Ar pattern | |
339 | .Bd -ragged -offset XXXXXX | |
340 | Specify interfaces whose configuration is permanently kept by | |
341 | .Nm lldpd . | |
342 | By default, | |
343 | .Nm lldpd | |
6003c0d6 | 344 | disregards any data about interfaces when they are removed from the |
0a78e14f VB |
345 | system (statistics, custom configuration). This option allows one to |
346 | specify a pattern similar to the interface pattern. If an interface | |
6003c0d6 PD |
347 | disappears but matches the pattern, its data is kept in memory and |
348 | reused if the interface reappears at some point. For example, on Linux, | |
0a78e14f VB |
349 | one could use the pattern |
350 | .Em eth*,eno*,enp* , | |
351 | which should match fixed interfaces on most systems. | |
352 | .Ed | |
353 | ||
354 | .Cd unconfigure | |
355 | .Cd system interface permanent | |
356 | .Bd -ragged -offset XXXXXX | |
357 | Remove any previously configured permanent interface pattern. Any | |
358 | interface removed from the system will be forgotten. This option | |
359 | undoes the previous one. | |
360 | .Ed | |
361 | ||
bb37268d VB |
362 | .Cd configure |
363 | .Cd system interface description | |
364 | .Bd -ragged -offset XXXXXX | |
6003c0d6 | 365 | Some OSes allow the user to set a description for an interface. Setting |
bb37268d VB |
366 | this option will enable |
367 | .Nm lldpd | |
368 | to override this description with the name of the peer neighbor if one | |
369 | is found or with the number of neighbors found. | |
370 | .Ed | |
371 | ||
6dd83015 | 372 | .Cd unconfigure |
b1118c26 | 373 | .Cd system interface description |
6dd83015 VB |
374 | .Bd -ragged -offset XXXXXX |
375 | Do not update interface description with the name of the peer | |
376 | neighbor. This option undoes the previous one. | |
377 | .Ed | |
378 | ||
f84199dd VB |
379 | .Cd configure |
380 | .Cd system interface promiscuous | |
381 | .Bd -ragged -offset XXXXXX | |
0a6f3866 | 382 | Enable promiscuous mode on managed interfaces. |
f84199dd VB |
383 | .Pp |
384 | When the interface is not managed any more (or when quitting | |
1eadc9a1 | 385 | .Nm lldpd ) , |
f84199dd VB |
386 | the interface is left in promiscuous mode as it is difficult to know |
387 | if someone else also put the interface in promiscuous mode. | |
388 | .Pp | |
389 | This option is known to be useful when the remote switch is a Cisco | |
0a6f3866 | 390 | 2960 and the local network card features VLAN hardware |
6003c0d6 PD |
391 | acceleration. In this case, you might not receive LLDP frames from the |
392 | remote switch. The most plausible explanation for this is that the frame is | |
393 | tagged with some VLAN (usually VLAN 1) and your network card filters | |
394 | VLANs. This is not the only available solution to work around | |
0a6f3866 | 395 | this problem. If you are concerned about performance issues, you can |
6003c0d6 | 396 | also tag VLAN 1 on each interface instead. |
0a6f3866 | 397 | .Pp |
6003c0d6 PD |
398 | Currently, this option has no effect on anything other than Linux. On |
399 | other OSes, either disable VLAN acceleration, tag VLAN 1 or enable | |
0a6f3866 | 400 | promiscuous mode manually on the interface. |
f84199dd VB |
401 | .Ed |
402 | ||
403 | .Cd unconfigure | |
404 | .Cd system interface promiscuous | |
405 | .Bd -ragged -offset XXXXXX | |
406 | Do not set promiscuous mode on managed interfaces. This option does | |
407 | not disable promiscuous mode on interfaces already using this mode. | |
408 | .Ed | |
409 | ||
622d14bb VB |
410 | .Cd configure |
411 | .Cd system ip management pattern Ar pattern | |
412 | .Bd -ragged -offset XXXXXX | |
c23713a8 PD |
413 | Specify the management addresses of this system as comma separated values (CSV). |
414 | As for interfaces | |
622d14bb | 415 | (described above), this option can use wildcards and inversions. |
abfea7d0 VB |
416 | Without this option, the first IPv4 and the first IPv6 are used. If an |
417 | exact IP address is provided, it is used as a management address | |
418 | without any check. If only negative patterns are provided, only one | |
6003c0d6 PD |
419 | IPv4 and one IPv6 address are chosen. Otherwise, many of them can be |
420 | selected. To remove IPv6 addresses, use | |
622d14bb | 421 | .Em !*:* . |
68bc4a4d | 422 | If an interface name is matched, the first IPv4 address and the first |
6003c0d6 | 423 | IPv6 address associated with this interface will be chosen. |
622d14bb VB |
424 | .Ed |
425 | ||
6dd83015 VB |
426 | .Cd unconfigure |
427 | .Cd system ip management pattern | |
428 | .Bd -ragged -offset XXXXXX | |
429 | Unset any specific pattern for matching management addresses. This | |
430 | option undoes the previous one. | |
431 | .Ed | |
432 | ||
3106c706 VB |
433 | .Cd configure |
434 | .Cd system bond-slave-src-mac-type Ar value | |
435 | .Bd -ragged -offset XXXXXX | |
436 | Set the type of src mac in lldp frames sent on bond slaves | |
437 | ||
438 | Valid types are: | |
439 | .Bl -tag -width "XXX." -compact -offset XX | |
440 | .It Sy real | |
441 | Slave real mac | |
442 | .It Sy zero | |
443 | All zero mac | |
444 | .It Sy fixed | |
445 | An arbitrary fixed value | |
446 | .Li ( 00:60:08:69:97:ef ) | |
447 | .It Sy local | |
448 | Real mac with locally administered bit set. If the real mac already | |
6003c0d6 | 449 | has the locally administered bit set, fall back to the fixed value. |
3106c706 VB |
450 | .El |
451 | .Pp | |
452 | Default value for | |
453 | .Nm bond-slave-src-mac-type | |
454 | is | |
455 | .Nm local . | |
456 | Some switches may complain when using one of the two other possible | |
457 | values (either because | |
458 | .Li 00:00:00:00:00:00 | |
459 | is not a valid MAC or because the MAC address is flapping from one | |
460 | port to another). Using | |
461 | .Sy local | |
462 | might lead to a duplicate MAC address on the network (but this is | |
463 | quite unlikely). | |
464 | .Ed | |
465 | ||
6e3cb2f5 VB |
466 | .Cd configure |
467 | .Cd system max-neighbors Ar neighbors | |
468 | .Bd -ragged -offset XXXXXX | |
469 | Change the maximum number of neighbors accepted (for each protocol) on | |
470 | an interface. This is a global value. The default is 32. This setting | |
471 | only applies to future neighbors. | |
472 | .Ed | |
473 | ||
1eadc9a1 VB |
474 | .Cd configure |
475 | .Cd lldp agent-type | |
476 | .Cd nearest-bridge | nearest-non-tpmr-bridge | nearest-customer-bridge | |
477 | .Bd -ragged -offset XXXXXX | |
478 | The destination MAC address used to send LLDPDU allows an agent to | |
479 | control the propagation of LLDPDUs. By default, the | |
480 | .Li 01:80:c2:00:00:0e | |
6003c0d6 | 481 | MAC address is used and limits the propagation of the LLDPDU to the |
1eadc9a1 VB |
482 | nearest bridge |
483 | .Cd ( nearest-bridge ) . | |
484 | To instruct | |
485 | .Nm lldpd | |
486 | to use the | |
487 | .Li 01:80:c2:00:00:03 | |
488 | MAC address instead, use | |
489 | .Cd nearest-nontpmr-bridge | |
490 | instead. | |
491 | To use the | |
492 | .Li 01:80:c2:00:00:00 | |
493 | MAC address instead, use | |
494 | .Cd nearest-customer-bridge | |
495 | instead. | |
496 | .Ed | |
497 | ||
0dc7a4a9 VB |
498 | .Cd configure |
499 | .Cd lldp capabilities-advertisements | |
500 | .Pp | |
501 | .Cd unconfigure | |
502 | .Cd lldp capabilities-advertisements | |
503 | .Bd -ragged -offset XXXXXX | |
504 | Enable or disable advertisements of the chassis capabilities TLV. | |
505 | .Ed | |
506 | ||
507 | .Cd configure | |
508 | .Cd lldp management-addresses-advertisements | |
509 | .Pp | |
510 | .Cd unconfigure | |
511 | .Cd lldp management-addresses-advertisements | |
512 | .Bd -ragged -offset XXXXXX | |
513 | Enable or disable advertisements of the management address TLV. | |
514 | .Ed | |
515 | ||
bef085b8 | 516 | .Cd configure |
4edc4960 | 517 | .Cd lldp portidsubtype |
b3dd61af VB |
518 | .Cd ifname | macaddress |
519 | .Pp | |
520 | .Cd configure | |
521 | .Op ports Ar ethX Op ,... | |
522 | .Cd lldp portidsubtype | |
dc9869ef | 523 | .Cd local Ar value |
bef085b8 VB |
524 | .Bd -ragged -offset XXXXXX |
525 | Force port ID subtype. By default, | |
1eadc9a1 | 526 | .Nm lldpd |
bef085b8 VB |
527 | will use the MAC address as port identifier and the interface name as |
528 | port description, unless the interface has an alias. In this case, the | |
529 | interface name will be used as port identifier and the description | |
530 | will be the interface alias. With this command, you can force the port | |
531 | identifier to be the interface name (with | |
50a978dc VB |
532 | .Cd ifname ) , |
533 | the MAC address (with | |
534 | .Cd macaddress ) | |
535 | or a local value (with | |
536 | .Cd value ) . | |
537 | In the latest case, the local value should be provided. | |
bef085b8 VB |
538 | .Ed |
539 | ||
3d96ef66 JJ |
540 | .Cd configure |
541 | .Op ports Ar ethX Op ,... | |
542 | .Cd lldp portdescription | |
543 | .Cd Ar description | |
544 | .Bd -ragged -offset XXXXXX | |
545 | Force port description to the provided string. | |
546 | .Ed | |
547 | ||
48d0a4b0 VB |
548 | .Cd configure |
549 | .Cd lldp tx-interval Ar interval | |
550 | .Bd -ragged -offset XXXXXX | |
551 | Change transmit delay to the specified value in seconds. The transmit | |
552 | delay is the delay between two transmissions of LLDP PDU. The default | |
3ae837fd ST |
553 | value is 30 seconds. Note: |
554 | .Nm lldpd | |
555 | also starts another system based refresh timer on each port to detect | |
556 | changes such as a hostname. This is the value of the tx-interval | |
557 | multiplied by 20. | |
6ef305d5 JPT |
558 | .Pp |
559 | You can specify an | |
560 | .Cd interval | |
561 | value in milliseconds by appending a "ms" suffix to the figure (e.g. | |
562 | "configure lldp tx-interval 1500ms" is 1.5s, not 1500s). In this case | |
563 | the TTL for received and sent LLDP frames is rounded up to the next | |
564 | second. Note: the effective interval can be limited by the operating | |
565 | system capabilities and CPU speed. | |
48d0a4b0 VB |
566 | .Ed |
567 | ||
568 | .Cd configure | |
569 | .Cd lldp tx-hold Ar hold | |
570 | .Bd -ragged -offset XXXXXX | |
571 | Change transmit hold value to the specified value. This value is used | |
572 | to compute the TTL of transmitted packets which is the product of this | |
573 | value and of the transmit delay. The default value is 4 and therefore | |
574 | the default TTL is 120 seconds. | |
575 | .Ed | |
576 | ||
e7331ce9 VB |
577 | .Cd configure |
578 | .Op ports Ar ethX Op ,... | |
579 | .Cd lldp | |
580 | .Cd status Ar rx-and-tx | rx-only | tx-only | disabled | |
581 | .Bd -ragged -offset XXXXXX | |
582 | Configure the administrative status of the given port. By default, all | |
583 | ports are configured to be in | |
6934b73d | 584 | .Ar rx-and-tx |
e7331ce9 VB |
585 | mode. This means they can receive and transmit LLDP frames (as well as |
586 | other protocols if needed). In | |
6934b73d | 587 | .Ar rx-only |
e7331ce9 | 588 | mode, they won't emit any frames and in |
6934b73d | 589 | .Ar tx-only |
e7331ce9 VB |
590 | mode, they won't receive any frames. In |
591 | .Ar disabled | |
592 | mode, no frame will be sent and any incoming frame will be | |
a6d1d023 | 593 | discarded. This setting does not override the operational mode of the |
e7331ce9 VB |
594 | main daemon. If it is configured in receive-only mode (with the |
595 | .Fl r | |
596 | flag), setting any transmit mode won't have any effect. | |
597 | .Ed | |
598 | ||
1e85286a MW |
599 | .Cd configure |
600 | .Op ports Ar ethX Op ,... | |
601 | .Cd lldp | |
602 | .Cd vlan-tx Ar vlan_id | |
603 | .Op Cd prio Ar priority Op Cd dei Ar dei | |
604 | .Bd -ragged -offset XXXXXX | |
605 | Configure the given port to send LLDP frames over a specified VLAN. With VLAN Identifier (VID) as | |
606 | .Ar vlan_id , | |
607 | Priority Code Point (PCP) as | |
608 | .Ar priority , | |
609 | and Drop Eligible Indicator (DEI) as | |
610 | .Ar dei . | |
611 | .Nm lldpd | |
612 | accepts LLDP frames on all VLANs. | |
613 | .Ed | |
614 | ||
24133f55 | 615 | .Cd configure |
4755f186 | 616 | .Op ports Ar ethX Op ,... |
7c26c8b4 | 617 | .Cd lldp custom-tlv |
618 | .Op Cd add | replace | |
619 | .Cd oui Ar oui | |
24133f55 VB |
620 | .Cd subtype Ar subtype |
621 | .Op Cd oui-info Ar content | |
622 | .Bd -ragged -offset XXXXXX | |
623 | Emit a custom TLV for OUI | |
624 | .Ar oui , | |
625 | with subtype | |
626 | .Ar subtype | |
7c26c8b4 | 627 | and optionally with the bytes specified in |
24133f55 VB |
628 | .Ar content . |
629 | Both | |
630 | .Ar oui | |
631 | and | |
632 | .Ar content | |
dd6277f9 | 633 | shall be a comma-separated list of bytes in hex format. |
24133f55 | 634 | .Ar oui |
6003c0d6 | 635 | must be exactly 3 bytes long. |
7c26c8b4 | 636 | If |
637 | .Ar add | |
638 | is specified then the TLV will be added. This is the default action. | |
639 | If | |
92a6d7f9 | 640 | .Ar replace |
7c26c8b4 | 641 | is specified then all TLVs with the same |
642 | .Ar oui | |
643 | and | |
644 | .Ar subtype | |
645 | will be replaced. | |
646 | ||
24133f55 VB |
647 | .Ed |
648 | ||
649 | .Cd unconfigure | |
4755f186 | 650 | .Op ports Ar ethX Op ,... |
24133f55 | 651 | .Cd lldp custom-tlv |
7c26c8b4 | 652 | .Op Cd oui Ar oui |
653 | .Op Cd subtype Ar subtype | |
24133f55 | 654 | .Bd -ragged -offset XXXXXX |
7c26c8b4 | 655 | When no oui is specified, remove all previously configured custom TLV. |
656 | When OUI | |
657 | .Ar oui | |
658 | and subtype | |
659 | .Ar subtype | |
660 | is specified, remove specific instances of custom TLV. | |
24133f55 VB |
661 | .Ed |
662 | ||
486a6133 VB |
663 | .Cd configure med fast-start |
664 | .Cd enable | tx-interval Ar interval | |
665 | .Bd -ragged -offset XXXXXX | |
666 | Configure LLDP-MED fast start mechanism. When a new LLDP-MED-enabled | |
667 | neighbor is detected, fast start allows | |
668 | .Nm lldpd | |
669 | to shorten the interval between two LLDPDU. | |
670 | .Cd enable | |
671 | should enable LLDP-MED fast start while | |
672 | .Cd tx-interval | |
673 | specifies the interval between two LLDPDU in seconds. The default | |
674 | interval is 1 second. Once 4 LLDPDU have been sent, the fast start | |
675 | mechanism is disabled until a new neighbor is detected. | |
676 | .Ed | |
677 | ||
678 | .Cd unconfigure med fast-start | |
679 | .Bd -ragged -offset XXXXXX | |
680 | Disable LLDP-MED fast start mechanism. | |
681 | .Ed | |
682 | ||
fe80711e | 683 | .Cd configure |
97772619 | 684 | .Op ports Ar ethX Op ,... |
fe80711e VB |
685 | .Cd med location coordinate |
686 | .Cd latitude Ar latitude | |
687 | .Cd longitude Ar longitude | |
688 | .Cd altitude Ar altitude Ar unit | |
689 | .Cd datum Ar datum | |
690 | .Bd -ragged -offset XXXXXX | |
691 | Advertise a coordinate based location on the given ports (or on all | |
692 | ports if no port is specified). The format of | |
693 | .Ar latitude | |
694 | is a decimal floating point number followed either by | |
695 | .Em N | |
696 | or | |
697 | .Em S . | |
698 | The format of | |
699 | .Ar longitude | |
700 | is a decimal floating point number followed either by | |
701 | .Em E | |
702 | or | |
703 | .Em W . | |
704 | .Ar altitude | |
705 | is a decimal floating point number followed either by | |
706 | .Em m | |
707 | when expressed in meters or | |
708 | .Em f | |
3fc1a10a VB |
709 | when expressed in floors. A space is expected between the floating |
710 | point number and the unit. | |
fe80711e VB |
711 | .Ar datum |
712 | is one of those values: | |
713 | .Bl -bullet -compact -offset XXXXXXXX | |
714 | .It | |
715 | WGS84 | |
716 | .It | |
717 | NAD83 | |
718 | .It | |
719 | NAD83/MLLW | |
720 | .El | |
721 | .Pp | |
722 | A valid use of this command is: | |
3fc1a10a | 723 | .D1 configure ports eth0 med location coordinate latitude 48.85667N longitude 2.2014E altitude 117.47 m datum WGS84 |
fe80711e VB |
724 | .Ed |
725 | ||
726 | .Cd configure | |
97772619 | 727 | .Op ports Ar ethX Op ,... |
fe80711e VB |
728 | .Cd med location address |
729 | .Cd country Ar country | |
730 | .Cd Op Ar type value Op ... | |
731 | .Bd -ragged -offset XXXXXX | |
732 | Advertise a civic address on the given ports (or on all ports if no | |
733 | port is specified). | |
734 | .Ar country | |
735 | is the two-letter code representing the country. The remaining | |
736 | arguments should be paired to form the address. The first member of | |
737 | each pair indicates the type of the second member which is a free-form | |
738 | text. Here is the list of valid types: | |
739 | .Bl -bullet -compact -offset XXXXXXXX | |
740 | .It | |
741 | language | |
742 | .It | |
743 | country-subdivision | |
744 | .It | |
745 | county | |
746 | .It | |
747 | city | |
748 | .It | |
749 | city-division | |
750 | .It | |
751 | block | |
752 | .It | |
753 | street | |
754 | .It | |
755 | direction | |
756 | .It | |
757 | trailing-street-suffix | |
758 | .It | |
759 | street-suffix | |
760 | .It | |
761 | number | |
762 | .It | |
763 | number-suffix | |
764 | .It | |
765 | landmark | |
766 | .It | |
767 | additional | |
768 | .It | |
769 | name | |
770 | .It | |
771 | zip | |
772 | .It | |
773 | building | |
774 | .It | |
775 | unit | |
776 | .It | |
777 | floor | |
778 | .It | |
779 | room | |
780 | .It | |
781 | place-type | |
782 | .It | |
783 | script | |
784 | .El | |
785 | .Pp | |
786 | A valid use of this command is: | |
120c071a | 787 | .D1 configure ports eth1 med location address country US street Qo Commercial Road Qc city Qo Roseville Qc |
fe80711e VB |
788 | .Ed |
789 | ||
790 | .Cd configure | |
97772619 | 791 | .Op ports Ar ethX Op ,... |
fe80711e VB |
792 | .Cd med location elin |
793 | .Ar number | |
794 | .Bd -ragged -offset XXXXXX | |
795 | Advertise the availability of an ELIN number. This is used for setting | |
6003c0d6 | 796 | up emergency calls. If the provided number is too small, it will be |
fe80711e VB |
797 | padded with 0. Here is an example of use: |
798 | .D1 configure ports eth2 med location elin 911 | |
799 | .Ed | |
800 | ||
801 | .Cd configure | |
97772619 | 802 | .Op ports Ar ethX Op ,... |
fe80711e VB |
803 | .Cd med policy |
804 | .Cd application Ar application | |
805 | .Op Cd unknown | |
17e55ef9 | 806 | .Op Cd tagged |
fe80711e VB |
807 | .Op Cd vlan Ar vlan |
808 | .Op Cd priority Ar priority | |
809 | .Op Cd dscp Ar dscp | |
810 | .Bd -ragged -offset XXXXXX | |
811 | Advertise a specific network policy for the given ports (or for all | |
812 | ports if no port was provided). Only the application type is | |
813 | mandatory. | |
814 | .Ar application | |
815 | should be one of the following values: | |
fe80711e VB |
816 | .Bl -bullet -compact -offset XXXXXXXX |
817 | .It | |
818 | voice | |
819 | .It | |
820 | voice-signaling | |
821 | .It | |
822 | guest-voice | |
823 | .It | |
824 | guest-voice-signaling | |
825 | .It | |
826 | softphone-voice | |
827 | .It | |
828 | video-conferencing | |
829 | .It | |
830 | streaming-video | |
831 | .It | |
832 | video-signaling | |
833 | .El | |
834 | .Pp | |
835 | The | |
836 | .Cd unknown | |
837 | flag tells that the network policy for the specified application type | |
838 | is required by the device but is currently unknown. This is used by | |
839 | Endpoint Devices, not by Network Connectivity Devices. If not | |
840 | specified, the network policy for the given application type is | |
841 | defined. | |
842 | .Pp | |
6003c0d6 | 843 | A VLAN specified with |
e7f83dc0 | 844 | .Ar vlan |
fe80711e VB |
845 | tells which 802.1q VLAN ID has to be advertised for the network |
846 | policy. A valid value is between 1 and 4094. | |
17e55ef9 | 847 | .Cd tagged |
6003c0d6 | 848 | tells that the VLAN should be tagged for the specified application type. |
e7f83dc0 VB |
849 | .Pp |
850 | .Ar priority | |
fe80711e VB |
851 | allows one to specify IEEE 802.1d / IEEE 802.1p Layer 2 Priority, also |
852 | known as Class of Service (CoS), to be used for the specified | |
17e55ef9 | 853 | application type. This field is usually ignored if no VLAN is |
e7f83dc0 VB |
854 | specified. The names match 802.1D-2004 standard (table G-2). Some more |
855 | recent standards may use different labels. Only the numeric values | |
856 | should be relied upon. The accepted labels are: | |
857 | .Bl -tag -width "X." -compact -offset XXXX | |
858 | .It Sy 1 | |
fe80711e | 859 | background |
e7f83dc0 | 860 | .It Sy 0 |
fe80711e | 861 | best-effort |
c56e4067 | 862 | .It Sy 2 |
fe80711e | 863 | excellent-effort |
c56e4067 VB |
864 | .It Sy 3 |
865 | critical-applications | |
e7f83dc0 | 866 | .It Sy 4 |
fe80711e | 867 | video |
c56e4067 | 868 | .It Sy 5 |
fe80711e | 869 | voice |
c56e4067 VB |
870 | .It Sy 6 |
871 | internetwork-control | |
e7f83dc0 | 872 | .It Sy 7 |
fe80711e VB |
873 | network-control |
874 | .El | |
875 | .Pp | |
876 | .Ar dscp | |
877 | represents the DSCP value to be advertised for the given network | |
878 | policy. DiffServ/Differentiated Services Code Point (DSCP) value as | |
879 | defined in IETF RFC 2474 for the specified application type. Value: 0 | |
880 | (default per RFC 2475) through 63. Note: The class selector DSCP | |
881 | values are backwards compatible for devices that only support the old | |
882 | IP precedence Type of Service (ToS) format. (See the RFCs for what | |
883 | these values mean) | |
884 | .Pp | |
885 | A valid use of this command is: | |
886 | .D1 configure med policy application voice vlan 500 priority voice dscp 46 | |
887 | .Ed | |
888 | ||
f1808b3b HG |
889 | .Cd configure |
890 | .Cd inventory hardware-revision Ar value | |
891 | .Bd -ragged -offset XXXXXX | |
892 | Override hardware-revision with the provided value. By default, the | |
893 | hardware-revision is fetched from /sys/class/dmi | |
894 | .Ed | |
895 | ||
896 | .Cd unconfigure | |
897 | .Cd inventory hardware-revision | |
898 | .Bd -ragged -offset XXXXXX | |
899 | Do not override hardware-revision and restore the use of the /sys/class/dmi value. | |
900 | .Ed | |
901 | ||
902 | .Cd configure | |
903 | .Cd inventory software-revision Ar value | |
904 | .Bd -ragged -offset XXXXXX | |
905 | Override software-revision with the provided value. By default, the | |
906 | software-revision is fetched from uname | |
907 | .Ed | |
908 | ||
909 | .Cd unconfigure | |
910 | .Cd inventory software-revision | |
911 | .Bd -ragged -offset XXXXXX | |
912 | Do not override software-revision and restore the use of the uname value. | |
913 | .Ed | |
914 | ||
915 | .Cd configure | |
916 | .Cd inventory firmware-revision Ar value | |
917 | .Bd -ragged -offset XXXXXX | |
918 | Override firmware-revision with the provided value. By default, the | |
919 | firmware-revision is fetched from /sys/class/dmi | |
920 | .Ed | |
921 | ||
922 | .Cd unconfigure | |
923 | .Cd inventory firmware-revision | |
924 | .Bd -ragged -offset XXXXXX | |
925 | Do not override firmware-revision and restore the use of the /sys/class/dmi value. | |
926 | .Ed | |
927 | ||
928 | .Cd configure | |
929 | .Cd inventory serial-number Ar value | |
930 | .Bd -ragged -offset XXXXXX | |
931 | Override serial-number with the provided value. By default, the | |
932 | serial-number is fetched from /sys/class/dmi | |
933 | .Ed | |
934 | ||
935 | .Cd unconfigure | |
936 | .Cd inventory serial-number | |
937 | .Bd -ragged -offset XXXXXX | |
938 | Do not override serial-number and restore the use of the /sys/class/dmi value. | |
939 | .Ed | |
940 | ||
941 | .Cd configure | |
942 | .Cd inventory manufacturer Ar value | |
943 | .Bd -ragged -offset XXXXXX | |
944 | Override manufacturer with the provided value. By default, the | |
945 | manufacturer is fetched from /sys/class/dmi | |
946 | .Ed | |
947 | ||
948 | .Cd unconfigure | |
949 | .Cd inventory manufacturer | |
950 | .Bd -ragged -offset XXXXXX | |
951 | Do not override manufacturer and restore the use of the /sys/class/dmi value. | |
952 | .Ed | |
953 | ||
954 | .Cd configure | |
955 | .Cd inventory model Ar value | |
956 | .Bd -ragged -offset XXXXXX | |
957 | Override model with the provided value. By default, the | |
958 | model is fetched from /sys/class/dmi | |
959 | .Ed | |
960 | ||
961 | .Cd unconfigure | |
962 | .Cd inventory model | |
963 | .Bd -ragged -offset XXXXXX | |
964 | Do not override model and restore the use of the /sys/class/dmi value. | |
965 | .Ed | |
966 | ||
967 | .Cd configure | |
968 | .Cd inventory asset Ar value | |
969 | .Bd -ragged -offset XXXXXX | |
970 | Override asset with the provided value. By default, the | |
971 | asset is fetched from /sys/class/dmi | |
972 | .Ed | |
973 | ||
974 | .Cd unconfigure | |
975 | .Cd inventory asset | |
976 | .Bd -ragged -offset XXXXXX | |
977 | Do not override asset and restore the use of the /sys/class/dmi value. | |
978 | .Ed | |
979 | ||
fe80711e | 980 | .Cd configure |
97772619 | 981 | .Op ports Ar ethX Op ,... |
fe80711e VB |
982 | .Cd med power pse | pd |
983 | .Cd source Ar source | |
984 | .Cd priority Ar priority | |
985 | .Cd value Ar value | |
986 | .Bd -ragged -offset XXXXXX | |
987 | Advertise the LLDP-MED POE-MDI TLV for the given ports or for all | |
988 | interfaces if no port is provided. One can act as a PD (power | |
989 | consumer) or a PSE (power provider). No check is done on the validity | |
990 | of the parameters while LLDP-MED requires some restrictions: | |
991 | .Bl -bullet | |
992 | .It | |
993 | PD shall never request more power than physical 802.3af class. | |
994 | .It | |
995 | PD shall never draw more than the maximum power advertised by PSE. | |
996 | .It | |
997 | PSE shall not reduce power allocated to PD when this power is in use. | |
998 | .It | |
999 | PSE may request reduced power using conservation mode | |
1000 | .It | |
b1118c26 | 1001 | Being PSE or PD is a global parameter, not a per-port parameter. |
fe80711e VB |
1002 | .Nm |
1003 | does not enforce this: a port can be set as PD or PSE. LLDP-MED also | |
6003c0d6 | 1004 | requires a PSE to have only one power source (primary or |
fe80711e VB |
1005 | backup). Again, |
1006 | .Nm | |
1007 | does not enforce this. Each port can have its own power source. The | |
1008 | same applies for PD and power priority. LLDP-MED MIB does not allow | |
1009 | this kind of representation. | |
1010 | .El | |
1011 | .Pp | |
1012 | Valid types are: | |
1013 | .Bl -tag -width "XXX." -compact -offset XX | |
1014 | .It Sy pse | |
1015 | Power Sourcing Entity (power provider) | |
1016 | .It Sy pd | |
1017 | Power Device (power consumer) | |
1018 | .El | |
1019 | .Pp | |
1020 | Valid sources are: | |
1021 | .Bl -tag -width "XXXXXXX" -compact -offset XX | |
1022 | .It Sy unknown | |
1023 | Unknown | |
1024 | .It Sy primary | |
1025 | For PSE, the power source is the primary power source. | |
1026 | .It Sy backup | |
6003c0d6 PD |
1027 | For PSE, the power source is the backup power source, or a power |
1028 | conservation mode is requested (the PSE may be running on UPS for | |
fe80711e VB |
1029 | example). |
1030 | .It Sy pse | |
1031 | For PD, the power source is the PSE. | |
1032 | .It Sy local | |
1033 | For PD, the power source is a local source. | |
1034 | .It Sy both | |
1035 | For PD, the power source is both the PSE and a local source. | |
1036 | .El | |
1037 | .Pp | |
1038 | Valid priorities are: | |
1039 | .Bl -tag -width "XXXXXXXXX" -compact -offset XX | |
1040 | .It Sy unknown | |
1041 | Unknown priority | |
1042 | .It Sy critical | |
1043 | Critical | |
1044 | .It Sy high | |
1045 | High | |
1046 | .It Sy low | |
1047 | Low | |
1048 | .El | |
1049 | .Pp | |
1050 | .Ar value | |
1051 | should be the total power in milliwatts required by the PD device or | |
1052 | available by the PSE device. | |
1053 | .Pp | |
1054 | Here is an example of use: | |
1055 | .D1 configure med power pd source pse priority high value 5000 | |
1056 | .Ed | |
1057 | ||
1058 | .Cd configure | |
97772619 | 1059 | .Op ports Ar ethX Op ,... |
fe80711e VB |
1060 | .Cd dot3 power pse | pd |
1061 | .Op Cd supported | |
1062 | .Op Cd enabled | |
1063 | .Op Cd paircontrol | |
0e05b829 | 1064 | .Cd powerpairs Ar powerpairs |
fe80711e VB |
1065 | .Op Cd class Ar class |
1066 | .Op Cd type Ar type Cd source Ar source Cd priority Ar priority Cd requested Ar requested Cd allocated Ar allocated | |
1067 | .Bd -ragged -offset XXXXXX | |
1068 | Advertise Dot3 POE-MDI TLV for the given port or for all ports if none | |
1069 | was provided. One can act as a PD (power consumer) or a PSE (power | |
6003c0d6 | 1070 | provider). This configuration is distinct from the configuration of the |
fe80711e VB |
1071 | transmission of the LLDP-MED POE-MDI TLV but the user should ensure |
1072 | the coherency of those two configurations if they are used together. | |
1073 | .Pp | |
1074 | .Ar supported | |
1075 | means that MDI power is supported on the given port while | |
1076 | .Ar enabled | |
1077 | means that MDI power is enabled. | |
1078 | .Ar paircontrol | |
6003c0d6 | 1079 | is used to indicate whether pair selection can be controlled. Valid values |
a6d1d023 | 1080 | for |
fe80711e VB |
1081 | .Ar powerpairs |
1082 | are: | |
1083 | .Bl -tag -width "XXXXXX" -compact -offset XX | |
1084 | .It Sy signal | |
1085 | The signal pairs only are in use. | |
1086 | .It Sy spare | |
1087 | The spare pairs only are in use. | |
1088 | .El | |
1089 | .Pp | |
1090 | When specified, | |
1091 | .Ar class | |
1092 | is a number between 0 and 4. | |
1093 | .Pp | |
1094 | The remaining parameters are in conformance with 802.3at and are optional. | |
1095 | .Ar type | |
6003c0d6 | 1096 | should be either 1 or 2, indicating whether the device conforms to |
5d0938c0 | 1097 | 802.3at type 1 or 802.3at type 2. Values of |
fe80711e VB |
1098 | .Ar source |
1099 | and | |
1100 | .Ar priority | |
1101 | are the same as for LLDP-MED POE-MDI TLV. | |
1102 | .Ar requested | |
1103 | and | |
1104 | .Ar allocated | |
1105 | are expressed in milliwats. | |
1106 | .Pp | |
1107 | Here are two valid uses of this command: | |
26498cf4 VB |
1108 | .D1 configure ports eth3 dot3 power pse supported enabled paircontrol powerpairs spare class class-3 |
1109 | .D1 configure dot3 power pd supported enabled powerpairs spare class class-3 type 1 source pse priority low requested 10000 allocated 15000 | |
fe80711e VB |
1110 | .Ed |
1111 | ||
e4ff3ed5 VB |
1112 | .Cd pause |
1113 | .Bd -ragged -offset XXXXXX | |
1114 | Pause | |
1115 | .Nm lldpd | |
1116 | operations. | |
1117 | .Nm lldpd | |
6003c0d6 | 1118 | will not send or receive any more frames. This can be undone with |
e4ff3ed5 | 1119 | .Cd resume |
e1ae41d0 VB |
1120 | command. This only works interactively as lldpd asks lldpcli to |
1121 | unpause after reading the configuration file. | |
e4ff3ed5 VB |
1122 | .Ed |
1123 | ||
1124 | .Cd resume | |
1125 | .Bd -ragged -offset XXXXXX | |
1126 | Resume | |
1127 | .Nm lldpd | |
1128 | operations. | |
1129 | .Nm lldpd | |
1130 | will start to send and receive frames. This command is issued | |
6003c0d6 | 1131 | internally after processing the configuration but can be used at any time |
e4ff3ed5 VB |
1132 | if a manual |
1133 | .Cd pause | |
1134 | command is issued. | |
1135 | .Ed | |
1136 | ||
fe80711e VB |
1137 | .Ed |
1138 | .Sh FILES | |
2cbc9cc5 VB |
1139 | .Bl -tag -width "@LLDPD_CTL_SOCKET@XX" -compact |
1140 | .It @LLDPD_CTL_SOCKET@ | |
fe80711e VB |
1141 | Unix-domain socket used for communication with |
1142 | .Xr lldpd 8 . | |
1143 | .El | |
1144 | .Sh SEE ALSO | |
1145 | .Xr lldpd 8 | |
1146 | .Sh AUTHORS | |
1147 | .An -nosplit | |
1148 | The | |
1149 | .Nm | |
1150 | program was written by | |
1151 | .An Vincent Bernat Aq bernat@luffy.cx . |