.\" Man page generated from reStructuredText .\" by the Docutils 0.23 manpage writer. . . .nr rst2man-indent-level 0 . .de1 rstReportMargin \\$1 \\n[an-margin] level \\n[rst2man-indent-level] level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] - \\n[rst2man-indent0] \\n[rst2man-indent1] \\n[rst2man-indent2] .. .de1 INDENT .\" .rstReportMargin pre: . RS \\$1 . nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin] . nr rst2man-indent-level +1 .\" .rstReportMargin post: .. .de UNINDENT . RE .\" indent \\n[an-margin] .\" old: \\n[rst2man-indent\\n[rst2man-indent-level]] .nr rst2man-indent-level -1 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. .TH "saquery" "8" "2017-08-21" "" "Open IB Diagnostics" .SH "نام (NAME)" saquery \- پرس‌وجوی ویژگی‌های مدیریت زیرشبکه (SA) در InfiniBand .SH "خلاصه دستور (SYNOPSIS)" .sp saquery [گزینه‌ها] [ | | ] .SH "توضیحات (DESCRIPTION)" .sp دستور saquery پرس‌وجوی انتخاب‌شدهٔ SA را صادر می‌کند. به‌طور پیش‌فرض، رکوردهای گره (Node records) استعلام می‌شوند. .SH "گزینه‌ها (OPTIONS)" .INDENT 0.0 .TP .B \fB\-p\fP دریافت اطلاعات PathRecord .TP .B \fB\-N\fP دریافت اطلاعات NodeRecord .TP .B \fB\-D, \-\-list\fP تنها دریافت توضیحات گره‌های CA (NodeDescriptions) .TP .B \fB\-S\fP دریافت اطلاعات ServiceRecord .TP .B \fB\-I\fP دریافت اطلاعات InformInfoRecord (اشتراک) .TP .B \fB\-L\fP بازگرداندن Lidهای مربوط به نام مشخص‌شده .TP .B \fB\-l\fP بازگرداندن Lid یکتای مربوط به نام مشخص‌شده .TP .B \fB\-G\fP بازگرداندن Guidهای مربوط به نام مشخص‌شده .TP .B \fB\-O\fP بازگرداندن نام مربوط به Lid مشخص‌شده .TP .B \fB\-U\fP بازگرداندن نام مربوط به Guid مشخص‌شده .TP .B \fB\-c\fP دریافت اطلاعات درگاه کلاس (class port) مربوط به SA .TP .B \fB\-s\fP بازگرداندن PortInfoRecordهایی که بیت ماسک قابلیت isSM یا isSMdisabled در آن‌ها فعال (روشن) است .TP .B \fB\-g\fP دریافت اطلاعات گروه چندپخشی (multicast group) .TP .B \fB\-m\fP دریافت اطلاعات عضو چندپخشی (multicast member). اگر گروهی مشخص شده باشد، خروجی به گروه تعیین‌شده محدود می‌شود و برای هر ورودی یک خط چاپ می‌گردد که تنها شامل GUID و توضیحات گره است. مثال: saquery \-m 0xc000 .TP .B \fB\-x\fP دریافت اطلاعات LinkRecord .TP .B \fB\-\-src\-to\-dst \fP دریافت یک PathRecord برای که در آن src و dst نام‌های گره یا LIDها هستند .TP .B \fB\-\-sgid\-to\-dgid \fP دریافت یک PathRecord از \fBsgid\fP به \fBdgid\fP که در آن هر دو GID در قالب IPv6 قابل قبول برای \fBinet_pton (3)\fP هستند .TP .B \fB\-\-smkey \fP استفاده از مقدار SM_Key برای پرس‌وجو. تنها در پرس‌وجوهای «معتمد» (\(dqtrusted\(dq) استفاده خواهد شد. اگر مقداری غیرعددی (مانند \(aqx\(aq) مشخص شود، saquery مقدار را از کاربر درخواست خواهد کرد. پیش‌فرض (هنگامی که در اینجا یا در /etc/infiniband\-diags/ibdiag.conf مشخص نشده باشد) استفاده از SM_Key == 0 (یا «نامعتمد» \(dquntrusted\(dq) است. .UNINDENT .\" Define the common option -K . .INDENT 0.0 .TP .B \fB\-K, \-\-show_keys\fP نمایش کلیدهای امنیتی (mkey، smkey و غیره) مرتبط با درخواست. .UNINDENT .sp \fB\-\-slid \fP شناسه LID مبدأ (PathRecord) .sp \fB\-\-dlid \fP شناسه LID مقصد (PathRecord) .sp \fB\-\-mlid \fP شناسه LID چندپخشی (MCMemberRecord) .sp \fB\-\-sgid \fP شناسه GID مبدأ (قالب IPv6) (PathRecord) .sp \fB\-\-dgid \fP شناسه GID مقصد (قالب IPv6) (PathRecord) .sp \fB\-\-gid \fP شناسه GID درگاه (MCMemberRecord) .sp \fB\-\-mgid \fP شناسه GID چندپخشی (MCMemberRecord) .sp \fB\-\-reversible\fP مسیر برگشت‌پذیر (PathRecord) .sp \fB\-\-numb_path\fP تعداد مسیرها (PathRecord) .INDENT 0.0 .TP .B \fB\-\-pkey\fP مقدار P_Key (در PathRecord و MCMemberRecord). اگر مقداری غیرعددی (مانند \(aqx\(aq) مشخص شود، saquery مقدار را از کاربر درخواست خواهد کرد. توجه داشته باشید این \fIمقدار\fP P_Key است که مورد استعلام قرار می‌گیرد، نه نمایه جدول P_Key خود بسته MAD درخواست (گزینهٔ \fB\-\-pkey\-idx\fP را ببینید). .UNINDENT .sp \fB\-\-qos_class\fP رده کیفیت خدمات (QoS Class) (PathRecord) .sp \fB\-\-sl\fP سطح سرویس (PathRecord, MCMemberRecord) .sp \fB\-\-mtu\fP مقدار MTU و انتخاب‌گر (PathRecord, MCMemberRecord) .sp \fB\-\-rate\fP نرخ و انتخاب‌گر (PathRecord, MCMemberRecord) .sp \fB\-\-pkt_lifetime\fP طول عمر بسته و انتخاب‌گر (PathRecord, MCMemberRecord) .INDENT 0.0 .TP .B \fB\-\-qkey\fP مقدار Q_Key (در MCMemberRecord). اگر مقداری غیرعددی (مانند \(aqx\(aq) مشخص شود saquery مقدار را از کاربر درخواست خواهد کرد .UNINDENT .sp \fB\-\-tclass\fP رده ترافیک (Traffic Class) (PathRecord, MCMemberRecord) .sp \fB\-\-flow_label\fP برچسب جریان (Flow Label) (PathRecord, MCMemberRecord) .sp \fB\-\-hop_limit\fP حد جهش (Hop limit) (PathRecord, MCMemberRecord) .sp \fB\-\-scope\fP حوزه (Scope) (MCMemberRecord) .sp \fB\-\-join_state\fP وضعیت پیوستن (Join state) (MCMemberRecord) .sp \fB\-\-proxy_join\fP پیوستن نیابتی (Proxy join) (MCMemberRecord) .sp \fB\-\-service_id\fP شناسه سرویس (ServiceID) (PathRecord) .sp نام‌های پشتیبانی‌شده برای پرس‌وجو (و نام‌های مستعار آن‌ها): .INDENT 0.0 .INDENT 3.5 .sp .EX 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] .EE .UNINDENT .UNINDENT .SS "فلگ‌های انتخاب درگاه (Port Selection flags)" .\" Define the common option -C . .sp \fB\-C, \-\-Ca \fP استفاده از ca_name مشخص‌شده. .\" Define the common option -P . .sp \fB\-P, \-\-Port \fP استفاده از ca_port مشخص‌شده. .\" Define the common option -Y . .INDENT 0.0 .TP .B \fB\-Y, \-\-pkey\-idx \fP نمایه جدول P_Key (مقدار 0\-65535، پیش‌فرض 0) مورد استفاده برای بسته‌های خروجی SA/GMP MAD. بسته‌های SMP (مسیر هدایت‌شده SMI یا هدایت‌شده با LID) همیشه از نمایه 0 جدول P_Key استفاده می‌کنند. .UNINDENT .\" Explanation of local port selection . .SS "انتخاب درگاه محلی (Local port Selection)" .sp پشتیبانی از چندین درگاه/چندین CA: هنگامی که هیچ دستگاه یا درگاه IB مشخص نشده باشد (بخش «پارامترهای محلی umad» در زیر را ببینید)، کتابخانه libibumad درگاه مورد استفاده را بر اساس معیارهای زیر انتخاب می‌کند: .INDENT 0.0 .INDENT 3.5 .INDENT 0.0 .IP 1. 3 نخستین درگاهی که در وضعیت ACTIVE باشد. .IP 2. 3 در صورت پیدا نشدن، نخستین درگاهی که در وضعیت UP باشد (پیوند فیزیکی برقرار باشد). .UNINDENT .sp اگر نام درگاه و/یا CA مشخص شده باشد، کتابخانه libibumad تلاش می‌کند درخواست کاربر را برآورده سازد، و در صورت عدم امکان شکست می‌خورد. .sp برای مثال: .INDENT 0.0 .INDENT 3.5 .sp .EX ibaddr # استفاده از نخستین درگاه (معیار شماره ۱ در بالا) ibaddr \-C mthca1 # انتخاب بهترین درگاه فقط از \(dqmthca1\(dq. ibaddr \-P 2 # استفاده از دومین درگاه (active/up) از نخستین دستگاه IB موجود. ibaddr \-C mthca0 \-P 2 # فقط استفاده از درگاه مشخص‌شده. .EE .UNINDENT .UNINDENT .UNINDENT .UNINDENT .SS "فلگ‌های اشکال‌زدایی (Debugging flags)" .\" Define the common option -d . .INDENT 0.0 .TP .B \-d افزایش سطح اشکال‌زدایی IB. می‌تواند چندین بار استفاده شود (\-ddd یا \-d \-d \-d). .UNINDENT .\" Define the common option -e . .INDENT 0.0 .TP .B \-e نمایش خطاهای ارسال و دریافت (مهلت زمانی و موارد دیگر) .UNINDENT .\" Define the common option -h . .sp \fB\-h, \-\-help\fP نمایش پیام راهنمای نحوه استفاده .\" Define the common option -v . .INDENT 0.0 .TP .B \fB\-v, \-\-verbose\fP افزایش سطح پرگویی (verbosity) برنامه. می‌تواند چندین بار استفاده شود (\-vv یا \-v \-v \-v) .UNINDENT .\" Define the common option -V . .sp \fB\-V, \-\-version\fP نمایش اطلاعات نسخه. .SS "فلگ‌های پیکربندی (Configuration flags)" .\" Define the common option -t . .sp \fB\-t, \-\-timeout \fP بازنویسی زمان مهلت پیش‌فرض برای madهای درخواست‌شده. .\" Define the common option -z . .INDENT 0.0 .TP .B \fB\-\-outstanding_smps, \-o \fP تعیین تعداد SMPهای در حال انتظاری که باید در حین پویش صادر شوند .sp پیش‌فرض: 2 .UNINDENT .\" Define the common option --node-name-map . .sp \fB\-\-node\-name\-map \fP مشخص کردن یک نگاشت نام گره. .INDENT 0.0 .INDENT 3.5 این فایل GUIDها را به نام‌های کاربرپسندتر نگاشت می‌کند. بخش «فایل‌های مشترک» را ببینید. .UNINDENT .UNINDENT .\" Define the common option -z . .sp \fB\-\-config, \-z \fP مشخص کردن فایل پیکربندی جایگزین. .INDENT 0.0 .INDENT 3.5 پیش‌فرض: /etc/infiniband\-diags/ibdiag.conf .UNINDENT .UNINDENT .SH "فایل‌های مشترک (COMMON FILES)" .\" Common text for the config file . .SS "فایل پیکربندی (CONFIG FILE)" .sp /etc/infiniband\-diags/ibdiag.conf .sp یک فایل پیکربندی سراسری برای تنظیم برخی از گزینه‌های مشترک میان تمام ابزارها ارائه شده است. برای جزئیات بیشتر به فایل پیکربندی ارائه‌شده مراجعه کنید. .\" Common text to describe the node name map file. . .SS "قالب فایل نگاشت نام گره (NODE NAME MAP FILE FORMAT)" .sp نگاشت نام گره برای تعیین نام‌های کاربرپسند برای گره‌ها در خروجی استفاده می‌شود. از GUIDها برای انجام جستجو استفاده می‌شود. .sp این قابلیت توسط بسته opensm\-libs ارائه می‌شود. برای اطلاع از محل فایل در توزیع خود به \fBopensm(8)\fP مراجعه کنید. .sp \fBبه‌طور کلی:\fP .INDENT 0.0 .INDENT 3.5 .sp .EX # comment \(dq\(dq .EE .UNINDENT .UNINDENT .sp \fBمثال:\fP .INDENT 0.0 .INDENT 3.5 .sp .EX # IB1 # Line cards 0x0008f104003f125c \(dqIB1 (Rack 11 slot 1 ) ISR9288/ISR9096 Voltaire sLB\-24D\(dq 0x0008f104003f125d \(dqIB1 (Rack 11 slot 1 ) ISR9288/ISR9096 Voltaire sLB\-24D\(dq 0x0008f104003f10d2 \(dqIB1 (Rack 11 slot 2 ) ISR9288/ISR9096 Voltaire sLB\-24D\(dq 0x0008f104003f10d3 \(dqIB1 (Rack 11 slot 2 ) ISR9288/ISR9096 Voltaire sLB\-24D\(dq 0x0008f104003f10bf \(dqIB1 (Rack 11 slot 12 ) ISR9288/ISR9096 Voltaire sLB\-24D\(dq # Spines 0x0008f10400400e2d \(dqIB1 (Rack 11 spine 1 ) ISR9288 Voltaire sFB\-12D\(dq 0x0008f10400400e2e \(dqIB1 (Rack 11 spine 1 ) ISR9288 Voltaire sFB\-12D\(dq 0x0008f10400400e2f \(dqIB1 (Rack 11 spine 1 ) ISR9288 Voltaire sFB\-12D\(dq 0x0008f10400400e31 \(dqIB1 (Rack 11 spine 2 ) ISR9288 Voltaire sFB\-12D\(dq 0x0008f10400400e32 \(dqIB1 (Rack 11 spine 2 ) ISR9288 Voltaire sFB\-12D\(dq # GUID Node Name 0x0008f10400411a08 \(dqSW1 (Rack 3) ISR9024 Voltaire 9024D\(dq 0x0008f10400411a28 \(dqSW2 (Rack 3) ISR9024 Voltaire 9024D\(dq 0x0008f10400411a34 \(dqSW3 (Rack 3) ISR9024 Voltaire 9024D\(dq 0x0008f104004119d0 \(dqSW4 (Rack 3) ISR9024 Voltaire 9024D\(dq .EE .UNINDENT .UNINDENT .SH "وابستگی‌ها (DEPENDENCIES)" .sp OpenSM (یا هر SM/SA در حال اجرای دیگر)، libosmcomp، libibumad، libibmad .SH "نویسندگان (AUTHORS)" .INDENT 0.0 .TP .B Ira Weiny < \% > .TP .B Hal Rosenstock < \% > .UNINDENT .\" End of generated man page.