.TH git-annex-mirror 1
.SH "نام (NAME)"
git-annex-mirror \- آینه‌کردن محتوای فایل‌ها به/از یک مخزن دیگر
.PP
.SH "خلاصه دستور (SYNOPSIS)"
git annex mirror \fB[مسیر ...] [\-\-to=remote|\-\-from=remote]\fP
.PP
.SH "توضیحات (DESCRIPTION)"
این دستور باعث می‌شود یک مخزن مقصد، محتوای یک مخزن مبدأ را به‌صورت آینه‌ای بازتاب دهد (mirror).
.PP
هر فایل مشخص‌شده در مخزن مبدأ به مخزن مقصد آینه می‌شود. اگر محتوای فایلی در مخزن مبدأ موجود باشد، به مخزن مقصد کپی خواهد شد. اگر محتوای فایلی در مخزن مبدأ موجود نباشد، در صورتی که تنظیمات numcopies اجازه دهد، از مخزن مقصد حذف (drop) خواهد شد.
.PP
توجه داشته باشید که mirror کل مخزن گیت را همگام‌سازی نمی‌کند، بلکه تنها محتوای فایل‌ها را آینه می‌کند. برای همگام‌سازی کامل مخزن گیت از
.BR git-annex\-sync (1)
استفاده کنید.
.PP
.SH "گزینه‌ها (OPTIONS)"
.IP "\fB\-\-to=remote\fP"
.IP
از مخزن محلی به عنوان مخزن مبدأ استفاده کرده و محتویات آن را به مخزن دوردست (remote) آینه می‌کند.
.IP
.IP "\fB\-\-from=remote\fP"
از مخزن دوردست به عنوان مخزن مبدأ استفاده کرده و محتویات آن را به مخزن محلی آینه می‌کند.
.IP
.IP "\fB\-\-jobs=N\fP \fB\-JN\fP"
انتقال موازی را با حداکثر تعداد کارهای مشخص‌شده که همزمان اجرا می‌شوند فعال می‌کند؛ برای مثال:
.B \-J10
.IP
تنظیم این مقدار به "cpus" به ازای هر هسته پردازنده (CPU) یک کار را اجرا می‌کند.
.IP
.IP "\fB\-\-all\fP \fB\-A\fP"
تمام اشیای ذخیره‌شده در git annex را آینه می‌کند، نه فقط اشیایی که توسط فایل‌های موجود فعلی استفاده می‌شوند.
.IP
با این حال، این گزینه هنگام حذف فایل‌ها، بررسی تنظیمات
.B annex.numcopies
در
.B .gitattributes
را دور می‌زند.
.IP
این رفتار پیش‌فرضِ هنگام اجرای git-annex در یک مخزن bare است.
.IP
.IP "\fB\-\-branch=ref\fP"
عملیات را روی فایل‌های موجود در شاخه یا شیء درخت‌مانند (treeish) مشخص‌شده انجام می‌دهد.
.IP
همانند
.BR \-\-all ،
این گزینه نیز هنگام حذف فایل‌ها، بررسی تنظیمات
.B annex.numcopies
در
.B .gitattributes
را دور می‌زند.
.IP
.IP "\fB\-\-unused\fP"
عملیات را روی فایل‌هایی که در آخرین اجرای
.B git-annex unused
یافت شده‌اند انجام می‌دهد.
.IP
.IP "\fB\-\-failed\fP"
عملیات را روی فایل‌هایی که اخیراً انتقال آن‌ها با شکست مواجه شده است انجام می‌دهد.
.IP
.IP "گزینه‌های تطبیق (matching options)"
می‌توان از
.BR git-annex\-matching\-options (1)
برای کنترل مواردی که باید آینه شوند استفاده کرد.
.IP
.IP "\fB\-\-json\fP"
فعال‌سازی خروجی JSON. این گزینه برای پردازش توسط برنامه‌هایی که از
.B git-annex
استفاده می‌کنند در نظر گرفته شده است. هر خط از خروجی یک شیء JSON است.
.IP
توجه داشته باشید که برخلاف سایر دستوراتی که از
.B \-\-json
پشتیبانی می‌کنند، این دستور در شرایط مختلف انواع متفاوتی از اشیای JSON را خروجی می‌دهد.
.IP
.IP "\fB\-\-json\-progress\fP"
گنجاندن اشیای پیشرفت فرآیند در خروجی JSON.
.IP
.IP "\fB\-\-json\-error\-messages\fP"
پیام‌هایی که به‌طور معمول در خروجی خطای استاندارد (stderr) نمایش داده می‌شدند، در عوض درون JSON گنجانده می‌شوند.
.IP
.IP "همچنین می‌توان از گزینه‌های \fBgit-annex\-common\-options\fP(1) نیز استفاده کرد."
.SH "همچنین ببینید (SEE ALSO)"
git-annex(1)
.PP
git-annex\-sync(1)
.PP
.SH "نویسنده (AUTHOR)"
Joey Hess <id@joeyh.name>