نام (NAME)

saquery - پرس‌وجوی ویژگی‌های مدیریت زیرشبکه (SA) در InfiniBand

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

saquery [گزینه‌ها] [<name> | <lid> | <guid>]

توضیحات (DESCRIPTION)

دستور saquery پرس‌وجوی انتخاب‌شدهٔ SA را صادر می‌کند. به‌طور پیش‌فرض، رکوردهای گره (Node records) استعلام می‌شوند.

گزینه‌ها (OPTIONS)

-p: دریافت اطلاعات PathRecord
-N: دریافت اطلاعات NodeRecord
-D, --list: تنها دریافت توضیحات گره‌های CA (NodeDescriptions)
-S: دریافت اطلاعات ServiceRecord
-I: دریافت اطلاعات InformInfoRecord (اشتراک)
-L: بازگرداندن Lidهای مربوط به نام مشخص‌شده
-l: بازگرداندن Lid یکتای مربوط به نام مشخص‌شده
-G: بازگرداندن Guidهای مربوط به نام مشخص‌شده
-O: بازگرداندن نام مربوط به Lid مشخص‌شده
-U: بازگرداندن نام مربوط به Guid مشخص‌شده
-c: دریافت اطلاعات درگاه کلاس (class port) مربوط به SA
-s: بازگرداندن PortInfoRecordهایی که بیت ماسک قابلیت isSM یا isSMdisabled در آن‌ها فعال (روشن) است
-g: دریافت اطلاعات گروه چندپخشی (multicast group)
-m: دریافت اطلاعات عضو چندپخشی (multicast member). اگر گروهی مشخص شده باشد، خروجی به گروه تعیین‌شده محدود می‌شود و برای هر ورودی یک خط چاپ می‌گردد که تنها شامل GUID و توضیحات گره است. مثال: saquery -m 0xc000
-x: دریافت اطلاعات LinkRecord
--src-to-dst <src:dst>: دریافت یک PathRecord برای <src:dst> که در آن src و dst نام‌های گره یا LIDها هستند
--sgid-to-dgid <sgid:dgid>: دریافت یک PathRecord از sgid به dgid که در آن هر دو GID در قالب IPv6 قابل قبول برای inet_pton (3) هستند
--smkey <val>: استفاده از مقدار SM_Key برای پرس‌وجو. تنها در پرس‌وجوهای «معتمد» ("trusted") استفاده خواهد شد. اگر مقداری غیرعددی (مانند 'x') مشخص شود، saquery مقدار را از کاربر درخواست خواهد کرد. پیش‌فرض (هنگامی که در اینجا یا در /etc/infiniband-diags/ibdiag.conf مشخص نشده باشد) استفاده از SM_Key == 0 (یا «نامعتمد» "untrusted") است.

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

--slid <lid> شناسه LID مبدأ (PathRecord)

--dlid <lid> شناسه LID مقصد (PathRecord)

--mlid <lid> شناسه LID چندپخشی (MCMemberRecord)

--sgid <gid> شناسه GID مبدأ (قالب IPv6) (PathRecord)

--dgid <gid> شناسه GID مقصد (قالب IPv6) (PathRecord)

--gid <gid> شناسه GID درگاه (MCMemberRecord)

--mgid <gid> شناسه GID چندپخشی (MCMemberRecord)

--reversible مسیر برگشت‌پذیر (PathRecord)

--numb_path تعداد مسیرها (PathRecord)

--pkey مقدار P_Key (در PathRecord و MCMemberRecord). اگر مقداری غیرعددی (مانند 'x'): مشخص شود، saquery مقدار را از کاربر درخواست خواهد کرد. توجه داشته باشید این مقدار P_Key است که مورد استعلام قرار می‌گیرد، نه نمایه جدول P_Key خود بسته MAD درخواست (گزینهٔ --pkey-idx را ببینید).

--qos_class رده کیفیت خدمات (QoS Class) (PathRecord)

--sl سطح سرویس (PathRecord, MCMemberRecord)

--mtu مقدار MTU و انتخاب‌گر (PathRecord, MCMemberRecord)

--rate نرخ و انتخاب‌گر (PathRecord, MCMemberRecord)

--pkt_lifetime طول عمر بسته و انتخاب‌گر (PathRecord, MCMemberRecord)

--qkey مقدار Q_Key (در MCMemberRecord). اگر مقداری غیرعددی (مانند 'x') مشخص شود: saquery مقدار را از کاربر درخواست خواهد کرد

--tclass رده ترافیک (Traffic Class) (PathRecord, MCMemberRecord)

--flow_label برچسب جریان (Flow Label) (PathRecord, MCMemberRecord)

--hop_limit حد جهش (Hop limit) (PathRecord, MCMemberRecord)

--scope حوزه (Scope) (MCMemberRecord)

--join_state وضعیت پیوستن (Join state) (MCMemberRecord)

--proxy_join پیوستن نیابتی (Proxy join) (MCMemberRecord)

--service_id شناسه سرویس (ServiceID) (PathRecord)

نام‌های پشتیبانی‌شده برای پرس‌وجو (و نام‌های مستعار آن‌ها):

ClassPortInfo (CPI)
NodeRecord (NR) [lid]
PortInfoRecord (PIR) [[lid]/[port]/[options]]
SL2VLTableRecord (SL2VL) [[lid]/[in_port]/[out_port]]
PKeyTableRecord (PKTR) [[lid]/[port]/[block]]
VLArbitrationTableRecord (VLAR) [[lid]/[port]/[block]]
InformInfoRecord (IIR)
LinkRecord (LR) [[from_lid]/[from_port]] [[to_lid]/[to_port]]
ServiceRecord (SR)
PathRecord (PR)
MCMemberRecord (MCMR)
LFTRecord (LFTR) [[lid]/[block]]
MFTRecord (MFTR) [[mlid]/[position]/[block]]
GUIDInfoRecord (GIR) [[lid]/[block]]
SwitchInfoRecord (SWIR) [lid]
SMInfoRecord (SMIR) [lid]

فلگ‌های انتخاب درگاه (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: افزایش سطح پرگویی (verbosity) برنامه. می‌تواند چندین بار استفاده شود (-vv یا -v -v -v)

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

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

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

--outstanding_smps, -o <val>: تعیین تعداد SMPهای در حال انتظاری که باید در حین پویش صادر شوند
پیش‌فرض: 2

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

این فایل GUIDها را به نام‌های کاربرپسندتر نگاشت می‌کند. بخش «فایل‌های مشترک» را ببینید.

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

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

فایل‌های مشترک (COMMON 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"

وابستگی‌ها (DEPENDENCIES)

OpenSM (یا هر SM/SA در حال اجرای دیگر)، libosmcomp، libibumad، libibmad

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

Ira Weiny: < <ira.weiny@intel.com> >
Hal Rosenstock: < <halr@mellanox.com> >