نام (NAME)

smpquery - پرس‌وجوی ویژگی‌های مدیریت زیرشبکه اینفینی‌باند (InfiniBand)

خلاصه دستور (SYNOPSIS)

smpquery [گزینه‌ها] <op> <dest dr_path|lid|guid> [op params]

توضیحات (DESCRIPTION)

ابزار smpquery امکان اجرای زیرمجموعه‌ای پایه‌ای از پرس‌وجوهای استاندارد SMP را فراهم می‌کند، از جمله: اطلاعات گره (node info)، شرح گره (node description)، اطلاعات سوئیچ (switch info) و اطلاعات درگاه (port info). فیلدها در قالبی خوانا برای انسان نمایش داده می‌شوند.

گزینه‌ها (OPTIONS)

عملیات پشتیبانی‌شده فعلی (بدون حساسیت به بزرگی و کوچکی حروف) و پارامترهای آن‌ها:

Nodeinfo (NI) <addr>
Nodedesc (ND) <addr>
Portinfo (PI) <addr> [<portnum>]     # default port is zero
PortInfoExtended (PIE) <addr> [<portnum>]
Switchinfo (SI) <addr>
PKeyTable (PKeys) <addr> [<portnum>]
SL2VLTable (SL2VL) <addr> [<portnum>]
VLArbitration (VLArb) <addr> [<portnum>]
GUIDInfo (GI) <addr>
MlnxExtPortInfo (MEPI) <addr> [<portnum>]  # default port is zero

-c, --combined: استفاده از آرگومان آدرس مسیر ترکیبی (Combined route) <lid> <DR_Path>
-x, --extended: تنظیم بیت ۳۱ SMSupportsExtendedSpeeds در AttributeModifier (تنها بر پرس‌وجوهای PortInfo تأثیر می‌گذارد).

-K, --show_keys: نمایش کلیدهای امنیتی (mkey، smkey و غیره) مرتبط با درخواست.

فلگ‌های آدرس‌دهی (Addressing Flags)

-D, --Direct آدرس مشخص‌شده یک مسیر هدایت‌شده است

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) همیشه از نمایه 0 جدول P_Key استفاده می‌کنند.

انتخاب درگاه محلی (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های درخواست‌شده.

--node-name-map <node-name-map> یک نگاشت نام گره را مشخص می‌کند.

این فایل GUIDها را به نام‌های کاربرپسندتر نگاشت می‌کند. بخش «فایل‌ها (FILES)» را ببینید.

-y, --m_key <key>: استفاده از M_key مشخص‌شده برای درخواست‌ها. اگر یک مقدار غیرعددی (مانند 'x') مشخص شود، مقدار از کاربر پرسیده خواهد شد.

--config, -z <config_file> مشخص کردن فایل پیکربندی جایگزین.

پیش‌فرض: /etc/infiniband-diags/ibdiag.conf

فایل‌ها (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)

smpquery portinfo 3 1                     # portinfo by lid, with port modifier
smpquery -G switchinfo 0x2C9000100D051 1  # switchinfo by guid
smpquery -D nodeinfo 0                    # nodeinfo by direct route
smpquery -c nodeinfo 6 0,12               # nodeinfo by combined route

همچنین ببینید (SEE ALSO)

smpdump(8)

نویسنده (AUTHOR)

Hal Rosenstock: < <hal@mellanox.com> >