LLDPCLI(8) System Manager's Manual LLDPCLI(8)

lldpcli, lldpctl — کنترل دیمن LLDP

lldpcli [-dv] [-u socket] [-f format] [-c file] [command ...] lldpctl [-dv] [-u socket] [-f format] [interfaces ...]

برنامه lldpcli دیمن lldpd(8) را کنترل می‌کند.

هنگامی که هیچ دستوری مشخص نشود، lldpcli یک شل تعاملی را آغاز می‌کند که می‌توان از آن برای وارد کردن دستورات دلخواه همانند زمانی که در خط فرمان مشخص می‌شوند استفاده کرد. این شل تعاملی باید از قابلیت تکمیل خودکار و تاریخچه دستورات پشتیبانی کند.

گزینه‌ها به شرح زیر هستند:

فعال‌سازی اطلاعات اشکال‌زدایی بیشتر. این فلگ می‌تواند تکرار شود.
socket
مشخص کردن سوکت دامنه یونیکس مورد استفاده برای ارتباط با lldpd(8).
نمایش نسخه lldpcli. در صورت تکرار، اطلاعات ساخت بیشتری را نمایش می‌دهد.
format
انتخاب قالب خروجی. در حال حاضر قالب‌های plain, , json, json0 و در دسترس هستند. حالت پیش‌فرض plain است. قالب json0 نسبت به json پرجزئیات‌تر است، اما ساختار شیء JSON تحت تأثیر تعداد رابط‌ها یا همسایگان قرار نمی‌گیرد؛ بنابراین تجزیه آن آسان‌تر است.
file
خواندن فایل پیکربندی داده‌شده. این گزینه می‌تواند چندین بار تکرار شود. اگر یک دایرکتوری مشخص شود، هر فایل درون آن که دارای پسوند .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]

نمایش اطلاعات مربوط به هر همسایه شناخته‌شده توسط دیمن lldpd(8). با summary ، تنها نام و توضیحات پورت هر میزبان راه دور نمایش داده خواهد شد. از سوی دیگر، با details ، تمام اطلاعات موجود نمایش داده شده و نمایی با جزئیات کامل ارائه می‌شود. هنگام استفاده از hidden ، پورت‌های راه دور که توسط پالایه هوشمند پنهان شده‌اند نیز نمایش داده می‌شوند. در صورت مشخص کردن یک یا چند پورت، اطلاعات نمایش‌داده‌شده به فهرست پورت‌های ارائه‌شده محدود می‌شود.

show interfaces [ports ethX [,...]] [details | summary] [hidden]

نمایش اطلاعات مربوط به هر رابط محلی شناخته‌شده توسط دیمن lldpd(8). با summary ، تنها نام و توضیحات پورت هر رابط محلی نمایش داده خواهد شد. از سوی دیگر، با details ، تمام اطلاعات موجود نمایش داده شده و نمایی با جزئیات کامل ارائه می‌شود. هنگام استفاده از hidden ، پورت‌های محلی که توسط پالایه هوشمند پنهان شده‌اند نیز نمایش داده می‌شوند. در صورت مشخص کردن یک یا چند پورت، اطلاعات نمایش‌داده‌شده به فهرست پورت‌های ارائه‌شده محدود می‌شود.

show chassis [details | summary]

نمایش اطلاعات درباره شاسی محلی. با summary ، بیشتر جزئیات نادیده گرفته می‌شوند. از سوی دیگر، با details ، تمام اطلاعات موجود نمایش داده شده و نمایی با جزئیات کامل ارائه می‌شود.

watch [ports ethX [,...]] [details | summary] [hidden] [limit X]

پایش هرگونه تغییرات همسایگان و گزارش آن‌ها به محض وقوع. هنگام مشخص کردن پورت‌ها، تغییرات تنها در صورتی گزارش می‌شوند که روی پورت‌های داده‌شده رخ دهند. hidden ، summary و details معنای مشابهی با آنچه پیش‌تر توضیح داده شد دارند. اگر limit مشخص شود، lldpcli پس از دریافت تعداد رویدادهای تعیین‌شده خارج خواهد شد.

show configuration

نمایش پیکربندی سراسری دیمن lldpd(8).

show statistics [ports ethX [,...]] [summary]

گزارش آمار مربوط به LLDP، مانند تعداد LLDPDUهای ارسال‌شده، دریافت‌شده، دور ریخته‌شده یا ناشناخته. هنگام مشخص کردن پورت‌ها، تنها آمار پورت داده‌شده گزارش می‌شود. با summary آمار هر پورت جمع زده می‌شود.

update

واداشتن lldpd(8) به به‌روزرسانی اطلاعات خود و ارسال PDUهای جدید LLDP روی تمام رابط‌ها.

configure system hostname name

جایگزینی نام میزبان سیستم با مقدار ارائه‌شده. به طور پیش‌فرض، نام سیستم همان FQDN به‌دست‌آمده از مقدار حل‌شده uname -n است. به عنوان یک مقدار ویژه، از "." (نقطه) برای استفاده از نام میزبان کوتاه به جای FQDN استفاده کنید.

unconfigure system hostname

عدم جایگزینی نام میزبان سیستم و بازگرداندن استفاده از نام گره.

configure system description description

جایگزینی توضیحات شاسی با مقدار ارائه‌شده به جای استفاده از نام هسته، نام گره، نسخه هسته، تاریخ ساخت و معماری.

unconfigure system description

عدم جایگزینی توضیحات شاسی و استفاده از مقداری که بر اساس نام گره، نام هسته، نسخه هسته، تاریخ ساخت و معماری محاسبه می‌شود.

configure system chassisid description

جایگزینی شناسه شاسی با مقدار ارائه‌شده به جای استفاده از آدرس MAC یکی از رابط‌ها یا نام میزبان.

unconfigure system chassisid

عدم جایگزینی شناسه شاسی، و در عوض استفاده از مقداری که از آدرس MAC یکی از رابط‌ها (یا در صورت نیافتن، از نام میزبان) محاسبه می‌شود.

configure system platform description

جایگزینی توضیحات پلتفرم با مقدار ارائه‌شده به جای استفاده از نام هسته. این مقدار در حال حاضر تنها برای CDP استفاده می‌شود.

unconfigure system platform

عدم جایگزینی توضیحات پلتفرم و استفاده از نام هسته. این گزینه عملکرد گزینه قبلی را خنثی می‌کند.

configure system capabilities enabled capabilities

جایگزینی قابلیت‌های سیستم با مقدار ارائه‌شده به جای استفاده از اطلاعات هسته. چندین قابلیت را می‌توان با ویرگول جدا کرده و مشخص نمود. تنها قابلیت‌های موجود را می‌توان فعال کرد. قابلیت‌های معتبر عبارتند از: نمونه‌ای از کاربرد:
configure system capabilities enabled bridge,router

unconfigure system capabilities enabled

عدم جایگزینی قابلیت‌ها، و در عوض استفاده از اطلاعات هسته. این گزینه عملکرد گزینه قبلی را خنثی می‌کند.

configure system interface pattern pattern

مشخص کردن رابط‌هایی که باید به آن‌ها گوش فرا داده شود و LLDPDU از آن‌ها ارسال شود به صورت مقادیر جداشده با ویرگول (CSV). بدون این گزینه، lldpd از تمام رابط‌های فیزیکی موجود استفاده خواهد کرد. این گزینه می‌تواند از نویسه‌های عام استفاده کند. چندین رابط را می‌توان با ویرگول جدا کرده و تعیین کرد. همچنین می‌توان با افزودن علامت تعجب در ابتدای نام یک رابط، آن را حذف کرد. می‌توان با قرار دادن دو علامت تعجب در ابتدای نام یک رابط، آن را مجاز کرد. یک رابط مجاز بر رابط ممنوع ارجحیت دارد و رابط ممنوع بر یک تطابق ساده ارجح است. برای نمونه، با برنامه lldpd تنها از رابط‌هایی استفاده می‌کند که با eth شروع می‌شوند، به استثنای eth1 و . در حالی که با برنامه lldpcli از تمام رابط‌ها استفاده می‌کند، به جز رابط‌هایی که با eth شروع می‌شوند، به استثنای eth1. هنگامی که یک تطابق دقیق یافت شود، برخی آزمون‌ها نادیده گرفته می‌شوند. برای نمونه، اگر مشخص شود، حتی در صورتی که یک رابط VLAN باشد نیز پذیرفته خواهد شد.

unconfigure system interface pattern

حذف هرگونه الگوی رابط پیکربندی‌شده قبلی و استفاده از تمام رابط‌های فیزیکی. این گزینه عملکرد گزینه قبلی را خنثی می‌کند.

configure system interface permanent pattern

مشخص کردن رابط‌هایی که پیکربندی آن‌ها به طور دائمی توسط lldpd نگه‌داری می‌شود. به طور پیش‌فرض، lldpd هنگامی که رابط‌ها از سیستم حذف می‌شوند، هرگونه داده مربوط به آن‌ها را نادیده می‌گیرد (آمارها، پیکربندی‌های سفارشی). این گزینه به کاربر اجازه می‌دهد الگویی مشابه الگوی رابط تعیین کند. اگر رابطی ناپدید شود اما با الگو مطابقت داشته باشد، داده‌های آن در حافظه حفظ شده و در صورتی که رابط مجدداً ظاهر شود مورد استفاده قرار می‌گیرد. برای نمونه، در لینوکس می‌توان از الگوی استفاده کرد که باید با رابط‌های ثابت در اکثر سیستم‌ها مطابقت داشته باشد.

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

مشخص کردن آدرس‌های مدیریتی این سیستم به صورت مقادیر جداشده با ویرگول (CSV). همانند رابط‌ها (که در بالا توضیح داده شد)، این گزینه می‌تواند از نویسه‌های عام و معکوس‌سازی استفاده کند. بدون این گزینه، نخستین آدرس IPv4 و نخستین آدرس IPv6 استفاده می‌شوند. اگر یک آدرس IP دقیق ارائه شود، بدون هیچ‌گونه بررسی به عنوان آدرس مدیریتی استفاده خواهد شد. اگر تنها الگوهای منفی ارائه شوند، فقط یک آدرس IPv4 و یک آدرس IPv6 انتخاب می‌شوند؛ در غیر این صورت، می‌توان موارد متعددی را انتخاب کرد. برای حذف آدرس‌های IPv6، از استفاده کنید. اگر نام یک رابط مطابقت پیدا کند، نخستین آدرس IPv4 و نخستین آدرس IPv6 مرتبط با این رابط انتخاب خواهند شد.

unconfigure system ip management pattern

لغو هرگونه الگوی خاص برای تطبیق آدرس‌های مدیریتی. این گزینه عملکرد گزینه قبلی را خنثی می‌کند.

configure system bond-slave-src-mac-type value

تنظیم نوع MAC مبدأ در فریم‌های LLDP ارسال‌شده روی اسلیوهای باندینگ.

انواع معتبر عبارتند از:

آدرس MAC واقعی اسلیو
آدرس MAC تماماً صفر
یک مقدار ثابت دلخواه (00:60:08:69:97:ef)
آدرس MAC واقعی با بیت مدیریت محلی تنظیم‌شده. اگر MAC واقعی از پیش این بیت را داشته باشد، به مقدار ثابت بازگشت می‌کند.

مقدار پیش‌فرض برای 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

آدرس MAC مقصد مورد استفاده برای ارسال LLDPDU به عامل اجازه می‌دهد انتشار LLDPDUها را کنترل کند. به طور پیش‌فرض، آدرس MAC 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

فعال‌سازی انتشار TLV مربوط به قابلیت‌های شاسی. در حال حاضر پیش‌فرض است.

unconfigure lldp capabilities-advertisements

غیرفعال‌سازی انتشار TLV قابلیت‌های شاسی.

configure lldp management-addresses-advertisements

فعال‌سازی انتشار TLV آدرس مدیریتی. در حال حاضر پیش‌فرض است.

unconfigure lldp management-addresses-advertisements

غیرفعال‌سازی انتشار TLV آدرس مدیریتی.

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

انتخاب منبع مورد استفاده برای TLV توضیحات پورت. این تنظیم بر نحوه تعیین توضیحات پورت در صورتی که به صراحت ارائه نشده باشد تأثیر می‌گذارد (برای نمونه با portidsubtype local و یک توضیح).

مقادیر معتبر عبارتند از:

استفاده از نام مستعار رابط به عنوان توضیحات پورت در صورتی که نام مستعار موجود باشد و زیرنوع شناسه پورت روی macaddress تنظیم نشده باشد. در غیر این صورت، از نام رابط استفاده می‌شود. این حالت پیش‌فرض بوده و رفتار پیشین را حفظ می‌کند.
همیشه از نام رابط به عنوان توضیحات پورت استفاده شود.
استفاده از نام مستعار رابط به عنوان توضیحات پورت در صورت وجود، صرف‌نظر از زیرنوع شناسه پورت. در صورت عدم تنظیم نام مستعار، به نام رابط بازگشت می‌کند.

configure [ports ethX [,...]] lldp portdescription description

اجبار توضیحات پورت به رشته ارائه‌شده.

configure lldp tx-interval interval

تغییر تأخیر ارسال به مقدار مشخص‌شده بر حسب ثانیه. تأخیر ارسال، مدت زمان بین دو ارسال LLDP PDU است. محدوده معتبر ۱ تا ۳۶۰۰ ثانیه است. مقدار پیش‌فرض ۳۰ ثانیه است. نکته: lldpd همچنین یک تایمر نوسازی مبتنی بر سیستم دیگر را روی هر پورت برای تشخیص تغییراتی مانند نام میزبان آغاز می‌کند. این مقدار برابر است با tx-interval ضرب در ۲۰.

می‌توانید مقدار interval را بر حسب میلی‌ثانیه با افزودن پسوند "ms" به عدد مشخص کنید (برای نمونه "configure lldp tx-interval 1500ms" برابر ۱٫۵ ثانیه است، نه ۱۵۰۰ ثانیه). در این صورت، مقدار TTL برای فریم‌های LLDP دریافتی و ارسالی به ثانیه بعدی گرد می‌شود. نکته: بازه مؤثر ممکن است توسط قابلیت‌های سیستم‌عامل و سرعت پردازنده محدود شود.

configure lldp tx-hold hold

تغییر مقدار نگه‌داری ارسال به مقدار مشخص‌شده. این مقدار برای محاسبه TTL بسته‌های ارسالی استفاده می‌شود که حاصل‌ضرب این مقدار در تأخیر ارسال است. محدوده معتبر ۱ تا ۱۰۰ است. مقدار پیش‌فرض ۴ است و بنابراین TTL پیش‌فرض ۱۲۰ ثانیه خواهد بود.

configure [ports ethX [,...]] lldp status rx-and-tx | rx-only | tx-only | disabled

پیکربندی وضعیت مدیریتی پورت داده‌شده. به طور پیش‌فرض، تمام پورت‌ها روی حالت rx-and-tx پیکربندی شده‌اند. این بدان معناست که آن‌ها می‌توانند فریم‌های LLDP (و همچنین سایر پروتکل‌ها در صورت نیاز) را دریافت و ارسال کنند. در حالت rx-only ، آن‌ها هیچ فریمی ارسال نمی‌کنند و در حالت tx-only ، هیچ فریمی دریافت نخواهند کرد. در حالت disabled ، هیچ فریمی ارسال نمی‌شود و هر فریم دریافتی دور ریخته خواهد شد. این تنظیم بر حالت عملیاتی دیمن اصلی ارجحیت ندارد؛ اگر دیمن در حالت فقط دریافت (با فلگ -r) پیکربندی شده باشد، تنظیم هرگونه حالت ارسال تأثیری نخواهد داشت.

configure [ports ethX [,...]] lldp vlan-tx vlan_id [prio priority [dei dei]]

پیکربندی پورت ارائه‌شده برای ارسال فریم‌های LLDP روی یک VLAN مشخص. با شناسه VLAN (VID) به صورت vlan_id ، نقطه کد اولویت (PCP) به صورت priority و نشانگر واجد شرایط حذف (DEI) به صورت dei. برنامه lldpd فریم‌های LLDP را روی تمام VLANها می‌پذیرد.

configure [ports ethX [,...]] lldp custom-tlv [add | replace] oui oui subtype subtype [oui-info content]

انتشار یک TLV سفارشی برای OUI oui ، با زیرنوع subtype و به صورت اختیاری با بایت‌های مشخص‌شده در content. هر دو مقدار oui و content باید فهرستی از بایت‌ها در قالب هگزادسیمال جداشده با ویرگول باشند. oui باید دقیقاً ۳ بایت طول داشته باشد. اگر add مشخص شود، TLV اضافه خواهد شد. این عمل پیش‌فرض است. اگر replace مشخص شود، تمام TLVها با oui و subtype یکسان جایگزین خواهند شد.

unconfigure [ports ethX [,...]] lldp custom-tlv [oui oui] [subtype subtype]

هنگامی که هیچ oui مشخص نشود، تمام TLVهای سفارشی پیکربندی‌شده قبلی حذف می‌شوند. هنگامی که OUI oui و زیرنوع subtype مشخص شود، نمونه‌های خاص TLV سفارشی حذف می‌شوند.

configure [ports ethX [,...]] lldp vlan-advertisements pattern pattern

پیکربندی انتشار VLAN برای پورت داده‌شده به صورت مقادیر جداشده با ویرگول (CSV). همانند رابط‌ها (که در بالا توضیح داده شد)، این گزینه می‌تواند از نویسه‌های عام و معکوس‌سازی استفاده کند. بدون این گزینه، lldpd تمام VLANها را منتشر خواهد کرد.

unconfigure [ports ethX [,...]] lldp vlan-advertisements pattern

حذف هرگونه الگوی انتشار VLAN پیکربندی‌شده قبلی برای پورت داده‌شده.

configure lldp fast-start enable | tx-interval interval

پیکربندی سازوکار شروع سریع پروتکل LLDP. هنگامی که یک همسایه جدید LLDP شناسایی می‌شود، شروع سریع به lldpd امکان می‌دهد بازه زمانی بین دو LLDPDU را کوتاه‌تر کند. enable شروع سریع LLDP را فعال می‌کند، در حالی که tx-interval بازه زمانی بین دو LLDPDU را بر حسب ثانیه مشخص می‌نماید. محدوده معتبر برای بازه، ۱ تا ۳۶۰۰ ثانیه است. بازه پیش‌فرض ۱ ثانیه است. پس از ارسال ۴ بسته LLDPDU، سازوکار شروع سریع تا زمان شناسایی یک همسایه جدید غیرفعال می‌شود.

unconfigure lldp fast-start

غیرفعال‌سازی سازوکار شروع سریع LLDP.

configure [ports ethX [,...]] med location coordinate latitude latitude longitude longitude altitude altitude unit datum datum

انتشار موقعیت مکانی مبتنی بر مختصات روی پورت‌های داده‌شده (یا روی تمام پورت‌ها در صورت مشخص نشدن پورت). قالب latitude یک عدد اعشاری ممیز شناور است که در پی آن یا می‌آید. قالب longitude یک عدد اعشاری ممیز شناور است که در پی آن یا می‌آید. altitude یک عدد اعشاری ممیز شناور است که در صورت بیان بر حسب متر در پی آن و در صورت بیان بر حسب طبقات در پی آن f می‌آید. انتظار می‌رود بین عدد ممیز شناور و واحد یک فاصله قرار گیرد. datum یکی از مقادیر زیر است:
  • WGS84
  • NAD83
  • NAD83/MLLW

یک نمونه معتبر از کاربرد این دستور:

configure ports eth0 med location coordinate latitude 48.85667N longitude 2.2014E altitude 117.47 m datum WGS84

configure [ports ethX [,...]] med location address country country [type value [...]]

انتشار یک نشانی مدنی روی پورت‌های داده‌شده (یا روی تمام پورت‌ها در صورت مشخص نشدن پورت). country کد دورقمی معرف کشور است. سایر آرگومان‌ها باید برای تشکیل نشانی به صورت جفت آورده شوند. عضو اول هر جفت نشان‌دهنده نوع عضو دوم است که یک متن آزاد می‌باشد. در اینجا فهرستی از انواع معتبر آورده شده است:
  • 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 eth1 med location address country US street "Commercial Road" city "Roseville"

configure [ports ethX [,...]] med location elin number

انتشار در دسترس بودن شماره ELIN. این مقدار برای برقراری تماس‌های اضطراری استفاده می‌شود. اگر شماره ارائه‌شده خیلی کوچک باشد، با 0 پر خواهد شد. نمونه‌ای از کاربرد:
configure ports eth2 med location elin 911

configure [ports ethX [,...]] med policy application application [unknown] [tagged] [vlan vlan] [priority priority] [dscp dscp]

انتشار یک سیاست شبکه خاص برای پورت‌های داده‌شده (یا برای تمام پورت‌ها در صورت مشخص نشدن پورت). تنها نوع برنامه اجباری است. application باید یکی از مقادیر زیر باشد:
  • 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) هستند. برخی استانداردهای جدیدتر ممکن است از برچسب‌های متفاوتی استفاده کنند. تنها مقادیر عددی قابل استناد هستند. برچسب‌های پذیرفته‌شده عبارتند از:

background
best-effort
excellent-effort
critical-applications
video
voice
internetwork-control
network-control

گزینه dscp نشان‌دهنده مقدار DSCP است که باید برای سیاست شبکه مشخص‌شده منتشر شود. مقدار DiffServ/Differentiated Services Code Point (DSCP) طبق تعریف در IETF RFC 2474 برای نوع برنامه مشخص‌شده. مقدار: از ۰ (پیش‌فرض طبق RFC 2475) تا ۶۳. نکته: مقادیر DSCP گزینش‌گر کلاس برای دستگاه‌هایی که تنها از قالب قدیمی اولویت IP یعنی نوع خدمت (ToS) پشتیبانی می‌کنند، دارای سازگاری رو به عقب است. (برای معنای این مقادیر به RFCها مراجعه کنید)

یک نمونه معتبر از کاربرد این دستور:

configure med policy application voice vlan 500 priority voice dscp 46

configure inventory hardware-revision value

جایگزینی بازنگری سخت‌افزار با مقدار ارائه‌شده. به طور پیش‌فرض، بازنگری سخت‌افزار از /sys/class/dmi واکشی می‌شود.

unconfigure inventory hardware-revision

عدم جایگزینی بازنگری سخت‌افزار و بازگرداندن استفاده از مقدار /sys/class/dmi.

configure inventory software-revision value

جایگزینی بازنگری نرم‌افزار با مقدار ارائه‌شده. به طور پیش‌فرض، بازنگری نرم‌افزار از uname واکشی می‌شود.

unconfigure inventory software-revision

عدم جایگزینی بازنگری نرم‌افزار و بازگرداندن استفاده از مقدار uname.

configure inventory firmware-revision value

جایگزینی بازنگری سفت‌افزار با مقدار ارائه‌شده. به طور پیش‌فرض، بازنگری سفت‌افزار از /sys/class/dmi واکشی می‌شود.

unconfigure inventory firmware-revision

عدم جایگزینی بازنگری سفت‌افزار و بازگرداندن استفاده از مقدار /sys/class/dmi.

configure inventory serial-number value

جایگزینی شماره سریال با مقدار ارائه‌شده. به طور پیش‌فرض، شماره سریال از /sys/class/dmi واکشی می‌شود.

unconfigure inventory serial-number

عدم جایگزینی شماره سریال و بازگرداندن استفاده از مقدار /sys/class/dmi.

configure inventory manufacturer value

جایگزینی نام سازنده با مقدار ارائه‌شده. به طور پیش‌فرض، نام سازنده از /sys/class/dmi واکشی می‌شود.

unconfigure inventory manufacturer

عدم جایگزینی نام سازنده و بازگرداندن استفاده از مقدار /sys/class/dmi.

configure inventory model value

جایگزینی مدل با مقدار ارائه‌شده. به طور پیش‌فرض، مدل از /sys/class/dmi واکشی می‌شود.

unconfigure inventory model

عدم جایگزینی مدل و بازگرداندن استفاده از مقدار /sys/class/dmi.

configure inventory asset value

جایگزینی برچسب اموال با مقدار ارائه‌شده. به طور پیش‌فرض، اموال از /sys/class/dmi واکشی می‌شود.

unconfigure inventory asset

عدم جایگزینی اموال و بازگرداندن استفاده از مقدار /sys/class/dmi.

configure [ports ethX [,...]] med power pse | pd source source priority priority value value

انتشار TLV مربوط به LLDP-MED POE-MDI برای پورت‌های داده‌شده یا برای تمام رابط‌ها در صورت مشخص نشدن پورت. دستگاه می‌تواند به عنوان یک PD (مصرف‌کننده توان) یا PSE (تأمین‌کننده توان) عمل کند. هیچ بررسی روی صحت پارامترها انجام نمی‌شود، در حالی که LLDP-MED نیازمند برخی محدودیت‌ها است:
  • دستگاه PD هرگز نباید توانی بیش از کلاس فیزیکی 802.3af درخواست کند.
  • دستگاه PD هرگز نباید توانی بیش از حداکثر توان منتشرشده توسط PSE دریافت نماید.
  • دستگاه PSE نباید توان تخصیص‌یافته به PD را هنگامی که این توان در حال استفاده است کاهش دهد.
  • دستگاه PSE ممکن است با استفاده از حالت صرفه‌جویی درخواست کاهش توان دهد.
  • بودن به عنوان PSE یا PD یک پارامتر سراسری است، نه پارامتری برای هر پورت. lldpcli این محدودیت را اعمال نمی‌کند: یک پورت می‌تواند به عنوان PD یا PSE تنظیم شود. همچنین LLDP-MED نیازمند آن است که یک PSE تنها یک منبع تغذیه (اصلی یا پشتیبان) داشته باشد. باز هم، lldpcli این محدودیت را اعمال نمی‌کند. هر پورت می‌تواند منبع تغذیه خودش را داشته باشد. همین امر برای PD و اولویت توان نیز صدق می‌کند. MIB مربوط به LLDP-MED چنین نمایشی را مجاز نمی‌داند.

انواع معتبر عبارتند از:

موجودیت تأمین‌کننده توان (Power Sourcing Entity)
دستگاه مصرف‌کننده توان (Power Device)

منابع معتبر عبارتند از:

نامشخص
برای PSE، منبع توان منبع اصلی است.
برای PSE، منبع توان منبع پشتیبان است، یا یک حالت صرفه‌جویی در مصرف توان درخواست شده است (برای نمونه ممکن است PSE با UPS کار کند).
برای PD، منبع توان همان PSE است.
برای PD، منبع توان یک منبع محلی است.
برای PD، منبع توان هم PSE و هم یک منبع محلی است.

اولویت‌های معتبر عبارتند از:

اولویت نامشخص
بحرانی
بالا
پایین

مقدار value باید کل توان بر حسب میلی‌وات باشد که توسط دستگاه PD مورد نیاز است یا توسط دستگاه PSE در دسترس قرار دارد.

نمونه‌ای از کاربرد:

configure med power pd source pse priority high value 5000

configure [ports ethX [,...]] dot3 power pse | pd [supported] [enabled] [paircontrol] powerpairs powerpairs [class class] [type type source source priority priority requested requested allocated allocated]

انتشار Dot3 POE-MDI TLV برای پورت داده‌شده یا برای تمام پورت‌ها در صورت مشخص نشدن. می‌توان به عنوان یک PD (مصرف‌کننده توان) یا یک PSE (تأمین‌کننده توان) عمل کرد. این پیکربندی از پیکربندی ارسال LLDP-MED POE-MDI TLV متمایز است اما کاربر در صورت استفاده همزمان از هر دو، باید از هماهنگی و سازگاری این دو پیکربندی اطمینان حاصل کند.

به این معناست که توان MDI روی پورت مشخص‌شده پشتیبانی می‌شود، در حالی که به معنای فعال بودن توان MDI است. برای نشان دادن اینکه آیا انتخاب زوج‌سیم‌ها قابل کنترل است یا خیر به کار می‌رود. مقادیر معتبر برای powerpairs عبارتند از:

تنها زوج‌های سیگنال در حال استفاده هستند.
تنها زوج‌های یدکی در حال استفاده هستند.

در صورت مشخص شدن، class به صورت class- با پسوند عددی از ۰ تا ۴ است. برای نمونه class-0 ، class-1 ، class-2 ، class-3 ، class-4.

برای استاندارد 802.3at، کلاس‌ها به شرح زیر هستند:

پیش‌فرض (نامشخص)، PD بین ۰٫۴۴ تا ۱۲٫۹۵ وات، PSE برابر ۱۵٫۴ وات
دستگاه با توان بسیار کم، PD بین ۰٫۴۴ تا ۳٫۸۴ وات، PSE برابر ۴٫۰ وات
دستگاه با توان کم، PD بین ۳٫۸۴ تا ۶٫۴۹ وات، PSE برابر ۷٫۰ وات
دستگاه با توان متوسط، PD بین ۶٫۴۹ تا ۱۲٫۹۵ وات، PSE برابر ۱۵٫۴ وات
دستگاه با توان بالا (PoE+)، PD بین ۱۲٫۹۵ تا ۲۵٫۵ وات، PSE برابر ۳۰٫۰ وات

بقیه پارامترها مطابق با استاندارد 802.3at بوده و اختیاری هستند. type باید ۱ یا ۲ باشد که نشان می‌دهد آیا دستگاه با 802.3at نوع ۱ یا 802.3at نوع ۲ مطابقت دارد. مقادیر source و priority مشابه مقادیر LLDP-MED POE-MDI TLV هستند. requested و allocated بر حسب میلی‌وات بیان می‌شوند.

دو نمونه معتبر از کاربرد این دستور:

configure ports eth3 dot3 power pse supported enabled paircontrol powerpairs spare class class-3
configure dot3 power pd supported enabled powerpairs spare class class-3 type 1 source pse priority low requested 10000 allocated 15000

pause

متوقف کردن موقت عملیات lldpd. برنامه lldpd دیگر هیچ فریمی ارسال یا دریافت نخواهد کرد. این عمل را می‌توان با دستور resume خنثی کرد. این دستور تنها به صورت تعاملی عمل می‌کند زیرا lldpd پس از خواندن فایل پیکربندی از lldpcli می‌خواهد که عملیات را از حالت تعلیق خارج کند.

resume

از سرگیری عملیات lldpd. برنامه lldpd ارسال و دریافت فریم‌ها را آغاز خواهد کرد. این دستور پس از پردازش پیکربندی به صورت داخلی صادر می‌شود، اما هر زمان که دستور دستی pause صادر شده باشد نیز قابل استفاده است.

/run/lldpd/socket
سوکت دامنه یونیکس مورد استفاده برای ارتباط با lldpd(8).

lldpd(8)

برنامه lldpcli توسط Vincent Bernat ⟨bernat@luffy.cx⟩ نوشته شده است.

July 16, 2008 Linux 6.12.107+deb13-amd64