.nh
.TH "apptainer" "1" "Jul 2026" "Auto generated by spf13/cobra" ""

.SH "نام (NAME)"
apptainer-inspect \- نمایش متادیتای یک تصویر


.SH "خلاصه دستور (SYNOPSIS)"
\fBapptainer inspect [inspect options...] \fP


.SH "توضیحات (DESCRIPTION)"
دستور inspect برچسب‌ها (labels)، متغیرهای محیطی، برنامه‌ها (apps) و اسکریپت‌های مرتبط با تصویر کانتینر را بر اساس گزینه‌های ورودی نمایش می‌دهد. به‌طور پیش‌فرض، این موارد در قالب متن ساده نمایش داده می‌شوند. اگر مایلید آن‌ها را در قالب JSON فهرست کنید، باید از گزینه --json استفاده نمایید.


.SH "گزینه‌ها (OPTIONS)"
\fB--all\fP[=false]
	نمایش تمام داده‌های موجود (شامل گزینه --json)

.PP
\fB--app\fP=""
	بررسی یک برنامه (app) خاص

.PP
\fB-d\fP, \fB--deffile\fP[=false]
	نمایش پرونده تعریف (definition file) Apptainer که برای ایجاد تصویر استفاده شده است

.PP
\fB-e\fP, \fB--environment\fP[=false]
	نمایش تنظیمات محیطی برای تصویر کانتینر

.PP
\fB-h\fP, \fB--help\fP[=false]
	راهنما برای inspect

.PP
\fB-H\fP, \fB--helpfile\fP[=false]
	بررسی پرونده راهنمای runscript (در صورت وجود)

.PP
\fB-j\fP, \fB--json\fP[=false]
	چاپ JSON ساختاریافته به جای بخش‌ها

.PP
\fB-l\fP, \fB--labels\fP[=false]
	نمایش برچسب‌های تصویر کانتینر (پیش‌فرض)

.PP
\fB--list-apps\fP[=false]
	فهرست کردن تمام برنامه‌های موجود در یک کانتینر

.PP
\fB-r\fP, \fB--runscript\fP[=false]
	نمایش اسکریپت اجرای تصویر (runscript)

.PP
\fB-s\fP, \fB--startscript\fP[=false]
	نمایش اسکریپت راه‌اندازی تصویر (startscript)

.PP
\fB-t\fP, \fB--test\fP[=false]
	نمایش اسکریپت آزمایش تصویر (test script)


.SH "مثال (EXAMPLE)"
.EX

  $ apptainer inspect ubuntu.sif

  اگر می‌خواهید برنامه‌های (apps) نصب‌شده در کانتینر (واقع در
  /scif/apps) را فهرست کنید، باید دستور inspect را با گزینه --list-apps <container-image> اجرا کنید.
  (برای اطلاعات بیشتر در مورد برنامه‌های SCIF به https://sci-f.github.io مراجعه کنید)

  متغیرهای محیطی زیر هنگام فراخوانی از پوسته درون کانتینر در دسترس شما
  هستند. متغیرهای بالایی مربوط به برنامه فعال (--app <app>) و متغیرهای پایینی
  برای همه برنامه‌ها صرف‌نظر از برنامه فعال در دسترس هستند. هر دو مجموعه متغیر
  در زمان توسعه (زمان ساخت) نیز در دسترس می‌باشند.

  محیط برنامه فعال (ACTIVE APP ENVIRONMENT):
      SCIF_APPNAME       نام برنامه فعال
      SCIF_APPROOT       پوشه نصب برنامه ایجادشده در /scif/apps/<app>
      SCIF_APPMETA       پوشه متادیتای برنامه
      SCIF_APPDATA       پوشه داده ایجادشده برای برنامه در /scif/data/<app>
        SCIF_APPINPUT    پوشه ورودی مورد انتظار در پوشه داده
        SCIF_APPOUTPUT   پوشه خروجی داده در پوشه داده

      SCIF_APPENV        اشاره به پرونده سفارشی environment.sh در پوشه متادیتای آن
      SCIF_APPLABELS     پرونده labels.json برنامه در پوشه متادیتا
      SCIF_APPBIN        پوشه bin برنامه، که هنگام فعال بودن برنامه به صورت خودکار به $PATH اضافه می‌شود
      SCIF_APPLIB        پوشه کتابخانه برنامه که به LD_LIBRARY_PATH اضافه می‌شود
      SCIF_APPRUN        اسکریپت اجرای runscript
      SCIF_APPSTART      اسکریپت راه‌اندازی startscript
      SCIF_APPHELP       پرونده راهنما برای runscript
      SCIF_APPTEST       اسکریپت آزمایش (test.sh) مرتبط با برنامه
      SCIF_APPNAME       نام برنامه فعال
      SCIF_APPFILES      بخش پرونده‌های مرتبط با برنامه که اضافه شده‌اند


  محیط برنامه سراسری (GLOBAL APP ENVIRONMENT):

      SCIF_DATA             پایگاه داده تعریف‌شده SCIF برای همه برنامه‌ها (/scif/data)
      SCIF_APPS             پایگاه‌های نصب تعریف‌شده SCIF برای همه برنامه‌ها (/scif/apps)
      SCIF_APPROOT_<app>    ریشه برنامه <app>
      SCIF_APPDATA_<app>    ریشه داده برنامه <app>

  برای فهرست کردن تمام برنامه‌ها:

  $ apptainer inspect --list-apps ubuntu.sif

  برای فهرست کردن تنها برچسب‌ها با قالب JSON از یک تصویر:

  $ apptainer inspect --json --labels ubuntu.sif

  برای بررسی اینکه یک برنامه مشخص در تصویر کانتینر خود دارید، از گزینه --app <appname> استفاده کنید:

  $ apptainer inspect --app <appname> ubuntu.sif
.EE


.SH "همچنین ببینید (SEE ALSO)"
\fBapptainer(1)\fP


.SH "تاریخچه (HISTORY)"
30-Jul-2026 تولید خودکار توسط spf13/cobra