OSHMEM_INFO(1)                     Open MPI                     OSHMEM_INFO(1)

نام (NAME)
       oshmem_info - نمایش اطلاعات درباره نصب OpenSHMEM

خلاصه دستور (SYNOPSIS)
       oshmem_info [گزینه‌ها]

توضیحات (DESCRIPTION)
       دستور oshmem_info اطلاعات دقیقی درباره نصب OpenSHMEM ارائه می‌دهد. این
       ابزار می‌تواند دست‌کم در سه سناریوی متداول مفید باشد:

       1. بررسی پیکربندی محلی و مشاهده نحوه نصب OpenSHMEM.

       2. ارسال گزارش‌های اشکال / درخواست‌های راهنمایی به جامعه کاربری OpenSHMEM
          (بخش دریافت راهنمایی را ببینید).

       3. مشاهده فهرستی از افزونه‌های نصب‌شده OpenSHMEM و پرس‌وجو درباره
          پارامترهای MCA که پشتیبانی می‌کنند.

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

گزینه‌ها (OPTIONS)
       دستور oshmem_info گزینه‌های زیر را می‌پذیرد:

       • -a, --all: نمایش تمامی گزینه‌های پیکربندی و پارامترهای MCA

       • --arch: نمایش معماری‌ای که OpenSHMEM روی آن کامپایل شده است

       • -c, --config: نمایش گزینه‌های پیکربندی

       • -gmca, --gmca <param> <value>*: ارسال پارامترهای سراسری MCA که برای
         تمام زمینه‌ها (contexts) قابل اعمال هستند.

       • -h, --help*: نمایش پیام راهنما / نحوه استفاده

       • --hostname: نمایش نام میزبانی (hostname) که OpenSHMEM روی آن پیکربندی
         و ساخته شده است

       • --internal: نمایش پارامترهای داخلی MCA (برای تغییر توسط کاربران در
         نظر گرفته نشده است)

       • --level: نمایش متغیرهایی حداکثر تا این سطح (۱-۹). مقدار پیش‌فرض ۱ است،
         مگر اینکه --all بدون --level مشخص شده باشد که در این صورت مقدار
         پیش‌فرض ۹ خواهد بود. برای اطلاعات بیشتر بخش سطوح (LEVELS) را ببینید.

       • -mca, --mca <param> <value>: ارسال پارامترهای MCA مختص به زمینه؛ در
         صورتی که از --gmca استفاده نشود و فقط یک زمینه تعیین شده باشد، این
         پارامترها سراسری در نظر گرفته می‌شوند.

       • --param <type> <component>: نمایش پارامترهای MCA. پارامتر اول نوع
         مؤلفه برای نمایش است؛ پارامتر دوم مؤلفه مشخص برای نمایش است (یا
         کلیدواژه all، به معنای «نمایش تمامی مؤلفه‌های این نوع»).

       • --parsable: در صورت استفاده به همراه پارامترهای دیگر، خروجی در قالبی
         قابل تجزیه توسط ماشین نمایش داده می‌شود. گزینه --parseable مترادفی
         برای --parsable است.

       • --path <type>: نمایش مسیرهایی که OpenSHMEM با آن‌ها پیکربندی شده است.
         پارامترهای زیر را می‌پذیرد: prefix، bindir، libdir، incdir، pkglibdir،
         sysconfdir.

       • --pretty: در صورت استفاده به همراه سایر پارامترها، خروجی در قالبی
         خوانا و آراسته (prettyprint) نمایش داده می‌شود (پیش‌فرض)

       • --selected-only: نمایش متغیرها تنها از مؤلفه‌های انتخاب‌شده.

       • -V, --version*: نمایش نسخه OpenSHMEM.

سطوح (LEVELS)

       1. اطلاعات پایه مورد توجه کاربران

       2. اطلاعات دقیق و تفصیلی مورد توجه کاربران

       3. تمام اطلاعات باقی‌مانده مورد توجه کاربران

       4. اطلاعات پایه مورد نیاز برای تنظیم و بهینه‌سازی (tuning)

       5. اطلاعات دقیق و تفصیلی مورد نیاز برای تنظیم و بهینه‌سازی

       6. تمام اطلاعات باقی‌مانده مورد نیاز برای تنظیم و بهینه‌سازی

       7. اطلاعات پایه برای پیاده‌سازان و توسعه‌دهندگان OpenSHMEM

       8. اطلاعات دقیق و تفصیلی برای پیاده‌سازان و توسعه‌دهندگان OpenSHMEM

       9. تمام اطلاعات باقی‌مانده برای پیاده‌سازان و توسعه‌دهندگان OpenSHMEM

مثال‌ها (EXAMPLES)

          shell$ oshmem_info

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

          shell$ oshmem_info --parsable

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

          shell$ oshmem_info --param btl openib

       نمایش پارامترهای MCA مربوط به مؤلفه BTL «openib» در قالبی خوانا و
       آراسته.

          shell$ oshmem_info --param btl openib --parsable

       نمایش پارامترهای MCA مربوط به مؤلفه BTL «openib» در قالبی قابل تجزیه
       توسط ماشین.

          shell$ oshmem_info --path bindir

       نمایش «bindir» پیکربندی‌شده برای OpenSHMEM.

          shell$ oshmem_info --version ompi full --parsable

       نمایش شماره نسخه‌های کامل OpenSHMEM (از جمله شماره نسخه‌های ORTE و OPAL)
       در قالبی قابل خواندن توسط ماشین.

          shell$ oshmem_info --version btl major

       نمایش شماره نسخه اصلی (major) تمامی مؤلفه‌های BTL در قالبی آراسته.

          shell$ oshmem_info --version btl:tcp minor

       نمایش شماره نسخه فرعی (minor) مؤلفه TCP BTL در قالبی آراسته.

          shell$ oshmem_info --all

       نمایش تمام اطلاعات مربوط به نصب OpenSHMEM، از جمله تمامی مؤلفه‌های
       یافت‌شده، پارامترهای MCA مورد پشتیبانی آن‌ها، نسخه‌های OpenSHMEM و
       مؤلفه‌ها، و غیره.

حق نشر (COPYRIGHT)
       2003-2026, The Open MPI Community

                               February 23, 2026                OSHMEM_INFO(1)