.TH git-annex-common-options 1
.SH "نام (NAME)"
git-annex\-common\-options \- گزینه‌های مشترک پشتیبانی‌شده توسط بسیاری از دستورات git-annex
.PP
.SH "توضیحات (DESCRIPTION)"
این گزینه‌های مشترک توسط بسیاری از دستورات git-annex پذیرفته می‌شوند و ممکن است به‌طور صریح در صفحات راهنمای اختصاصی آن‌ها فهرست نشده باشند. بیشتر این گزینه‌ها توسط تمامی دستورات git-annex پشتیبانی می‌شوند.
(بسیاری از دستورات همچنین
git-annex\-matching\-options(1)
را می‌پذیرند.)
.PP
.SH "گزینه‌ها (OPTIONS)"
.IP "\fB\-\-force\fP"
.IP
اجرای عملیات‌های ناامن را اجبار می‌کند؛ مانند حذف محتوای یک فایل در حالی که هیچ منبع دیگری از آن که هنوز وجود داشته باشد قابل تأیید نیست، یا افزودن فایل‌های نادیده‌گرفته‌شده. با احتیاط استفاده شود.
.IP
.IP "\fB\-\-fast\fP"
اجتناب از برخی عملیات‌های سنگین که به‌طور معمول توسط یک دستور انجام می‌شوند. آنچه از آن صرف‌نظر می‌شود به نوع دستور بستگی دارد؛ برای جزئیات به صفحهٔ راهنمای اختصاصی هر دستور مراجعه کنید.
.IP
.IP "\fB\-\-quiet\fP"
جلوگیری از نمایش پرگویی (verbose) پیش‌فرض از کارهای انجام‌شده؛ فقط خطاها نمایش داده می‌شوند.
.IP
.IP "\fB\-\-verbose\fP"
فعال‌سازی نمایش با جزئیات (پرگو). به‌طور پیش‌فرض فعال است اما می‌توان آن را با \-\-quiet غیرفعال کرد.
.IP
.IP "\fB\-\-explain\fP"
نمایش توضیحات دربارهٔ مواردی که git-annex هنگام تصمیم‌گیری برای اقدام مد نظر قرار می‌دهد. این توضیحات درون کروشه قرار خواهند گرفت؛ برای مثال "[foo is not present here]".
.IP
این شامل توضیحاتی دربارهٔ این است که چرا عبارات محتوای ترجیحی (preferred content expressions) و سایر عبارات مشابه مانند annex.largefiles مطابقت دارند یا ناموفق هستند. در این توضیحات، عبارت نمایش داده می‌شود و در ادامهٔ هر عبارت "[TRUE]" یا "[FALSE]" برای نشان دادن مقدار آن درج می‌گردد. عبارات نامربوط از توضیحات حذف خواهند شد؛ برای مثال \fB"exclude=* and copies=1"\fP به‌صورت \fB"exclude=*[FALSE]"\fP نمایش داده می‌شود.
.IP
.IP "\fB\-\-debug\fP"
نمایش پیام‌های اشکال‌زدایی در خروجی خطای استاندارد (stderr).
.IP
.IP "\fB\-\-no\-debug\fP"
غیرفعال‌سازی نمایش پیام‌های اشکال‌زدایی.
.IP
.IP "\fB\-\-debugfilter=name[,name..]\fP"
هنگامی که نمایش پیام‌های اشکال‌زدایی با \fB\-\-debug\fP فعال شده باشد، پیام‌های اشکال‌زدایی نمایش‌داده‌شده را تنها به مواردی محدود (فیلتر) می‌کند که از ماژول‌هایی با نام‌های مشخص‌شده می‌آیند.
.IP
برای یافتن نام ماژول‌ها، خروجی کامل اشکال‌زدایی را مشاهده کنید که شامل نام ماژول است؛ مانند "(Utility.Process)".
.IP
هنگام استفاده از این گزینه نیازی به ذکر نام کامل ماژول نیست و یک زیررشته از نام نیز کفایت می‌کند.
.IP
برای مثال، \fB\-\-debugfilter=Process,External\fP خروجی اشکال‌زدایی را هنگام اجرای پردازش‌ها توسط git-annex و هنگام برقراری ارتباط با ریموت‌های خاص خارجی نمایش می‌دهد.
.IP
.IP "\fB\-\-numcopies=n\fP"
تنظیمات numcopies را بازنویسی می‌کند.
.IP
.IP "\fB\-\-mincopies=n\fP"
تنظیمات mincopies را بازنویسی می‌کند.
.IP
.IP "\fB\-\-rebalance\fP"
رفتار عبارت محتوای ترجیحی "balanced" را مشابه "fullbalanced"، و عبارت "sizebalanced" را مشابه "fullsizebalanced" تغییر می‌دهد. هنگامی که از این عبارات استفاده شود، این کار می‌تواند باعث انجام کارهای زیادی جهت توازن مجدد (rebalance) مخازن شود.
.IP
.IP "\fB\-\-time\-limit=time\fP"
مدت زمان اجرای دستور git-annex را محدود می‌کند. زمان می‌تواند مقداری مانند "5h" یا "30m" یا حتی "45s" یا "10d" باشد.
.IP
توجه داشته باشید که git-annex ممکن است پس از اتمام محدودیت زمانی مشخص‌شده نیز برای مدتی به کار خود ادامه دهد تا پردازش فایل‌هایی را که پیش از رسیدن به محدودیت زمانی آغاز کرده بود، به پایان برساند. این ویژگی و همچنین خروج تمیزتر برنامه، تفاوت میان استفاده از این گزینه با دستوری مانند \fBtimeout(1)\fP است.
.IP
هنگامی که محدودیت زمانی مانع از انجام تمامی وظایف درخواستی توسط git-annex شود، برنامه با کد خروج ویژهٔ 101 خارج می‌شود.
.IP
.IP "\fB\-\-size\-limit=size\fP"
حجم کل فایل‌های ضمیمه‌شده‌ای را که دستور git-annex می‌تواند پردازش کند، محدود می‌سازد.
.IP
حجم را می‌توان با هر یک از واحدهای متداول، مانند "50gb" مشخص کرد.
.IP
در برخی موارد، حجم یک فایل ضمیمه‌شده مشخص نیست. این گزینه مانع از پردازش چنین فایل‌هایی توسط git-annex می‌شود.
.IP
هنگامی که محدودیت حجم مانع از اقدام git-annex روی هر فایلی شود، برنامه با کد ویژهٔ 101 خارج می‌شود.
.IP
.IP "\fB\-\-semitrust=repository\fP"
.IP "\fB\-\-untrust=repository\fP"
تنظیمات اعتماد (trust) را برای یک مخزن بازنویسی می‌کند. می‌تواند بیش از یک بار مشخص شود.
.IP
مخزن باید با استفاده از نام یک ریموت پیکربندی‌شده، یا UUID یا توضیح یک مخزن مشخص شود.
.IP
.IP "\fB\-\-trust=repository\fP"
این گزینه در گذشته تنظیمات اعتماد یک مخزن را بازنویسی می‌کرد، اما اکنون چنین کاری نمی‌کند؛ زیرا اعتماد به یک مخزن می‌تواند منجر به از دست رفتن داده‌ها شود و از دست رفتن داده‌ها اکنون تنها هنگام استفاده از گزینهٔ \fB\-\-force\fP مجاز است.
.IP
.IP "\fB\-\-trust\-glacier\fP"
این گزینه در گذشته تنظیمات اعتماد را برای ریموت‌های خاص Glacier بازنویسی می‌کرد، اما اکنون چنین کاری نمی‌کند؛ چرا که می‌توانست منجر به از دست رفتن داده‌ها شود، و از دست رفتن داده‌ها اکنون تنها هنگام استفاده از گزینهٔ \fB\-\-force\fP فعال است.
.IP
.IP "\fB\-\-user\-agent=value\fP"
مقدار User\-Agent را هنگام دانلود فایل‌ها از وب یا دسترسی به خدمات وب بازنویسی می‌کند.
.IP
.IP "\fB\-\-notify\-finish\fP"
باعث نمایش یک اعلان دسکتاپ پس از هر بار دانلود و آپلود موفق فایل می‌شود.
.IP
(تنها در برخی پلتفرم‌ها مانند لینوکس با dbus پشتیبانی می‌شود؛ در صورت عدم پشتیبانی، بی‌اثر خواهد بود.)
.IP
.IP "\fB\-\-notify\-start\fP"
باعث نمایش اعلان دسکتاپ هنگام شروع آپلود یا دانلود یک فایل، یا هنگام رهاسازی یک فایل می‌شود.
.IP
.IP "\fB\-c name=value\fP"
تنظیمات پیکربندی گیت را بازنویسی می‌کند. می‌تواند چندین بار مشخص شود.
.IP
.SH "همچنین ببینید (SEE ALSO)"
git-annex(1)
.PP
.SH "نویسنده (AUTHOR)"
Joey Hess <id@joeyh.name>