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

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


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


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


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

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

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

.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

  اگر می‌خواهید برنامه‌های نصب‌شده در کانتینر (واقع در /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:

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


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


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