.\" 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 "IBPORTSTATE" "8" "2013-03-26" "" "Open IB Diagnostics" .SH "نام (NAME)" ibportstate \- مدیریت وضعیت (فیزیکی) درگاه و سرعت پیوند یک درگاه InfiniBand .SH "خلاصه دستور (SYNOPSIS)" .sp ibportstate [options] [] .SH "توضیحات (DESCRIPTION)" .sp دستور ibportstate امکان استعلام وضعیت درگاه و وضعیت فیزیکی درگاه یک درگاه IB را فراهم می‌کند (علاوه بر اعتبارسنجی پهنا و سرعت پیوند نسبت به درگاه همتا هنگامی که درگاه مورد استعلام یک درگاه سوییچ باشد)، یا اینکه یک درگاه سوییچ غیرفعال، فعال یا بازنشانی شود. وضعیت درگاه InfiniBand HCA ممکن است به‌صورت محلی و بدون اطلاع مدیر زیرشبکه (Subnet Manager) تغییر یابد. همچنین امکان تنظیم سرعت/پهنای پیوند فعال‌شده روی هر درگاه IB را فراهم می‌کند. .SH "گزینه‌ها (OPTIONS)" .INDENT 0.0 .TP .B \fB\fP .INDENT 7.0 .TP .B عملیات‌های پشتیبانی‌شده: enable, disable, reset, speed, espeed, fdr10, width, query, on, off, down, arm, active, vls, mtu, lid, smlid, lmc, mkey, mkeylease, mkeyprot (پیش‌فرض query است) .UNINDENT .sp دستورات \fBenable, disable, and reset\fP وضعیت یک درگاه سوییچ یا HCA را تغییر داده یا بازنشانی می‌کنند (هنگام تغییر محلی وضعیت درگاه CA باید نام CA و شماره Port را مشخص کنید.) .sp دستور \fBoff\fP وضعیت درگاه را به disable تغییر می‌دهد. .sp دستور \fBon\fP وضعیت درگاه را به enable تغییر می‌دهد (تنها زمانی که وضعیت فعلی disable باشد). .sp دستورات \fBspeed and width\fP روی هر درگاهی مجاز هستند .sp مقادیر \fBspeed\fP مقادیر مجاز برای PortInfo:LinkSpeedEnabled هستند (اگر PortInfo:LinkSpeedSupported از این تنظیم پشتیبانی نکند، خطا اعلام می‌شود) .sp دستور \fBespeed\fP روی هر درگاهی که از سرعت‌های پیوند گسترش‌یافته پشتیبانی می‌کند مجاز است .sp دستور \fBfdr10\fP روی هر درگاهی که از fdr10 پشتیبانی می‌کند مجاز است (اگر ماسک قابلیت درگاه نشان دهد که سرعت‌های پیوند گسترش‌یافته پشتیبانی نمی‌شوند یا اگر PortInfo:LinkSpeedExtSupported از این تنظیم پشتیبانی نکند، خطا اعلام می‌شود) .sp مقادیر \fBwidth\fP مقادیر مجاز برای PortInfo:LinkWidthEnabled هستند (اگر PortInfo:LinkWidthSupported از این تنظیم پشتیبانی نکند، خطا اعلام می‌شود) (نکته: تغییرات سرعت و پهنا تا زمانی که درگاه مذاکره مجدد پیوند را انجام ندهد، اعمال نمی‌شوند) .sp دستور \fBquery\fP همچنین ویژگی‌های درگاه (پهنای پیوند، speed ،espeed و fdr10) را بر اساس درگاه همتا اعتبارسنجی می‌کند. این بررسی زمانی انجام می‌شود که درگاه مورد استعلام یک درگاه سوییچ باشد، زیرا بر مسیریابی ترکیبی (مسیریابی اولیه LID به همراه مسیریابی هدایت‌شده به همتا) متکی است که تنها روی سوییچ قابل انجام است. این ویژگی اعتبارسنجی درگاه همتا در عملیات query نیازمند فعال بودن مسیریابی LID در زیرشبکه است. .sp دستورات \fBmkey, mkeylease, and mkeyprot\fP تنها روی CAها، روترها، یا درگاه 0 سوییچ مجاز هستند (در صورت تلاش روی درگاه‌های خارجی سوییچ، خطا ایجاد می‌شود). کلیدهای mkey در مبنای شانزده و هشت را می‌توان با افزودن پیشوند \(aq0x\(aq یا \(aq0\(aq به کلید مشخص کرد. اگر یک مقدار غیرعددی (مانند \(aqx\(aq) برای mkey مشخص شود، ibportstate مقدار را درخواست خواهد کرد. .UNINDENT .SS "فلگ‌های آدرس‌دهی (Addressing Flags)" .\" Define the common option -L . .sp \fB\-L, \-\-Lid\fP آدرس مشخص‌شده یک LID است .\" Define the common option -G . .sp \fB\-G, \-\-Guid\fP آدرس مشخص‌شده یک Port GUID است .\" Define the common option -D for Directed routes . .sp \fB\-D, \-\-Direct\fP آدرس مشخص‌شده یک مسیر هدایت‌شده (directed route) است .INDENT 0.0 .INDENT 3.5 .sp .EX مثال‌ها: [options] \-D [options] \(dq0\(dq # self port [options] \-D [options] \(dq0,1,2,1,4\(dq # out via port 1, then 2, ... (توجه داشته باشید که دومین عدد در مسیر مشخص‌شده باید با درگاه مورد استفاده تطابق داشته باشد. این مورد می‌تواند با استفاده از فلگ انتخاب درگاه \(aq\-P\(aq یا درگاه یافت‌شده از طریق فرآیند انتخاب خودکار مشخص شود.) .EE .UNINDENT .UNINDENT .\" Define the common option -s . .sp \fB\-s, \-\-sm_port \fP استفاده از \(aqsmlid\(aq به عنوان lid هدف برای استعلام‌های SA. .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های خروجی. MADهای SMP (مبتنی بر SMI directed\-route/LID\-routed) همیشه از نمایه 0 جدول P_Key استفاده می‌کنند. .UNINDENT .\" Explanation of local port selection . .SS "انتخاب درگاه محلی (Local port Selection)" .sp پشتیبانی از چندین درگاه/چندین CA: هنگامی که هیچ دستگاه یا درگاه IB مشخص نشده باشد (به \(dqپارامترهای محلی umad\(dq در زیر مراجعه کنید)، کتابخانه 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 # use the first port (criteria #1 above) ibaddr \-C mthca1 # pick the best port from \(dqmthca1\(dq 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. .EE .UNINDENT .UNINDENT .UNINDENT .UNINDENT .SS "فلگ‌های پیکربندی (Configuration flags)" .\" Define the common option -z . .sp \fB\-\-config, \-z \fP مشخص کردن فایل پیکربندی جایگزین. .INDENT 0.0 .INDENT 3.5 پیش‌فرض: /etc/infiniband\-diags/ibdiag.conf .UNINDENT .UNINDENT .\" Define the common option -t . .sp \fB\-t, \-\-timeout \fP بازنویسی زمان مهلت پیش‌فرض برای madهای درخواست‌شده. .\" Define the common option -y . .INDENT 0.0 .TP .B \fB\-y, \-\-m_key \fP استفاده از M_key مشخص‌شده برای درخواست‌ها. اگر مقدار غیرعددی (مانند \(aqx\(aq) مشخص شود، برای دریافت مقدار اعلان خواهد شد. .UNINDENT .SS "فلگ‌های اشکال‌زدایی (Debugging flags)" .\" Define the common option -h . .sp \fB\-h, \-\-help\fP نمایش پیام راهنمای نحوه استفاده .\" 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 -K . .INDENT 0.0 .TP .B \fB\-K, \-\-show_keys\fP نمایش کلیدهای امنیتی (mkey ،smkey و غیره) مرتبط با درخواست. .UNINDENT .\" 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 نمایش اطلاعات نسخه. .SH "فایل‌ها (FILES)" .\" Common text for the config file . .SS "فایل پیکربندی (CONFIG FILE)" .sp /etc/infiniband\-diags/ibdiag.conf .sp یک فایل پیکربندی سراسری برای تنظیم برخی از گزینه‌های متداول برای تمام ابزارها ارائه شده است. برای جزئیات به فایل پیکربندی ارائه‌شده مراجعه کنید. .SH "مثال‌ها (EXAMPLES)" .INDENT 0.0 .INDENT 3.5 .sp .EX 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 .EE .UNINDENT .UNINDENT .SH "نویسندگان (AUTHORS)" .INDENT 0.0 .TP .B Hal Rosenstock < \% > .UNINDENT .\" End of generated man page.