IBADDR(8)                     OpenIB Diagnostics                     IBADDR(8)

نام (NAME)
       ibaddr - استعلام آدرس(های) اینفینی‌باند

خلاصه دستور (SYNOPSIS)
       ibaddr [options]

توضیحات (DESCRIPTION)
       نمایش lid (و محدوده آن) و همچنین نشانی GID درگاه مشخص‌شده (با مسیر DR،
       lid یا GUID) یا درگاه محلی به صورت پیش‌فرض.

       نکته: این ابزار می‌تواند به عنوان یک حل‌کننده ساده نشانی (address
       resolver) استفاده شود.

گزینه‌ها (OPTIONS)
       --gid_show, -g تنها نمایش نشانی gid

       --lid_show, -l تنها نمایش محدوده lid

       --Lid_show, -L تنها نمایش محدوده lid (در مبنای ده‌دهی)

   فلگ‌های آدرس‌دهی (Addressing Flags)
       -D, --Direct     نشانی مشخص‌شده یک مسیر هدایت‌شده (directed route) است

          مثال‌ها:
             [options] -D [options] "0"          # درگاه خود (self port)
             [options] -D [options] "0,1,2,1,4"  # خروج از طریق درگاه 1، سپس 2، ...

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

       -G, --Guid     نشانی مشخص‌شده یک Port GUID است

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

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

       -d     افزایش سطح اشکال‌زدایی IB.  می‌تواند چندین بار استفاده شود (-ddd
              یا -d -d -d).

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

       -h, --help      نمایش پیام راهنمای نحوه استفاده

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

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

   فلگ‌های انتخاب درگاه (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  # فقط استفاده از درگاه مشخص‌شده.

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

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

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

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

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

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

مثال‌ها (EXAMPLES)

          ibaddr                  # نشانی درگاه محلی
          ibaddr 32               # نمایش محدوده lid و gid مربوط به lid 32
          ibaddr -G 0x8f1040023   # همان مورد ولی با استفاده از نشانی guid
          ibaddr -l 32            # تنها نمایش محدوده lid
          ibaddr -L 32            # تنها نمایش محدوده lid در مبنای ده‌دهی
          ibaddr -g 32            # تنها نمایش نشانی gid

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

نویسنده (AUTHOR)

       Hal Rosenstock
              < <halr@voltaire.com> >

                                  2013-10-11                         IBADDR(8)