.\" Copyright (c) 2006 Pierre-Yves Ritschard .\" Copyright (c) 2008 Vincent Bernat .\" .\" Permission to use, copy, modify, and/or distribute this software for any .\" purpose with or without fee is hereby granted, provided that the above .\" copyright notice and this permission notice appear in all copies. .\" .\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES .\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF .\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR .\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES .\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. .\" .Dd $Mdocdate: July 16 2008 $ .Dt LLDPCLI 8 .Os .Sh "نام (NAME)" .Nm lldpcli , .Nm lldpctl .Nd کنترل دیمن LLDP .Sh "خلاصه دستور (SYNOPSIS)" .Nm .Op Fl dv .Op Fl u Ar socket .Op Fl f Ar format .Op Fl c Ar file .Op Ar command ... .Nm lldpctl .Op Fl dv .Op Fl u Ar socket .Op Fl f Ar format .Op Ar interfaces ... .Sh "توضیحات (DESCRIPTION)" برنامه .Nm دیمن .Xr lldpd 8 را کنترل می‌کند. .Pp هنگامی که هیچ دستوری مشخص نشود، .Nm یک شل تعاملی را آغاز می‌کند که می‌توان از آن برای وارد کردن دستورات دلخواه همانند زمانی که در خط فرمان مشخص می‌شوند استفاده کرد. این شل تعاملی باید از قابلیت تکمیل خودکار و تاریخچه دستورات پشتیبانی کند. .Pp گزینه‌ها به شرح زیر هستند: .Bl -tag -width Ds .It Fl d فعال‌سازی اطلاعات اشکال‌زدایی بیشتر. این فلگ می‌تواند تکرار شود. .It Fl u Ar socket مشخص کردن سوکت دامنه یونیکس مورد استفاده برای ارتباط با .Xr lldpd 8 . .It Fl v نمایش نسخه .Nm . در صورت تکرار، اطلاعات ساخت بیشتری را نمایش می‌دهد. .It Fl f Ar format انتخاب قالب خروجی. در حال حاضر قالب‌های .Em plain , .Em xml , .Em json , .Em json0 و .Em keyvalue در دسترس هستند. حالت پیش‌فرض .Em plain است. قالب .Em json0 نسبت به .Em json پرجزئیات‌تر است، اما ساختار شیء JSON تحت تأثیر تعداد رابط‌ها یا همسایگان قرار نمی‌گیرد؛ بنابراین تجزیه آن آسان‌تر است. .It Fl c Ar file خواندن فایل پیکربندی داده‌شده. این گزینه می‌تواند چندین بار تکرار شود. اگر یک دایرکتوری مشخص شود، هر فایل درون آن که دارای پسوند .Li .conf باشد خوانده خواهد شد. ترتیب خواندن بر اساس الفبا است. .El .Pp هنگامی که به صورت .Nm lldpctl فراخوانی شود، .Nm اطلاعات تفصیلی درباره هر همسایه را روی رابط‌های مشخص‌شده یا در صورت عدم تعیین، روی تمام رابط‌ها نمایش می‌دهد. این دستور بیشتر جهت سازگاری رو به عقب با نسخه‌های قدیمی‌تر حفظ شده است. .Pp دستورات زیر توسط .Nm پشتیبانی می‌شوند. هنگامی که ابهامی وجود نداشته باشد، کلیدواژه‌ها را می‌توان به صورت اختصاری نوشت. برای نمونه، .Cd show neighbors ports eth0 summary و .Cd sh neigh p eth0 sum یک دستور یکسان هستند. .Bd -ragged -offset XX .Cd exit .Bd -ragged -offset XXXXXX خروج از .Nm . .Ed .Cd help Op ... .Bd -ragged -offset XXXXXX نمایش راهنمای عمومی یا راهنما درباره یک دستور. همچنین می‌توانید با استفاده از تکمیل خودکار یا با فشردن کلید .Ic ? راهنمایی بگیرید. با این حال، اگر .Nm بدون پشتیبانی از readline کامپایل شده باشد، تکمیل خودکار و راهنمای درون‌خطی ممکن است در دسترس نباشند، اما دستور .Cd help همیشه در دسترس است. .Ed .Cd show neighbors .Op ports Ar ethX Op ,... .Op Cd details | summary .Op Cd hidden .Bd -ragged -offset XXXXXX نمایش اطلاعات مربوط به هر همسایه شناخته‌شده توسط دیمن .Xr lldpd 8 . با .Cd summary ، تنها نام و توضیحات پورت هر میزبان راه دور نمایش داده خواهد شد. از سوی دیگر، با .Cd details ، تمام اطلاعات موجود نمایش داده شده و نمایی با جزئیات کامل ارائه می‌شود. هنگام استفاده از .Cd hidden ، پورت‌های راه دور که توسط پالایه هوشمند پنهان شده‌اند نیز نمایش داده می‌شوند. در صورت مشخص کردن یک یا چند پورت، اطلاعات نمایش‌داده‌شده به فهرست پورت‌های ارائه‌شده محدود می‌شود. .Ed .Cd show interfaces .Op ports Ar ethX Op ,... .Op Cd details | summary .Op Cd hidden .Bd -ragged -offset XXXXXX نمایش اطلاعات مربوط به هر رابط محلی شناخته‌شده توسط دیمن .Xr lldpd 8 . با .Cd summary ، تنها نام و توضیحات پورت هر رابط محلی نمایش داده خواهد شد. از سوی دیگر، با .Cd details ، تمام اطلاعات موجود نمایش داده شده و نمایی با جزئیات کامل ارائه می‌شود. هنگام استفاده از .Cd hidden ، پورت‌های محلی که توسط پالایه هوشمند پنهان شده‌اند نیز نمایش داده می‌شوند. در صورت مشخص کردن یک یا چند پورت، اطلاعات نمایش‌داده‌شده به فهرست پورت‌های ارائه‌شده محدود می‌شود. .Ed .Cd show chassis .Op Cd details | summary .Bd -ragged -offset XXXXXX نمایش اطلاعات درباره شاسی محلی. با .Cd summary ، بیشتر جزئیات نادیده گرفته می‌شوند. از سوی دیگر، با .Cd details ، تمام اطلاعات موجود نمایش داده شده و نمایی با جزئیات کامل ارائه می‌شود. .Ed .Cd watch .Op ports Ar ethX Op ,... .Op Cd details | summary .Op Cd hidden .Op Cd limit Ar X .Bd -ragged -offset XXXXXX پایش هرگونه تغییرات همسایگان و گزارش آن‌ها به محض وقوع. هنگام مشخص کردن پورت‌ها، تغییرات تنها در صورتی گزارش می‌شوند که روی پورت‌های داده‌شده رخ دهند. .Cd hidden ، summary و .Cd details معنای مشابهی با آنچه پیش‌تر توضیح داده شد دارند. اگر .Cd limit مشخص شود، .Nm پس از دریافت تعداد رویدادهای تعیین‌شده خارج خواهد شد. .Ed .Cd show configuration .Bd -ragged -offset XXXXXX نمایش پیکربندی سراسری دیمن .Xr lldpd 8 . .Ed .Cd show statistics .Op ports Ar ethX Op ,... .Op Cd summary .Bd -ragged -offset XXXXXX گزارش آمار مربوط به LLDP، مانند تعداد LLDPDUهای ارسال‌شده، دریافت‌شده، دور ریخته‌شده یا ناشناخته. هنگام مشخص کردن پورت‌ها، تنها آمار پورت داده‌شده گزارش می‌شود. با .Cd summary آمار هر پورت جمع زده می‌شود. .Ed .Cd update .Bd -ragged -offset XXXXXX واداشتن .Xr lldpd 8 به به‌روزرسانی اطلاعات خود و ارسال PDUهای جدید LLDP روی تمام رابط‌ها. .Ed .Cd configure .Cd system hostname Ar name .Bd -ragged -offset XXXXXX جایگزینی نام میزبان سیستم با مقدار ارائه‌شده. به طور پیش‌فرض، نام سیستم همان FQDN به‌دست‌آمده از مقدار حل‌شده .Ic uname -n است. به عنوان یک مقدار ویژه، از "." (نقطه) برای استفاده از نام میزبان کوتاه به جای FQDN استفاده کنید. .Ed .Cd unconfigure .Cd system hostname .Bd -ragged -offset XXXXXX عدم جایگزینی نام میزبان سیستم و بازگرداندن استفاده از نام گره. .Ed .Cd configure .Cd system description Ar description .Bd -ragged -offset XXXXXX جایگزینی توضیحات شاسی با مقدار ارائه‌شده به جای استفاده از نام هسته، نام گره، نسخه هسته، تاریخ ساخت و معماری. .Ed .Cd unconfigure .Cd system description .Bd -ragged -offset XXXXXX عدم جایگزینی توضیحات شاسی و استفاده از مقداری که بر اساس نام گره، نام هسته، نسخه هسته، تاریخ ساخت و معماری محاسبه می‌شود. .Ed .Cd configure .Cd system chassisid Ar description .Bd -ragged -offset XXXXXX جایگزینی شناسه شاسی با مقدار ارائه‌شده به جای استفاده از آدرس MAC یکی از رابط‌ها یا نام میزبان. .Ed .Cd unconfigure .Cd system chassisid .Bd -ragged -offset XXXXXX عدم جایگزینی شناسه شاسی، و در عوض استفاده از مقداری که از آدرس MAC یکی از رابط‌ها (یا در صورت نیافتن، از نام میزبان) محاسبه می‌شود. .Ed .Cd configure .Cd system platform Ar description .Bd -ragged -offset XXXXXX جایگزینی توضیحات پلتفرم با مقدار ارائه‌شده به جای استفاده از نام هسته. این مقدار در حال حاضر تنها برای CDP استفاده می‌شود. .Ed .Cd unconfigure .Cd system platform .Bd -ragged -offset XXXXXX عدم جایگزینی توضیحات پلتفرم و استفاده از نام هسته. این گزینه عملکرد گزینه قبلی را خنثی می‌کند. .Ed .Cd configure .Cd system capabilities enabled Ar capabilities .Bd -ragged -offset XXXXXX جایگزینی قابلیت‌های سیستم با مقدار ارائه‌شده به جای استفاده از اطلاعات هسته. چندین قابلیت را می‌توان با ویرگول جدا کرده و مشخص نمود. تنها قابلیت‌های موجود را می‌توان فعال کرد. قابلیت‌های معتبر عبارتند از: .Bl -tag -width "XXX." -compact -offset XX .It Sy bridge .It Sy docsis .It Sy other .It Sy repeater .It Sy router .It Sy station .It Sy telephone .It Sy wlan .El نمونه‌ای از کاربرد: .D1 configure system capabilities enabled bridge,router .Pp .Ed .Cd unconfigure .Cd system capabilities enabled .Bd -ragged -offset XXXXXX عدم جایگزینی قابلیت‌ها، و در عوض استفاده از اطلاعات هسته. این گزینه عملکرد گزینه قبلی را خنثی می‌کند. .Ed .Cd configure .Cd system interface pattern Ar pattern .Bd -ragged -offset XXXXXX مشخص کردن رابط‌هایی که باید به آن‌ها گوش فرا داده شود و LLDPDU از آن‌ها ارسال شود به صورت مقادیر جداشده با ویرگول (CSV). بدون این گزینه، .Nm lldpd از تمام رابط‌های فیزیکی موجود استفاده خواهد کرد. این گزینه می‌تواند از نویسه‌های عام استفاده کند. چندین رابط را می‌توان با ویرگول جدا کرده و تعیین کرد. همچنین می‌توان با افزودن علامت تعجب در ابتدای نام یک رابط، آن را حذف کرد. می‌توان با قرار دادن دو علامت تعجب در ابتدای نام یک رابط، آن را مجاز کرد. یک رابط مجاز بر رابط ممنوع ارجحیت دارد و رابط ممنوع بر یک تطابق ساده ارجح است. برای نمونه، با .Em eth*,!eth1,!eth2 برنامه .Nm lldpd تنها از رابط‌هایی استفاده می‌کند که با .Em eth شروع می‌شوند، به استثنای .Em eth1 و .Em eth2 . در حالی که با .Em *,!eth*,!!eth1 برنامه .Nm از تمام رابط‌ها استفاده می‌کند، به جز رابط‌هایی که با .Em eth شروع می‌شوند، به استثنای .Em eth1 . هنگامی که یک تطابق دقیق یافت شود، برخی آزمون‌ها نادیده گرفته می‌شوند. برای نمونه، اگر .Em eth0.12 مشخص شود، حتی در صورتی که یک رابط VLAN باشد نیز پذیرفته خواهد شد. .Ed .Cd unconfigure .Cd system interface pattern .Bd -ragged -offset XXXXXX حذف هرگونه الگوی رابط پیکربندی‌شده قبلی و استفاده از تمام رابط‌های فیزیکی. این گزینه عملکرد گزینه قبلی را خنثی می‌کند. .Ed .Cd configure .Cd system interface permanent Ar pattern .Bd -ragged -offset XXXXXX مشخص کردن رابط‌هایی که پیکربندی آن‌ها به طور دائمی توسط .Nm lldpd نگه‌داری می‌شود. به طور پیش‌فرض، .Nm lldpd هنگامی که رابط‌ها از سیستم حذف می‌شوند، هرگونه داده مربوط به آن‌ها را نادیده می‌گیرد (آمارها، پیکربندی‌های سفارشی). این گزینه به کاربر اجازه می‌دهد الگویی مشابه الگوی رابط تعیین کند. اگر رابطی ناپدید شود اما با الگو مطابقت داشته باشد، داده‌های آن در حافظه حفظ شده و در صورتی که رابط مجدداً ظاهر شود مورد استفاده قرار می‌گیرد. برای نمونه، در لینوکس می‌توان از الگوی .Em eth*,eno*,enp* استفاده کرد که باید با رابط‌های ثابت در اکثر سیستم‌ها مطابقت داشته باشد. .Ed .Cd unconfigure .Cd system interface permanent .Bd -ragged -offset XXXXXX حذف هرگونه الگوی رابط دائمی پیکربندی‌شده قبلی. هر رابطی که از سیستم حذف شود فراموش خواهد شد. این گزینه عملکرد گزینه قبلی را خنثی می‌کند. .Ed .Cd configure .Cd system interface description .Bd -ragged -offset XXXXXX برخی از سیستم‌عامل‌ها به کاربر اجازه می‌دهند توضیحی برای یک رابط تنظیم کند. فعال‌سازی این گزینه به .Nm lldpd امکان می‌دهد این توضیحات را با نام همسایه متناظر (در صورت یافتن) یا با تعداد همسایگان یافته‌شده بازنویسی و جایگزین کند. .Ed .Cd unconfigure .Cd system interface description .Bd -ragged -offset XXXXXX توضیحات رابط با نام همسایه متناظر به‌روزرسانی نشود. این گزینه عملکرد گزینه قبلی را خنثی می‌کند. .Ed .Cd configure .Cd system interface promiscuous .Bd -ragged -offset XXXXXX فعال‌سازی حالت بی‌قید روی رابط‌های مدیریت‌شده. .Pp هنگامی که رابط دیگر مدیریت نمی‌شود (یا هنگام خروج از .Nm lldpd ) ، رابط در حالت بی‌قید رها می‌شود؛ زیرا تشخیص اینکه آیا برنامه دیگری نیز رابط را در حالت بی‌قید قرار داده دشوار است. .Pp این گزینه زمانی مفید است که سوییچ راه دور یک Cisco 2960 بوده و کارت شبکه محلی دارای شتاب‌دهنده سخت‌افزاری VLAN باشد. در این حالت، ممکن است فریم‌های LLDP را از سوییچ راه دور دریافت نکنید. محتمل‌ترین دلیل برای این مسئله آن است که فریم با یک VLAN برچسب‌گذاری شده (معمولاً VLAN 1) و کارت شبکه شما VLANها را فیلتر می‌کند. این تنها راهکار موجود برای دور زدن این مشکل نیست. اگر نگران مسائل مربوط به کارایی هستید، می‌توانید به جای آن VLAN 1 را روی هر رابط برچسب‌گذاری کنید. .Pp در حال حاضر، این گزینه روی هیچ سیستم‌عاملی به جز لینوکس تأثیری ندارد. در سایر سیستم‌عامل‌ها، یا شتاب‌دهنده VLAN را غیرفعال کنید، VLAN 1 را برچسب بزنید یا حالت بی‌قید را به صورت دستی روی رابط فعال کنید. .Ed .Cd unconfigure .Cd system interface promiscuous .Bd -ragged -offset XXXXXX حالت بی‌قید روی رابط‌های مدیریت‌شده تنظیم نشود. این گزینه حالت بی‌قید را روی رابط‌هایی که هم‌اکنون از این حالت استفاده می‌کنند غیرفعال نمی‌کند. .Ed .Cd configure .Cd system ip management pattern Ar pattern .Bd -ragged -offset XXXXXX مشخص کردن آدرس‌های مدیریتی این سیستم به صورت مقادیر جداشده با ویرگول (CSV). همانند رابط‌ها (که در بالا توضیح داده شد)، این گزینه می‌تواند از نویسه‌های عام و معکوس‌سازی استفاده کند. بدون این گزینه، نخستین آدرس IPv4 و نخستین آدرس IPv6 استفاده می‌شوند. اگر یک آدرس IP دقیق ارائه شود، بدون هیچ‌گونه بررسی به عنوان آدرس مدیریتی استفاده خواهد شد. اگر تنها الگوهای منفی ارائه شوند، فقط یک آدرس IPv4 و یک آدرس IPv6 انتخاب می‌شوند؛ در غیر این صورت، می‌توان موارد متعددی را انتخاب کرد. برای حذف آدرس‌های IPv6، از .Em !*:* استفاده کنید. اگر نام یک رابط مطابقت پیدا کند، نخستین آدرس IPv4 و نخستین آدرس IPv6 مرتبط با این رابط انتخاب خواهند شد. .Ed .Cd unconfigure .Cd system ip management pattern .Bd -ragged -offset XXXXXX لغو هرگونه الگوی خاص برای تطبیق آدرس‌های مدیریتی. این گزینه عملکرد گزینه قبلی را خنثی می‌کند. .Ed .Cd configure .Cd system bond-slave-src-mac-type Ar value .Bd -ragged -offset XXXXXX تنظیم نوع MAC مبدأ در فریم‌های LLDP ارسال‌شده روی اسلیوهای باندینگ. انواع معتبر عبارتند از: .Bl -tag -width "XXX." -compact -offset XX .It Sy real آدرس MAC واقعی اسلیو .It Sy zero آدرس MAC تماماً صفر .It Sy fixed یک مقدار ثابت دلخواه .Li ( 00:60:08:69:97:ef ) .It Sy local آدرس MAC واقعی با بیت مدیریت محلی تنظیم‌شده. اگر MAC واقعی از پیش این بیت را داشته باشد، به مقدار ثابت بازگشت می‌کند. .El .Pp مقدار پیش‌فرض برای .Nm bond-slave-src-mac-type برابر .Nm local است. برخی سوییچ‌ها ممکن است هنگام استفاده از یکی از دو مقدار احتمالی دیگر ایراد بگیرند (یا به این دلیل که .Li 00:00:00:00:00:00 یک MAC معتبر نیست یا به دلیل نوسان آدرس MAC از یک پورت به پورت دیگر). استفاده از .Sy local ممکن است منجر به ایجاد آدرس MAC تکراری در شبکه شود (اما این امر بسیار بعید است). .Ed .Cd configure .Cd system max-neighbors Ar neighbors .Bd -ragged -offset XXXXXX تغییر حداکثر تعداد همسایگان پذیرفته‌شده (برای هر پروتکل) روی یک رابط. این یک مقدار سراسری است. مقدار پیش‌فرض ۳۲ است. این تنظیم فقط برای همسایگان بعدی اعمال می‌شود. .Ed .Cd configure .Cd lldp agent-type .Cd nearest-bridge | nearest-non-tpmr-bridge | nearest-customer-bridge .Bd -ragged -offset XXXXXX آدرس MAC مقصد مورد استفاده برای ارسال LLDPDU به عامل اجازه می‌دهد انتشار LLDPDUها را کنترل کند. به طور پیش‌فرض، آدرس MAC .Li 01:80:c2:00:00:0e استفاده می‌شود و انتشار LLDPDU را به نزدیک‌ترین پل محدود می‌کند .Cd ( nearest-bridge ) . برای هدایت .Nm lldpd به استفاده از آدرس MAC .Li 01:80:c2:00:00:03 به جای آن، از .Cd nearest-nontpmr-bridge استفاده کنید. برای استفاده از آدرس MAC .Li 01:80:c2:00:00:00 به جای آن، از .Cd nearest-customer-bridge استفاده کنید. .Ed .Cd configure .Cd lldp capabilities-advertisements .Bd -ragged -offset XXXXXX فعال‌سازی انتشار TLV مربوط به قابلیت‌های شاسی. در حال حاضر پیش‌فرض است. .Ed .Pp .Cd unconfigure .Cd lldp capabilities-advertisements .Bd -ragged -offset XXXXXX غیرفعال‌سازی انتشار TLV قابلیت‌های شاسی. .Ed .Cd configure .Cd lldp management-addresses-advertisements .Bd -ragged -offset XXXXXX فعال‌سازی انتشار TLV آدرس مدیریتی. در حال حاضر پیش‌فرض است. .Ed .Pp .Cd unconfigure .Cd lldp management-addresses-advertisements .Bd -ragged -offset XXXXXX غیرفعال‌سازی انتشار TLV آدرس مدیریتی. .Ed .Cd configure .Cd lldp portidsubtype .Cd ifname | macaddress .Pp .Cd configure .Op ports Ar ethX Op ,... .Cd lldp portidsubtype .Cd local Ar value .Bd -ragged -offset XXXXXX اجبار زیرنوع شناسه پورت. به طور پیش‌فرض، .Nm lldpd از آدرس MAC به عنوان شناسه پورت و از نام رابط به عنوان توضیحات پورت استفاده می‌کند، مگر اینکه رابط دارای یک نام مستعار باشد. در این صورت، از نام رابط به عنوان شناسه پورت و از نام مستعار رابط به عنوان توضیحات استفاده خواهد شد. با این دستور، می‌توانید شناسه پورت را مجبور کنید که نام رابط (با .Cd ifname ) ، آدرس MAC (با .Cd macaddress ) یا یک مقدار محلی (با .Cd value ) باشد. در حالت اخیر، مقدار محلی باید ارائه شود. .Ed .Cd configure .Cd lldp portdescription-source .Cd auto | ifname | alias .Bd -ragged -offset XXXXXX انتخاب منبع مورد استفاده برای TLV توضیحات پورت. این تنظیم بر نحوه تعیین توضیحات پورت در صورتی که به صراحت ارائه نشده باشد تأثیر می‌گذارد (برای نمونه با .Cd portidsubtype local و یک توضیح). .Pp مقادیر معتبر عبارتند از: .Bl -tag -width "XXXXXXX" -compact -offset XX .It Sy auto استفاده از نام مستعار رابط به عنوان توضیحات پورت در صورتی که نام مستعار موجود باشد و زیرنوع شناسه پورت روی .Cd macaddress تنظیم نشده باشد. در غیر این صورت، از نام رابط استفاده می‌شود. این حالت پیش‌فرض بوده و رفتار پیشین را حفظ می‌کند. .It Sy ifname همیشه از نام رابط به عنوان توضیحات پورت استفاده شود. .It Sy alias استفاده از نام مستعار رابط به عنوان توضیحات پورت در صورت وجود، صرف‌نظر از زیرنوع شناسه پورت. در صورت عدم تنظیم نام مستعار، به نام رابط بازگشت می‌کند. .El .Ed .Cd configure .Op ports Ar ethX Op ,... .Cd lldp portdescription .Cd Ar description .Bd -ragged -offset XXXXXX اجبار توضیحات پورت به رشته ارائه‌شده. .Ed .Cd configure .Cd lldp tx-interval Ar interval .Bd -ragged -offset XXXXXX تغییر تأخیر ارسال به مقدار مشخص‌شده بر حسب ثانیه. تأخیر ارسال، مدت زمان بین دو ارسال LLDP PDU است. محدوده معتبر ۱ تا ۳۶۰۰ ثانیه است. مقدار پیش‌فرض ۳۰ ثانیه است. نکته: .Nm lldpd همچنین یک تایمر نوسازی مبتنی بر سیستم دیگر را روی هر پورت برای تشخیص تغییراتی مانند نام میزبان آغاز می‌کند. این مقدار برابر است با tx-interval ضرب در ۲۰. .Pp می‌توانید مقدار .Cd interval را بر حسب میلی‌ثانیه با افزودن پسوند "ms" به عدد مشخص کنید (برای نمونه "configure lldp tx-interval 1500ms" برابر ۱٫۵ ثانیه است، نه ۱۵۰۰ ثانیه). در این صورت، مقدار TTL برای فریم‌های LLDP دریافتی و ارسالی به ثانیه بعدی گرد می‌شود. نکته: بازه مؤثر ممکن است توسط قابلیت‌های سیستم‌عامل و سرعت پردازنده محدود شود. .Ed .Cd configure .Cd lldp tx-hold Ar hold .Bd -ragged -offset XXXXXX تغییر مقدار نگه‌داری ارسال به مقدار مشخص‌شده. این مقدار برای محاسبه TTL بسته‌های ارسالی استفاده می‌شود که حاصل‌ضرب این مقدار در تأخیر ارسال است. محدوده معتبر ۱ تا ۱۰۰ است. مقدار پیش‌فرض ۴ است و بنابراین TTL پیش‌فرض ۱۲۰ ثانیه خواهد بود. .Ed .Cd configure .Op ports Ar ethX Op ,... .Cd lldp .Cd status Ar rx-and-tx | rx-only | tx-only | disabled .Bd -ragged -offset XXXXXX پیکربندی وضعیت مدیریتی پورت داده‌شده. به طور پیش‌فرض، تمام پورت‌ها روی حالت .Ar rx-and-tx پیکربندی شده‌اند. این بدان معناست که آن‌ها می‌توانند فریم‌های LLDP (و همچنین سایر پروتکل‌ها در صورت نیاز) را دریافت و ارسال کنند. در حالت .Ar rx-only ، آن‌ها هیچ فریمی ارسال نمی‌کنند و در حالت .Ar tx-only ، هیچ فریمی دریافت نخواهند کرد. در حالت .Ar disabled ، هیچ فریمی ارسال نمی‌شود و هر فریم دریافتی دور ریخته خواهد شد. این تنظیم بر حالت عملیاتی دیمن اصلی ارجحیت ندارد؛ اگر دیمن در حالت فقط دریافت (با فلگ .Fl r ) پیکربندی شده باشد، تنظیم هرگونه حالت ارسال تأثیری نخواهد داشت. .Ed .Cd configure .Op ports Ar ethX Op ,... .Cd lldp .Cd vlan-tx Ar vlan_id .Op Cd prio Ar priority Op Cd dei Ar dei .Bd -ragged -offset XXXXXX پیکربندی پورت ارائه‌شده برای ارسال فریم‌های LLDP روی یک VLAN مشخص. با شناسه VLAN (VID) به صورت .Ar vlan_id ، نقطه کد اولویت (PCP) به صورت .Ar priority و نشانگر واجد شرایط حذف (DEI) به صورت .Ar dei . برنامه .Nm lldpd فریم‌های LLDP را روی تمام VLANها می‌پذیرد. .Ed .Cd configure .Op ports Ar ethX Op ,... .Cd lldp custom-tlv .Op Cd add | replace .Cd oui Ar oui .Cd subtype Ar subtype .Op Cd oui-info Ar content .Bd -ragged -offset XXXXXX انتشار یک TLV سفارشی برای OUI .Ar oui ، با زیرنوع .Ar subtype و به صورت اختیاری با بایت‌های مشخص‌شده در .Ar content . هر دو مقدار .Ar oui و .Ar content باید فهرستی از بایت‌ها در قالب هگزادسیمال جداشده با ویرگول باشند. .Ar oui باید دقیقاً ۳ بایت طول داشته باشد. اگر .Ar add مشخص شود، TLV اضافه خواهد شد. این عمل پیش‌فرض است. اگر .Ar replace مشخص شود، تمام TLVها با .Ar oui و .Ar subtype یکسان جایگزین خواهند شد. .Ed .Cd unconfigure .Op ports Ar ethX Op ,... .Cd lldp custom-tlv .Op Cd oui Ar oui .Op Cd subtype Ar subtype .Bd -ragged -offset XXXXXX هنگامی که هیچ oui مشخص نشود، تمام TLVهای سفارشی پیکربندی‌شده قبلی حذف می‌شوند. هنگامی که OUI .Ar oui و زیرنوع .Ar subtype مشخص شود، نمونه‌های خاص TLV سفارشی حذف می‌شوند. .Ed .Cd configure .Op ports Ar ethX Op ,... .Cd lldp vlan-advertisements pattern Ar pattern .Bd -ragged -offset XXXXXX پیکربندی انتشار VLAN برای پورت داده‌شده به صورت مقادیر جداشده با ویرگول (CSV). همانند رابط‌ها (که در بالا توضیح داده شد)، این گزینه می‌تواند از نویسه‌های عام و معکوس‌سازی استفاده کند. بدون این گزینه، .Nm lldpd تمام VLANها را منتشر خواهد کرد. .Ed .Cd unconfigure .Op ports Ar ethX Op ,... .Cd lldp vlan-advertisements pattern .Bd -ragged -offset XXXXXX حذف هرگونه الگوی انتشار VLAN پیکربندی‌شده قبلی برای پورت داده‌شده. .Ed .Cd configure lldp fast-start .Cd enable | tx-interval Ar interval .Bd -ragged -offset XXXXXX پیکربندی سازوکار شروع سریع پروتکل LLDP. هنگامی که یک همسایه جدید LLDP شناسایی می‌شود، شروع سریع به .Nm lldpd امکان می‌دهد بازه زمانی بین دو LLDPDU را کوتاه‌تر کند. .Cd enable شروع سریع LLDP را فعال می‌کند، در حالی که .Cd tx-interval بازه زمانی بین دو LLDPDU را بر حسب ثانیه مشخص می‌نماید. محدوده معتبر برای بازه، ۱ تا ۳۶۰۰ ثانیه است. بازه پیش‌فرض ۱ ثانیه است. پس از ارسال ۴ بسته LLDPDU، سازوکار شروع سریع تا زمان شناسایی یک همسایه جدید غیرفعال می‌شود. .Ed .Cd unconfigure lldp fast-start .Bd -ragged -offset XXXXXX غیرفعال‌سازی سازوکار شروع سریع LLDP. .Ed .Cd configure .Op ports Ar ethX Op ,... .Cd med location coordinate .Cd latitude Ar latitude .Cd longitude Ar longitude .Cd altitude Ar altitude Ar unit .Cd datum Ar datum .Bd -ragged -offset XXXXXX انتشار موقعیت مکانی مبتنی بر مختصات روی پورت‌های داده‌شده (یا روی تمام پورت‌ها در صورت مشخص نشدن پورت). قالب .Ar latitude یک عدد اعشاری ممیز شناور است که در پی آن .Em N یا .Em S می‌آید. قالب .Ar longitude یک عدد اعشاری ممیز شناور است که در پی آن .Em E یا .Em W می‌آید. .Ar altitude یک عدد اعشاری ممیز شناور است که در صورت بیان بر حسب متر در پی آن .Em m و در صورت بیان بر حسب طبقات در پی آن .Em f می‌آید. انتظار می‌رود بین عدد ممیز شناور و واحد یک فاصله قرار گیرد. .Ar datum یکی از مقادیر زیر است: .Bl -bullet -compact -offset XXXXXXXX .It WGS84 .It NAD83 .It NAD83/MLLW .El .Pp یک نمونه معتبر از کاربرد این دستور: .D1 configure ports eth0 med location coordinate latitude 48.85667N longitude 2.2014E altitude 117.47 m datum WGS84 .Ed .Cd configure .Op ports Ar ethX Op ,... .Cd med location address .Cd country Ar country .Cd Op Ar type value Op ... .Bd -ragged -offset XXXXXX انتشار یک نشانی مدنی روی پورت‌های داده‌شده (یا روی تمام پورت‌ها در صورت مشخص نشدن پورت). .Ar country کد دورقمی معرف کشور است. سایر آرگومان‌ها باید برای تشکیل نشانی به صورت جفت آورده شوند. عضو اول هر جفت نشان‌دهنده نوع عضو دوم است که یک متن آزاد می‌باشد. در اینجا فهرستی از انواع معتبر آورده شده است: .Bl -bullet -compact -offset XXXXXXXX .It language .It country-subdivision .It county .It city .It city-division .It block .It street .It direction .It trailing-street-suffix .It street-suffix .It number .It number-suffix .It landmark .It additional .It name .It zip .It building .It unit .It floor .It room .It place-type .It script .El .Pp یک نمونه معتبر از کاربرد این دستور: .D1 configure ports eth1 med location address country US street Qo Commercial Road Qc city Qo Roseville Qc .Ed .Cd configure .Op ports Ar ethX Op ,... .Cd med location elin .Ar number .Bd -ragged -offset XXXXXX انتشار در دسترس بودن شماره ELIN. این مقدار برای برقراری تماس‌های اضطراری استفاده می‌شود. اگر شماره ارائه‌شده خیلی کوچک باشد، با 0 پر خواهد شد. نمونه‌ای از کاربرد: .D1 configure ports eth2 med location elin 911 .Ed .Cd configure .Op ports Ar ethX Op ,... .Cd med policy .Cd application Ar application .Op Cd unknown .Op Cd tagged .Op Cd vlan Ar vlan .Op Cd priority Ar priority .Op Cd dscp Ar dscp .Bd -ragged -offset XXXXXX انتشار یک سیاست شبکه خاص برای پورت‌های داده‌شده (یا برای تمام پورت‌ها در صورت مشخص نشدن پورت). تنها نوع برنامه اجباری است. .Ar application باید یکی از مقادیر زیر باشد: .Bl -bullet -compact -offset XXXXXXXX .It voice .It voice-signaling .It guest-voice .It guest-voice-signaling .It softphone-voice .It video-conferencing .It streaming-video .It video-signaling .El .Pp فلگ .Cd unknown بیانگر آن است که سیاست شبکه برای نوع برنامه مشخص‌شده توسط دستگاه الزامی است اما در حال حاضر نامشخص می‌باشد. این مورد توسط دستگاه‌های پایانی (Endpoint Devices) استفاده می‌شود، نه دستگاه‌های اتصال شبکه (Network Connectivity Devices). در صورت مشخص نشدن، سیاست شبکه برای نوع برنامه داده‌شده تعریف می‌شود. .Pp یک VLAN مشخص‌شده با .Ar vlan تعیین می‌کند کدام شناسه 802.1q VLAN باید برای این سیاست شبکه منتشر شود. یک مقدار معتبر بین ۱ و ۴۰۹۴ است. .Cd tagged مشخص می‌کند که VLAN باید برای نوع برنامه مشخص‌شده برچسب‌گذاری شود. .Pp گزینه .Ar priority به شما امکان می‌دهد اولویت لایه ۲ از استاندارد IEEE 802.1d / IEEE 802.1p را که به عنوان کلاس خدمت (CoS) نیز شناخته می‌شود، برای نوع برنامه مشخص‌شده تعیین کنید. این فیلد در صورتی که هیچ VLAN تعیین نشده باشد معمولاً نادیده گرفته می‌شود. نام‌ها مطابق با استاندارد 802.1D-2004 (جدول G-2) هستند. برخی استانداردهای جدیدتر ممکن است از برچسب‌های متفاوتی استفاده کنند. تنها مقادیر عددی قابل استناد هستند. برچسب‌های پذیرفته‌شده عبارتند از: .Bl -tag -width "X." -compact -offset XXXX .It Sy 1 background .It Sy 0 best-effort .It Sy 2 excellent-effort .It Sy 3 critical-applications .It Sy 4 video .It Sy 5 voice .It Sy 6 internetwork-control .It Sy 7 network-control .El .Pp گزینه .Ar dscp نشان‌دهنده مقدار DSCP است که باید برای سیاست شبکه مشخص‌شده منتشر شود. مقدار DiffServ/Differentiated Services Code Point (DSCP) طبق تعریف در IETF RFC 2474 برای نوع برنامه مشخص‌شده. مقدار: از ۰ (پیش‌فرض طبق RFC 2475) تا ۶۳. نکته: مقادیر DSCP گزینش‌گر کلاس برای دستگاه‌هایی که تنها از قالب قدیمی اولویت IP یعنی نوع خدمت (ToS) پشتیبانی می‌کنند، دارای سازگاری رو به عقب است. (برای معنای این مقادیر به RFCها مراجعه کنید) .Pp یک نمونه معتبر از کاربرد این دستور: .D1 configure med policy application voice vlan 500 priority voice dscp 46 .Ed .Cd configure .Cd inventory hardware-revision Ar value .Bd -ragged -offset XXXXXX جایگزینی بازنگری سخت‌افزار با مقدار ارائه‌شده. به طور پیش‌فرض، بازنگری سخت‌افزار از /sys/class/dmi واکشی می‌شود. .Ed .Cd unconfigure .Cd inventory hardware-revision .Bd -ragged -offset XXXXXX عدم جایگزینی بازنگری سخت‌افزار و بازگرداندن استفاده از مقدار /sys/class/dmi. .Ed .Cd configure .Cd inventory software-revision Ar value .Bd -ragged -offset XXXXXX جایگزینی بازنگری نرم‌افزار با مقدار ارائه‌شده. به طور پیش‌فرض، بازنگری نرم‌افزار از uname واکشی می‌شود. .Ed .Cd unconfigure .Cd inventory software-revision .Bd -ragged -offset XXXXXX عدم جایگزینی بازنگری نرم‌افزار و بازگرداندن استفاده از مقدار uname. .Ed .Cd configure .Cd inventory firmware-revision Ar value .Bd -ragged -offset XXXXXX جایگزینی بازنگری سفت‌افزار با مقدار ارائه‌شده. به طور پیش‌فرض، بازنگری سفت‌افزار از /sys/class/dmi واکشی می‌شود. .Ed .Cd unconfigure .Cd inventory firmware-revision .Bd -ragged -offset XXXXXX عدم جایگزینی بازنگری سفت‌افزار و بازگرداندن استفاده از مقدار /sys/class/dmi. .Ed .Cd configure .Cd inventory serial-number Ar value .Bd -ragged -offset XXXXXX جایگزینی شماره سریال با مقدار ارائه‌شده. به طور پیش‌فرض، شماره سریال از /sys/class/dmi واکشی می‌شود. .Ed .Cd unconfigure .Cd inventory serial-number .Bd -ragged -offset XXXXXX عدم جایگزینی شماره سریال و بازگرداندن استفاده از مقدار /sys/class/dmi. .Ed .Cd configure .Cd inventory manufacturer Ar value .Bd -ragged -offset XXXXXX جایگزینی نام سازنده با مقدار ارائه‌شده. به طور پیش‌فرض، نام سازنده از /sys/class/dmi واکشی می‌شود. .Ed .Cd unconfigure .Cd inventory manufacturer .Bd -ragged -offset XXXXXX عدم جایگزینی نام سازنده و بازگرداندن استفاده از مقدار /sys/class/dmi. .Ed .Cd configure .Cd inventory model Ar value .Bd -ragged -offset XXXXXX جایگزینی مدل با مقدار ارائه‌شده. به طور پیش‌فرض، مدل از /sys/class/dmi واکشی می‌شود. .Ed .Cd unconfigure .Cd inventory model .Bd -ragged -offset XXXXXX عدم جایگزینی مدل و بازگرداندن استفاده از مقدار /sys/class/dmi. .Ed .Cd configure .Cd inventory asset Ar value .Bd -ragged -offset XXXXXX جایگزینی برچسب اموال با مقدار ارائه‌شده. به طور پیش‌فرض، اموال از /sys/class/dmi واکشی می‌شود. .Ed .Cd unconfigure .Cd inventory asset .Bd -ragged -offset XXXXXX عدم جایگزینی اموال و بازگرداندن استفاده از مقدار /sys/class/dmi. .Ed .Cd configure .Op ports Ar ethX Op ,... .Cd med power pse | pd .Cd source Ar source .Cd priority Ar priority .Cd value Ar value .Bd -ragged -offset XXXXXX انتشار TLV مربوط به LLDP-MED POE-MDI برای پورت‌های داده‌شده یا برای تمام رابط‌ها در صورت مشخص نشدن پورت. دستگاه می‌تواند به عنوان یک PD (مصرف‌کننده توان) یا PSE (تأمین‌کننده توان) عمل کند. هیچ بررسی روی صحت پارامترها انجام نمی‌شود، در حالی که LLDP-MED نیازمند برخی محدودیت‌ها است: .Bl -bullet .It دستگاه PD هرگز نباید توانی بیش از کلاس فیزیکی 802.3af درخواست کند. .It دستگاه PD هرگز نباید توانی بیش از حداکثر توان منتشرشده توسط PSE دریافت نماید. .It دستگاه PSE نباید توان تخصیص‌یافته به PD را هنگامی که این توان در حال استفاده است کاهش دهد. .It دستگاه PSE ممکن است با استفاده از حالت صرفه‌جویی درخواست کاهش توان دهد. .It بودن به عنوان PSE یا PD یک پارامتر سراسری است، نه پارامتری برای هر پورت. .Nm این محدودیت را اعمال نمی‌کند: یک پورت می‌تواند به عنوان PD یا PSE تنظیم شود. همچنین LLDP-MED نیازمند آن است که یک PSE تنها یک منبع تغذیه (اصلی یا پشتیبان) داشته باشد. باز هم، .Nm این محدودیت را اعمال نمی‌کند. هر پورت می‌تواند منبع تغذیه خودش را داشته باشد. همین امر برای PD و اولویت توان نیز صدق می‌کند. MIB مربوط به LLDP-MED چنین نمایشی را مجاز نمی‌داند. .El .Pp انواع معتبر عبارتند از: .Bl -tag -width "XXX." -compact -offset XX .It Sy pse موجودیت تأمین‌کننده توان (Power Sourcing Entity) .It Sy pd دستگاه مصرف‌کننده توان (Power Device) .El .Pp منابع معتبر عبارتند از: .Bl -tag -width "XXXXXXX" -compact -offset XX .It Sy unknown نامشخص .It Sy primary برای PSE، منبع توان منبع اصلی است. .It Sy backup برای PSE، منبع توان منبع پشتیبان است، یا یک حالت صرفه‌جویی در مصرف توان درخواست شده است (برای نمونه ممکن است PSE با UPS کار کند). .It Sy pse برای PD، منبع توان همان PSE است. .It Sy local برای PD، منبع توان یک منبع محلی است. .It Sy both برای PD، منبع توان هم PSE و هم یک منبع محلی است. .El .Pp اولویت‌های معتبر عبارتند از: .Bl -tag -width "XXXXXXXXX" -compact -offset XX .It Sy unknown اولویت نامشخص .It Sy critical بحرانی .It Sy high بالا .It Sy low پایین .El .Pp مقدار .Ar value باید کل توان بر حسب میلی‌وات باشد که توسط دستگاه PD مورد نیاز است یا توسط دستگاه PSE در دسترس قرار دارد. .Pp نمونه‌ای از کاربرد: .D1 configure med power pd source pse priority high value 5000 .Ed .Cd configure .Op ports Ar ethX Op ,... .Cd dot3 power pse | pd .Op Cd supported .Op Cd enabled .Op Cd paircontrol .Cd powerpairs Ar powerpairs .Op Cd class Ar class .Op Cd type Ar type Cd source Ar source Cd priority Ar priority Cd requested Ar requested Cd allocated Ar allocated .Bd -ragged -offset XXXXXX انتشار Dot3 POE-MDI TLV برای پورت داده‌شده یا برای تمام پورت‌ها در صورت مشخص نشدن. می‌توان به عنوان یک PD (مصرف‌کننده توان) یا یک PSE (تأمین‌کننده توان) عمل کرد. این پیکربندی از پیکربندی ارسال LLDP-MED POE-MDI TLV متمایز است اما کاربر در صورت استفاده همزمان از هر دو، باید از هماهنگی و سازگاری این دو پیکربندی اطمینان حاصل کند. .Pp .Sy supported به این معناست که توان MDI روی پورت مشخص‌شده پشتیبانی می‌شود، در حالی که .Sy enabled به معنای فعال بودن توان MDI است. .Sy paircontrol برای نشان دادن اینکه آیا انتخاب زوج‌سیم‌ها قابل کنترل است یا خیر به کار می‌رود. مقادیر معتبر برای .Ar powerpairs عبارتند از: .Bl -tag -width "XXXXXX" -compact -offset XX .It Sy signal تنها زوج‌های سیگنال در حال استفاده هستند. .It Sy spare تنها زوج‌های یدکی در حال استفاده هستند. .El .Pp در صورت مشخص شدن، .Ar class به صورت .Ar class- با پسوند عددی از ۰ تا ۴ است. برای نمونه .Ar class-0 ، .Ar class-1 ، .Ar class-2 ، .Ar class-3 ، .Ar class-4 . .Pp برای استاندارد 802.3at، کلاس‌ها به شرح زیر هستند: .Bl -tag -width "XXXXXX" -compact -offset XX .It Sy 0 پیش‌فرض (نامشخص)، PD بین ۰٫۴۴ تا ۱۲٫۹۵ وات، PSE برابر ۱۵٫۴ وات .It Sy 1 دستگاه با توان بسیار کم، PD بین ۰٫۴۴ تا ۳٫۸۴ وات، PSE برابر ۴٫۰ وات .It Sy 2 دستگاه با توان کم، PD بین ۳٫۸۴ تا ۶٫۴۹ وات، PSE برابر ۷٫۰ وات .It Sy 3 دستگاه با توان متوسط، PD بین ۶٫۴۹ تا ۱۲٫۹۵ وات، PSE برابر ۱۵٫۴ وات .It Sy 4 دستگاه با توان بالا (PoE+)، PD بین ۱۲٫۹۵ تا ۲۵٫۵ وات، PSE برابر ۳۰٫۰ وات .El .Pp بقیه پارامترها مطابق با استاندارد 802.3at بوده و اختیاری هستند. .Ar type باید ۱ یا ۲ باشد که نشان می‌دهد آیا دستگاه با 802.3at نوع ۱ یا 802.3at نوع ۲ مطابقت دارد. مقادیر .Ar source و .Ar priority مشابه مقادیر LLDP-MED POE-MDI TLV هستند. .Ar requested و .Ar allocated بر حسب میلی‌وات بیان می‌شوند. .Pp دو نمونه معتبر از کاربرد این دستور: .D1 configure ports eth3 dot3 power pse supported enabled paircontrol powerpairs spare class class-3 .D1 configure dot3 power pd supported enabled powerpairs spare class class-3 type 1 source pse priority low requested 10000 allocated 15000 .Ed .Cd pause .Bd -ragged -offset XXXXXX متوقف کردن موقت عملیات .Nm lldpd . برنامه .Nm lldpd دیگر هیچ فریمی ارسال یا دریافت نخواهد کرد. این عمل را می‌توان با دستور .Cd resume خنثی کرد. این دستور تنها به صورت تعاملی عمل می‌کند زیرا lldpd پس از خواندن فایل پیکربندی از lldpcli می‌خواهد که عملیات را از حالت تعلیق خارج کند. .Ed .Cd resume .Bd -ragged -offset XXXXXX از سرگیری عملیات .Nm lldpd . برنامه .Nm lldpd ارسال و دریافت فریم‌ها را آغاز خواهد کرد. این دستور پس از پردازش پیکربندی به صورت داخلی صادر می‌شود، اما هر زمان که دستور دستی .Cd pause صادر شده باشد نیز قابل استفاده است. .Ed .Ed .Sh "فایل‌ها (FILES)" .Bl -tag -width "/run/lldpd/socketXX" -compact .It /run/lldpd/socket سوکت دامنه یونیکس مورد استفاده برای ارتباط با .Xr lldpd 8 . .El .Sh "همچنین ببینید (SEE ALSO)" .Xr lldpd 8 .Sh "نویسندگان (AUTHORS)" .An -nosplit برنامه .Nm توسط .An Vincent Bernat Aq bernat@luffy.cx نوشته شده است.