| LLDPCLI(8) | System Manager's Manual | LLDPCLI(8) |
نام (NAME)
lldpcli, lldpctl
— کنترل
دیمن LLDP
خلاصه دستور (SYNOPSIS)
lldpcli [-dv]
[-u socket]
[-f format]
[-c file]
[command ...] lldpctl
[-dv] [-u
socket] [-f
format] [interfaces ...]
توضیحات (DESCRIPTION)
برنامه
lldpcli دیمن
lldpd(8) را
کنترل
میکند.
هنگامی که
هیچ دستوری
مشخص نشود،
lldpcli یک شل
تعاملی را
آغاز
میکند که
میتوان از
آن برای
وارد کردن
دستورات
دلخواه
همانند
زمانی که در
خط فرمان
مشخص
میشوند
استفاده
کرد. این شل
تعاملی
باید از
قابلیت
تکمیل
خودکار و
تاریخچه
دستورات
پشتیبانی
کند.
گزینهها به شرح زیر هستند:
-d- فعالسازی اطلاعات اشکالزدایی بیشتر. این فلگ میتواند تکرار شود.
-usocket- مشخص کردن سوکت دامنه یونیکس مورد استفاده برای ارتباط با lldpd(8).
-v- نمایش نسخه
lldpcli. در صورت تکرار، اطلاعات ساخت بیشتری را نمایش میدهد. -fformat- انتخاب قالب خروجی. در حال حاضر قالبهای plain, xml, json, json0 و keyvalue در دسترس هستند. حالت پیشفرض plain است. قالب json0 نسبت به json پرجزئیاتتر است، اما ساختار شیء JSON تحت تأثیر تعداد رابطها یا همسایگان قرار نمیگیرد؛ بنابراین تجزیه آن آسانتر است.
-cfile- خواندن
فایل
پیکربندی
دادهشده.
این گزینه
میتواند
چندین بار
تکرار شود.
اگر یک
دایرکتوری
مشخص شود،
هر فایل
درون آن که
دارای
پسوند
.confباشد خوانده خواهد شد. ترتیب خواندن بر اساس الفبا است.
هنگامی که
به صورت
lldpctl
فراخوانی
شود، lldpcli
اطلاعات
تفصیلی
درباره هر
همسایه را
روی
رابطهای
مشخصشده
یا در صورت
عدم تعیین،
روی تمام
رابطها
نمایش
میدهد. این
دستور
بیشتر جهت
سازگاری رو
به عقب با
نسخههای
قدیمیتر
حفظ شده
است.
دستورات
زیر توسط
lldpcli
پشتیبانی
میشوند.
هنگامی که
ابهامی
وجود
نداشته
باشد،
کلیدواژهها
را میتوان
به صورت
اختصاری
نوشت. برای
نمونه، show
neighbors ports eth0 summary و sh neigh p
eth0 sum یک دستور
یکسان
هستند.
exit
lldpcli.help [...]
lldpcli
بدون
پشتیبانی
از readline
کامپایل
شده باشد،
تکمیل
خودکار و
راهنمای
درونخطی
ممکن است در
دسترس
نباشند،
اما دستور
help همیشه
در دسترس
است.show neighbors [ports
ethX [,...]] [details |
summary] [hidden]
summary ، تنها
نام و
توضیحات
پورت هر
میزبان راه
دور نمایش
داده خواهد
شد. از سوی
دیگر، با
details ، تمام
اطلاعات
موجود
نمایش داده
شده و نمایی
با جزئیات
کامل ارائه
میشود.
هنگام
استفاده از
hidden ،
پورتهای
راه دور که
توسط
پالایه
هوشمند
پنهان
شدهاند
نیز نمایش
داده
میشوند. در
صورت مشخص
کردن یک یا
چند پورت،
اطلاعات
نمایشدادهشده
به فهرست
پورتهای
ارائهشده
محدود
میشود.show interfaces [ports
ethX [,...]] [details |
summary] [hidden]
summary ، تنها
نام و
توضیحات
پورت هر
رابط محلی
نمایش داده
خواهد شد. از
سوی دیگر،
با details ،
تمام
اطلاعات
موجود
نمایش داده
شده و نمایی
با جزئیات
کامل ارائه
میشود.
هنگام
استفاده از
hidden ،
پورتهای
محلی که
توسط
پالایه
هوشمند
پنهان
شدهاند
نیز نمایش
داده
میشوند. در
صورت مشخص
کردن یک یا
چند پورت،
اطلاعات
نمایشدادهشده
به فهرست
پورتهای
ارائهشده
محدود
میشود.show chassis
[details | summary]
summary ،
بیشتر
جزئیات
نادیده
گرفته
میشوند. از
سوی دیگر،
با details ،
تمام
اطلاعات
موجود
نمایش داده
شده و نمایی
با جزئیات
کامل ارائه
میشود.watch [ports ethX
[,...]] [details | summary]
[hidden] [limit
X]
hidden
، summary و details
معنای
مشابهی با
آنچه
پیشتر
توضیح داده
شد دارند.
اگر limit
مشخص شود،
lldpcli پس از
دریافت
تعداد
رویدادهای
تعیینشده
خارج خواهد
شد.show configuration
show statistics [ports
ethX [,...]] [summary]
summary آمار
هر پورت جمع
زده
میشود.update
configure system
hostname name
uname
-n است. به
عنوان یک
مقدار
ویژه، از "."
(نقطه) برای
استفاده از
نام میزبان
کوتاه به
جای FQDN
استفاده
کنید.unconfigure system
hostname
configure system
description description
unconfigure system
description
configure system
chassisid description
unconfigure system
chassisid
configure system
platform description
unconfigure system
platform
configure system
capabilities enabled capabilities
unconfigure system
capabilities enabled
configure system
interface pattern pattern
lldpd
از تمام
رابطهای
فیزیکی
موجود
استفاده
خواهد کرد.
این گزینه
میتواند
از
نویسههای
عام
استفاده
کند. چندین
رابط را
میتوان با
ویرگول جدا
کرده و
تعیین کرد.
همچنین
میتوان با
افزودن
علامت تعجب
در ابتدای
نام یک
رابط، آن را
حذف کرد.
میتوان با
قرار دادن
دو علامت
تعجب در
ابتدای نام
یک رابط، آن
را مجاز کرد.
یک رابط
مجاز بر
رابط ممنوع
ارجحیت
دارد و رابط
ممنوع بر یک
تطابق ساده
ارجح است.
برای
نمونه، با
eth*,!eth1,!eth2
برنامه lldpd
تنها از
رابطهایی
استفاده
میکند که
با eth شروع
میشوند،
به استثنای
eth1 و
eth2.
در حالی که
با
*,!eth*,!!eth1
برنامه
lldpcli از
تمام
رابطها
استفاده
میکند، به
جز
رابطهایی
که با eth
شروع
میشوند،
به استثنای
eth1. هنگامی
که یک تطابق
دقیق یافت
شود، برخی
آزمونها
نادیده
گرفته
میشوند.
برای
نمونه، اگر
eth0.12
مشخص شود،
حتی در
صورتی که یک
رابط VLAN باشد
نیز
پذیرفته
خواهد شد.unconfigure system
interface pattern
configure system
interface permanent pattern
lldpd
نگهداری
میشود. به
طور
پیشفرض،
lldpd هنگامی
که رابطها
از سیستم
حذف
میشوند،
هرگونه
داده مربوط
به آنها را
نادیده
میگیرد
(آمارها،
پیکربندیهای
سفارشی). این
گزینه به
کاربر
اجازه
میدهد
الگویی
مشابه
الگوی رابط
تعیین کند.
اگر رابطی
ناپدید شود
اما با الگو
مطابقت
داشته
باشد،
دادههای
آن در حافظه
حفظ شده و در
صورتی که
رابط
مجدداً
ظاهر شود
مورد
استفاده
قرار
میگیرد.
برای
نمونه، در
لینوکس
میتوان از
الگوی
eth*,eno*,enp*
استفاده
کرد که باید
با
رابطهای
ثابت در
اکثر
سیستمها
مطابقت
داشته
باشد.unconfigure system
interface permanent
configure system
interface description
lldpd
امکان
میدهد این
توضیحات را
با نام
همسایه
متناظر (در
صورت یافتن)
یا با تعداد
همسایگان
یافتهشده
بازنویسی و
جایگزین
کند.unconfigure system
interface description
configure system
interface promiscuous
هنگامی که
رابط دیگر
مدیریت
نمیشود (یا
هنگام خروج
از lldpd)
، رابط
در حالت
بیقید رها
میشود؛
زیرا تشخیص
اینکه آیا
برنامه
دیگری نیز
رابط را در
حالت
بیقید
قرار داده
دشوار است.
این گزینه زمانی مفید است که سوییچ راه دور یک Cisco 2960 بوده و کارت شبکه محلی دارای شتابدهنده سختافزاری VLAN باشد. در این حالت، ممکن است فریمهای LLDP را از سوییچ راه دور دریافت نکنید. محتملترین دلیل برای این مسئله آن است که فریم با یک VLAN برچسبگذاری شده (معمولاً VLAN 1) و کارت شبکه شما VLANها را فیلتر میکند. این تنها راهکار موجود برای دور زدن این مشکل نیست. اگر نگران مسائل مربوط به کارایی هستید، میتوانید به جای آن VLAN 1 را روی هر رابط برچسبگذاری کنید.
در حال حاضر، این گزینه روی هیچ سیستمعاملی به جز لینوکس تأثیری ندارد. در سایر سیستمعاملها، یا شتابدهنده VLAN را غیرفعال کنید، VLAN 1 را برچسب بزنید یا حالت بیقید را به صورت دستی روی رابط فعال کنید.
unconfigure system
interface promiscuous
configure system ip
management pattern pattern
unconfigure system ip
management pattern
configure system
bond-slave-src-mac-type value
انواع معتبر عبارتند از:
مقدار
پیشفرض
برای
bond-slave-src-mac-type
برابر local
است. برخی
سوییچها
ممکن است
هنگام
استفاده از
یکی از دو
مقدار
احتمالی
دیگر ایراد
بگیرند (یا
به این دلیل
که 00:00:00:00:00:00 یک
MAC معتبر
نیست یا به
دلیل نوسان
آدرس MAC از یک
پورت به
پورت دیگر).
استفاده از
local ممکن
است منجر به
ایجاد آدرس
MAC تکراری در
شبکه شود
(اما این امر
بسیار بعید
است).
configure system
max-neighbors neighbors
configure lldp
agent-type nearest-bridge |
nearest-non-tpmr-bridge |
nearest-customer-bridge
01:80:c2:00:00:0e
استفاده
میشود و
انتشار LLDPDU را
به
نزدیکترین
پل محدود
میکند
(nearest-bridge). برای
هدایت lldpd
به استفاده
از آدرس MAC
01:80:c2:00:00:03 به
جای آن، از
nearest-nontpmr-bridge
استفاده
کنید. برای
استفاده از
آدرس MAC 01:80:c2:00:00:00
به جای آن،
از nearest-customer-bridge
استفاده
کنید.configure lldp
capabilities-advertisements
unconfigure lldp
capabilities-advertisements
configure lldp
management-addresses-advertisements
unconfigure lldp
management-addresses-advertisements
configure lldp
portidsubtype ifname |
macaddress
configure [ports
ethX [,...]] lldp
portidsubtype local
value
lldpd از
آدرس MAC به
عنوان
شناسه پورت
و از نام
رابط به
عنوان
توضیحات
پورت
استفاده
میکند،
مگر اینکه
رابط دارای
یک نام
مستعار
باشد. در این
صورت، از
نام رابط به
عنوان
شناسه پورت
و از نام
مستعار
رابط به
عنوان
توضیحات
استفاده
خواهد شد. با
این دستور،
میتوانید
شناسه پورت
را مجبور
کنید که نام
رابط (با
ifname) ،
آدرس MAC (با
macaddress) یا یک
مقدار محلی
(با value)
باشد. در
حالت اخیر،
مقدار محلی
باید ارائه
شود.configure lldp
portdescription-source auto |
ifname | alias
portidsubtype local و
یک توضیح).
مقادیر معتبر عبارتند از:
- auto
- استفاده از
نام مستعار
رابط به
عنوان
توضیحات
پورت در
صورتی که
نام مستعار
موجود باشد
و زیرنوع
شناسه پورت
روی
macaddressتنظیم نشده باشد. در غیر این صورت، از نام رابط استفاده میشود. این حالت پیشفرض بوده و رفتار پیشین را حفظ میکند. - ifname
- همیشه از نام رابط به عنوان توضیحات پورت استفاده شود.
- alias
- استفاده از نام مستعار رابط به عنوان توضیحات پورت در صورت وجود، صرفنظر از زیرنوع شناسه پورت. در صورت عدم تنظیم نام مستعار، به نام رابط بازگشت میکند.
configure [ports
ethX [,...]] lldp
portdescription description
configure lldp
tx-interval interval
lldpd
همچنین یک
تایمر
نوسازی
مبتنی بر
سیستم دیگر
را روی هر
پورت برای
تشخیص
تغییراتی
مانند نام
میزبان
آغاز
میکند. این
مقدار
برابر است
با tx-interval ضرب در
۲۰.
میتوانید
مقدار interval
را بر حسب
میلیثانیه
با افزودن
پسوند "ms" به
عدد مشخص
کنید (برای
نمونه "configure lldp tx-interval
1500ms" برابر
۱٫۵ ثانیه
است، نه
۱۵۰۰ ثانیه).
در این
صورت،
مقدار TTL
برای
فریمهای LLDP
دریافتی و
ارسالی به
ثانیه بعدی
گرد میشود.
نکته: بازه
مؤثر ممکن
است توسط
قابلیتهای
سیستمعامل
و سرعت
پردازنده
محدود شود.
configure lldp
tx-hold hold
configure [ports
ethX [,...]] lldp
status rx-and-tx |
rx-only | tx-only |
disabled
-r)
پیکربندی
شده باشد،
تنظیم
هرگونه
حالت ارسال
تأثیری
نخواهد
داشت.configure [ports
ethX [,...]] lldp
vlan-tx vlan_id
[prio priority
[dei dei]]
lldpd
فریمهای LLDP
را روی تمام
VLANها
میپذیرد.configure [ports
ethX [,...]] lldp custom-tlv
[add | replace]
oui oui
subtype subtype
[oui-info content]
unconfigure [ports
ethX [,...]] lldp custom-tlv
[oui oui]
[subtype subtype]
configure [ports
ethX [,...]] lldp vlan-advertisements
pattern pattern
lldpd تمام
VLANها را منتشر
خواهد کرد.unconfigure [ports
ethX [,...]] lldp vlan-advertisements
pattern
configure lldp fast-start
enable | tx-interval
interval
lldpd
امکان
میدهد
بازه زمانی
بین دو LLDPDU را
کوتاهتر
کند. enable
شروع سریع LLDP
را فعال
میکند، در
حالی که
tx-interval بازه
زمانی بین
دو LLDPDU را بر
حسب ثانیه
مشخص
مینماید.
محدوده
معتبر برای
بازه، ۱ تا
۳۶۰۰ ثانیه
است. بازه
پیشفرض ۱
ثانیه است.
پس از ارسال
۴ بسته LLDPDU،
سازوکار
شروع سریع
تا زمان
شناسایی یک
همسایه
جدید
غیرفعال
میشود.unconfigure lldp fast-start
configure [ports
ethX [,...]] med location
coordinate latitude
latitude longitude
longitude altitude
altitude unit
datum datum
- WGS84
- NAD83
- NAD83/MLLW
یک نمونه معتبر از کاربرد این دستور:
configure [ports
ethX [,...]] med location
address country country
[type value [...]]
- language
- country-subdivision
- county
- city
- city-division
- block
- street
- direction
- trailing-street-suffix
- street-suffix
- number
- number-suffix
- landmark
- additional
- name
- zip
- building
- unit
- floor
- room
- place-type
- script
یک نمونه معتبر از کاربرد این دستور:
configure [ports
ethX [,...]] med location elin
number
configure [ports
ethX [,...]] med policy
application application
[unknown] [tagged]
[vlan vlan]
[priority priority]
[dscp dscp]
- voice
- voice-signaling
- guest-voice
- guest-voice-signaling
- softphone-voice
- video-conferencing
- streaming-video
- video-signaling
فلگ unknown
بیانگر آن
است که
سیاست شبکه
برای نوع
برنامه
مشخصشده
توسط
دستگاه
الزامی است
اما در حال
حاضر
نامشخص
میباشد.
این مورد
توسط
دستگاههای
پایانی (Endpoint Devices)
استفاده
میشود، نه
دستگاههای
اتصال شبکه
(Network Connectivity Devices). در
صورت مشخص
نشدن،
سیاست شبکه
برای نوع
برنامه
دادهشده
تعریف
میشود.
یک VLAN
مشخصشده
با vlan
تعیین
میکند
کدام شناسه
802.1q VLAN باید
برای این
سیاست شبکه
منتشر شود.
یک مقدار
معتبر بین ۱
و ۴۰۹۴ است.
tagged مشخص
میکند که VLAN
باید برای
نوع برنامه
مشخصشده
برچسبگذاری
شود.
گزینه priority به شما امکان میدهد اولویت لایه ۲ از استاندارد IEEE 802.1d / IEEE 802.1p را که به عنوان کلاس خدمت (CoS) نیز شناخته میشود، برای نوع برنامه مشخصشده تعیین کنید. این فیلد در صورتی که هیچ VLAN تعیین نشده باشد معمولاً نادیده گرفته میشود. نامها مطابق با استاندارد 802.1D-2004 (جدول G-2) هستند. برخی استانداردهای جدیدتر ممکن است از برچسبهای متفاوتی استفاده کنند. تنها مقادیر عددی قابل استناد هستند. برچسبهای پذیرفتهشده عبارتند از:
گزینه dscp نشاندهنده مقدار DSCP است که باید برای سیاست شبکه مشخصشده منتشر شود. مقدار DiffServ/Differentiated Services Code Point (DSCP) طبق تعریف در IETF RFC 2474 برای نوع برنامه مشخصشده. مقدار: از ۰ (پیشفرض طبق RFC 2475) تا ۶۳. نکته: مقادیر DSCP گزینشگر کلاس برای دستگاههایی که تنها از قالب قدیمی اولویت IP یعنی نوع خدمت (ToS) پشتیبانی میکنند، دارای سازگاری رو به عقب است. (برای معنای این مقادیر به RFCها مراجعه کنید)
یک نمونه معتبر از کاربرد این دستور:
configure inventory
hardware-revision value
unconfigure inventory
hardware-revision
configure inventory
software-revision value
unconfigure inventory
software-revision
configure inventory
firmware-revision value
unconfigure inventory
firmware-revision
configure inventory
serial-number value
unconfigure inventory
serial-number
configure inventory
manufacturer value
unconfigure inventory
manufacturer
configure inventory
model value
unconfigure inventory
model
configure inventory
asset value
unconfigure inventory
asset
configure [ports
ethX [,...]] med power pse |
pd source
source priority
priority value
value
- دستگاه PD هرگز نباید توانی بیش از کلاس فیزیکی 802.3af درخواست کند.
- دستگاه PD هرگز نباید توانی بیش از حداکثر توان منتشرشده توسط PSE دریافت نماید.
- دستگاه PSE نباید توان تخصیصیافته به PD را هنگامی که این توان در حال استفاده است کاهش دهد.
- دستگاه PSE ممکن است با استفاده از حالت صرفهجویی درخواست کاهش توان دهد.
- بودن به
عنوان PSE یا PD
یک پارامتر
سراسری
است، نه
پارامتری
برای هر
پورت.
lldpcliاین محدودیت را اعمال نمیکند: یک پورت میتواند به عنوان PD یا PSE تنظیم شود. همچنین LLDP-MED نیازمند آن است که یک PSE تنها یک منبع تغذیه (اصلی یا پشتیبان) داشته باشد. باز هم،lldpcliاین محدودیت را اعمال نمیکند. هر پورت میتواند منبع تغذیه خودش را داشته باشد. همین امر برای PD و اولویت توان نیز صدق میکند. MIB مربوط به LLDP-MED چنین نمایشی را مجاز نمیداند.
انواع معتبر عبارتند از:
منابع معتبر عبارتند از:
- unknown
- نامشخص
- primary
- برای PSE، منبع توان منبع اصلی است.
- backup
- برای PSE، منبع توان منبع پشتیبان است، یا یک حالت صرفهجویی در مصرف توان درخواست شده است (برای نمونه ممکن است PSE با UPS کار کند).
- pse
- برای PD، منبع توان همان PSE است.
- local
- برای PD، منبع توان یک منبع محلی است.
- both
- برای PD، منبع توان هم PSE و هم یک منبع محلی است.
اولویتهای معتبر عبارتند از:
مقدار value باید کل توان بر حسب میلیوات باشد که توسط دستگاه PD مورد نیاز است یا توسط دستگاه PSE در دسترس قرار دارد.
نمونهای از کاربرد:
configure [ports
ethX [,...]] dot3 power pse |
pd [supported]
[enabled] [paircontrol]
powerpairs powerpairs
[class class]
[type type
source source
priority priority
requested requested
allocated allocated]
supported به این معناست که توان MDI روی پورت مشخصشده پشتیبانی میشود، در حالی که enabled به معنای فعال بودن توان MDI است. paircontrol برای نشان دادن اینکه آیا انتخاب زوجسیمها قابل کنترل است یا خیر به کار میرود. مقادیر معتبر برای powerpairs عبارتند از:
در صورت مشخص شدن، class به صورت class- با پسوند عددی از ۰ تا ۴ است. برای نمونه class-0 ، class-1 ، class-2 ، class-3 ، class-4.
برای استاندارد 802.3at، کلاسها به شرح زیر هستند:
- 0
- پیشفرض (نامشخص)، PD بین ۰٫۴۴ تا ۱۲٫۹۵ وات، PSE برابر ۱۵٫۴ وات
- 1
- دستگاه با توان بسیار کم، PD بین ۰٫۴۴ تا ۳٫۸۴ وات، PSE برابر ۴٫۰ وات
- 2
- دستگاه با توان کم، PD بین ۳٫۸۴ تا ۶٫۴۹ وات، PSE برابر ۷٫۰ وات
- 3
- دستگاه با توان متوسط، PD بین ۶٫۴۹ تا ۱۲٫۹۵ وات، PSE برابر ۱۵٫۴ وات
- 4
- دستگاه با توان بالا (PoE+)، PD بین ۱۲٫۹۵ تا ۲۵٫۵ وات، PSE برابر ۳۰٫۰ وات
بقیه پارامترها مطابق با استاندارد 802.3at بوده و اختیاری هستند. type باید ۱ یا ۲ باشد که نشان میدهد آیا دستگاه با 802.3at نوع ۱ یا 802.3at نوع ۲ مطابقت دارد. مقادیر source و priority مشابه مقادیر LLDP-MED POE-MDI TLV هستند. requested و allocated بر حسب میلیوات بیان میشوند.
دو نمونه معتبر از کاربرد این دستور:
pause
lldpd.
برنامه lldpd
دیگر هیچ
فریمی
ارسال یا
دریافت
نخواهد کرد.
این عمل را
میتوان با
دستور resume
خنثی کرد.
این دستور
تنها به
صورت
تعاملی عمل
میکند
زیرا lldpd پس از
خواندن
فایل
پیکربندی
از lldpcli
میخواهد
که عملیات
را از حالت
تعلیق خارج
کند.resume
lldpd.
برنامه lldpd
ارسال و
دریافت
فریمها را
آغاز خواهد
کرد. این
دستور پس از
پردازش
پیکربندی
به صورت
داخلی صادر
میشود،
اما هر زمان
که دستور
دستی pause
صادر شده
باشد نیز
قابل
استفاده
است.فایلها (FILES)
- /run/lldpd/socket
- سوکت دامنه یونیکس مورد استفاده برای ارتباط با lldpd(8).
همچنین ببینید (SEE ALSO)
نویسندگان (AUTHORS)
برنامه
lldpcli توسط
Vincent Bernat ⟨bernat@luffy.cx⟩
نوشته شده
است.
| July 16, 2008 | Linux 6.12.107+deb13-amd64 |