| ibroute(8) | Open IB Diagnostics | ibroute(8) |
نام (NAME)
ibroute - جدولهای هدایت سوئیچ اینفینیباند را پرسوجو میکند
خلاصه دستور (SYNOPSIS)
ibroute [options] [<dest dr_path|lid|guid> [<startlid> [<endlid>]]]
توضیحات (DESCRIPTION)
دستور ibroute از بستههای SMP برای نمایش جدولهای هدایت (تکپخشی (LinearForwardingTable یا LFT) یا چندپخشی (MulticastForwardingTable یا MFT)) برای LID سوئیچ مشخصشده و محدوده اختیاری lid (یا mlid) استفاده میکند. محدوده پیشفرض، همه مدخلهای معتبر در بازه 1...FDBTop است.
گزینهها (OPTIONS)
- -a, --all
- نمایش همه lidها در محدوده، حتی مدخلهای نامعتبر.
- -n, --no_dests
- تلاشی برای حل مقصدها انجام ندهد.
- -M, --Multicast
- نمایش جدولهای هدایت چندپخشی. در این حالت، پارامترهای محدوده مشخصکننده بازه mlid هستند.
فلگهای آدرسدهی (Addressing Flags)
-D, --Direct آدرس مشخصشده یک مسیر هدایتشده (directed route) است
Examples: [options] -D [options] "0" # self port [options] -D [options] "0,1,2,1,4" # out via port 1, then 2, ... (Note the second number in the path specified must match the port being used. This can be specified using the port selection flag '-P' or the port found through the automatic selection process.)
-G, --Guid آدرس مشخصشده یک Port GUID است
-L, --Lid آدرس مشخصشده یک LID است
-s, --sm_port <smlid> استفاده از 'smlid' به عنوان lid هدف برای پرسوجوهای SA.
فلگهای انتخاب درگاه (Port Selection flags)
-C, --Ca <ca_name> استفاده از ca_name مشخصشده.
-P, --Port <ca_port> استفاده از ca_port مشخصشده.
- -Y, --pkey-idx <idx>
- نمایه جدول P_Key (مقدار 0-65535، پیشفرض 0) که برای بستههای خروجی SA/GMP MAD استفاده میشود. بستههای SMP (مسیر هدایتشده SMI یا هدایتشده با LID) همیشه از نمایه P_Key برابر با 0 استفاده میکنند.
انتخاب درگاه محلی (Local port Selection)
پشتیبانی از چندین درگاه/چندین CA: هنگامی که هیچ دستگاه یا درگاه IB مشخص نشده باشد (بخش «پارامترهای محلی umad» در زیر را ببینید)، کتابخانه libibumad درگاه مورد استفاده را بر اساس معیارهای زیر انتخاب میکند:
- 1.
- نخستین درگاهی که ACTIVE باشد.
- 2.
- در صورت پیدا نشدن، نخستین درگاهی که UP باشد (پیوند فیزیکی متصل باشد).
اگر نام درگاه یا CA مشخص شده باشد، کتابخانه libibumad تلاش میکند تا درخواست کاربر را برآورده سازد، و در صورت عدم امکان شکست میخورد.
به عنوان مثال:
ibaddr # use the first port (criteria #1 above) ibaddr -C mthca1 # pick the best port from "mthca1" only. ibaddr -P 2 # use the second (active/up) port from the first available IB device. ibaddr -C mthca0 -P 2 # use the specified port only.
فلگهای اشکالزدایی (Debugging flags)
- -d
- افزایش سطح اشکالزدایی IB. میتوان چندین بار استفاده کرد (-ddd یا -d -d -d).
- -e
- نمایش خطاهای ارسال و دریافت (مهلت زمانی و موارد دیگر).
-h, --help نمایش پیام راهنمای نحوه استفاده
- -v, --verbose
- افزایش سطح جزئیات برنامه. میتوان چندین بار استفاده کرد (-vv یا -v -v -v).
-V, --version نمایش اطلاعات نسخه.
فلگهای پیکربندی (Configuration flags)
-t, --timeout <timeout_ms> بازنویسی مهلت زمانی پیشفرض برای madهای درخواستشده.
- -y, --m_key <key>
- استفاده از M_key مشخصشده برای درخواستها. اگر یک مقدار غیرعددی (مانند 'x') مشخص شود، مقدار از کاربر پرسیده خواهد شد.
--node-name-map <node-name-map> نگاشت نام گره را مشخص میکند.
--config, -z <config_file> مشخص کردن فایل پیکربندی جایگزین.
فایلها (FILES)
فایل پیکربندی (CONFIG FILE)
/etc/infiniband-diags/ibdiag.conf
یک فایل پیکربندی سراسری برای تنظیم برخی از گزینههای مشترک میان تمام ابزارها ارائه شده است. برای جزئیات بیشتر به فایل پیکربندی ارائهشده مراجعه کنید.
قالب فایل نگاشت نام گره (NODE NAME MAP FILE FORMAT)
نگاشت نام گره برای مشخص کردن نامهای کاربرپسند برای گرهها در خروجی استفاده میشود. برای انجام این جستجو از GUIDها استفاده میشود.
این قابلیت توسط بسته opensm-libs ارائه میشود. برای آگاهی از مکان فایل در توزیع خود، به opensm(8) مراجعه کنید.
به طور کلی:
# comment <guid> "<name>"
مثال:
# IB1 # Line cards 0x0008f104003f125c "IB1 (Rack 11 slot 1 ) ISR9288/ISR9096 Voltaire sLB-24D" 0x0008f104003f125d "IB1 (Rack 11 slot 1 ) ISR9288/ISR9096 Voltaire sLB-24D" 0x0008f104003f10d2 "IB1 (Rack 11 slot 2 ) ISR9288/ISR9096 Voltaire sLB-24D" 0x0008f104003f10d3 "IB1 (Rack 11 slot 2 ) ISR9288/ISR9096 Voltaire sLB-24D" 0x0008f104003f10bf "IB1 (Rack 11 slot 12 ) ISR9288/ISR9096 Voltaire sLB-24D" # Spines 0x0008f10400400e2d "IB1 (Rack 11 spine 1 ) ISR9288 Voltaire sFB-12D" 0x0008f10400400e2e "IB1 (Rack 11 spine 1 ) ISR9288 Voltaire sFB-12D" 0x0008f10400400e2f "IB1 (Rack 11 spine 1 ) ISR9288 Voltaire sFB-12D" 0x0008f10400400e31 "IB1 (Rack 11 spine 2 ) ISR9288 Voltaire sFB-12D" 0x0008f10400400e32 "IB1 (Rack 11 spine 2 ) ISR9288 Voltaire sFB-12D" # GUID Node Name 0x0008f10400411a08 "SW1 (Rack 3) ISR9024 Voltaire 9024D" 0x0008f10400411a28 "SW2 (Rack 3) ISR9024 Voltaire 9024D" 0x0008f10400411a34 "SW3 (Rack 3) ISR9024 Voltaire 9024D" 0x0008f104004119d0 "SW4 (Rack 3) ISR9024 Voltaire 9024D"
مثالها (EXAMPLES)
مثالهای تکپخشی (Unicast)
ibroute 4 # dump all lids with valid out ports of switch with lid 4 ibroute -a 4 # same, but dump all lids, even with invalid out ports ibroute -n 4 # simple dump format - no destination resolution ibroute 4 10 # dump lids starting from 10 (up to FDBTop) ibroute 4 0x10 0x20 # dump lid range ibroute -G 0x08f1040023 # resolve switch by GUID ibroute -D 0,1 # resolve switch by direct path
مثالهای چندپخشی (Multicast)
ibroute -M 4 # dump all non empty mlids of switch with lid 4 ibroute -M 4 0xc010 0xc020 # same, but with range ibroute -M -n 4 # simple dump format
همچنین ببینید (SEE ALSO)
نویسندگان (AUTHORS)
- Hal Rosenstock
- < <halr@voltaire.com> >
| 2017-08-21 |