smpquery(8)                   Open IB Diagnostics                  smpquery(8)

نام (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> >

                                  2017-08-21                       smpquery(8)