IBLINKINFO(8)                 OpenIB Diagnostics                 IBLINKINFO(8)

نام (NAME)
       iblinkinfo - گزارش اطلاعات پیوند برای تمام پیوندهای موجود در فابریک

خلاصه دستور (SYNOPSIS)
       iblinkinfo [گزینه‌ها]

توضیحات (DESCRIPTION)
       دستور iblinkinfo اطلاعات پیوند را برای هر پورت در یک فابریک اینفینی‌باند
       (IB)، به‌صورت گره به گره گزارش می‌دهد.  به‌صورت اختیاری، iblinkinfo
       می‌تواند پویش‌های جزئی انجام داده و خروجی خود را به بخش‌هایی از فابریک
       محدود سازد.

گزینه‌ها (OPTIONS)
       --down, -d تنها گره‌هایی را چاپ می‌کند که پورتی در وضعیت «Down» (غیرفعال)
       دارند.

       --line, -l تمام اطلاعات هر پیوند را در یک خط چاپ می‌کند. حالت پیش‌فرض،
       چاپ یک سرآیند حاوی اطلاعات گره و سپس فهرستی برای هر پورت است (برای
       فیلتر کردن خروجی با grep مفید است).

       --additional, -p تنظیمات اضافی پورت را چاپ می‌کند
       (<LifeTime>,<HoqLife>,<VLStallCount>).

       --switches-only تنها سوییچ‌ها را در خروجی نمایش می‌دهد.

       --cas-only تنها CAها (آداپتورهای کانال) را در خروجی نمایش می‌دهد.

   گزینه‌های پویش جزئی (Partial Scan flags)
       گره آغاز پویش جزئی را می‌توان با نشانی‌های زیر مشخص کرد.

       --port-guid, -G <port_guid>  مشخص کردن یک port_guid.

       -D, --Direct <dr_path>     نشانی مشخص‌شده یک مسیر هدایت‌شده (directed
       route) است.

          مثال‌ها:
             -D "0"          # پورت خود
             -D "0,1,2,1,4"  # خروج از طریق پورت ۱، سپس ۲، ...

             (توجه داشته باشید که عدد دوم در مسیر مشخص‌شده باید با پورت مورد استفاده
             مطابقت داشته باشد. این مقدار را می‌توان با استفاده از پرچم انتخاب پورت '-P' یا
             پورت یافت‌شده از طریق فرآیند انتخاب خودکار مشخص کرد.)

       نکته: برای سوییچ‌ها، نتایج برای همه پورت‌ها چاپ می‌شود، نه فقط پورت ۰
       سوییچ.

       --switch, -S <port_guid> مشابه "-G" است. (تنها برای سازگاری با نسخه‌های
       پیشین ارائه شده است)

       میزان نتایج پویش برای چاپ را می‌توان با موارد زیر کنترل کرد.

       --all, -a تمام گره‌های یافت‌شده در یک پویش جزئی فابریک را چاپ می‌کند.
       معمولاً یک پویش جزئی فابریک تنها گره مشخص‌شده را برمی‌گرداند. این گزینه
       سایر گره‌های یافت‌شده را نیز چاپ خواهد کرد.

       --hops, -n <hops> تعداد گام‌ها (hops) دورتر از گره مشخص‌شده را برای پویش
       تعیین می‌کند. این گزینه برای گسترش یک پویش جزئی فابریک فراتر از گره
       مشخص‌شده مفید است.

   گزینه‌های فایل کَش (Cache File flags)
       --load-cache <filename> بارگیری و استفاده از داده‌های ذخیره‌شده
       ibnetdiscover در فایل مشخص‌شده.  ممکن است برای نمایش خروجی و بررسی سایر
       فابریک‌ها یا وضعیت پیشین یک فابریک مفید باشد.

       --diff <filename> بارگیری داده‌های ذخیره‌شده ibnetdiscover و انجام مقایسه
       تفاضلی (diff) با شبکه فعلی یا یک کَش دیگر. یک خروجی تفاضلی ویژه برای
       خروجی ibnetdiscover نمایش داده خواهد شد که تفاوت‌های میان فابریک قدیمی و
       فعلی را نشان می‌دهد. به‌طور پیش‌فرض، موارد زیر برای تفاوت‌ها مقایسه می‌شوند:
       سوییچ‌ها، آداپتورهای کانال، مسیریاب‌ها و اتصالات پورت.

       --diffcheck <key(s)> مشخص کردن اینکه چه بررسی‌های تفاضلی باید در گزینه
       --diff بالا انجام شود. چندین کلید بررسی تفاوت را با کاما جدا کنید.
       بررسی‌های تفاوت موجود عبارتند از: port = اتصالات پورت، state = وضعیت
       پورت، lid = شناسه‌های LID، و nodedesc = توصیف‌های گره. توجه داشته باشید
       که port، lid و nodedesc تنها برای انواع گره‌های مشخص‌شده بررسی می‌شوند
       (مانند switches-only، cas-only). اگر port در کنار lid یا nodedesc مشخص
       شود، LIDها و توصیف‌های گره برای پورت‌های دوردست نیز مقایسه خواهند شد.

       --filterdownports <filename> فیلتر کردن پورت‌های غیرفعال (down) مشخص‌شده
       در یک کَش ibnetdiscover. اگر پورتی پیش‌تر در کَش مشخص‌شده به عنوان غیرفعال
       نشان داده شده باشد و هنوز هم غیرفعال باشد، آن را در خروجی حاصل نمایش
       نمی‌دهد. این گزینه به‌ویژه برای محیط‌هایی مفید است که سوییچ‌ها به‌طور کامل
       پر نشده‌اند و بنابراین بسیاری از اطلاعات پیش‌فرض iblinkinfo بی‌استفاده
       تلقی می‌شود. برای اطلاعات بیشتر در مورد کَش کردن خروجی ibnetdiscover، به
       ibnetdiscover مراجعه کنید.

   گزینه‌های انتخاب پورت (Port Selection flags)
       -C, --Ca <ca_name>    استفاده از ca_name مشخص‌شده.

       -P, --Port <ca_port>    استفاده از ca_port مشخص‌شده.

       -Y, --pkey-idx <idx>
              شاخص جدول P_Key (از ۰ تا ۶۵۵۳۵، پیش‌فرض ۰) مورد استفاده برای
              بسته‌های MAD خروجی SA/GMP.  بسته‌های SMP MAD (مسیر مستقیم SMI /
              هدایت‌شده با LID) همیشه از شاخص ۰ جدول P_Key استفاده می‌کنند.

   انتخاب پورت محلی (Local port Selection)
       پشتیبانی از چندین پورت/چندین CA: هنگامی که هیچ دستگاه یا پورت IB مشخص
       نشده باشد (به "پارامترهای محلی umad" در زیر مراجعه کنید)، کتابخانه
       libibumad پورت مورد استفاده را بر اساس معیارهای زیر انتخاب می‌کند:

          1. نخستین پورتی که ACTIVE (فعال) باشد.

          2. در صورت پیدا نشدن، نخستین پورتی که UP (پیوند فیزیکی برقرار) باشد.

          اگر نام پورت و/یا CA مشخص شده باشد، کتابخانه libibumad تلاش می‌کند
          درخواست کاربر را برآورده سازد و در صورت عدم امکان شکست خواهد خورد.

          برای مثال:

             ibaddr                 # استفاده از نخستین پورت (معیار ۱ در بالا)
             ibaddr -C mthca1       # انتخاب بهترین پورت تنها از "mthca1"
             ibaddr -P 2            # استفاده از پورت دوم (فعال/برقرار) از نخستین دستگاه IB موجود
             ibaddr -C mthca0 -P 2  # تنها استفاده از پورت مشخص‌شده

   گزینه‌های پیکربندی (Configuration flags)
       --config, -z  <config_file> مشخص کردن فایل پیکربندی جایگزین.
          پیش‌فرض: /etc/infiniband-diags/ibdiag.conf

       --outstanding_smps, -o <val>
              مشخص کردن تعداد SMPهای معوقی که باید در طول پویش صادر شوند.

              پیش‌فرض: ۲

       --node-name-map <node-name-map> مشخص کردن یک فایل نگاشت نام گره.
          این فایل GUIDها را به نام‌های کاربرپسندتر نگاشت می‌کند. به بخش «فایل‌ها
          (FILES)» مراجعه کنید.

       -t, --timeout <timeout_ms> لغو و جایگزینی مهلت زمانی پیش‌فرض برای
       بسته‌های MAD درخواست‌شده.

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

   گزینه‌های اشکال‌زدایی (Debugging flags)

       -e     نمایش خطاهای ارسال و دریافت (مهلت زمانی و موارد دیگر).

       -h, --help      نمایش پیام راهنما.

       -v, --verbose
              افزایش سطح پرگویی و جزئیات برنامه.  می‌تواند چندین بار استفاده
              شود (-vv یا -v -v -v).

       -V, --version     نمایش اطلاعات نسخه.

وضعیت خروج (EXIT STATUS)
       ۰ در صورت موفقیت، ۱- در صورت عدم موفقیت در پویش فابریک، و ۱ در صورتی که
       حالت بررسی استفاده شده و ناهمخوانی‌هایی یافت شود.

فایل‌ها (FILES)
   فایل پیکربندی (CONFIG FILE)
       /etc/infiniband-diags/ibdiag.conf

       یک فایل پیکربندی سراسری برای تنظیم برخی از گزینه‌های مشترک تمامی ابزارها
       ارائه شده است.  برای جزئیات بیشتر به فایل پیکربندی ارائه‌شده مراجعه
       کنید.

   قالب فایل نگاشت نام گره (NODE NAME MAP FILE FORMAT)
       فایل نگاشت نام گره برای مشخص کردن نام‌های کاربرپسند برای گره‌ها در خروجی
       استفاده می‌شود.  از GUIDها برای جستجو و تطبیق استفاده می‌گردد.

       این قابلیت توسط بسته opensm-libs ارائه شده است. برای مشاهده مکان فایل
       در نصب سیستم خود، به opensm(8) مراجعه کنید.

       به‌طور کلی:

          # توضیح
          <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"

همچنین ببینید (SEE ALSO)
       ibnetdiscover(8), opensm(8)

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

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

                                  2018-07-09                     IBLINKINFO(8)