گزینه‌های پویش جزئی (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 مشخص‌شده.

انتخاب پورت محلی (Local port Selection)

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

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

گزینه‌های پیکربندی (Configuration flags)

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

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

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

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

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

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

فایل پیکربندی (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"