'\" t
.\"     Title: git-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\-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-archive \- ساخت بایگانی از فایل‌های یک درخت مشخص
.SH "خلاصه دستور (SYNOPSIS)"
.sp
.nf
\fIgit archive\fR [\-\-format=<fmt>] [\-\-list] [\-\-prefix=<prefix>/] [<extra>]
              [\-o <file> | \-\-output=<file>] [\-\-worktree\-attributes]
              [\-\-remote=<repo> [\-\-exec=<git\-upload\-archive>]] <tree\-ish>
              [<path>\&...]
.fi
.sp
.SH "توضیحات (DESCRIPTION)"
.sp
یک بایگانی با قالب مشخص‌شده که شامل ساختار درختیِ درخت نام‌برده است ایجاد کرده و آن را در خروجی استاندارد می‌نویسد\&. در صورت تعیین <prefix>، این پیشوند به ابتدای نام فایل‌ها در بایگانی اضافه می‌شود\&.
.sp
رفتار \fIgit archive\fR هنگامی که یک شناسه درخت (tree ID) به آن داده می‌شود در مقایسه با زمانی که شناسه کامیت (commit ID) یا شناسه برچسب (tag ID) داده می‌شود متفاوت است\&. وقتی شناسه درخت داده شود، از زمان فعلی به عنوان زمان تغییر هر فایل در بایگانی استفاده می‌شود\&. از سوی دیگر، وقتی شناسه کامیت یا برچسب مشخص شود، از زمان کامیت ثبت‌شده در شیء کامیت ارجاع‌شده استفاده خواهد شد\&. علاوه بر این، در صورت استفاده از قالب tar، شناسه کامیت در یک هدر pax سراسری گسترش‌یافته ذخیره می‌شود؛ این مقدار را می‌توان با استفاده از \fIgit get\-tar\-commit\-id\fR استخراج کرد\&. در فایل‌های ZIP نیز به عنوان توضیح فایل (file comment) ذخیره می‌شود\&.
.SH "گزینه‌ها (OPTIONS)"
.PP
\-\-format=<fmt>
.RS 4
قالب بایگانی خروجی\&. مقادیر ممکن عبارتند از
\fBtar\fR،
\fBzip\fR،
\fBtar\&.gz\fR،
\fBtgz\fR، و هر قالبی که با استفاده از گزینه پیکربندی
\fBtar\&.\fR\fI<format>\fR\fB\&.command\fR تعریف شده باشد\&. اگر
\fB\-\-format\fR
مشخص نشده باشد و فایل خروجی تعیین شده باشد، در صورت امکان قالب از نام فایل برداشت می‌شود (برای مثال، نوشتن در
\fBfoo\&.zip\fR
باعث می‌شود خروجی در قالب
\fBzip\fR
باشد)\&. در غیر این صورت، قالب خروجی
\fBtar\fR
خواهد بود\&.
.RE
.PP
\-l, \-\-list
.RS 4
نمایش تمامی قالب‌های موجود\&.
.RE
.PP
\-v, \-\-verbose
.RS 4
گزارش روند پیشرفت در خروجی خطای استاندارد (stderr)\&.
.RE
.PP
\-\-prefix=<prefix>/
.RS 4
افزودن پیشوند <prefix>/ به ابتدای مسیرها در بایگانی\&. می‌تواند تکرار شود؛ راست‌ترین مقدار آن برای تمام فایل‌های ردگیری‌شده استفاده می‌شود\&. برای اطلاع از اینکه کدام مقدار توسط
\fB\-\-add\-file\fR
استفاده می‌شود، به توضیحات زیر مراجعه کنید\&.
.sp
مقدار <prefix> دقیقاً همان‌طور که وارد شده استفاده می‌شود و نرمال‌سازی نمی‌شود\&. ممکن است شامل اسلش‌های ابتدایی یا مؤلفه‌های دایرکتوری والد باشد (مانند
\fB\&.\&.\fR\fB/\fR)\&. برخی از برنامه‌های مصرف‌کننده بایگانی ممکن است چنین مسیرهایی را بالقوه ناامن تلقی کرده و در زمان استخراج، آنها را اصلاح کنند یا هشدار دهند\&.
.RE
.PP
\-o <file>, \-\-output=<file>
.RS 4
نوشتن بایگانی در <file> به جای خروجی استاندارد (stdout)\&.
.RE
.PP
\-\-add\-file=<file>
.RS 4
افزودن یک فایل ردگیری‌نشده به بایگانی\&. برای افزودن چندین فایل می‌توان آن را تکرار کرد\&. مسیر فایل در بایگانی با الحاق مقدار آخرین گزینه
\fB\-\-prefix\fR
(در صورت وجود) پیش از این
\fB\-\-add\-file\fR
و نام پایه (basename) فایل <file> ساخته می‌شود\&.
.RE
.PP
\-\-add\-virtual\-file=<path>:<content>
.RS 4
افزودن محتوای مشخص‌شده به بایگانی\&. برای افزودن چندین فایل می‌توان آن را تکرار کرد\&.
.sp
آرگومان
\fI<path>\fR
می‌تواند با یک نویسه گیومه دوتایی شروع و پایان یابد؛ نام فایل درون آن به عنوان یک رشته به سبک C تفسیر می‌شود، یعنی بک‌اسلش به عنوان نویسه اسکیپ تعبیر می‌گردد\&. اگر مسیر شامل دونقطه (:) باشد، باید درون گیومه قرار گیرد تا از اشتباه گرفته شدن دونقطه به عنوان جداکننده بین مسیر و محتوا جلوگیری شود، یا اگر مسیر با نویسه گیومه شروع یا تمام شود نیز باید درون گیومه باشد\&.
.sp
حالت فایل محدود به فایل معمولی است و این گزینه ممکن است مشمول محدودیت‌های خط فرمان وابسته به پلتفرم باشد\&. برای موارد پیچیده‌تر، یک فایل ردگیری‌نشده بنویسید و به جای آن از
\fB\-\-add\-file\fR
استفاده کنید\&.
.sp
توجه داشته باشید که برخلاف
\fB\-\-add\-file\fR،
مسیر ایجادشده در بایگانی تحت تأثیر گزینه
\fB\-\-prefix\fR
قرار نمی‌گیرد، زیرا یک
\fI<path>\fR
کامل می‌تواند به عنوان مقدار این گزینه داده شود\&.
.RE
.PP
\-\-worktree\-attributes
.RS 4
جستجوی مشخصه‌ها در فایل‌های \&.gitattributes در درخت کاری نیز (به بخش
\(lqمشخصه‌ها (ATTRIBUTES)\(rq
مراجعه کنید)\&.
.RE
.PP
\-\-mtime=<time>
.RS 4
تنظیم زمان تغییر (mtime) ورودی‌های بایگانی\&. بدون این گزینه، در صورتی که
\fI<tree\-ish>\fR
یک کامیت یا برچسب باشد از زمان کامیت‌کننده (committer time) استفاده می‌شود و اگر یک درخت باشد از زمان فعلی استفاده خواهد شد\&.
.RE
.PP
<extra>
.RS 4
می‌تواند هر گزینه‌ای باشد که بخش پشتیبان (backend) بایگانی‌ساز آن را درک می‌کند\&. بخش بعدی را ببینید\&.
.RE
.PP
\-\-remote=<repo>
.RS 4
به جای ساخت بایگانی tar از مخزن محلی، یک بایگانی tar را از یک مخزن دوردست (ریموت) دریافت می‌کند\&. توجه داشته باشید که مخزن دوردست ممکن است محدودیت‌هایی در مورد اینکه کدام عبارت‌های sha1 در
\fI<tree\-ish>\fR
مجاز هستند اعمال کند\&. برای جزئیات به
\fBgit-upload-archive\fR(1)
مراجعه کنید\&.
.RE
.PP
\-\-exec=<git\-upload\-archive>
.RS 4
همراه با \-\-remote برای مشخص کردن مسیر به
\fIgit\-upload\-archive\fR
در سمت دوردست استفاده می‌شود\&.
.RE
.PP
<tree\-ish>
.RS 4
درخت یا کامیت مورد نظر برای تولید بایگانی\&.
.RE
.PP
<path>
.RS 4
بدون پارامتر اختیاری مسیر، تمام فایل‌ها و زیردایرکتوری‌های دایرکتوری کاری فعلی در بایگانی گنجانده می‌شوند\&. اگر یک یا چند مسیر مشخص شود، فقط این مسیرها گنجانده خواهند شد\&.
.RE
.SH "گزینه‌های اضافی بخش پشتیبان (BACKEND EXTRA OPTIONS)"
.SS "zip"
.PP
\-<digit>
.RS 4
تعیین سطح فشرده‌سازی\&. مقادیر بزرگ‌تر به دستور اجازه می‌دهند تا زمان بیشتری را برای فشرده‌سازی به اندازه کوچک‌تر صرف کند\&. مقادیر پشتیبانی‌شده از
\fB\-0\fR
(فقط ذخیره/بدون فشرده‌سازی) تا
\fB\-9\fR
(بهترین ضریب فشرده‌سازی) هستند\&. در صورت تعیین نشدن، پیش‌فرض
\fB\-6\fR
است\&.
.RE
.SS "tar"
.PP
\-<number>
.RS 4
تعیین سطح فشرده‌سازی\&. این مقدار به دستور فشرده‌سازی پیکربندی‌شده در
\fBtar\&.\fR\fI<format>\fR\fB\&.command\fR
ارسال خواهد شد\&. برای اطلاع از فهرست سطوح پشتیبانی‌شده و سطح پیش‌فرض در صورت مشخص نشدن این گزینه، به صفحه راهنمای دستور پیکربندی‌شده مراجعه کنید\&.
.RE
.SH "پیکربندی (CONFIGURATION)"
.PP
tar\&.umask
.RS 4
این متغیر می‌تواند برای محدود کردن بیت‌های دسترسی ورودی‌های بایگانی tar استفاده شود\&. پیش‌فرض 0002 است که بیت نوشتن برای همگان (world write) را خاموش می‌کند\&. مقدار ویژه "user" نشان می‌دهد که به جای آن از umask کاربر بایگانی‌کننده استفاده خواهد شد\&. برای جزئیات به umask(2) مراجعه کنید\&. اگر
\fB\-\-remote\fR
استفاده شود، تنها پیکربندی مخزن دوردست اعمال می‌شود\&.
.RE
.PP
tar\&.<format>\&.command
.RS 4
این متغیر یک دستور پوسته را مشخص می‌کند که خروجی tar تولیدشده توسط
\fBgit\fR
\fBarchive\fR
باید از طریق پایپ به آن هدایت شود\&. دستور با استفاده از پوسته اجرا می‌شود و فایل tar تولیدشده در ورودی استاندارد آن قرار می‌گیرد، و باید خروجی نهایی را در خروجی استاندارد خود تولید کند\&. هر گزینه‌ای مربوط به سطح فشرده‌سازی به دستور ارسال خواهد شد (مانند
\fB\-9\fR)\&.
.sp
قالب‌های
\fBtar\&.gz\fR
و
\fBtgz\fR
به طور خودکار تعریف شده‌اند و به طور پیش‌فرض از دستور جادویی
\fBgit\fR
\fBarchive\fR
\fBgzip\fR
استفاده می‌کنند که یک پیاده‌سازی داخلی از gzip را فراخوانی می‌کند\&.
.RE
.PP
tar\&.<format>\&.remote
.RS 4
در صورت true بودن، قالب را برای استفاده کلاینت‌های دوردست از طریق
\fBgit-upload-archive\fR(1)
فعال می‌کند\&. پیش‌فرض برای قالب‌های تعریف‌شده توسط کاربر false است، اما برای قالب‌های
\fBtar\&.gz\fR
و
\fBtgz\fR
برابر true می‌باشد\&.
.RE
.SH "مشخصه‌ها (ATTRIBUTES)"
.PP
export\-ignore
.RS 4
فایل‌ها و دایرکتوری‌های دارای مشخصه export\-ignore به فایل‌های بایگانی اضافه نخواهند شد\&. برای جزئیات به
\fBgitattributes\fR(5)
مراجعه کنید\&.
.RE
.PP
export\-subst
.RS 4
اگر مشخصه export\-subst برای فایلی تنظیم شده باشد، گیت هنگام افزودن این فایل به بایگانی چندین جانگهدار (placeholder) را بسط می‌دهد\&. برای جزئیات به
\fBgitattributes\fR(5)
مراجعه کنید\&.
.RE
.sp
توجه داشته باشید که مشخصه‌ها به طور پیش‌فرض از فایل‌های \fB\&.gitattributes\fR در درختی که در حال بایگانی است گرفته می‌شوند\&. اگر می‌خواهید نحوه تولید خروجی را پس از واقعه تغییر دهید (مثلاً بدون افزودن export\-ignore مناسب در \fB\&.gitattributes\fR آن، کامیت کرده‌اید)، فایل \fB\&.gitattributes\fR خارج‌شده (checked out) را بر حسب نیاز تنظیم کنید و از گزینه \fB\-\-worktree\-attributes\fR استفاده نمایید\&. متناوباً می‌توانید مشخصه‌های لازم را که باید هنگام بایگانی هر درختی اعمال شوند در فایل \fB$GIT_DIR/info/attributes\fR خود نگه دارید\&.
.SH "مثال‌ها (EXAMPLES)"
.PP
\fBgit\fR \fBarchive\fR \fB\-\-format=tar\fR \fB\-\-prefix=junk/\fR \fBHEAD\fR | (\fBcd\fR \fB/var/tmp/\fR && \fBtar\fR \fBxf\fR \fB\-\fR)
.RS 4
ایجاد یک بایگانی tar شامل محتویات آخرین کامیت روی شاخه فعلی، و استخراج آن در دایرکتوری
\fB/var/tmp/junk\fR\&.
.RE
.PP
\fBgit\fR \fBarchive\fR \fB\-\-format=tar\fR \fB\-\-prefix=git\-1\&.4\&.0/\fR \fBv1\&.4\&.0\fR | \fBgzip\fR >\fBgit\-1\&.4\&.0\&.tar\&.gz\fR
.RS 4
ایجاد یک فایل فشرده tarball برای نسخه انتشار v1\&.4\&.0\&.
.RE
.PP
\fBgit\fR \fBarchive\fR \fB\-\-format=tar\&.gz\fR \fB\-\-prefix=git\-1\&.4\&.0/\fR \fBv1\&.4\&.0\fR >\fBgit\-1\&.4\&.0\&.tar\&.gz\fR
.RS 4
مشابه مورد بالا، اما با استفاده از مدیریت داخلی tar\&.gz\&.
.RE
.PP
\fBgit\fR \fBarchive\fR \fB\-\-prefix=git\-1\&.4\&.0/\fR \fB\-o\fR \fBgit\-1\&.4\&.0\&.tar\&.gz\fR \fBv1\&.4\&.0\fR
.RS 4
مشابه مورد بالا، اما قالب از فایل خروجی استنباط می‌شود\&.
.RE
.PP
\fBgit\fR \fBarchive\fR \fB\-\-format=tar\fR \fB\-\-prefix=git\-1\&.4\&.0/\fR \fBv1\&.4\&.0^\fR{tree} | \fBgzip\fR >\fBgit\-1\&.4\&.0\&.tar\&.gz\fR
.RS 4
ایجاد یک فایل فشرده tarball برای نسخه انتشار v1\&.4\&.0، اما بدون هدر سراسری گسترش‌یافته pax\&.
.RE
.PP
\fBgit\fR \fBarchive\fR \fB\-\-format=zip\fR \fB\-\-prefix=git\-docs/\fR \fBHEAD:Documentation/\fR > \fBgit\-1\&.4\&.0\-docs\&.zip\fR
.RS 4
قرار دادن همه‌چیز در دایرکتوری Documentation/ مربوط به HEAD فعلی در
\fIgit\-1\&.4\&.0\-docs\&.zip\fR، با پیشوند
\fIgit\-docs/\fR\&.
.RE
.PP
\fBgit\fR \fBarchive\fR \fB\-o\fR \fBlatest\&.zip\fR \fBHEAD\fR
.RS 4
ایجاد یک بایگانی Zip شامل محتویات آخرین کامیت در شاخه فعلی\&. توجه داشته باشید که قالب خروجی از پسوند فایل خروجی استنباط می‌شود\&.
.RE
.PP
\fBgit\fR \fBarchive\fR \fB\-o\fR \fBlatest\&.tar\fR \fB\-\-prefix=build/\fR \fB\-\-add\-file=configure\fR \fB\-\-prefix=\fR \fBHEAD\fR
.RS 4
ایجاد یک بایگانی tar شامل محتویات آخرین کامیت در شاخه فعلی بدون پیشوند، و فایل ردگیری‌نشده
\fIconfigure\fR
با پیشوند
\fIbuild/\fR\&.
.RE
.PP
\fBgit\fR \fBconfig\fR \fBtar\&.tar\&.xz\&.command\fR "xz \fB\-c\fR"
.RS 4
پیکربندی قالب "tar\&.xz" برای ساخت فایل‌های tar فشرده‌شده با LZMA\&. می‌توانید با مشخص کردن
\fB\-\-format=tar\&.xz\fR
یا با ایجاد یک فایل خروجی مانند
\fB\-o\fR
\fBfoo\&.tar\&.xz\fR
از آن استفاده کنید\&.
.RE
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fBgitattributes\fR(5)
.SH "گیت (GIT)"
.sp
بخشی از مجموعه \fBgit\fR(1)