OMPI_INFO(1) Open MPI OMPI_INFO(1)

ompi_info - نمایش اطلاعات درباره پیکربندی و نصب Open MPI

ompi_info [گزینه‌ها]

ompi_info اطلاعات دقیقی درباره نصب Open MPI ارائه می‌دهد. این ابزار حداقل در سه سناریوی متداول مفید است:

1.
بررسی پیکربندی محلی و مشاهده نحوه نصب Open MPI.
2.
ارسال گزارش‌های اشکال / درخواست‌های راهنمایی به جامعه کاربری Open MPI (بخش دریافت راهنمایی را ببینید).
3.
مشاهده فهرستی از افزونه‌های (plugins) نصب‌شده Open MPI و بررسی این‌که چه پارامترهای MCA توسط آن‌ها پشتیبانی می‌شود.

نکته:

ompi_info به‌طور پیش‌فرض تنها تعداد اندکی از پارامترهای MCA را نمایش می‌دهد (یعنی پارامترهای سطح ۱). از گزینه --level برای فعال‌سازی نمایش گزینه‌های بیشتر استفاده کنید (برای اطلاعات بیشتر بخش سطوح (LEVELS) را ببینید).

ompi_info گزینه‌های زیر را می‌پذیرد:

  • -a, --all: نمایش تمام گزینه‌های پیکربندی و پارامترهای MCA. همچنین سطح پیش‌فرض پارامترهای MCA را به ۹ تغییر می‌دهد، مگر اینکه --level نیز مشخص شده باشد.
  • --arch: نمایش معماری سیستمی که Open MPI روی آن کامپایل شده است.
  • -c, --config: نمایش گزینه‌های پیکربندی.
  • -gmca, --gmca <param> <value>: ارسال پارامترهای سراسری MCA که برای تمام زمینه‌ها (contexts) اعمال می‌شوند.
  • -h, --help: نمایش پیام راهنما / نحوه استفاده.
  • --hostname: نمایش نام میزبانی (hostname) که Open MPI روی آن پیکربندی و ساخته شده است.
  • --internal: نمایش پارامترهای داخلی MCA (که برای تغییر توسط کاربران در نظر گرفته نشده‌اند).
  • --level <level>: نمایش متغیرها تنها تا حداکثر این سطح (۱-۹). مقدار پیش‌فرض ۱ است مگر اینکه --all بدون --level مشخص شده باشد، که در این صورت مقدار پیش‌فرض ۹ خواهد بود. برای اطلاعات بیشتر بخش سطوح (LEVELS) را ببینید.
  • -mca, --mca <param> <value>: ارسال پارامترهای MCA وابسته به زمینه (context-specific)؛ اگر از --gmca استفاده نشود و تنها یک زمینه تعیین شده باشد، این پارامترها سراسری در نظر گرفته می‌شوند.
  • --param <type> <component>: نمایش پارامترهای MCA. پارامتر اول نوع مؤلفه‌ای است که باید نمایش داده شود؛ پارامتر دوم مؤلفه مشخص جهت نمایش است (یا کلمه کلیدی all، به معنای «نمایش تمامی مؤلفه‌های این نوع»).
  • -t, --type: نمایش پارامترهای MCA از نوع مشخص‌شده در پارامتر. مقادیر زیر را می‌پذیرد: unsigned_int، unsigned_long، unsigned_long_long، size_t، string، version_string، bool، double. به‌طور پیش‌فرض سطح ۱ است مگر اینکه با --level مشخص شده باشد.
  • --parsable: هنگام استفاده در ترکیب با سایر پارامترها، خروجی در قالبی قابل تجزیه توسط ماشین (machine-parsable) نمایش داده می‌شود. گزینه --parseable مترادفی برای --parsable است.
  • --path <type>: نمایش مسیرهایی که Open MPI با آن‌ها پیکربندی شده است. پارامترهای زیر را می‌پذیرد: prefix، bindir، libdir، incdir، pkglibdir، sysconfdir.
  • --pretty: هنگام استفاده در ترکیب با سایر پارامترها، خروجی در قالب خوانا و زیبا (prettyprint) نمایش داده می‌شود (پیش‌فرض).
  • --selected-only: نمایش متغیرها تنها از مؤلفه‌های انتخاب‌شده.
  • -V, --version: نمایش نسخه Open MPI.

پروژه Open MPI دارای تعداد بسیار زیادی پارامتر قابل تنظیم در زمان اجرا (تحت عنوان «پارامترهای MCA») است و معمولاً تنها شمار اندکی از آن‌ها برای یک کاربر مشخص مفید هستند.

از این رو، Open MPI این پارامترها را به ۹ سطح متمایز تقسیم کرده است که در ۳ دسته کلی، و هر دسته در ۳ زیردسته تفکیک شده‌اند.

توجه داشته باشید از آن‌جا که هر پارامتر MCA از طریق API متغیر کنترلی MPI_T (معرفی‌شده در MPI-3.0) قابل دسترسی است، این سطوح دقیقاً با ۹ سطح cvar در MPI_T مطابقت دارند.

سه دسته اصلی عبارتند از:

1.
کاربر نهایی (End user): به‌طور کلی، این پارامترها برای صحت عملکرد برنامه ضروری هستند؛ به این معنا که ممکن است کاربر صرفاً برای اجرای صحیح برنامه MPI خود ناچار به تنظیم آن‌ها باشد. به عنوان مثال، پارامترهای BTL شامل if_include و if_exclude در این دسته قرار می‌گیرند.
2.
تنظیم‌کننده کارایی برنامه (Application tuner): به‌طور کلی، این پارامترها برای بهینه‌سازی و تنظیم عملکرد برنامه MPI به کار می‌روند. این پارامترها حتی مواردی که سطوح مصرف منابع را کنترل می‌کنند (مانند تعداد ورودی‌های لیست آزاد، اندازه بافرها و غیره) در بر می‌گیرند، که اگر بیش از حد کم تنظیم شوند ممکن است پارامتر «صحت عملکرد» تلقی شوند؛ اما در واقع پارامترهای تنظیم کارایی هستند.
3.
توسعه‌دهنده Open MPI (Open MPI developer): پارامترهای این دسته یا در دو دسته دیگر جای نمی‌گیرند، یا منحصراً برای اشکال‌زدایی / توسعه خود Open MPI طراحی شده‌اند.

و درون هر دسته، سه زیردسته وجود دارد:

1.
پایه (Basic): این زیردسته برای پارامترهایی است که همه افراد حاضر در آن دسته مایل به دیدن آن هستند — حتی کاربران نهایی با تجربه کمتر، بهینه‌سازان برنامه و توسعه‌دهندگان جدید OMPI.
2.
همراه با جزئیات (Detailed): این زیردسته برای پارامترهایی است که به‌طور کلی مفید هستند، اما کاربران احتمالاً نیازی به تغییر مکرر آن‌ها نخواهند داشت.
3.
همه (All): این زیردسته شامل تمام پارامترهای دیگر است. چنین پارامترهایی احتمالاً کاملاً تخصصی و کم‌کاربرد هستند.

با ترکیب دسته‌ها و زیردسته‌ها، نحوه تعریف تمام سطوح ۹‌گانه توسط Open MPI به شرح زیر است:

1.
اطلاعات پایه مورد نیاز کاربران نهایی.
2.
اطلاعات با جزئیات بیشتر مورد نیاز کاربران نهایی.
3.
تمامی اطلاعات باقی‌مانده مورد نیاز کاربران نهایی.
4.
اطلاعات پایه مورد نیاز برای بهینه‌سازان برنامه‌ها.
5.
اطلاعات با جزئیات مورد نیاز برای بهینه‌سازان برنامه‌ها.
6.
تمامی اطلاعات باقی‌مانده مورد نیاز برای بهینه‌سازان برنامه‌ها.
7.
اطلاعات پایه برای توسعه‌دهندگان Open MPI.
8.
اطلاعات با جزئیات برای توسعه‌دهندگان Open MPI.
9.
تمامی اطلاعات باقی‌مانده برای توسعه‌دهندگان Open MPI.

به‌طور پیش‌فرض، ompi_info تنها پارامترهای MCA سطح ۱ را نمایش می‌دهد. برای مشاهده پارامترهای بیشتر، از گزینه خط فرمان --level استفاده کنید.

نمایش خروجی پیش‌فرض گزینه‌ها و فهرست مؤلفه‌های نصب‌شده در قالب خوانا و زیبا (prettyprint):

ompi_info

نمایش خروجی پیش‌فرض گزینه‌ها و فهرست مؤلفه‌های نصب‌شده در قالبی قابل تجزیه توسط ماشین (machine-parsable):

ompi_info --parsable

نمایش پارامترهای MCA سطح ۱ برای مؤلفه BTL با نام «tcp» در قالب انسان‌خوان / زیبا:

ompi_info --param btl tcp

نمایش پارامترهای MCA از سطح ۱ تا سطح ۶ برای مؤلفه BTL با نام «tcp» در قالب انسان‌خوان / زیبا:

ompi_info --param btl tcp --level 6

نمایش پارامترهای MCA سطح ۱ برای مؤلفه BTL با نام «tcp» در قالب قابل پردازش توسط ماشین:

ompi_info --param btl tcp --parsable

نمایش پارامترهای MCA از سطح ۱ تا سطح ۳ از نوع رشته‌ای (string) در قالبی خوانا و زیبا:

ompi_info --type string --pretty-print --level 3

نمایش دایرکتوری «bindir» که Open MPI با آن پیکربندی شده است:

ompi_info --path bindir

نمایش شماره نسخه‌های Open MPI در قالبی زیبا و خوانا:

ompi_info --version

نمایش تمام اطلاعات مربوط به نصب Open MPI، از جمله تمامی مؤلفه‌های یافت‌شده، تمام پارامترهای MCA که پشتیبانی می‌کنند (یعنی سطوح ۱ تا ۹)، نسخه‌های Open MPI و مؤلفه‌ها و غیره:

ompi_info --all

2003-2026, The Open MPI Community

February 23, 2026