ibtracert(8)                  Open IB Diagnostics                 ibtracert(8)

نام (NAME)
       ibtracert - ردگیری مسیر اینفینی‌باند

خلاصه دستور (SYNOPSIS)
       ibtracert [options] [<lid|guid> [<startlid> [<endlid>]]]

توضیحات (DESCRIPTION)
       دستور ibtracert از بسته‌های SMP برای ردگیری مسیر از یک GID/LID مبدا به
       یک GID/LID مقصد استفاده می‌کند.  هر گام (hop) در امتداد مسیر تا زمانی که
       به مقصد برسد یا پاسخی از یک گام دریافت نشود، نمایش داده می‌شود.  با
       استفاده از گزینه -m، می‌توان ردگیری مسیر چندپخشی (multicast) را بین
       گره‌های مبدا و مقصد انجام داد.

گزینه‌ها (OPTIONS)

       -n, --no_info
              قالب ساده؛ اطلاعات اضافی را نشان ندهد.

       -m     نمایش ردگیری چندپخشی مربوط به mlid مشخص‌شده.

       -f, --force
              مسیردهی اجباری به درگاه مقصد.

   فلگ‌های آدرس‌دهی (Addressing Flags)
       -G, --Guid     آدرس مشخص‌شده یک Port GUID است

       -L, --Lid   آدرس مشخص‌شده یک LID است

       -s, --sm_port <smlid>     استفاده از 'smlid' به عنوان lid هدف برای
       پرس‌وجوهای SA.

       --ports-file <ports-file>   مشخص کردن یک فایل درگاه‌ها.
          این فایل شامل چندین جفت lid یا guid مبدا و مقصد است. بخش «فایل‌ها
          (FILES)» را ببینید.

   فلگ‌های انتخاب درگاه (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                 # استفاده از نخستین درگاه (معیار شماره ۱ در بالا)
             ibaddr -C mthca1       # انتخاب بهترین درگاه فقط از "mthca1"
             ibaddr -P 2            # استفاده از دومین درگاه (active/up) از نخستین دستگاه IB موجود
             ibaddr -C mthca0 -P 2  # فقط استفاده از درگاه مشخص‌شده

   فلگ‌های اشکال‌زدایی (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"

   قالب فایل درگاه‌ها (PORTS FILE FORMAT)
       فایل درگاه‌ها می‌تواند برای مشخص کردن چندین جفت مبدا و مقصد استفاده شود.
       آن‌ها می‌توانند lid یا guid باشند. در صورت استفاده از guid، برای مشخص
       کردن آن از گزینه -G استفاده کنید.

       به طور کلی:

          # comment
          <src> <dst>

       مثال:

          73 207
          203 657
          531 101

          > یا <

          0x0008f104003f125c 0x0008f104003f133d
          0x0008f1040011ab07 0x0008f104004265c0
          0x0008f104007c5510 0x0008f1040099bb08

مثال‌ها (EXAMPLES)
       مثال‌های تک‌پخشی (Unicast)

          ibtracert 4 16                                  # نمایش مسیر بین lidهای 4 و 16
          ibtracert -n 4 16                               # همان مورد، اما با استفاده از قالب خروجی ساده
          ibtracert -G 0x8f1040396522d 0x002c9000100d051  # استفاده از نشانی‌های guid

       مثال چندپخشی (Multicast)

          ibtracert -m 0xc000 4 16    # نمایش مسیر چندپخشی mlid 0xc000 بین lidهای 4 و 16

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

نویسندگان (AUTHORS)

       Hal Rosenstock
              <<hal.rosenstock@gmail.com>>

       Ira Weiny
              < <ira.weiny@intel.com> >

                                  2018-04-02                      ibtracert(8)