نام (NAME)

ibportstate - مدیریت وضعیت (فیزیکی) درگاه و سرعت پیوند یک درگاه InfiniBand

خلاصه دستور (SYNOPSIS)

ibportstate [options] <dest dr_path|lid|guid> <portnum> [<op>]

توضیحات (DESCRIPTION)

دستور ibportstate امکان استعلام وضعیت درگاه و وضعیت فیزیکی درگاه یک درگاه IB را فراهم می‌کند (علاوه بر اعتبارسنجی پهنا و سرعت پیوند نسبت به درگاه همتا هنگامی که درگاه مورد استعلام یک درگاه سوییچ باشد)، یا اینکه یک درگاه سوییچ غیرفعال، فعال یا بازنشانی شود. وضعیت درگاه InfiniBand HCA ممکن است به‌صورت محلی و بدون اطلاع مدیر زیرشبکه (Subnet Manager) تغییر یابد. همچنین امکان تنظیم سرعت/پهنای پیوند فعال‌شده روی هر درگاه IB را فراهم می‌کند.

گزینه‌ها (OPTIONS)

<op>

عملیات‌های پشتیبانی‌شده: enable, disable, reset, speed, espeed, fdr10, width, query,: on, off, down, arm, active, vls, mtu, lid, smlid, lmc, mkey, mkeylease, mkeyprot (پیش‌فرض query است)

دستورات enable, disable, and reset وضعیت یک درگاه سوییچ یا HCA را تغییر داده یا بازنشانی می‌کنند (هنگام تغییر محلی وضعیت درگاه CA باید نام CA و شماره Port را مشخص کنید.)

دستور off وضعیت درگاه را به disable تغییر می‌دهد.

دستور on وضعیت درگاه را به enable تغییر می‌دهد (تنها زمانی که وضعیت فعلی disable باشد).

دستورات speed and width روی هر درگاهی مجاز هستند

مقادیر speed مقادیر مجاز برای PortInfo:LinkSpeedEnabled هستند (اگر PortInfo:LinkSpeedSupported از این تنظیم پشتیبانی نکند، خطا اعلام می‌شود)

دستور espeed روی هر درگاهی که از سرعت‌های پیوند گسترش‌یافته پشتیبانی می‌کند مجاز است

دستور fdr10 روی هر درگاهی که از fdr10 پشتیبانی می‌کند مجاز است (اگر ماسک قابلیت درگاه نشان دهد که سرعت‌های پیوند گسترش‌یافته پشتیبانی نمی‌شوند یا اگر PortInfo:LinkSpeedExtSupported از این تنظیم پشتیبانی نکند، خطا اعلام می‌شود)

مقادیر width مقادیر مجاز برای PortInfo:LinkWidthEnabled هستند (اگر PortInfo:LinkWidthSupported از این تنظیم پشتیبانی نکند، خطا اعلام می‌شود) (نکته: تغییرات سرعت و پهنا تا زمانی که درگاه مذاکره مجدد پیوند را انجام ندهد، اعمال نمی‌شوند)

دستور query همچنین ویژگی‌های درگاه (پهنای پیوند، speed ،espeed و fdr10) را بر اساس درگاه همتا اعتبارسنجی می‌کند. این بررسی زمانی انجام می‌شود که درگاه مورد استعلام یک درگاه سوییچ باشد، زیرا بر مسیریابی ترکیبی (مسیریابی اولیه LID به همراه مسیریابی هدایت‌شده به همتا) متکی است که تنها روی سوییچ قابل انجام است. این ویژگی اعتبارسنجی درگاه همتا در عملیات query نیازمند فعال بودن مسیریابی LID در زیرشبکه است.

دستورات mkey, mkeylease, and mkeyprot تنها روی CAها، روترها، یا درگاه 0 سوییچ مجاز هستند (در صورت تلاش روی درگاه‌های خارجی سوییچ، خطا ایجاد می‌شود). کلیدهای mkey در مبنای شانزده و هشت را می‌توان با افزودن پیشوند '0x' یا '0' به کلید مشخص کرد. اگر یک مقدار غیرعددی (مانند 'x') برای mkey مشخص شود، ibportstate مقدار را درخواست خواهد کرد.

فلگ‌های آدرس‌دهی (Addressing Flags)

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

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

-D, --Direct آدرس مشخص‌شده یک مسیر هدایت‌شده (directed route) است

مثال‌ها:
   [options] -D [options] "0"          # self port
   [options] -D [options] "0,1,2,1,4"  # out via port 1, then 2, ...
   (توجه داشته باشید که دومین عدد در مسیر مشخص‌شده باید با درگاه مورد استفاده
   تطابق داشته باشد. این مورد می‌تواند با استفاده از فلگ انتخاب درگاه '-P' یا
   درگاه یافت‌شده از طریق فرآیند انتخاب خودکار مشخص شود.)

-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های خروجی. MADهای SMP (مبتنی بر SMI directed-route/LID-routed) همیشه از نمایه 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.

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

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

پیش‌فرض: /etc/infiniband-diags/ibdiag.conf

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

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

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

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

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

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

-K, --show_keys: نمایش کلیدهای امنیتی (mkey ،smkey و غیره) مرتبط با درخواست.

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

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

فایل‌ها (FILES)

فایل پیکربندی (CONFIG FILE)

/etc/infiniband-diags/ibdiag.conf

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

مثال‌ها (EXAMPLES)

ibportstate -C qib0 -P 1 3 1 disable     # by CA name, CA Port Number, lid, physical port number
ibportstate -C qib0 -P 1 3 1 enable      # by CA name, CA Port Number, lid, physical port number
ibportstate -D 0 1                       # (query) by direct route
ibportstate 3 1 reset                    # by lid
ibportstate 3 1 speed 1                  # by lid
ibportstate 3 1 width 1                  # by lid
ibportstate -D 0 1 lid 0x1234 arm        # by direct route

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

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