--add-compression=compression

اطمینان حاصل می‌کند که نوع فشرده‌سازی درخواستی برای هر بستر به فهرست مانیفست اضافه شود، در حالی که نمونه اصلی در همان فهرست مانیفست دست‌نخورده باقی می‌ماند. مقادیر پشتیبانی‌شده عبارتند از (gzip، zstd و zstd:chunked). این گزینه می‌تواند چندین بار استفاده شود.

توجه داشته باشید که --compression-format قالب فشرده‌سازی هر نمونه در فهرست مانیفست را کنترل می‌کند. گزینه --add-compression نوع دیگری را برای هر نمونه در فهرست با فشرده‌سازی‌های مشخص‌شده اضافه می‌کند. برای مثال، ترکیب --compression-format gzip و --add-compression zstd یک فهرست مانیفست ارسال می‌کند که در آن هر نمونه با gzip فشرده شده، به همراه یک نوع اضافی از هر نمونه که با zstd فشرده شده است.

--all

علاوه بر خود فهرست یا نمایه، ایمیج‌های ذکرشده در فهرست مانیفست یا نمایه ایمیج را نیز ارسال می‌کند. (پیش‌فرض true است)

--authfile=path

مسیر فایل احراز هویت. مقدار پیش‌فرض در لینوکس ${XDG_RUNTIME_DIR}/containers/auth.json و در ویندوز/مک‌او‌اس $HOME/.config/containers/auth.json است. این فایل توسط podman login ایجاد می‌شود. اگر وضعیت احراز هویت در آنجا یافت نشود، مسیر $HOME/.docker/config.json که با استفاده از docker login تنظیم می‌شود بررسی خواهد شد.

نکته: همچنین این امکان وجود دارد که با تنظیم متغیر محیطی REGISTRY_AUTH_FILE، مسیر پیش‌فرض فایل احراز هویت را بازنویسی کنید. این کار با دستور export REGISTRY_AUTH_FILE=path انجام‌پذیر است.

--cert-dir=path

استفاده از گواهی‌های موجود در مسیر path با پسوندهای (*.crt, *.cert, *.key) برای اتصال به رجیستری (پیش‌فرض: /etc/containers/certs.d). برای جزئیات بیشتر به containers-certs.d(5) مراجعه کنید. (این گزینه در کلاینت راه دور پادمن، از جمله دستگاه‌های مک و ویندوز (به استثنای WSL2) در دسترس نیست).

--compression-format=gzip | zstd | zstd:chunked

قالب فشرده‌سازی مورد استفاده را مشخص می‌کند. مقادیر پشتیبانی‌شده عبارتند از: gzip، zstd و zstd:chunked. مقدار پیش‌فرض gzip است، مگر اینکه در فایل containers.conf بازنویسی شده باشد. گزینه zstd:chunked با رمزنگاری ایمیج‌ها ناسازگار است و در این حالت به عنوان zstd همراه با یک هشدار در نظر گرفته خواهد شد.

--compression-level=level

سطح فشرده‌سازی مورد استفاده را مشخص می‌کند. این مقدار به الگوریتم فشرده‌سازی استفاده‌شده بستگی دارد؛ برای مثال برای zstd مقادیر پذیرفته‌شده در محدوده ۱ تا ۲۰ (شامل هر دو) با مقدار پیش‌فرض ۳ هستند، در حالی که برای gzip در محدوده ۱ تا ۹ (شامل هر دو) با مقدار پیش‌فرض ۵ است.

--creds=[username[:password]]

مقدار [username[:password]] برای احراز هویت در رجیستری، در صورت نیاز. اگر یک یا هر دو مقدار ارائه نشوند، اعلانی در خط فرمان ظاهر شده و می‌توان مقدار را وارد کرد. گذرواژه بدون بازتاب وارد می‌شود.

توجه داشته باشید که اعتبارنامه‌های مشخص‌شده فقط برای احراز هویت در برابر رجیستری‌های هدف استفاده می‌شوند. آن‌ها برای آینه‌ها یا زمانی که آدرس رجیستری بازنویسی می‌شود استفاده نمی‌شوند (به containers-registries.conf(5) مراجعه کنید)؛ برای احراز هویت در این موارد استفاده از فایل containers-auth.json(5) را در نظر بگیرید.

--digestfile=Digestfile

پس از کپی کردن ایمیج، دایجست ایمیج حاصل را در فایل می‌نویسد.

--force-compression

در صورت تنظیم، عملیات ارسال از الگوریتم فشرده‌سازی مشخص‌شده استفاده می‌کند حتی اگر مقصد در حال حاضر شامل گونه‌ای با فشرده‌سازی متفاوت باشد. اگر --compression-format به‌صراحت در خط فرمان مشخص شده باشد، مقدار پیش‌فرض true و در غیر این صورت false است.

--format, -f=format

نوع فهرست مانیفست (oci یا v2s2) جهت استفاده هنگام ارسال فهرست (پیش‌فرض oci است).

--quiet, -q

هنگام نوشتن مانیفست، از نمایش خروجی‌های پیشرفت جلوگیری می‌کند.

--remove-signatures

هنگام ارسال ایمیج‌ها، امضاها کپی نشوند.

--retry=attempts

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

--retry-delay=duration

مدت زمان تاخیر بین دفعات تلاش مجدد هنگام دریافت یا ارسال ایمیج‌ها بین رجیستری و فضای ذخیره‌سازی محلی در صورت بروز خطا. حالت پیش‌فرض شروع با دو ثانیه و سپس افزایش نمایی است. در صورت تنظیم این مقدار، تاخیر تعیین‌شده اعمال شده و افزایش نمایی صورت نمی‌گیرد.

--rm

در صورت موفقیت‌آمیز بودن ارسال، فهرست مانیفست یا نمایه ایمیج از فضای ذخیره‌سازی محلی حذف شود.

--sign-by=fingerprint

ایمیج‌های ارسالی را با یک امضای «امضای ساده» (simple signing) با استفاده از کلید مشخص‌شده امضا می‌کند. (این گزینه در کلاینت راه دور پادمن، از جمله دستگاه‌های مک و ویندوز (به استثنای WSL2) در دسترس نیست).

--sign-by-sigstore=param-file

افزودن امضای sigstore بر اساس گزینه‌های بیشتر مشخص‌شده در یک فایل پارامتر امضای sigstore کانتینر (param-file). برای جزئیات درباره قالب فایل به containers-sigstore-signing-params.yaml(5) مراجعه کنید.

--sign-by-sigstore-private-key=path

ایمیج‌های ارسالی را با یک امضای sigstore با استفاده از کلید خصوصی در مسیر مشخص‌شده امضا می‌کند. (این گزینه در کلاینت راه دور پادمن، از جمله دستگاه‌های مک و ویندوز (به استثنای WSL2) در دسترس نیست).

--sign-by-sq-fingerprint=fingerprint

افزودن امضای «امضای ساده» با استفاده از کلید Sequoia-PGP با اثر انگشت مشخص‌شده. (این گزینه در کلاینت راه دور پادمن، از جمله دستگاه‌های مک و ویندوز (به استثنای WSL2) در دسترس نیست).

--sign-passphrase-file=path

در صورت امضای ایمیج (با استفاده از --sign-by، --sign-by-sq-fingerprint یا --sign-by-sigstore-private-key)، عبارت عبور مورد استفاده را از مسیر مشخص‌شده می‌خواند.

--tls-verify

الزام HTTPS و اعتبارسنجی گواهی‌ها هنگام برقراری ارتباط با رجیستری‌ها (پیش‌فرض: true). اگر صراحتاً روی true تنظیم شود، اعتبارسنجی TLS انجام می‌شود. اگر روی false تنظیم شود، اعتبارسنجی TLS انجام نمی‌شود. در صورت عدم تعیین، اعتبارسنجی TLS انجام خواهد شد مگر اینکه رجیستری هدف در containers-registries.conf(5) به عنوان یک رجیستری ناامن فهرست شده باشد.