.nh
.TH podman-artifact-extract 1
.SH "نام (NAME)"
podman-artifact-extract \- استخراج یک آرتیفکت OCI به یک مسیر محلی

.SH "خلاصه دستور (SYNOPSIS)"
\fBpodman artifact extract\fP \fIartifact\fP \fItarget\fP

.SH "توضیحات (DESCRIPTION)"
استخراج بلاب‌های (blobs) یک آرتیفکت OCI به یک فایل یا دایرکتوری محلی.

.PP
اگر مسیر مقصد یک فایل باشد یا وجود نداشته باشد، آرتیفکت باید شامل تنها یک بلاب (لایه) باشد، یا اگر دارای چندین بلاب (لایه) است باید از گزینه \fB--digest\fP یا \fB--title\fP برای انتخاب تنها یک بلاب منفرد استفاده شود. اگر فایل از قبل وجود داشته باشد، بازنویسی خواهد شد.

.PP
اگر مقصد یک دایرکتوری باشد (باید از قبل وجود داشته باشد)، تمام بلاب‌ها به دایرکتوری مقصد کپی خواهند شد. مقدار حاشیه‌نویسی (annotation) \fBorg.opencontainers.image.title\fR به عنوان نام فایل مقصد استفاده می‌شود. در صورتی که این حاشیه‌نویسی وجود نداشته باشد، نام فایل مقصد برابر با دایجست (digest) بلاب خواهد بود (که در نام آن \fB:\fR با \fB-\fR جایگزین می‌شود).
اگر فایل مقصد از قبل در دایرکتوری وجود داشته باشد، بازنویسی خواهد شد.

.SH "گزینه‌ها (OPTIONS)"
.SS \fB--digest\fP=\fBdigest\fP
هنگام استخراج بلاب‌ها از آرتیفکت، تنها از بلاب با دایجست مشخص‌شده استفاده می‌کند.
اگر مقصد یک دایرکتوری باشد، حتی در صورت وجود حاشیه‌نویسی عنوان روی بلاب، همیشه از دایجست به عنوان نام فایل استفاده می‌شود.
با گزینه \fB--title\fP در تضاد است.

.SS \fB--title\fP=\fBtitle\fP
هنگام استخراج بلاب‌ها از آرتیفکت، تنها از بلاب با عنوان مشخص‌شده استفاده می‌کند.
این گزینه حاشیه‌نویسی \fBorg.opencontainers.image.title\fR را بررسی کرده و آن را با عنوان داده‌شده تطبیق می‌دهد.
با گزینه \fB--digest\fP در تضاد است.

.SH "مثال‌ها (EXAMPLES)"
استخراج یک آرتیفکت با یک بلاب منفرد

.EX
$ podman artifact extract quay.io/artifact/foobar1:test /tmp/myfile
.EE

.PP
استخراج یک آرتیفکت با چندین بلاب

.EX
$ podman artifact extract quay.io/artifact/foobar2:test /tmp/mydir
$ ls /tmp/mydir
CONTRIBUTING.md  README.md
.EE

.PP
استخراج تنها یک بلاب از یک آرتیفکت با چندین بلاب

.EX
$ podman artifact extract --title README.md quay.io/artifact/foobar2:test /tmp/mydir
$ ls /tmp/mydir
README.md
.EE

.PP
یا استفاده از دایجست به جای عنوان

.EX
$ podman artifact extract --digest sha256:c0594e012b17fd9e6548355ceb571a79613f7bb988d7d883f112513601ac6e9a quay.io/artifact/foobar2:test /tmp/mydir
$ ls /tmp/mydir
README.md
.EE

.SH "همچنین ببینید (SEE ALSO)"
\fBpodman(1)\fP, \fBpodman-artifact(1)\fP

.SH "تاریخچه (HISTORY)"
فوریه ۲۰۲۵، در ابتدا توسط پائول هولتسینگر (Paul Holzinger pholzing@redhat.com) گردآوری شد
\[la]mailto:pholzing@redhat.com\[ra]