'\" t
.\"     Title: git-upload-archive
.\"    Author: [FIXME: author] [see http://www.docbook.org/tdg5/en/html/author]
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net>
.\"      Date: 2026-06-29
.\"    Manual: Git Manual
.\"    Source: Git 2.55.0
.\"  Language: English
.\"
.TH "GIT\-UPLOAD\-ARCHIVE" "1" "2026\-06\-29" "Git 2\&.55\&.0" "Git Manual"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "نام (NAME)"
git-upload-archive \- ارسال بایگانی به git\-archive
.SH "خلاصه دستور (SYNOPSIS)"
.sp
.nf
\fIgit upload\-archive\fR <repository>
.fi
.sp
.SH "توضیحات (DESCRIPTION)"
.sp
توسط \fIgit archive \-\-remote\fR فراخوانی می‌شود و یک بایگانی ایجادشده را از طریق پروتکل گیت به سمت دیگر ارسال می‌کند\&.
.sp
این دستور معمولاً مستقیماً توسط کاربر نهایی فراخوانی نمی‌شود\&. رابط کاربری این پروتکل در سمت \fIgit archive\fR قرار دارد و این جفت برنامه برای دریافت یک بایگانی از یک مخزن دوردست (ریموت) به کار می‌روند\&.
.SH "امنیت (SECURITY)"
.sp
به منظور محافظت از حریم خصوصی اشیایی که از تاریخچه حذف شده‌اند اما ممکن است هنوز هرس (prune) نشده باشند، \fBgit\-upload\-archive\fR از ارائه بایگانی‌ها برای کامیت‌ها و درخت‌هایی که از طریق ارجاع‌های (refs) مخزن قابل دسترسی نیستند خودداری می‌کند\&. با این حال، از آنجا که محاسبه قابلیت دسترسی اشیاء از نظر محاسباتی سنگین است، \fBgit\-upload\-archive\fR مجموعه‌ای سخت‌گیرانه‌تر اما با بررسی آسان‌تر از قوانین را پیاده‌سازی می‌کند:
.sp
.RS 4
.ie n \{\
\h'-04' 1.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  1." 4.2
.\}
کلاینت‌ها می‌توانند کامیت یا درختی را درخواست کنند که مستقیماً توسط یک ارجاع (ref) به آن اشاره شده است\&. برای مثال:
\fBgit\fR
\fBarchive\fR
\fB\-\-remote=origin\fR
\fBv1\&.0\fR\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 2.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  2." 4.2
.\}
کلاینت‌ها می‌توانند یک زیردرخت را درون یک کامیت یا درخت با استفاده از ساختار نحوی
\fBref:path\fR
درخواست کنند\&. برای مثال:
\fBgit\fR
\fBarchive\fR
\fB\-\-remote=origin\fR
\fBv1\&.0:Documentation\fR\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 3.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  3." 4.2
.\}
کلاینت‌ها
\fIنباید\fR
از سایر عبارات sha1 استفاده کنند، حتی اگر نتیجه نهایی قابل دسترسی باشد\&. برای مثال، نه یک کامیت نسبی مانند
\fBmaster^\fR
و نه یک عبارت صریح sha1 مانند
\fBabcd1234\fR
مجاز نیستند، حتی اگر نتیجه از ارجاع‌ها قابل دسترسی باشد\&.
.RE
.sp
توجه داشته باشید که قانون ۳ بسیاری از مواردی را که هیچ پیامد نقض حریم خصوصی ندارند نیز ممنوع می‌کند\&. این قوانین در نسخه‌های آینده گیت ممکن است تغییر کنند و سروری که توسط \fBgit\fR \fBarchive\fR \fB\-\-remote\fR به آن دسترسی پیدا می‌شود ممکن است دقیقاً از این قوانین پیروی کند یا نکند\&.
.sp
اگر گزینه پیکربندی \fBuploadArchive\&.allowUnreachable\fR فعال (true) باشد، این قوانین نادیده گرفته می‌شوند و کلاینت‌ها می‌توانند از عبارات دلخواه sha1 استفاده کنند\&. این گزینه در صورتی مفید است که حریم خصوصی اشیاء غیرقابل‌دسترس برای شما اهمیتی نداشته باشد، یا اینکه پایگاه داده اشیاء شما پیش‌تر از طریق non\-smart\-http برای دسترسی عمومی در دسترس قرار گرفته باشد\&.
.SH "گزینه‌ها (OPTIONS)"
.PP
<repository>
.RS 4
مخزنی که باید یک بایگانی tar از آن دریافت شود\&.
.RE
.SH "گیت (GIT)"
.sp
بخشی از مجموعه \fBgit\fR(1)