نام (NAME)

singularity-inspect - نمایش فراداده‌های (متادیتا) یک تصویر کانتینر

خلاصه دستور (SYNOPSIS)

apptainer inspect [inspect options...]

توضیحات (DESCRIPTION)

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

گزینه‌ها (OPTIONS)

--all[=false] نمایش تمام داده‌های موجود (شامل گزینه --json)

--app="" بررسی یک برنامه خاص درون کانتینر

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

-e, --environment[=false] نمایش تنظیمات محیطی تصویر کانتینر

-h, --help[=false] راهنمای inspect

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

-j, --json[=false] چاپ خروجی ساختاریافته به فرمت JSON به جای بخش‌های متنی

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

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

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

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

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

مثال‌ها (EXAMPLE)

$ 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

همچنین ببینید (SEE ALSO)

apptainer(1)

تاریخچه (HISTORY)

30-Jul-2026 تولید خودکار توسط spf13/cobra