.\" Man page generated from reStructuredText.
.
.TH "OMPI_INFO" "1" "Feb 23, 2026" "" "Open MPI"
.
.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
..
.SH "نام (NAME)"
ompi_info \- نمایش اطلاعات درباره پیکربندی و نصب Open MPI
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBompi_info\fP [\fIگزینه‌ها\fP]
.SH "توضیحات (DESCRIPTION)"
.sp
\fBompi_info\fP اطلاعات دقیقی درباره نصب Open MPI ارائه می‌دهد. این ابزار حداقل در سه سناریوی متداول مفید است:
.INDENT 0.0
.IP 1. 3
بررسی پیکربندی محلی و مشاهده نحوه نصب Open MPI.
.IP 2. 3
ارسال گزارش‌های اشکال / درخواست‌های راهنمایی به جامعه کاربری Open MPI
(بخش \fI\%دریافت راهنمایی\fP را ببینید).
.IP 3. 3
مشاهده فهرستی از افزونه‌های (plugins) نصب‌شده Open MPI و بررسی این‌که چه پارامترهای MCA توسط آن‌ها پشتیبانی می‌شود.
.UNINDENT
.sp
\fBنکته:\fP
.INDENT 0.0
.INDENT 3.5
\fBompi_info\fP به‌طور پیش‌فرض تنها تعداد اندکی از پارامترهای MCA را نمایش می‌دهد (یعنی پارامترهای سطح ۱). از گزینه
\fB\-\-level\fP
برای فعال‌سازی نمایش گزینه‌های بیشتر استفاده کنید (برای اطلاعات بیشتر بخش \fI\%سطوح (LEVELS)\fP را ببینید).
.UNINDENT
.UNINDENT
.SH "گزینه‌ها (OPTIONS)"
.sp
\fBompi_info\fP گزینه‌های زیر را می‌پذیرد:
.INDENT 0.0
.IP \(bu 2
\fB\-a\fP, \fB\-\-all\fP: نمایش تمام گزینه‌های پیکربندی و پارامترهای MCA. همچنین سطح پیش‌فرض پارامترهای MCA را به ۹ تغییر می‌دهد، مگر اینکه \fB\-\-level\fP نیز مشخص شده باشد.
.IP \(bu 2
\fB\-\-arch\fP: نمایش معماری سیستمی که Open MPI روی آن کامپایل شده است.
.IP \(bu 2
\fB\-c\fP, \fB\-\-config\fP: نمایش گزینه‌های پیکربندی.
.IP \(bu 2
\fB\-gmca\fP, \fB\-\-gmca <param> <value>\fP: ارسال پارامترهای سراسری MCA که برای تمام زمینه‌ها (contexts) اعمال می‌شوند.
.IP \(bu 2
\fB\-h\fP, \fB\-\-help\fP: نمایش پیام راهنما / نحوه استفاده.
.IP \(bu 2
\fB\-\-hostname\fP: نمایش نام میزبانی (hostname) که Open MPI روی آن پیکربندی و ساخته شده است.
.IP \(bu 2
\fB\-\-internal\fP: نمایش پارامترهای داخلی MCA (که برای تغییر توسط کاربران در نظر گرفته نشده‌اند).
.IP \(bu 2
\fB\-\-level <level>\fP: نمایش متغیرها تنها تا حداکثر این سطح (۱\-۹). مقدار پیش‌فرض ۱ است مگر اینکه \fB\-\-all\fP بدون \fB\-\-level\fP مشخص شده باشد، که در این صورت مقدار پیش‌فرض ۹ خواهد بود. برای اطلاعات بیشتر بخش \fI\%سطوح (LEVELS)\fP را ببینید.
.IP \(bu 2
\fB\-mca\fP, \fB\-\-mca <param> <value>\fP: ارسال پارامترهای MCA وابسته به زمینه (context\-specific)؛ اگر از \fB\-\-gmca\fP استفاده نشود و تنها یک زمینه تعیین شده باشد، این پارامترها سراسری در نظر گرفته می‌شوند.
.IP \(bu 2
\fB\-\-param <type> <component>\fP: نمایش پارامترهای MCA. پارامتر اول نوع مؤلفه‌ای است که باید نمایش داده شود؛ پارامتر دوم مؤلفه مشخص جهت نمایش است (یا کلمه کلیدی \fBall\fP، به معنای «نمایش تمامی مؤلفه‌های این نوع»).
.IP \(bu 2
\fB\-t\fP, \fB\-\-type\fP: نمایش پارامترهای MCA از نوع مشخص‌شده در پارامتر. مقادیر زیر را می‌پذیرد: \fBunsigned_int\fP، \fBunsigned_long\fP، \fBunsigned_long_long\fP، \fBsize_t\fP، \fBstring\fP، \fBversion_string\fP، \fBbool\fP، \fBdouble\fP\&. به‌طور پیش‌فرض سطح ۱ است مگر اینکه با \fB\-\-level\fP مشخص شده باشد.
.IP \(bu 2
\fB\-\-parsable\fP: هنگام استفاده در ترکیب با سایر پارامترها، خروجی در قالبی قابل تجزیه توسط ماشین (machine\-parsable) نمایش داده می‌شود. گزینه \fB\-\-parseable\fP مترادفی برای \fB\-\-parsable\fP است.
.IP \(bu 2
\fB\-\-path <type>\fP: نمایش مسیرهایی که Open MPI با آن‌ها پیکربندی شده است. پارامترهای زیر را می‌پذیرد: \fBprefix\fP، \fBbindir\fP، \fBlibdir\fP، \fBincdir\fP، \fBpkglibdir\fP، \fBsysconfdir\fP\&.
.IP \(bu 2
\fB\-\-pretty\fP: هنگام استفاده در ترکیب با سایر پارامترها، خروجی در قالب خوانا و زیبا (prettyprint) نمایش داده می‌شود (پیش‌فرض).
.IP \(bu 2
\fB\-\-selected\-only\fP: نمایش متغیرها تنها از مؤلفه‌های انتخاب‌شده.
.IP \(bu 2
\fB\-V\fP, \fB\-\-version\fP: نمایش نسخه Open MPI.
.UNINDENT
.SH "سطوح (LEVELS)"
.sp
پروژه Open MPI دارای تعداد بسیار زیادی پارامتر قابل تنظیم در زمان اجرا (تحت عنوان «پارامترهای MCA») است و معمولاً تنها شمار اندکی از آن‌ها برای یک کاربر مشخص مفید هستند.
.sp
از این رو، Open MPI این پارامترها را به ۹ سطح متمایز تقسیم کرده است که در ۳ دسته کلی، و هر دسته در ۳ زیردسته تفکیک شده‌اند.
.sp
توجه داشته باشید از آن‌جا که هر پارامتر MCA از طریق API متغیر کنترلی MPI_T (معرفی‌شده در MPI\-3.0) قابل دسترسی است، این سطوح دقیقاً با ۹ سطح cvar در MPI_T مطابقت دارند.
.sp
سه دسته اصلی عبارتند از:
.INDENT 0.0
.IP 1. 3
\fBکاربر نهایی (End user)\fP: به‌طور کلی، این پارامترها برای صحت عملکرد برنامه ضروری هستند؛ به این معنا که ممکن است کاربر صرفاً برای اجرای صحیح برنامه MPI خود ناچار به تنظیم آن‌ها باشد. به عنوان مثال، پارامترهای BTL شامل \fBif_include\fP و \fBif_exclude\fP در این دسته قرار می‌گیرند.
.IP 2. 3
\fBتنظیم‌کننده کارایی برنامه (Application tuner)\fP: به‌طور کلی، این پارامترها برای بهینه‌سازی و تنظیم عملکرد برنامه MPI به کار می‌روند. این پارامترها حتی مواردی که سطوح مصرف منابع را کنترل می‌کنند (مانند تعداد ورودی‌های لیست آزاد، اندازه بافرها و غیره) در بر می‌گیرند، که اگر بیش از حد کم تنظیم شوند ممکن است پارامتر «صحت عملکرد» تلقی شوند؛ اما در واقع پارامترهای تنظیم کارایی هستند.
.IP 3. 3
\fBتوسعه‌دهنده Open MPI (Open MPI developer)\fP: پارامترهای این دسته یا در دو دسته دیگر جای نمی‌گیرند، یا منحصراً برای اشکال‌زدایی / توسعه خود Open MPI طراحی شده‌اند.
.UNINDENT
.sp
و درون هر دسته، سه زیردسته وجود دارد:
.INDENT 0.0
.IP 1. 3
\fBپایه (Basic)\fP: این زیردسته برای پارامترهایی است که همه افراد حاضر در آن دسته مایل به دیدن آن هستند — حتی کاربران نهایی با تجربه کمتر، بهینه‌سازان برنامه و توسعه‌دهندگان جدید OMPI.
.IP 2. 3
\fBهمراه با جزئیات (Detailed)\fP: این زیردسته برای پارامترهایی است که به‌طور کلی مفید هستند، اما کاربران احتمالاً نیازی به تغییر مکرر آن‌ها نخواهند داشت.
.IP 3. 3
\fBهمه (All)\fP: این زیردسته شامل تمام پارامترهای دیگر است. چنین پارامترهایی احتمالاً کاملاً تخصصی و کم‌کاربرد هستند.
.UNINDENT
.sp
با ترکیب دسته‌ها و زیردسته‌ها، نحوه تعریف تمام سطوح ۹‌گانه توسط Open MPI به شرح زیر است:
.INDENT 0.0
.IP 1. 3
اطلاعات پایه مورد نیاز کاربران نهایی.
.IP 2. 3
اطلاعات با جزئیات بیشتر مورد نیاز کاربران نهایی.
.IP 3. 3
تمامی اطلاعات باقی‌مانده مورد نیاز کاربران نهایی.
.IP 4. 3
اطلاعات پایه مورد نیاز برای بهینه‌سازان برنامه‌ها.
.IP 5. 3
اطلاعات با جزئیات مورد نیاز برای بهینه‌سازان برنامه‌ها.
.IP 6. 3
تمامی اطلاعات باقی‌مانده مورد نیاز برای بهینه‌سازان برنامه‌ها.
.IP 7. 3
اطلاعات پایه برای توسعه‌دهندگان Open MPI.
.IP 8. 3
اطلاعات با جزئیات برای توسعه‌دهندگان Open MPI.
.IP 9. 3
تمامی اطلاعات باقی‌مانده برای توسعه‌دهندگان Open MPI.
.UNINDENT
.sp
به‌طور پیش‌فرض، \fBompi_info\fP تنها پارامترهای MCA سطح ۱ را نمایش می‌دهد. برای مشاهده پارامترهای بیشتر، از گزینه خط فرمان \fB\-\-level\fP استفاده کنید.
.SH "مثال‌ها (EXAMPLES)"
.sp
نمایش خروجی پیش‌فرض گزینه‌ها و فهرست مؤلفه‌های نصب‌شده در قالب خوانا و زیبا (prettyprint):
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
ompi_info
.ft P
.fi
.UNINDENT
.UNINDENT
.sp
نمایش خروجی پیش‌فرض گزینه‌ها و فهرست مؤلفه‌های نصب‌شده در قالبی قابل تجزیه توسط ماشین (machine\-parsable):
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
ompi_info \-\-parsable
.ft P
.fi
.UNINDENT
.UNINDENT
.sp
نمایش پارامترهای MCA سطح ۱ برای مؤلفه BTL با نام «tcp» در قالب انسان‌خوان / زیبا:
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
ompi_info \-\-param btl tcp
.ft P
.fi
.UNINDENT
.UNINDENT
.sp
نمایش پارامترهای MCA از سطح ۱ تا سطح ۶ برای مؤلفه BTL با نام «tcp» در قالب انسان‌خوان / زیبا:
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
ompi_info \-\-param btl tcp \-\-level 6
.ft P
.fi
.UNINDENT
.UNINDENT
.sp
نمایش پارامترهای MCA سطح ۱ برای مؤلفه BTL با نام «tcp» در قالب قابل پردازش توسط ماشین:
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
ompi_info \-\-param btl tcp \-\-parsable
.ft P
.fi
.UNINDENT
.UNINDENT
.sp
نمایش پارامترهای MCA از سطح ۱ تا سطح ۳ از نوع رشته‌ای (string) در قالبی خوانا و زیبا:
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
ompi_info \-\-type string \-\-pretty\-print \-\-level 3
.ft P
.fi
.UNINDENT
.UNINDENT
.sp
نمایش دایرکتوری «bindir» که Open MPI با آن پیکربندی شده است:
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
ompi_info \-\-path bindir
.ft P
.fi
.UNINDENT
.UNINDENT
.sp
نمایش شماره نسخه‌های Open MPI در قالبی زیبا و خوانا:
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
ompi_info \-\-version
.ft P
.fi
.UNINDENT
.UNINDENT
.sp
نمایش \fIتمام\fP اطلاعات مربوط به نصب Open MPI، از جمله تمامی مؤلفه‌های یافت‌شده، تمام پارامترهای MCA که پشتیبانی می‌کنند (یعنی سطوح ۱ تا ۹)، نسخه‌های Open MPI و مؤلفه‌ها و غیره:
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
ompi_info \-\-all
.ft P
.fi
.UNINDENT
.UNINDENT
.SH "حق نشر (COPYRIGHT)"
2003-2026, The Open MPI Community
.\" Generated by docutils manpage writer.
.