.nh
.TH "GH-ATTESTATION-DOWNLOAD" "1" "Sep 2026" "" "GitHub CLI manual"

.SH "نام (NAME)"
gh-attestation-download \- دانلود تاییدیه‌ها از گیت‌هاب


.SH "خلاصه دستور (SYNOPSIS)"
\fBgh attestation download [<file-path> | oci://<image-uri>] [--owner | --repo] [flags]\fR


.SH "توضیحات (DESCRIPTION)"
.SS "نکته: این قابلیت در حال حاضر در مرحلهٔ پیش‌نمایش عمومی است و ممکن است تغییر کند."
دانلود تاییدیه‌های مرتبط با یک دست‌ساخته (آرتفکت) برای استفادهٔ آفلاین.

.PP
این دستور به یکی از موارد زیر نیاز دارد:
* مسیر فایل به یک دست‌ساخته، یا
* یک
.B URI
تصویر کانتینر (برای نمونه
.BR oci://<image-uri> )
  * (توجه داشته باشید که در صورت ارائهٔ یک نشانی اینترنتی
.BR OCI ،
باید از قبل در رجیستری کانتینر آن احراز هویت کرده باشید)

.PP
علاوه بر این، این دستور به یکی از موارد زیر نیاز دارد:
* فلگ
.B \-\-repo
(برای نمونه
.BR \-\-repo " github/example)."
* یا فلگ
.B \-\-owner
(برای نمونه
.BR \-\-owner " github)،"
یا

.PP
مقدار فلگ
.B \-\-repo
باید با نام مخزن گیت‌هابی که دست‌ساخته به آن مرتبط است مطابقت داشته باشد.

.PP
مقدار فلگ
.B \-\-owner
باید با نام سازمان گیت‌هابی که مخزن مرتبط با دست‌ساخته به آن تعلق دارد مطابقت داشته باشد.

.PP
هر بستهٔ مرتبط
.RB ( bundle )
در فایلی درون دایرکتوری جاری و با نام برگرفته از خلاصهٔ
.RB ( digest )
دست‌ساخته نوشته خواهد شد. برای نمونه، اگر خلاصه
"sha256:1234"
باشد، نام فایل
"sha256:1234.jsonl"
خواهد بود.

.PP
دو‌نقطه
.RB ( : )
در ویندوز جزو نویسه‌های خاص است و نمی‌توان از آن در نام فایل‌ها استفاده کرد. برای سازگاری با این محدودیت، از یک خط تیره برای جداسازی الگوریتم از خلاصه در نام فایل تاییدیه‌ها استفاده خواهد شد. برای نمونه، اگر خلاصه
"sha256:1234"
باشد، نام فایل
"sha256-1234.jsonl"
خواهد بود.


.SH "گزینه‌ها (OPTIONS)"
.TP
\fB-d\fR, \fB--digest-alg\fR \fB<string> (default "sha256")\fR
الگوریتم مورد استفاده برای محاسبهٔ خلاصهٔ (دایجست) دست‌ساخته: {sha256|sha512}

.TP
\fB--hostname\fR \fB<string>\fR
پیکربندی میزبان مورد استفاده

.TP
\fB-L\fR, \fB--limit\fR \fB<int> (default 30)\fR
حداکثر تعداد تاییدیه‌ها برای دریافت

.TP
\fB-o\fR, \fB--owner\fR \fB<string>\fR
سازمان گیت‌هاب جهت محدود کردن دامنهٔ جستجوی تاییدیه‌ها

.TP
\fB--predicate-type\fR \fB<string>\fR
فیلتر کردن تاییدیه‌ها بر اساس نوع گزارهٔ (predicate type) ارائه‌شده

.TP
\fB-R\fR, \fB--repo\fR \fB<string>\fR
نام مخزن در قالب [HOST/]OWNER/REPO


.SH "کدهای خروج (EXIT CODES)"
0: اجرای موفقیت‌آمیز

.PP
1: خطا

.PP
2: دستور لغو شد

.PP
4: نیاز به احراز هویت است

.PP
نکته: دستورات خاص ممکن است کدهای خروج بیشتری داشته باشند. برای اطلاعات بیشتر به راهنمای همان دستور مراجعه کنید.


.SH "مثال‌ها (EXAMPLES)"
.EX
# دانلود تاییدیه‌ها برای یک دست‌ساخته محلی مرتبط با یک سازمان
$ gh attestation download example.bin -o github

# دانلود تاییدیه‌ها برای یک دست‌ساخته محلی مرتبط با یک مخزن
$ gh attestation download example.bin -R github/example

# دانلود تاییدیه‌ها برای یک تصویر OCI مرتبط با یک سازمان
$ gh attestation download oci://example.com/foo/bar:latest -o github

.EE


.SH "همچنین ببینید (SEE ALSO)"
\fBgh-attestation(1)\fR