.TH git-annex 1
.SH "نام (NAME)"
git-annex \- مدیریت فایل‌ها با گیت بدون ذخیره محتوای آن‌ها در مخزن
.PP
.SH "خلاصه دستور (SYNOPSIS)"
git annex command [params ...]
.PP
.SH "توضیحات (DESCRIPTION)"
ابزار git-annex امکان مدیریت فایل‌ها با گیت را بدون ثبت محتوای فایل درون گیت فراهم می‌کند. اگرچه ممکن است این موضوع متناقض به نظر برسد، اما هنگام مواجهه با فایل‌هایی که از توانایی گیت برای مدیریت آسان فراتر هستند، خواه به دلیل محدودیت‌های حافظه، زمان محاسبه جمع کنترلی (checksum) یا فضای دیسک، بسیار مفید است.
.PP
حتی بدون ردیابی محتوای فایل‌ها، امکان مدیریت فایل‌ها با گیت، جابه‌جایی و حذف آن‌ها همراه با درخت‌های دایرکتوری نسخه‌بندی‌شده و بهره‌گیری از شاخه‌ها و شبیه‌سازی‌های توزیع‌شده (clones)، همگی دلایل بسیار کاربردی برای استفاده از گیت هستند. همچنین فایل‌های ضمیمه‌شده (annexed) می‌توانند در کنار فایل‌های معمولی دارای نسخه‌بندی در یک مخزن گیت همزیستی داشته باشند؛ این ویژگی برای نگهداری اسناد، Makefileها و سایر مواردی که با فایل‌های ضمیمه‌شده مرتبط هستند اما از کنترل کامل نسخه بهره‌مند می‌شوند، بسیار مناسب است.
.PP
هنگامی که فایلی ضمیمه (annex) می‌شود، محتوای آن به یک مخزن کلید\-مقدار (key\-value store) منتقل شده و یک پیوند نمادین (symlink) ساخته می‌شود که به آن محتوا اشاره می‌کند. این پیوندهای نمادین مانند فایل‌های معمولی در گیت ثبت و نسخه‌بندی می‌شوند. شما می‌توانید آن‌ها را جابه‌جا یا حذف کنید و غیره. ارسال (push) به یک مخزن گیت دیگر، git-annex موجود در آنجا را از فایل ضمیمه‌شده مطلع می‌کند و می‌تواند برای دریافت محتوای آن از مخزن کلید\-مقدار به کار رود.
.PP
.SH "مثال‌ها (EXAMPLES)"
.nf
 # git annex get video/hackity_hack_and_kaxxt.mov
 get video/hackity_hack_and_kaxxt.mov (not available)
   I was unable to access these remotes: server
   Try making some of these repositories available:
   	5863d8c0\-d9a9\-11df\-adb2\-af51e6559a49  \-\- my home file server
    	58d84e8a\-d9ae\-11df\-a1aa\-ab9aa8c00826  \-\- portable USB drive
    	ca20064c\-dbb5\-11df\-b2fe\-002170d25c55  \-\- backup SATA drive
 failed
 # sudo mount /media/usb
 # git remote add usbdrive /media/usb
 # git annex get video/hackity_hack_and_kaxxt.mov
 get video/hackity_hack_and_kaxxt.mov (from usbdrive...) ok
 
 # git annex add iso
 add iso/Debian_5.0.iso ok
 
 # git annex drop iso/Debian_4.0.iso
 drop iso/Debian_4.0.iso ok
 
 # git annex move iso \-\-to=usbdrive
 move iso/Debian_5.0.iso (moving to usbdrive...) ok
.fi
.PP
.SH "دستورات پرکاربرد (COMMONLY USED COMMANDS)"
.IP "\fBhelp\fP"
.IP
نمایش راهنمای داخلی.
.IP
برای راهنمایی درباره یک دستور خاص، از \fBgit annex help command\fP استفاده کنید.
.IP
.IP "\fBadd [path ...]\fP"
فایل‌ها را به ضمیمه اضافه می‌کند.
.IP
برای جزئیات بیشتر به git-annex\-add(1) مراجعه کنید.
.IP
.IP "\fBget [path ...]\fP"
محتوای فایل‌های ضمیمه‌شده را در این مخزن در دسترس قرار می‌دهد.
.IP
برای جزئیات بیشتر به git-annex\-get(1) مراجعه کنید.
.IP
.IP "\fBdrop [path ...]\fP"
محتوای فایل‌های ضمیمه‌شده را از این مخزن حذف می‌کند.
.IP
برای جزئیات بیشتر به git-annex\-drop(1) مراجعه کنید.
.IP
.IP "\fBmove [path ...] [\-\-from=remote|\-\-to=remote]\fP"
محتوای فایل‌ها را از یا به یک مخزن دوردست (remote) دیگر منتقل می‌کند.
.IP
برای جزئیات بیشتر به git-annex\-move(1) مراجعه کنید.
.IP
.IP "\fBcopy [path ...] [\-\-from=remote|\-\-to=remote]\fP"
محتوای فایل‌ها را از یا به یک مخزن دوردست دیگر کپی می‌کند.
.IP
برای جزئیات بیشتر به git-annex\-copy(1) مراجعه کنید.
.IP
.IP "\fBstatus [path ...]\fP"
وضعیت درخت کاری را نمایش می‌دهد. (منسوخ‌شده)
.IP
برای جزئیات بیشتر به git-annex\-status(1) مراجعه کنید.
.IP
.IP "\fBunlock [path ...]\fP"
قفل فایل‌های ضمیمه‌شده را برای اعمال تغییرات باز می‌کند.
.IP
برای جزئیات بیشتر به git-annex\-unlock(1) مراجعه کنید.
.IP
.IP "\fBedit [path ...]\fP"
این یک نام مستعار برای دستور unlock است. اگر به عنوان امکانی برای ویرایش یک فایل ضمیمه‌شده به آن فکر کنید، ممکن است به خاطر سپردن آن آسان‌تر باشد.
.IP
.IP "\fBlock [path ...]\fP"
اگر نمی‌خواهید فایل‌ها را تغییر دهید یا تغییراتی ایجاد کرده‌اید که می‌خواهید لغو شوند، از این برای لغو دستور unlock استفاده کنید.
.IP
برای جزئیات بیشتر به git-annex\-lock(1) مراجعه کنید.
.IP
.IP "\fBpull [remote ...]\fP"
محتوا را از مخازن دوردست دریافت (pull) می‌کند.
.IP
برای جزئیات بیشتر به git-annex\-pull(1) مراجعه کنید.
.IP
.IP "\fBpush [remote ...]\fP"
محتوا را به مخازن دوردست ارسال (push) می‌کند.
.IP
برای جزئیات بیشتر به git-annex\-push(1) مراجعه کنید.
.IP
.IP "\fBsync [remote ...]\fP"
مخزن محلی را با مخازن دوردست همگام‌سازی می‌کند.
.IP
برای جزئیات بیشتر به git-annex\-sync(1) مراجعه کنید.
.IP
.IP "\fBassist [remote ...]\fP"
فایل‌ها را اضافه کرده و تغییرات را با مخازن دوردست همگام می‌کند.
.IP
برای جزئیات بیشتر به git-annex\-assist(1) مراجعه کنید.
.IP
.IP "\fBsatisfy [remote ...]\fP"
تنظیمات محتوای ترجیحی را با انتقال و حذف محتوا برآورده می‌سازد.
.IP
برای جزئیات بیشتر به git-annex\-satisfy(1) مراجعه کنید.
.IP
.IP "\fBmirror [path ...] [\-\-to=remote|\-\-from=remote]\fP"
محتوای فایل‌ها را به/از یک مخزن دیگر آینه‌سازی (mirror) می‌کند.
.IP
برای جزئیات بیشتر به git-annex\-mirror(1) مراجعه کنید.
.IP
.IP "\fBaddurl [url ...]\fP"
هر نشانی اینترنتی (url) را در فایل خودش بارگیری کرده و آن را به ضمیمه اضافه می‌کند.
.IP
برای جزئیات بیشتر به git-annex\-addurl(1) مراجعه کنید.
.IP
.IP "\fBrmurl file url\fP"
ثبت می‌کند که فایل دیگر در آن نشانی اینترنتی در دسترس نیست.
.IP
برای جزئیات بیشتر به git-annex\-rmurl(1) مراجعه کنید.
.IP
.IP "\fBimport \-\-from remote branch[:subdir] | [path ...]\fP"
یک درخت از فایل‌ها را به مخزن اضافه می‌کند.
.IP
برای جزئیات بیشتر به git-annex\-import(1) مراجعه کنید.
.IP
.IP "\fBimportfeed [url ...]\fP"
محتویات فیدهای پادکست را به ضمیمه وارد می‌کند.
.IP
برای جزئیات بیشتر به git-annex\-importfeed(1) مراجعه کنید.
.IP
.IP "\fBexport treeish \-\-to remote\fP"
محتوا را به یک مخزن دوردست صادر می‌کند.
.IP
برای جزئیات بیشتر به git-annex\-export(1) مراجعه کنید.
.IP
.IP "\fBundo [filename|directory] ...\fP"
آخرین تغییر در یک فایل یا دایرکتوری را لغو می‌کند.
.IP
برای جزئیات بیشتر به git-annex\-undo(1) مراجعه کنید.
.IP
.IP "\fBaddcomputed\fP"
فایل‌های محاسبه‌شده را به مخزن اضافه می‌کند.
.IP
برای جزئیات بیشتر به git-annex\-addcomputed(1) مراجعه کنید.
.IP
.IP "\fBrecompute\fP"
فایل‌های محاسبه‌شده را مجدداً محاسبه می‌کند.
.IP
برای جزئیات بیشتر به git-annex\-recompute(1) مراجعه کنید.
.IP
.IP "\fBfindcomputed\fP"
فایل‌های محاسبه‌شده را فهرست می‌کند.
.IP
برای جزئیات بیشتر به git-annex\-findcomputed(1) مراجعه کنید.
.IP
.IP "\fBmulticast\fP"
توزیع چندپخشی (multicast) فایل‌ها.
.IP
برای جزئیات بیشتر به git-annex\-multicast(1) مراجعه کنید.
.IP
.IP "\fBwatch\fP"
دیمن برای نظارت بر تغییرات و ثبت خودکار تغییرات در کامیت (autocommit).
.IP
برای جزئیات بیشتر به git-annex\-watch(1) مراجعه کنید.
.IP
.IP "\fBassistant\fP"
دیمن برای همگام‌سازی خودکار تغییرات.
.IP
برای جزئیات بیشتر به git-annex\-assistant(1) مراجعه کنید.
.IP
.IP "\fBwebapp\fP"
یک برنامه تحت وب را باز می‌کند که امکان راه‌اندازی آسان مخزن git-annex و کنترل دستیار git-annex را فراهم می‌آورد. اگر دستیار از قبل در حال اجرا نباشد، راه‌اندازی خواهد شد.
.IP
برای جزئیات بیشتر به git-annex\-webapp(1) مراجعه کنید.
.IP
.IP "\fBp2phttp\fP"
امکان دسترسی به مخزن git-annex از طریق HTTP را با استفاده از پروتکل p2p ابزار git-annex فراهم می‌کند.
.IP
برای جزئیات بیشتر به git-annex\-p2phttp(1) مراجعه کنید.
.IP
.IP "\fBremotedaemon\fP"
ارتباط مداوم و پایدار با مخازن دوردست.
.IP
برای جزئیات بیشتر به git-annex\-remotedaemon(1) مراجعه کنید.
.IP
.SH "دستورات راه‌اندازی مخزن (REPOSITORY SETUP COMMANDS)"
.IP "\fBinit [description]\fP"
.IP
تا زمانی که یک مخزن (یا یکی از مخازن دوردست آن) مقداردهی اولیه نشده باشد، git-annex برای جلوگیری از استفاده تصادفی در مخزنی که قرار نبوده است ضمیمه داشته باشد، از کار بر روی آن امتناع می‌ورزد.
.IP
برای جزئیات بیشتر به git-annex\-init(1) مراجعه کنید.
.IP
.IP "\fBdescribe repository description\fP"
توضیحات یک مخزن را تغییر می‌دهد.
.IP
برای جزئیات بیشتر به git-annex\-describe(1) مراجعه کنید.
.IP
.IP "\fBinitremote name type=value [param=value ...]\fP"
یک مخزن دوردست ویژه (special remote) جدید ایجاد کرده و آن را به \fB.git/config\fP می‌افزاید.
.IP
برای جزئیات بیشتر به git-annex\-initremote(1) مراجعه کنید.
.IP
.IP "\fBenableremote name [param=value ...]\fP"
استفاده از یک مخزن دوردست ویژه موجود را در مخزن فعلی فعال می‌کند.
.IP
برای جزئیات بیشتر به git-annex\-enableremote(1) مراجعه کنید.
.IP
.IP "\fBconfigremote name [param=value ...]\fP"
پیکربندی یک مخزن دوردست ویژه موجود را تغییر می‌دهد.
.IP
برای جزئیات بیشتر به git-annex\-configremote(1) مراجعه کنید.
.IP
.IP "\fBrenameremote\fP"
نام یک مخزن دوردست ویژه را تغییر می‌دهد.
.IP
برای جزئیات بیشتر به git-annex\-renameremote(1) مراجعه کنید.
.IP
.IP "\fBenable\-tor\fP"
سرویس مخفی تور (tor hidden service) را راه‌اندازی می‌کند.
.IP
برای جزئیات بیشتر به git-annex\-enable\-tor(1) مراجعه کنید.
.IP
.IP "\fBnumcopies [N]\fP"
تعداد نسخه‌های مطلوب را پیکربندی می‌کند.
.IP
برای جزئیات بیشتر به git-annex\-numcopies(1) مراجعه کنید.
.IP
.IP "\fBmincopies [N]\fP"
حداقل تعداد نسخه‌ها را پیکربندی می‌کند.
.IP
برای جزئیات بیشتر به git-annex\-mincopies(1) مراجعه کنید.
.IP
.IP "\fBtrust [repository ...]\fP"
ثبت می‌کند که یک مخزن مورد اعتماد است تا به طور غیرمنتظره محتوا را از دست ندهد. با احتیاط استفاده شود.
.IP
برای جزئیات بیشتر به git-annex\-trust(1) مراجعه کنید.
.IP
.IP "\fBuntrust [repository ...]\fP"
ثبت می‌کند که یک مخزن غیرقابل‌اعتماد است و ممکن است هر زمانی محتوا را از دست بدهد.
.IP
برای جزئیات بیشتر به git-annex\-untrust(1) مراجعه کنید.
.IP
.IP "\fBsemitrust [repository ...]\fP"
یک مخزن را به وضعیت پیش‌فرض نیمه‌قابل‌اعتماد بازمی‌گرداند.
.IP
برای جزئیات بیشتر به git-annex\-semitrust(1) مراجعه کنید.
.IP
.IP "\fBgroup repository groupname\fP"
یک مخزن را به یک گروه اضافه می‌کند.
.IP
برای جزئیات بیشتر به git-annex\-group(1) مراجعه کنید.
.IP
.IP "\fBungroup repository groupname\fP"
یک مخزن را از یک گروه حذف می‌کند.
.IP
برای جزئیات بیشتر به git-annex\-ungroup(1) مراجعه کنید.
.IP
.IP "\fBwanted repository [expression]\fP"
عبارت محتوای ترجیحی را دریافت یا تنظیم می‌کند.
.IP
برای جزئیات بیشتر به git-annex\-wanted(1) مراجعه کنید.
.IP
.IP "\fBgroupwanted groupname [expression]\fP"
عبارت محتوای ترجیحی گروه را دریافت یا تنظیم می‌کند.
.IP
برای جزئیات بیشتر به git-annex\-groupwanted(1) مراجعه کنید.
.IP
.IP "\fBrequired repository [expression]\fP"
عبارت محتوای الزامی را دریافت یا تنظیم می‌کند.
.IP
برای جزئیات بیشتر به git-annex\-required(1) مراجعه کنید.
.IP
.IP "\fBmaxsize repository [size]\fP"
حداکثر اندازه مخزن را دریافت یا تنظیم می‌کند.
.IP
.IP "\fBinitcluster\fP"
یک کلاستر جدید را مقداردهی اولیه می‌کند.
.IP
برای جزئیات بیشتر به git-annex\-initcluster(1) مراجعه کنید.
.IP
.IP "\fBupdatecluster\fP"
سوابق گره‌های کلاستر را به‌روزرسانی می‌کند.
.IP
برای جزئیات بیشتر به git-annex\-updatecluster(1) مراجعه کنید.
.IP
.IP "\fBextendcluster\fP"
یک درگاه اضافی به یک کلاستر اضافه می‌کند.
.IP
برای جزئیات بیشتر به git-annex\-extendcluster(1) مراجعه کنید.
.IP
.IP "\fBupdateproxy\fP"
سوابق را با پیکربندی پروکسی به‌روزرسانی می‌کند.
.IP
برای جزئیات بیشتر به git-annex\-updateproxy(1) مراجعه کنید.
.IP
.IP "\fBschedule repository [expression]\fP"
وظایف زمان‌بندی‌شده را دریافت یا تنظیم می‌کند.
.IP
برای جزئیات بیشتر به git-annex\-schedule(1) مراجعه کنید.
.IP
.IP "\fBconfig\fP"
سایر تنظیمات پیکربندی ذخیره‌شده در شاخه git-annex را دریافت و تنظیم می‌کند.
.IP
برای جزئیات بیشتر به git-annex\-config(1) مراجعه کنید.
.IP
.IP "\fBvicfg\fP"
ویرایشگر EDITOR را روی یک فایل موقت حاوی بیشتر تنظیمات پیکربندی بالا، همراه با چند مورد دیگر باز می‌کند و پس از خروج، هرگونه تغییر ایجادشده را در شاخه git-annex ذخیره می‌نماید.
.IP
برای جزئیات بیشتر به git-annex\-vicfg(1) مراجعه کنید.
.IP
.IP "\fBadjust\fP"
یک مخزن را به استفاده از یک شاخه تعدیل‌شده تغییر می‌دهد، که می‌تواند به طور خودکار قفل تمام فایل‌ها را باز کند و غیره.
.IP
برای جزئیات بیشتر به git-annex\-adjust(1) مراجعه کنید.
.IP
.IP "\fBdirect\fP"
مخزن را به استفاده از حالت مستقیم تغییر می‌دهد. (منسوخ‌شده)
.IP
برای جزئیات بیشتر به git-annex\-direct(1) مراجعه کنید.
.IP
.IP "\fBindirect\fP"
مخزن را به استفاده از حالت غیرمستقیم تغییر می‌دهد. (منسوخ‌شده)
.IP
برای جزئیات بیشتر به git-annex\-indirect(1) مراجعه کنید.
.IP
.SH "دستورات نگهداری مخزن (REPOSITORY MAINTENANCE COMMANDS)"
.IP "\fBfsck [path ...]\fP"
.IP
یکپارچگی ضمیمه را بررسی کرده و درباره هرگونه مشکل یافت‌شده هشدار می‌دهد یا آن را برطرف می‌کند. این دستور مکمل خوبی برای \fBgit fsck\fP است.
.IP
برای جزئیات بیشتر به git-annex\-fsck(1) مراجعه کنید.
.IP
.IP "\fBexpire [repository:]time ...\fP"
مخازنی را که اخیراً فعالیتی (مانند fsck) انجام نداده‌اند، منقضی می‌کند.
.IP
برای جزئیات بیشتر به git-annex\-expire(1) مراجعه کنید.
.IP
.IP "\fBunused\fP"
ضمیمه را برای داده‌هایی که با هیچ فایلی در هیچ برچسب یا شاخه‌ای مطابقت ندارند بررسی کرده و یک فهرست شماره‌گذاری‌شده از داده‌ها را چاپ می‌کند.
.IP
برای جزئیات بیشتر به git-annex\-unused(1) مراجعه کنید.
.IP
.IP "\fBdropunused [number|range ...]\fP"
داده‌های مربوط به شماره‌های فهرست‌شده در آخرین خروجی \fBgit annex unused\fP را حذف می‌کند.
.IP
برای جزئیات بیشتر به git-annex\-dropunused(1) مراجعه کنید.
.IP
.IP "\fBaddunused [number|range ...]\fP"
فایل‌ها را برای محتوای مربوط به شماره‌ها یا بازه‌های فهرست‌شده در آخرین خروجی \fBgit annex unused\fP مجدداً اضافه می‌کند.
.IP
برای جزئیات بیشتر به git-annex\-addunused(1) مراجعه کنید.
.IP
.IP "\fBfix [path ...]\fP"
پیوندهای نمادینی را که خراب شده‌اند اصلاح می‌کند تا دوباره به محتوای ضمیمه‌شده اشاره کنند.
.IP
برای جزئیات بیشتر به git-annex\-fix(1) مراجعه کنید.
.IP
.IP "\fBmerge\fP"
تغییرات را به طور خودکار از مخازن دوردست ادغام می‌کند.
.IP
برای جزئیات بیشتر به git-annex\-merge(1) مراجعه کنید.
.IP
.IP "\fBupgrade\fP"
مخزن را ارتقا می‌دهد.
.IP
برای جزئیات بیشتر به git-annex\-upgrade(1) مراجعه کنید.
.IP
.IP "\fBdead [repository ...] [\-\-key key]\fP"
مشخص می‌کند که یک مخزن یا یک کلید منفرد به طور جبران‌ناپذیری از دست رفته است.
.IP
برای جزئیات بیشتر به git-annex\-dead(1) مراجعه کنید.
.IP
.IP "\fBforget\fP"
باعث بازنویسی شاخه git-annex و دور ریختن داده‌های تاریخی مربوط به مکان‌های گذشته فایل‌ها می‌شود.
.IP
برای جزئیات بیشتر به git-annex\-forget(1) مراجعه کنید.
.IP
.IP "\fBfilter\-branch\fP"
یک نسخه فیلترشده از شاخه git-annex تولید می‌کند.
.IP
برای جزئیات بیشتر به git-annex\-filter\-branch(1) مراجعه کنید.
.IP
.IP "\fBrepair\fP"
این می‌تواند بسیاری از مشکلاتی را که \fBgit fsck\fP در مخازن گیت شناسایی می‌کند، اما خودش تعمیر نمی‌کند، برطرف سازد. این دستور زمانی مفید است که یک مخزن به شدت آسیب دیده باشد. یکی از حالت‌هایی که این اتفاق می‌تواند رخ دهد این است که مخزن استفاده‌شده توسط git-annex روی یک درایو جداشدنی قرار داشته باشد که در زمان نامناسبی از سیستم جدا شده باشد.
.IP
برای جزئیات بیشتر به git-annex\-repair(1) مراجعه کنید.
.IP
.IP "\fBp2p\fP"
پیوندهای همتا به همتا (peer\-to\-peer) را میان مخازن پیکربندی می‌کند.
.IP
برای جزئیات بیشتر به git-annex\-p2p(1) مراجعه کنید.
.IP
.SH "دستورات پرس‌وجو (QUERY COMMANDS)"
.IP "\fBfind [path ...]\fP"
.IP
فهرستی از فایل‌های ضمیمه‌شده را در مسیر مشخص‌شده خروجی می‌دهد. در صورت نبود مسیر، فایل‌ها را در دایرکتوری جاری و زیردایرکتوری‌های آن پیدا می‌کند.
.IP
برای جزئیات بیشتر به git-annex\-find(1) مراجعه کنید.
.IP
.IP "\fBwhereis [path ...]\fP"
اطلاعاتی درباره مکان قرارگیری محتوای فایل‌ها نمایش می‌دهد.
.IP
برای جزئیات بیشتر به git-annex\-whereis(1) مراجعه کنید.
.IP
.IP "\fBlist [path ...]\fP"
جدولی از مخازن دوردست را که حاوی محتوای فایل‌های مشخص‌شده هستند نمایش می‌دهد. این شبیه به whereis است اما خروجی فشرده‌تری دارد.
.IP
برای جزئیات بیشتر به git-annex\-list(1) مراجعه کنید.
.IP
.IP "\fBwhereused\fP"
فایل‌هایی را که از یک کلید استفاده می‌کنند یا کرده‌اند پیدا می‌کند.
.IP
.IP "\fBlog [path ...]\fP"
گزارش مکان را برای فایل یا فایل‌های مشخص‌شده نمایش می‌دهد و نشان می‌دهد که آن‌ها به کدام مخزن اضافه ("+") و از کدام مخزن حذف ("\-") شده‌اند.
.IP
برای جزئیات بیشتر به git-annex\-log(1) مراجعه کنید.
.IP
.IP "\fBoldkeys [path ...]\fP"
کلیدهای استفاده‌شده برای نسخه‌های قدیمی فایل‌ها را فهرست می‌کند.
.IP
برای جزئیات بیشتر به git-annex\-oldkeys(1) مراجعه کنید.
.IP
.IP "\fBinfo [directory|file|remote|uuid ...]\fP"
آمار و سایر اطلاعات را برای مورد مشخص‌شده نمایش می‌دهد، که می‌تواند یک دایرکتوری، فایل، مخزن دوردست، یا uuid یک مخزن باشد.
.IP
هنگامی که موردی مشخص نشده باشد، آمار و اطلاعات مربوط به کل مخزن را نمایش می‌دهد.
.IP
برای جزئیات بیشتر به git-annex\-info(1) مراجعه کنید.
.IP
.IP "\fBversion\fP"
نسخه git-annex و همچنین اطلاعات نسخه مخزن را نمایش می‌دهد.
.IP
برای جزئیات بیشتر به git-annex\-version(1) مراجعه کنید.
.IP
.IP "\fBmap\fP"
نقشه‌ای از مخازن تولید می‌کند.
.IP
برای جزئیات بیشتر به git-annex\-map(1) مراجعه کنید.
.IP
.IP "\fBinprogress\fP"
دسترسی به فایل‌ها در حین بارگیری آن‌ها.
.IP
برای جزئیات بیشتر به git-annex\-inprogress(1) مراجعه کنید.
.IP
.IP "\fBfindkeys\fP"
مشابه \fBgit-annex find\fP است، اما روی کلیدها عمل می‌کند.
.IP
برای جزئیات بیشتر به git-annex\-findkeys(1) مراجعه کنید.
.IP
.SH "دستورات فراداده (METADATA COMMANDS)"
.IP "\fBmetadata [path ...]\fP"
.IP
محتوای یک فایل ضمیمه‌شده می‌تواند هر تعداد فیلد فراداده (metadata) را برای توصیف خود به همراه داشته باشد. هر فیلد فراداده نیز می‌تواند شامل هر تعداد مقدار باشد.
.IP
این دستور می‌تواند برای تنظیم فراداده یا نمایش فراداده‌های فعلی تنظیم‌شده استفاده شود.
.IP
برای جزئیات بیشتر به git-annex\-metadata(1) مراجعه کنید.
.IP
.IP "\fBview [tag ...] [field=value ...] [field=glob ...] [?tag ...] [field?=glob] [!tag ...] [field!=value ...]\fP"
از فراداده برای ساختن یک شاخه نما (view branch) از فایل‌ها در شاخه فعلی استفاده کرده و شاخه نما را تحویل (checkout) می‌گیرد. فقط فایل‌هایی در شاخه فعلی که فراداده آن‌ها با تمام مقادیر فیلد و برچسب‌های مشخص‌شده مطابقت داشته باشد، در نما نشان داده خواهند شد.
.IP
برای جزئیات بیشتر به git-annex\-view(1) مراجعه کنید.
.IP
.IP "\fBvpop [N]\fP"
از نمای فعال فعلی به نمای قبلی بازمی‌گردد؛ یا از نمای نخست به شاخه اصلی بازمی‌گردد.
.IP
برای جزئیات بیشتر به git-annex\-vpop(1) مراجعه کنید.
.IP
.IP "\fBvfilter [tag ...] [field=value ...] [!tag ...] [field!=value ...]\fP"
نمای فعلی را تنها به فایل‌هایی فیلتر می‌کند که مقادیر فیلد و برچسب‌های مشخص‌شده را دارا باشند.
.IP
برای جزئیات بیشتر به git-annex\-vfilter(1) مراجعه کنید.
.IP
.IP "\fBvadd [field=glob ...] [field=value ...] [tag ...]\fP"
نمای فعلی را تغییر داده و یک سطح اضافی از دایرکتوری‌ها را برای دسته‌بندی فایل‌ها اضافه می‌کند.
.IP
برای جزئیات بیشتر به git-annex\-vfilter(1) مراجعه کنید.
.IP
.IP "\fBvcycle\fP"
هنگامی که یک نما شامل زیردایرکتوری‌های تودرتو باشد، ترتیب آن‌ها را به صورت چرخشی تغییر می‌دهد.
.IP
برای جزئیات بیشتر به git-annex\-vcycle(1) مراجعه کنید.
.IP
.SH "دستورات کاربردی (UTILITY COMMANDS)"
.IP "\fBmigrate [path ...]\fP"
.IP
فایل‌های ضمیمه‌شده مشخص‌شده را برای استفاده از یک بک‌اند کلید\-مقدار دیگر تغییر می‌دهد.
.IP
برای جزئیات بیشتر به git-annex\-migrate(1) مراجعه کنید.
.IP
.IP "\fBreinject src dest\fP"
فایل src را به عنوان محتوای فایل dest به درون ضمیمه منتقل می‌کند. این می‌تواند زمانی مفید باشد که محتوای یک فایل را از جای دیگری به دست آورده‌اید و می‌خواهید آن را در ضمیمه محلی قرار دهید.
.IP
برای جزئیات بیشتر به git-annex\-reinject(1) مراجعه کنید.
.IP
.IP "\fBunannex [path ...]\fP"
از این دستور برای لغو یک دستور ناخواسته یا تصادفی \fBgit annex add\fP استفاده کنید. این کار فایل را به حالت قبل از افزودن بازمی‌گرداند.
.IP
برای جزئیات بیشتر به git-annex\-unannex(1) مراجعه کنید.
.IP
.IP "\fBuninit\fP"
لغو مقداردهی اولیه git-annex و پاک‌سازی مخزن.
.IP
برای جزئیات بیشتر به git-annex\-uninit(1) مراجعه کنید.
.IP
.IP "\fBreinit uuid|description\fP"
مقداردهی اولیه مخزن با استفاده مجدد از UUID قدیمی.
.IP
برای جزئیات بیشتر به git-annex\-reinit(1) مراجعه کنید.
.IP
.SH "دستورات سطح پایین (PLUMBING COMMANDS)"
.IP "\fBpre\-commit [path ...]\fP"
.IP
این دستور برای فراخوانی از قلاب pre\-commit گیت در نظر گرفته شده است. دستور \fBgit annex init\fP به طور خودکار یک قلاب pre\-commit با استفاده از این ایجاد می‌کند.
.IP
برای جزئیات بیشتر به git-annex\-pre\-commit(1) مراجعه کنید.
.IP
.IP "\fBpost\-receive\fP"
این دستور برای فراخوانی از قلاب post\-receive گیت در نظر گرفته شده است. دستور \fBgit annex init\fP به طور خودکار یک قلاب post\-receive با استفاده از این ایجاد می‌کند.
.IP
برای جزئیات بیشتر به git-annex\-post\-receive(1) مراجعه کنید.
.IP
.IP "\fBlookupkey [file ...]\fP"
کلید استفاده‌شده برای یک فایل را جستجو می‌کند.
.IP
برای جزئیات بیشتر به git-annex\-lookupkey(1) مراجعه کنید.
.IP
.IP "\fBcalckey [file ...]\fP"
کلیدی را که برای ارجاع به یک فایل استفاده خواهد شد، محاسبه می‌کند.
.IP
برای جزئیات بیشتر به git-annex\-calckey(1) مراجعه کنید.
.IP
.IP "\fBcontentlocation [key ..]\fP"
مکان محتوای ضمیمه‌شده را برای یک کلید جستجو می‌کند.
.IP
برای جزئیات بیشتر به git-annex\-contentlocation(1) مراجعه کنید.
.IP
.IP "\fBexaminekey [key ...]\fP"
اطلاعاتی را چاپ می‌کند که صرفاً با بررسی کلید قابل تشخیص هستند.
.IP
برای جزئیات بیشتر به git-annex\-examinekey(1) مراجعه کنید.
.IP
.IP "\fBmatchexpression\fP"
بررسی می‌کند که آیا یک عبارت محتوای ترجیحی با داده‌های ارائه‌شده مطابقت دارد یا خیر.
.IP
برای جزئیات بیشتر به git-annex\-matchexpression(1) مراجعه کنید.
.IP
.IP "\fBfromkey [key file]\fP"
یک فایل را در مخزن گیت به صورت دستی تنظیم می‌کند تا به یک کلید مشخص پیوند داده شود.
.IP
برای جزئیات بیشتر به git-annex\-fromkey(1) مراجعه کنید.
.IP
.IP "\fBregisterurl [key url]\fP"
یک نشانی وب را برای یک کلید ثبت می‌کند.
.IP
برای جزئیات بیشتر به git-annex\-registerurl(1) مراجعه کنید.
.IP
.IP "\fBunregisterurl [key url]\fP"
ثبت یک نشانی وب را برای یک کلید لغو می‌کند.
.IP
برای جزئیات بیشتر به git-annex\-unregisterurl(1) مراجعه کنید.
.IP
.IP "\fBreregisterurl [key url]\fP"
اطلاعات ثبت نشانی وب را به‌روزرسانی می‌کند.
.IP
برای جزئیات بیشتر به git-annex\-reregisterurl(1) مراجعه کنید.
.IP
.IP "\fBsetkey key file\fP"
یک فایل را به عنوان محتوای یک کلید به درون ضمیمه منتقل می‌کند.
.IP
برای جزئیات بیشتر به git-annex\-setkey(1) مراجعه کنید.
.IP
.IP "\fBdropkey [key ...]\fP"
محتوای ضمیمه‌شده را برای کلیدهای مشخص‌شده حذف می‌کند.
.IP
برای جزئیات بیشتر به git-annex\-dropkey(1) مراجعه کنید.
.IP
.IP "\fBtransferkey key [\-\-from=remote|\-\-to=remote]\fP"
یک کلید را از یا به یک مخزن دوردست منتقل می‌کند.
.IP
برای جزئیات بیشتر به git-annex\-transferkey(1) مراجعه کنید.
.IP
.IP "\fBtransferrer\fP"
به طور داخلی توسط git-annex برای انتقال محتوا استفاده می‌شود.
.IP
برای جزئیات بیشتر به git-annex\-transferrer(1) مراجعه کنید.
.IP
.IP "\fBtransferkeys\fP"
به طور داخلی توسط نسخه‌های قدیمی دستیار استفاده می‌شد.
.IP
برای جزئیات بیشتر به git-annex\-transferkey(1) مراجعه کنید.
.IP
.IP "\fBsetpresentkey key uuid [1|0]\fP"
این دستور در سطح زیرساختی (plumbing)، سوابق git-annex را درباره اینکه آیا محتوای کلید مشخص‌شده در یک مخزن دوردست با uuid تعیین‌شده موجود است یا خیر، تغییر می‌دهد.
.IP
برای جزئیات بیشتر به git-annex\-setpresentkey(1) مراجعه کنید.
.IP
.IP "\fBreadpresentkey key uuid\fP"
سوابق مربوط به مکان‌هایی را که کلید در آن‌ها موجود است می‌خواند.
.IP
برای جزئیات بیشتر به git-annex\-readpresentkey(1) مراجعه کنید.
.IP
.IP "\fBcheckpresentkey key remote\fP"
بررسی می‌کند که آیا کلید در مخزن دوردست وجود دارد یا خیر.
.IP
برای جزئیات بیشتر به git-annex\-checkpresentkey(1) مراجعه کنید.
.IP
.IP "\fBrekey [file key ...]\fP"
کلیدهای استفاده‌شده برای فایل‌ها را تغییر می‌دهد.
.IP
برای جزئیات بیشتر به git-annex\-rekey(1) مراجعه کنید.
.IP
.IP "\fBresolvemerge\fP"
یک ادغام دارای تداخل را با افزودن هر دو نسخه متعارض فایل به درخت، با استفاده از گونه‌های نام فایل آن‌ها برطرف می‌کند. این کار هنگام استفاده از \fBgit annex sync\fP یا \fBgit-annex pull\fP یا \fBgit annex merge\fP به طور خودکار انجام می‌شود.
.IP
برای جزئیات بیشتر به git-annex\-resolvemerge(1) مراجعه کنید.
.IP
.IP "\fBdiffdriver\fP"
این می‌تواند برای تنظیم \fBgit diff\fP جهت مقایسه تفاوت‌های محتوای فایل‌های ضمیمه‌شده به کار رود.
.IP
برای جزئیات بیشتر به git-annex\-diffdriver(1) مراجعه کنید.
.IP
.IP "\fBsmudge\fP"
این دستور اجازه می‌دهد تا git-annex به عنوان درایور فیلتر گیت استفاده شود، و بدین ترتیب فایل‌های ضمیمه‌شده در مخزن گیت به جای پیوندهای نمادین، فایل‌های بازشده معمولی باشند.
.IP
برای جزئیات بیشتر به git-annex\-smudge(1) مراجعه کنید.
.IP
.IP "\fBfilter\-process\fP"
یک پیاده‌سازی جایگزین از درایور فیلتر گیت، که در برخی موقعیت‌ها سریع‌تر و در برخی دیگر کندتر از \fBgit-annex smudge\fP عمل می‌کند.
.IP
برای جزئیات بیشتر به git-annex\-filter\-process(1) مراجعه کنید.
.IP
.IP "\fBrestage\fP"
فایل‌های بازشده را مجدداً در ایندکس گیت آماده (restage) می‌کند.
.IP
برای جزئیات بیشتر به git-annex\-restage(1) مراجعه کنید.
.IP
.IP "\fBfindref [ref]\fP"
فایل‌ها را در یک مرجع (ref) گیت فهرست می‌کند. (منسوخ‌شده)
.IP
برای جزئیات بیشتر به git-annex\-findref(1) مراجعه کنید.
.IP
.IP "\fBproxy \-\- git cmd [options]\fP"
حفاظ حالت مستقیم را دور می‌زند. (منسوخ‌شده)
.IP
برای جزئیات بیشتر به git-annex\-proxy(1) مراجعه کنید.
.IP
.SH "دستورات آزمایش (TESTING COMMANDS)"
.IP "\fBtest\fP"
.IP
مجموعه آزمایش‌های داخلی git-annex را اجرا می‌کند.
.IP
برای جزئیات بیشتر به git-annex\-test(1) مراجعه کنید.
.IP
.IP "\fBtestremote remote\fP"
یک مخزن دوردست را با تولید چند شیء تصادفی و ارسال آن‌ها به مخزن دوردست، سپس بارگیری مجدد، حذف آن‌ها از مخزن دوردست و غیره آزمایش می‌کند.
.IP
اجرای آن در یک مخزن موجود ایمن است (محتویات مخزن تغییر نمی‌کند)، اگرچه ممکن است انتقال داده‌های پرهزینه‌ای را انجام دهد.
.IP
برای جزئیات بیشتر به git-annex\-testremote(1) مراجعه کنید.
.IP
.IP "\fBsim\fP"
این دستور شبکه‌ای از مخازن git-annex را شبیه‌سازی می‌کند. می‌توان از آن برای آزمایش یک پیکربندی پیش از استفاده در دنیای واقعی بهره برد.
.IP
برای جزئیات بیشتر به git-annex\-sim(1) مراجعه کنید.
.IP
.IP "\fBfuzztest\fP"
تغییرات تصادفی در فایل‌های مخزن جاری ایجاد می‌کند تا برای آزمایش دستیار (assistant) مورد استفاده قرار گیرد.
.IP
برای جزئیات بیشتر به git-annex\-fuzztest(1) مراجعه کنید.
.IP
.IP "\fBbenchmark\fP"
در صورتی که git-annex با پشتیبانی از معیارسنجی ساخته شده باشد، بنچمارک‌های داخلی آن را اجرا می‌کند.
.IP
برای جزئیات بیشتر به git-annex\-benchmark(1) مراجعه کنید.
.IP
.SH "دستورات افزونه (ADDON COMMANDS)"
علاوه بر تمامی دستورات ذکر شده در بالا، با قرار دادن دستوراتی با نام‌هایی مانند "git-annex\-foo" در پوشه‌ای در PATH، می‌توان دستورات بیشتری را به git-annex اضافه کرد.
.PP
.SH "پیکربندی (CONFIGURATION)"
مانند سایر دستورات git، ابزار git-annex نیز از طریق \fB.git/config\fP پیکربندی می‌شود. این تنظیمات و همچنین تنظیمات مرتبط در git config، مواردی هستند که git-annex استفاده می‌کند.
.PP
(برخی از این تنظیمات را می‌توان با استفاده از git-annex\-config در تمام کلون‌های مخزن نیز اعمال کرد. برای مشاهده فهرست آنها به صفحه راهنمای آن مراجعه کنید.)
.PP
.IP "\fBannex.uuid\fP"
یک UUID یکتا برای این مخزن (به طور خودکار تنظیم می‌شود).
.IP
.IP "\fBannex.backend\fP"
نام بک‌اند کلید\-مقدار پیش‌فرض برای استفاده هنگام افزودن فایل‌های جدید به مخزن. برای اطلاعات درباره بک‌اندهای موجود به git-annex\-backends(1) مراجعه کنید.
.IP
این مورد توسط پیکربندی annex.backend در فایل‌های \&.gitattributes و توسط گزینه \-\-backend بازنویسی (override) می‌شود.
.IP
(این گزینه قبلاً \fBannex.backends\fP نامیده می‌شد و در صورت تنظیم همچنان استفاده خواهد شد.)
.IP
.IP "\fBannex.securehashesonly\fP"
تنظیم روی true نشان می‌دهد که مخزن فقط باید از درهم‌سازهای (هش‌های) امن رمزنگاری‌شده (SHA2, SHA3) استفاده کند و نه هش‌های ناامن (MD5, SHA1) برای محتوا.
.IP
هنگامی که این گزینه فعال باشد، اجازه اضافه شدن محتوای فایل‌هایی که از هش‌های رمزنگاری ناامن استفاده می‌کنند به مخزن داده نخواهد شد.
.IP
همچنین \fBgit-annex fsck\fP در مورد هر فایل موجود در مخزن که از هش‌های ناامن استفاده می‌کند هشدار خواهد داد. و \fBgit-annex import \-\-no\-content\fP از وارد کردن فایل‌ها از ریموت‌های ویژه با استفاده از هش‌های ناامن خودداری می‌کند.
.IP
برای پیکربندی این رفتار در کلون‌های جدید مخزن، می‌توان آن را با استفاده از git-annex\-config تنظیم کرد.
.IP
.IP "\fBannex.maxextensionlength\fP"
حداکثر طول، بر حسب بایت، برای آنچه پسوند نام فایل در نظر گرفته می‌شود. این گزینه هنگام افزودن فایل به بک‌اندی که پسوندهای نام فایل را حفظ می‌کند و همچنین هنگام تولید یک شاخه نما (view branch) استفاده می‌شود.
.IP
طول پیش‌فرض ۴ است که پسوندهایی مانند "jpeg" را مجاز می‌داند. نقطه قبل از پسوند جزو طول آن شمرده نمی‌شود.
.IP
.IP "\fBannex.maxextensions\fP"
حداکثر تعداد پسوندهای نام فایل جهت نگهداری هنگام استفاده از بک‌اندی که پسوندهای نام فایل را حفظ می‌کند و همچنین هنگام تولید شاخه نما.
.IP
مقدار پیش‌فرض ۲ است که امکان پسوندهای ترکیبی مانند ".tar.gz" را فراهم می‌کند. وقتی روی ۱ تنظیم شود، فقط آخرین پسوند را حفظ می‌کند، مانند ".gz".
.IP
.IP "\fBannex.diskreserve\fP"
میزان فضای دیسک برای رزرو. فضای دیسک هنگام انتقال محتوای پیوست‌شده بررسی می‌شود تا از اتمام فضا جلوگیری شود و می‌توان فضای خالی اضافی را از طریق این گزینه رزرو کرد تا فضایی برای سایر داده‌ها (مانند لاگ‌های کامیت git) باقی بماند. می‌تواند با هر یک از واحدهای رایج مشخص شود، به عنوان مثال "0.5 gb"، "500M" یا "100 KiloBytes".
.IP
میزان رزرو پیش‌فرض ۱۰۰ مگابایت است.
.IP
.IP "\fBannex.fullybalancedthreshhold\fP"
درصد پر بودن مخزن را پیکربندی می‌کند تا عبارت محتوای ترجیحی "fullybalanced" آن را پر در نظر بگیرد. مقدار پیش‌فرض ۹۰ است.
.IP
.IP "\fBannex.skipunknown\fP"
تنظیم روی true باعث می‌شود دستوراتی مانند "git-annex get" مواردی را که در خط فرمان ذکر شده‌اند اما در git ثبت نشده‌اند، بدون پیام خطا نادیده بگیرند.
.IP
تنظیم روی false باعث می‌شود اگر به دستوراتی مانند "git-annex get" گفته شود روی فایل‌هایی که در git ثبت نشده‌اند عمل کنند، خطا در نظر گرفته شود. (این مقدار پیش‌فرض در نسخه‌های اخیر git-annex است.)
.IP
توجه داشته باشید که وقتی annex.skipunknown برابر false است، دستوری مانند "git-annex get \&." در صورتی که هیچ فایلی در پوشه جاری در git ثبت نشده باشد با شکست مواجه می‌شود. دستوراتی مانند "git-annex get foo/" در صورتی که هیچ فایلی در پوشه در git ثبت نشده باشد با شکست مواجه می‌شوند، اما اگر حداقل یک فایل ثبت شده باشد، سایر فایل‌هایی را که ثبت نشده‌اند نادیده می‌گیرد. این دقیقاً مشابه رفتار "git\-ls files \-\-error\-unmatch" است.
.IP
همچنین توجه داشته باشید که git-annex فایل‌هایی را که در git ثبت شده‌اند اما فایل پیوست‌شده نیستند نادیده می‌گیرد؛ این تنظیم روی آن تأثیری ندارد.
.IP
.IP "\fBannex.largefiles\fP"
برای پیکربندی اینکه چه فایل‌هایی به اندازه کافی بزرگ هستند که به annex افزوده شوند استفاده می‌شود. این یک عبارت تطبیق با فایل‌های بزرگ است، مانند "\fBinclude=*.mp3 or largerthan=500kb\fP". برای جزئیات مربوط به نحو به git-annex\-matching\-expression(1) مراجعه کنید.
.IP
ویژگی‌های annex.largefiles در فایل‌های \fB.gitattributes\fP را لغو می‌کند.
.IP
برای پیکربندی یک annex.largefiles پیش‌فرض برای تمام کلون‌های مخزن، می‌توان این مورد را در git-annex\-config(1) تنظیم کرد.
.IP
این گزینه رفتار هر دو ابزار git-annex و git را هنگام افزودن فایل‌ها به مخزن پیکربندی می‌کند. به طور پیش‌فرض، \fBgit-annex add\fP تمام فایل‌ها را به annex اضافه می‌کند (به جز فایل‌های نقطه‌دار و فایل‌های موجود در پوشه‌های نقطه‌دار)، و \fBgit add\fP فایل‌ها را به git اضافه می‌کند (مگر اینکه قبلاً به annex اضافه شده باشند). هنگامی که annex.largefiles پیکربندی شده باشد، هم \fBgit annex add\fP و هم \fBgit add\fP فایل‌های بزرگ منطبق را به annex و سایر فایل‌ها را به git اضافه می‌کنند.
.IP
سایر دستورات git-annex نیز به annex.largefiles احترام می‌گذارند، از جمله \fBgit annex import\fP، \fBgit annex addurl\fP، \fBgit annex importfeed\fP، \fBgit-annex assist\fP و \fBgit-annex assistant\fP.
.IP
.IP "\fBannex.dotfiles\fP"
به طور معمول، فایل‌های نقطه‌دار (dotfiles) و فایل‌های درون پوشه‌های نقطه‌دار به عنوان فایل‌های پیکربندی مانند .gitignore فرض می‌شوند که محتوای آنها همیشه باید بخشی از مخزن git باشد، بنابراین به annex اضافه نمی‌شوند. تنظیم annex.dotfiles روی true باعث می‌شود این فایل‌ها نیز مانند هر فایل دیگری به annex اضافه شوند.
.IP
برای پیوست کردن فقط برخی از فایل‌های نقطه‌دار، این گزینه را فعال کنید و annex.largefiles را طوری پیکربندی کنید که با موارد مورد نظرتان مطابقت داشته باشد. برای مثال، برای تطبیق فقط فایل‌های نقطه‌داری که به ".big" ختم می‌شوند:
.IP
 git config annex.largefiles "(include=.*.big or include=*/.*.big) or (exclude=.* and exclude=*/.*)"
 git config annex.dotfiles true
.IP
برای پیکربندی یک annex.dotfiles پیش‌فرض برای تمامی کلون‌های مخزن، می‌توان این مورد را در git-annex\-config(1) تنظیم کرد.
.IP
.IP "\fBannex.gitaddtoannex\fP"
تنظیم این گزینه روی false مانع از اضافه شدن فایل‌ها توسط \fBgit add\fP به annex، علیرغم پیکربندی annex.largefiles می‌شود.
.IP
.IP "\fBannex.addsmallfiles\fP"
کنترل می‌کند که آیا فایل‌های کوچک (فایل‌هایی که با annex.largefiles مطابقت ندارند، یا فایل‌های نقطه‌دار) باید توسط \fBgit annex add\fP در git ثبت شوند یا خیر. پیش‌فرض true است؛ برای نادیده گرفتن فایل‌های کوچک، آن را روی false تنظیم کنید.
.IP
.IP "\fBannex.addunlocked\fP"
دستوراتی مانند \fBgit-annex add\fP به طور پیش‌فرض فایل‌ها را به صورت قفل‌شده به مخزن اضافه می‌کنند. این گزینه می‌تواند باعث شود آنها فایل‌ها را به صورت قفل‌گشایی‌شده اضافه کنند، همان‌گونه که اگر git-annex\-unlock(1) روی فایل‌ها اجرا می‌شد.
.IP
می‌توان این مورد را روی "true" تنظیم کرد تا همه‌چیز به صورت قفل‌گشایی‌شده اضافه شود، یا می‌تواند یک عبارت پیچیده‌تر باشد که فایل‌ها را بر اساس نام، اندازه یا محتوا تطبیق دهد. برای جزئیات به git-annex\-matching\-expression(1) مراجعه کنید.
.IP
برای پیکربندی یک annex.addunlocked پیش‌فرض برای تمام کلون‌های مخزن، می‌توان این مورد را در git-annex\-config(1) تنظیم کرد.
.IP
استفاده از \fBgit add\fP همیشه فایل‌ها را به صورت قفل‌گشایی‌شده اضافه می‌کند و تحت تأثیر این تنظیم قرار نمی‌گیرد. دستیار (assistant) به طور پیش‌فرض همه فایل‌ها را قفل‌گشایی‌شده اضافه می‌کند، مگر اینکه \fBannex.assistant.allowunlocked\fP تنظیم شده باشد.
.IP
هنگامی که یک مخزن core.symlinks را روی false تنظیم کرده باشد، یا یک شاخه قفل‌گشایی‌شده تنظیم‌شده (adjusted unlocked branch) را checkout کرده باشد، این تنظیم نادیده گرفته می‌شود و فایل‌ها همیشه به صورت قفل‌گشایی‌شده به مخزن اضافه می‌شوند.
.IP
.IP "\fBannex.assistant.allowunlocked\fP"
دستیار \fBgit-annex assistant\fP به طور پیش‌فرض همه فایل‌ها را به صورت قفل‌گشایی‌شده اضافه می‌کند، به طوری که فایل‌ها بتوانند بدون نیاز به انجام کاری توسط کاربر برای باز کردن قفل، ویرایش شوند.
.IP
اگر این مقدار روی \fBtrue\fP تنظیم شود، در عوض از پیکربندی \fBannex.addunlocked\fP برای تصمیم‌گیری در مورد اینکه کدام فایل‌ها به صورت قفل‌گشایی‌شده اضافه شوند استفاده خواهد کرد.
.IP
.IP "\fBannex.numcopies\fP"
این یک تنظیم منسوخ‌شده است. در عوض باید از دستور \fBgit annex numcopies\fP برای پیکربندی تعداد نسخه‌هایی از فایل‌ها که در سراسر مخازن نگهداری می‌شوند، یا از تنظیم annex.numcopies در \&.gitattributes استفاده کنید.
.IP
این تنظیم پیکربندی فقط زمانی بررسی می‌شود که \fBgit annex numcopies\fP هرگز پیکربندی نشده باشد و هیچ تنظیم annex.numcopies در فایل \&.gitattributes وجود نداشته باشد.
.IP
.IP "\fBannex.genmetadata\fP"
این گزینه را روی \fBtrue\fP تنظیم کنید تا git-annex هنگام افزودن فایل‌ها به مخزن، مقداری متادیتا را به طور خودکار تولید کند.
.IP
به ویژه، متادیتای سال، ماه و روز را بر اساس تاریخ تغییر فایل ذخیره می‌کند.
.IP
هنگامی که importfeed استفاده می‌شود، متادیتای اضافی را از فید ذخیره می‌کند، مانند نویسنده، عنوان و غیره.
.IP
.IP "\fBannex.used\-refspec\fP"
کنترل می‌کند که \fBgit-annex unused\fP کدام refها را به عنوان استفاده‌شده در نظر بگیرد. برای جزئیات به بخش REFSPEC FORMAT در git-annex\-unused(1) مراجعه کنید.
.IP
.IP "\fBannex.jobs\fP"
تعداد وظایف همزمان برای اجرا را پیکربندی می‌کند. پیش‌فرض ۱ است.
.IP
فقط دستورات git-annex که از گزینه \-\-jobs پشتیبانی می‌کنند از این تنظیم استفاده خواهند کرد.
.IP
تنظیم این مقدار روی "cpus" به ازای هر هسته پردازنده (CPU) یک وظیفه را اجرا می‌کند.
.IP
هنگامی که گزینه \fB\-\-batch\fP استفاده شود، این پیکربندی نادیده گرفته می‌شود.
.IP
.IP "\fBannex.adjustedbranchrefresh\fP"
هنگامی که git-annex\-adjust(1) برای راه‌اندازی یک شاخه تنظیم‌شده (adjusted branch) که پس از دریافت یا رها کردن (drop) فایل‌ها نیاز به تازه‌سازی دارد استفاده می‌شود، این پیکربندی کنترل می‌کند که شاخه هر چند وقت یک‌بار تازه‌سازی شود.
.IP
تازه‌سازی شاخه زمان می‌برد، بنابراین انجام آن پس از هر فایل می‌تواند بسیار کند باشد. (همچنین می‌تواند اشیای معلق زیادی در git ایجاد کند.) مقدار پیش‌فرض 0 (یا false) است که شاخه را تازه‌سازی نمی‌کند. تنظیم 1 (یا true) تنها یک بار پس از انجام سایر تغییرات توسط git-annex تازه‌سازی می‌کند. مقدار 2 پس از هر فایل، 3 پس از هر دو فایل و به همین ترتیب تازه‌سازی می‌کند؛ مقدار 100 پس از هر 99 فایل تازه‌سازی می‌کند.
.IP
(اگر git-annex در آینده سریع‌تر شود، نرخ‌های تازه‌سازی متناسب با بهبود سرعت افزایش می‌یابد.)
.IP
.IP "\fBannex.queuesize\fP"
ابزار git-annex برای ادغام دستورات مشابه جهت افزایش سرعت، صفی از دستورات git می‌سازد. به طور پیش‌فرض اندازه صف به ۱۰۲۴۰ دستور محدود شده است؛ از این گزینه می‌توان برای تغییر اندازه استفاده کرد. اگر حافظه زیادی دارید و با تعداد بسیار زیادی از فایل‌ها کار می‌کنید، افزایش اندازه صف می‌تواند سرعت آن را بالا ببرد.
.IP
.IP "\fBannex.bloomcapacity\fP"
دستورات \fBgit annex unused\fP و \fBgit annex sync \-\-content\fP از یک فیلتر بلوم برای تعیین اینکه چه فایل‌هایی برای مثال در درخت کاری حضور دارند استفاده می‌کنند. اندازه پیش‌فرض فیلتر بلوم برای مدیریت حداکثر ۵۰۰٬۰۰۰ فایل تعیین شده است. اگر مخزن شما بزرگتر از این است، باید این مقدار را افزایش دهید. مقادیر بزرگتر باعث مصرف حافظه بیشتر توسط \fBgit-annex unused\fP و \fBgit annex sync \-\-content\fP می‌شود؛ برای مشاهده ارقام مصرف حافظه دستور \fBgit annex info\fP را اجرا کنید.
.IP
.IP "\fBannex.bloomaccuracy\fP"
دقت فیلتر بلوم مورد استفاده توسط \fBgit annex unused\fP و \fBgit annex sync \-\-content\fP را تنظیم می‌کند. دقت پیش‌فرض 10000000 است \-\- ۱ فایل استفاده‌نشده از هر ۱۰٬۰۰۰٬۰۰۰ فایل توسط \fBgit annex unused\fP نادیده گرفته خواهد شد. افزایش دقت باعث مصرف حافظه بیشتر توسط \fBgit annex unused\fP خواهد شد؛ برای دیدن ارقام مصرف حافظه، \fBgit annex info\fP را اجرا کنید.
.IP
.IP "\fBannex.sshcaching\fP"
به طور پیش‌فرض، git-annex اتصالات ssh را با استفاده از تنظیمات ControlMaster و ControlPersist در ssh ذخیره موقت (کَش) می‌کند (در صورتی که با نسخه‌ای به اندازه کافی جدید از ssh ساخته شده باشد). برای غیرفعال کردن این ویژگی، آن را روی \fBfalse\fP تنظیم کنید.
.IP
.IP "\fBannex.adviceNoSshCaching\fP"
هنگامی که git-annex قادر به استفاده از کَش اتصالات ssh نیست، یا طوری پیکربندی شده که از آن استفاده نکند، و همزمانی فعال است، هشدار می‌دهد که این ممکن است منجر به درخواست همزمان گذرواژه توسط چندین فرآیند ssh شود. برای غیرفعال کردن این هشدار، برای مثال اگر خودتان کَش اتصال ssh را پیکربندی کرده‌اید یا ssh-agent گذرواژه‌ها را در حافظه دارد، این گزینه را روی \fBfalse\fP تنظیم کنید.
.IP
.IP "\fBannex.alwayscommit\fP"
به طور پیش‌فرض، git-annex پس از اجرای هر دستور، داده‌ها را به طور خودکار به شاخه git-annex کامیت می‌کند. اگر مجموعه‌ای از دستورات دارید که می‌خواهید یک کامیت واحد ایجاد کنند، می‌توانید دستورات را با \fB\-c annex.alwayscommit=false\fP اجرا کنید. بعداً می‌توانید با اجرای \fBgit annex merge\fP (یا با ادغام‌های خودکار) یا \fBgit annex sync\fP داده‌ها را کامیت کنید.
.IP
.IP "\fBannex.commitmessage\fP"
هنگامی که git-annex شاخه git-annex را به‌روزرسانی می‌کند، معمولاً پیام کامیت مخصوص به خود را می‌سازد (مثلاً "update")، زیرا کاربران به ندرت به تغییرات آن شاخه نگاه کرده یا اهمیت می‌دهند. اگر این موضوع برای شما مهم است، می‌توانید با اجرای دستورات به همراه \fB\-c annex.commitmessage=whatever\fP این تنظیم را مشخص کنید.
.IP
این گزینه در ترکیب با annex.alwayscommit=false به خوبی کار می‌کند تا مجموعه‌ای از تغییرات را گردآوری کرده و آنها را با پیامی که مشخص می‌کنید کامیت کند.
.IP
.IP "\fBannex.commitmessage\-command\fP"
این دستور اجرا شده و خروجی آن به عنوان پیام کامیت برای شاخه git-annex استفاده می‌شود.
.IP
همچنین می‌توان یک اسکریپت قلاب (hook) در \fB.git/hooks/commitmessage\-annex\fP نصب کرد.
.IP
.IP "\fBannex.post\-update\-command\fP"
این دستور پس از اینکه git-annex شاخه git-annex را به‌روزرسانی کرد، اجرا می‌شود.
.IP
هنگام انتشار یک مخزن git-annex از طریق http، می‌توان از این گزینه برای اجرای \fBgit update\-server\-info\fP استفاده کرد.
.IP
همچنین می‌توان یک اسکریپت قلاب در \fB.git/hooks/post\-update\-annex\fP نصب کرد.
.IP
.IP "\fBannex.pre\-commit\-command\fP"
این دستور هر زمان که کامیتی در شاخه HEAD مخزن git ایجاد شود (چه توسط git commit یا توسط git-annex) اجرا می‌شود.
.IP
همچنین می‌توان یک اسکریپت قلاب در \fB.git/hooks/pre\-commit\-annex\fP نصب کرد.
.IP
.IP "\fBannex.pre\-init\-command\fP"
این دستور قبل از مقداردهی اولیه مخزن، چه توسط \fBgit-annex init\fP و چه با مقداردهی اولیه خودکار، اجرا می‌شود. می‌تواند مخزن را به هر روشی که لازم است پیکربندی کند. اگر با خروجی غیرصفر خارج شود، مقداردهی اولیه مخزن با شکست مواجه خواهد شد.
.IP
همچنین می‌توان یک اسکریپت قلاب در \fB.git/hooks/pre\-init\-annex\fP نصب کرد.
.IP
.IP "\fBannex.alwayscompact\fP"
به طور پیش‌فرض، git-annex داده‌هایی را که در شاخه git-annex ثبت می‌کند فشرده‌سازی (compact) می‌نماید. تنظیم این مقدار روی false در برخی موارد از این فشرده‌سازی جلوگیری می‌کند، که می‌تواند عملیاتی را که شاخه git-annex را با داده‌های زیاد پر می‌کنند سرعت ببخشد. با این حال، هنگام استفاده با عملیاتی که مقادیر قدیمی را در شاخه git-annex بازنویسی می‌کنند، ممکن است باعث شود شاخه git-annex فضای دیسک بیشتری مصرف کند و بنابراین خواندن داده‌ها از آن کندتر شود.
.IP
نمونه‌ای از دستوری که با استفاده از \fB\-c annex.alwayscompact=false\fP سرعت آن افزایش می‌یابد، \fBgit-annex registerurl \-\-batch\fP هنگام افزودن تعداد زیادی URL به یک کلید یکسان است.
.IP
این گزینه برای اولین بار در نسخه 10.20220724 برنامه git-annex پشتیبانی شد. تنظیم این گزینه در مخزنی که ممکن است همزمان توسط نسخه قدیمی‌تر git-annex و نسخه‌ای که از این گزینه پشتیبانی می‌کند استفاده شود، کاملاً ایمن نیست.
.IP
.IP "\fBannex.allowsign\fP"
به طور پیش‌فرض git-annex از امضای gpg برای کامیت‌هایی که هدف اصلی یک دستور نیستند و صرفاً یک اثر جانبی محسوب می‌شوند، خودداری می‌کند. این پیش‌فرض از درخواست‌های مکرر گذرواژه gpg در صورت تنظیم commit.gpgSign جلوگیری می‌کند. دستوری مانند \fBgit annex sync\fP یا \fBgit annex merge\fP کامیت خود را با gpg امضا خواهد کرد، اما دستوری مانند \fBgit annex get\fP که شاخه git-annex را به‌روزرسانی می‌کند، این کار را انجام نخواهد داد. دستیار (assistant) نیز از امضای کامیت‌ها خودداری می‌کند.
.IP
تنظیم annex.allowsign روی true امکان امضای تمام کامیت‌ها را طبق تنظیمات commit.gpgSign و سایر پیکربندی‌های git فراهم می‌کند.
.IP
.IP "\fBannex.merge\-annex\-branches\fP"
به طور پیش‌فرض، شاخه‌های git-annex که از ریموت‌ها دریافت (pull) شده‌اند، به طور خودکار در شاخه محلی git-annex ادغام می‌شوند تا git-annex به‌روزترین اطلاعات ممکن را در اختیار داشته باشد.
.IP
برای جلوگیری از این ادغام، این گزینه را روی "false" تنظیم کنید.
.IP
این می‌تواند به ویژه زمانی مفید باشد که مجوز نوشتن در مخزن را ندارید. اگرچه git-annex بیشتر قادر است در یک مخزن فقط‌خواندنی با شاخه‌های ادغام‌نشده git-annex کار کند، برخی موارد کار نمی‌کنند و زمانی هم که کار کند، به دلیل نیاز به بررسی هر یک از شاخه‌های ادغام‌نشده کندتر خواهد بود.
.IP
.IP "\fBannex.private\fP"
هنگامی که این گزینه روی true تنظیم شود، هیچ اطلاعاتی در مورد مخزن در شاخه git-annex ثبت نخواهد شد.
.IP
برای مثال، برای ساخت مخزنی بدون اینکه هرگز نامی از آن در شاخه git-annex ظاهر شود:
.IP
 git init myprivate
 cd myprivaterepo
 git config annex.private true
 git annex init
.IP
.IP "\fBannex.hardlink\fP"
این گزینه را روی \fBtrue\fP تنظیم کنید تا در صورت امکان، محتوای فایل‌ها به جای یک کپی پرهزینه‌تر، بین مخزن و ریموت‌های آن پیوند سخت (hard link) شود.
.IP
با احتیاط استفاده شود \-\- این می‌تواند شمارش numcopies را باطل کند، زیرا با پیوندهای سخت، نسخه‌های کمتری از یک فایل ممکن است وجود داشته باشد. بنابراین، ایده خوبی است که مخزنی را که از این تنظیم استفاده می‌کند به عنوان غیرقابل اعتماد (untrusted) علامت‌گذاری کنید.
.IP
هنگامی که یک مخزن با استفاده از \fBgit clone \-\-shared\fP راه‌اندازی می‌شود، git-annex init به طور خودکار annex.hardlink را تنظیم کرده و مخزن را به عنوان غیرقابل اعتماد علامت‌گذاری می‌کند.
.IP
هنگامی که \fBannex.thin\fP نیز تنظیم شده باشد، تنظیم \fBannex.hardlink\fP هیچ تأثیری ندارد.
.IP
.IP "\fBannex.thin\fP"
این گزینه را روی \fBtrue\fP تنظیم کنید تا فایل‌های قفل‌گشایی‌شده به جای یک نسخه کپی دوم، یک پیوند سخت به محتوای خود در annex باشند. این می‌تواند مقدار قابل توجهی در فضای دیسک صرفه‌جویی کند، اما هنگامی که تغییری در یک فایل ایجاد می‌شود، نسخه قدیمی محلی (و احتمالاً تنها نسخه) را از دست خواهید داد. هر فایل قفل‌شده دیگری در مخزن که به آن محتوا اشاره می‌کرد نیز خراب می‌شود (\fBgit-annex fsck\fP پس از آن، این مورد را شناسایی و پاکسازی خواهد کرد). بنابراین این گزینه را با احتیاط فعال کنید.
.IP
پس از تنظیم (یا لغو تنظیم) این مورد، باید \fBgit annex fix\fP را اجرا کنید تا فایل‌های پیوست‌شده در درخت کاری اصلاح شده و به پیوندهای سخت (یا کپی‌ها) تبدیل شوند.
.IP
توجه داشته باشید که وقتی سیستم فایل از پیوندهای سخت پشتیبانی نمی‌کند، این مورد هیچ اثری ندارد. و هنگامی که چندین فایل در درخت کاری دارای محتوای یکسان باشند، فقط یکی از آنها به annex پیوند سخت می‌شود.
.IP
.IP "\fBannex.supportunlocked\fP"
به طور پیش‌فرض git-annex از فایل‌های قفل‌گشایی‌شده و همچنین فایل‌های قفل‌شده پشتیبانی می‌کند، بنابراین این مقدار به طور پیش‌فرض true است. اگر روی false تنظیم شود، git-annex فقط از فایل‌های قفل‌شده پشتیبانی خواهد کرد. این کار از انجام کارهای لازم برای پشتیبانی از فایل‌های قفل‌گشایی‌شده جلوگیری می‌کند.
.IP
توجه داشته باشید که تنظیم این گزینه روی false مانع از اضافه شدن فایل‌های قفل‌گشایی‌شده به مخزن نمی‌شود و در این حالت تا زمانی که قفل نشوند، محتوای فایل‌ها قابل دسترسی نخواهد بود.
.IP
پس از تغییر این پیکربندی، برای اعمال آن باید \fBgit-annex init\fP را دوباره اجرا کنید.
.IP
.IP "\fBannex.trashbin\fP"
هنگامی که این گزینه روی نام یک ریموت تنظیم شود، فایل‌هایی که از مخزن رها (drop) می‌شوند به آن ریموت منتقل خواهند شد.
.IP
توجه داشته باشید اگر انتقال فایل به ریموت زمان زیادی ببرد، کاربر نمایشی از پیشرفت برای عملیات drop خود مشاهده نخواهد کرد. بنابراین بهتر است با یک ریموت سریع استفاده شود.
.IP
همچنین اگر ریموت در دسترس نباشد یا انتقال فایل به آن با شکست مواجه شود، فایل از مخزن رها نخواهد شد.
.IP
.IP "\fBannex.url\fP"
هنگامی که یک ریموت دارای یک URL با پروتکل http باشد، اولین باری که git-annex از ریموت استفاده می‌کند بررسی می‌نماید که آیا می‌تواند فایل \fB.git/config\fP آن را بارگیری کند یا خیر. اگر بتواند و فایل دارای این تنظیم روی یک URL به صورت "annex+http" یا "annex+https" باشد، آن URL در \fBremote.<name>.annexUrl\fP کپی خواهد شد.
.IP
.IP "\fBannex.resolvemerge\fP"
تنظیم روی false از حل خودکار تداخل‌های ادغام (merge conflicts) در شاخه فعلی توسط \fBgit-annex assistant\fP، \fBgit-annex assist\fP، \fBgit-annex sync\fP، \fBgit-annex pull\fP، \fBgit-annex merge\fP و قلاب post\-receive برنامه git-annex جلوگیری می‌کند.
.IP
برای پیکربندی این رفتار در تمام کلون‌های مخزن، می‌توان این مورد را در git-annex\-config(1) تنظیم کرد.
.IP
.IP "\fBannex.synccontent\fP"
تنظیم روی true باعث می‌شود \fBgit-annex sync\fP به طور پیش‌فرض محتوای پیوست‌شده را انتقال دهد.
.IP
تنظیم روی false از انتقال محتوای پیوست‌شده توسط \fBgit-annex assist\fP، \fBgit-annex pull\fP و \fBgit-annex push\fP جلوگیری می‌کند.
.IP
برای پیکربندی این رفتار در تمام کلون‌های مخزن، می‌توان این مورد را در git-annex\-config(1) تنظیم کرد.
.IP
.IP "\fBannex.synconlyannex\fP"
تنظیم روی true باعث می‌شود \fBgit-annex assist\fP، \fBgit-annex sync\fP، \fBgit-annex pull\fP و \fBgit-annex push\fP به طور پیش‌فرض فقط روی شاخه git-annex و محتوای پیوست‌شده عمل کنند.
.IP
برای پیکربندی این رفتار در تمام کلون‌های مخزن، می‌توان این مورد را در git-annex\-config(1) تنظیم کرد.
.IP
.IP "\fBannex.syncmigrations\fP"
تنظیم روی false مانع از این می‌شود که \fBgit-annex sync\fP و \fBgit-annex pull\fP مهاجرت‌ها را پویش کرده و مخزن محلی را برای آن مهاجرت‌ها به‌روز کنند.
.IP
.IP "\fBannex.viewunsetdirectory\fP"
این گزینه نام پوشه‌ای را پیکربندی می‌کند که در یک نما (view) برای نگهداری فایل‌هایی که متادیتای تنظیم‌شده ندارند استفاده می‌شود. نام پیش‌فرض این پوشه \fB"_"\fP است. برای جزئیات به git-annex\-view(1) مراجعه کنید.
.IP
.IP "\fBannex.debug\fP"
تنظیم روی true برای فعال کردن ثبت لاگ‌های اشکال‌زدایی (debug) به صورت پیش‌فرض.
.IP
.IP "\fBannex.debugfilter\fP"
برای پیکربندی اینکه کدام پیام‌های اشکال‌زدایی نمایش داده شوند (هنگامی که نمایش پیام اشکال‌زدایی توسط annex.debug یا \-\-debug فعال شده است) تنظیم می‌شود. مقدار آن یک یا چند نام ماژول است که با کاما از هم جدا شده‌اند.
.IP
.IP "\fBannex.version\fP"
نسخه فعلی مخزن git-annex. این مورد توسط git-annex نگهداری می‌شود و هرگز نباید به صورت دستی تغییر کند.
.IP
.IP "\fBannex.autoupgraderepository\fP"
هنگامی که یک نسخه قدیمی از مخزن git-annex دیگر پشتیبانی نمی‌شود، git-annex به طور معمول مخزن را به طور خودکار به نسخه جدید ارتقا می‌دهد. همچنین ممکن است گاهی از یک نسخه قدیمی مخزن که هنوز پشتیبانی می‌شود اما به خوبی نسخه جدیدتر نیست، ارتقا یابد.
.IP
اگر این مقدار روی false تنظیم شود، git-annex مخزن را به طور خودکار ارتقا نخواهد داد. اگر نسخه مخزن پشتیبانی نشود، git-annex در عوض با یک پیام خطا خارج می‌شود. اگر هنوز پشتیبانی شود، git-annex به کار خود ادامه خواهد داد.
.IP
زمانی که آماده ارتقای مخزن شدید، می‌توانید خودتان \fBgit annex upgrade\fP را اجرا کنید.
.IP
.IP "\fBannex.crippledfilesystem\fP"
اگر مخزن روی یک سیستم فایل ناقص (crippled filesystem) مانند FAT قرار دارد که از پیوندهای نمادین، پیوندهای سخت یا مجوزهای یونیکس پشتیبانی نمی‌کند، روی true تنظیم کنید. این مورد توسط "git annex init" به صورت خودکار شناسایی و بررسی می‌شود.
.IP
.IP "\fBannex.pidlock\fP"
به طور معمول، git-annex از فایل‌های قفل‌گذاری دقیق (fine\-grained lock files) استفاده می‌کند تا به چندین فرآیند اجازه دهد به صورت همزمان بدون تداخل با یکدیگر اجرا شوند. این به خوبی کار می‌کند، مگر اینکه از git-annex روی سیستم فایلی استفاده کنید که از قفل‌های fcntl در استاندارد POSIX پشتیبانی نمی‌کند. این موضوع گاهی اوقات هنگام استفاده از سیستم‌های فایل NFS یا Lustre رخ می‌دهد.
.IP
برای پشتیبانی از چنین شرایطی، می‌توانید annex.pidlock را روی true تنظیم کنید و به یک قفل تک‌فایلی pid در بالاترین سطح بازخواهد گشت.
.IP
اگرچه در بیشتر موارد واقعاً بهتر است پیکربندی سیستم فایل شبکه‌ای خود را طوری اصلاح کنید که از قفل‌های POSIX پشتیبانی کند.. و همچنین برخی از سیستم‌های فایل شبکه‌ای آن‌قدر ناهماهنگ هستند که یک گره نمی‌تواند به طور قابل اعتمادی تشخیص دهد گره دیگر چه زمانی قفل pid را در اختیار دارد. مسئولیت ریسک با خودتان است (Caveat emptor).
.IP
.IP "\fBannex.pidlocktimeout\fP"
ابزار git-annex تا این تعداد ثانیه منتظر می‌ماند تا فایل قفل pid ناپدید شود و در صورت عدم امکان ادامه کار، عملیات را لغو می‌کند. مقدار پیش‌فرض: ۳۰۰
.IP
هنگام استفاده از فایل‌های قفل pid، این احتمال وجود دارد که یک فایل قفل کهنه (stale) از اجرای قبلی git-annex که متوقف یا مختل شده است باقی بماند. از این حالت عمدتاً جلوگیری می‌شود، اما می‌تواند به ویژه هنگام استفاده از یک سیستم فایل شبکه‌ای رخ دهد. این زمان انقضا (timeout) مانع از انتظار همیشگی git-annex در چنین شرایطی می‌شود.
.IP
.IP "\fBannex.dbdir\fP"
پوشه‌ای که git-annex باید پایگاه‌های داده sqlite خود را در آن ذخیره کند. مکان پیش‌فرض درون \fB.git/annex/\fP است.
.IP
برخی سیستم‌های فایل، مانند cifs، ممکن است از عملیات قفل‌گذاری که sqlite به آن نیاز دارد پشتیبانی نکنند و تنظیم این گزینه روی پوشه‌ای در سیستم فایل دیگر می‌تواند این مشکل را دور بزند.
.IP
می‌توان این مورد را در پیکربندی چندین مخزن با اطمینان روی یک پوشه یکسان تنظیم کرد؛ هر مخزن از یک زیرپوشه برای پایگاه داده sqlite خود استفاده خواهد کرد.
.IP
.IP "\fBannex.cachecreds\fP"
هنگامی که روی "true" باشد (پیش‌فرض)، git-annex اطلاعات هویتی و اعتبارسنجی مورد استفاده برای دسترسی به ریموت‌های ویژه را در فایل‌هایی در .git/annex/creds/ که فقط شما می‌توانید بخوانید کَش می‌کند. برای غیرفعال کردن این ذخیره‌سازی، آن را روی "false" تنظیم کنید و اطلاعات اعتبارسنجی فقط از متغیرهای محیطی خوانده می‌شوند یا در صورتی که به صورت رمزگذاری‌شده در مخزن git تعبیه شده باشند، هر بار که git-annex نیاز به دسترسی به ریموت داشته باشد استخراج و رمزگشایی خواهند شد.
.IP
.IP "\fBannex.secure\-erase\-command\fP"
می‌توان این گزینه را روی دستوری تنظیم کرد که باید هر زمان که git-annex محتوای یک فایل را از مخزن حذف می‌کند، اجرا شود.
.IP
در خط فرمان، %file با فایلی که باید پاک شود جایگزین می‌گردد.
.IP
به عنوان مثال، برای استفاده از دستور wipe، آن را روی \fBwipe \-f %file\fP تنظیم کنید.
.IP
به جای تنظیم در git config، می‌توان یک اسکریپت قلاب را در \fB.git/hooks/secure\-erase\-annex\fP نصب کرد. فایلی که باید پاک شود به عنوان تنها پارامتر به قلاب داده می‌شود.
.IP
.IP "\fBannex.freezecontent\-command\fP, \fBannex.thawcontent\-command\fP"
معمولاً بیت‌های مجوز نوشتن برای محافظت از اشیای پیوست‌شده در برابر تغییر یا حذف برداشته می‌شوند. Freezecontent پس از اینکه git-annex بیت نوشتن را حذف کرد (یا برای حذف آن تلاش نمود) اجرا می‌شود و می‌تواند برای جلوگیری از نوشتن به روش دیگری استفاده شود. Thawcontent باید اثر آن را خنثی کند و قبل از اینکه git-annex بیت نوشتن را بازیابی کند اجرا می‌شود.
.IP
در خط فرمان، %path با فایل یا پوشه‌ای که باید روی آن عملیات انجام شود جایگزین می‌گردد.
.IP
(هنگامی که annex.crippledfilesystem تنظیم شده باشد، git-annex تلاشی برای حذف/بازیابی بیت نوشتن نمی‌کند، اما همچنان freezecontent و thawcontent را اجرا خواهد کرد.)
.IP
به جای تنظیم در git config، می‌توان اسکریپت‌های قلاب را در \fB.git/hooks/freezecontent\-annex\fP و \fB.git/hooks/thawcontent\-annex\fP نصب کرد. فایل یا پوشه‌ای که باید روی آن عملیات انجام شود به عنوان تنها پارامتر به قلاب داده می‌شود.
.IP
.IP "\fBannex.tune.objecthash1\fP, \fBannex.tune.objecthashlower\fP, \fBannex.tune.branchhash1\fP"
این موارد را می‌توان برای تنظیم دقیق مخزن به \fBgit annex init\fP ارسال کرد. تغییر آنها در یک مخزن فعال ایمن نیست و هرگز نباید در پیکربندی سراسری git تنظیم شوند. برای جزئیات به <https://git-annex.branchable.com/tuning> مراجعه کنید.
.IP
.IP "\fBannex.cluster.<name>\fP"
این گزینه برای تبدیل مخزن به یک درگاه (gateway) به یک کلاستر تنظیم می‌شود. مقدار آن UUID کلاستر است. توجه داشته باشید که UUIDهای کلاستر با UUIDهای مخزن یکسان نیستند و نمی‌توان از UUID مخزن در اینجا استفاده کرد.
.IP
معمولاً این مورد با اجرای git-annex\-initcluster یا git-annex\-extendcluster راه‌اندازی می‌شود.
.IP
.SH "پیکربندی ریموت‌ها (CONFIGURATION OF REMOTES)"
ریموت‌ها با استفاده از این تنظیمات در \fB.git/config\fP پیکربندی می‌شوند.
.PP
.IP "\fBremote.<name>.annex\-cost\fP"
هنگام تعیین اینکه فایل‌های پیوست‌شده از یا به کدام مخزن انتقال یابند، مخازنی با هزینه کمتر ترجیح داده می‌شوند. هزینه پیش‌فرض برای مخازن محلی ۱۰۰ و برای مخازن دوردست (remote) ۲۰۰ است.
.IP
.IP "\fBremote.<name>.annex\-cost\-command\fP"
در صورت تنظیم، این دستور اجرا شده و عددی که در خروجی می‌دهد به عنوان هزینه استفاده می‌شود. این امر اجازه می‌دهد هزینه بر اساس مواردی مانند شبکه فعلی تغییر کند.
.IP
.IP "\fBremote.<name>.annex\-start\-command\fP"
دستوری که هنگام شروع استفاده git-annex از ریموت اجرا می‌شود. از این دستور می‌توان به عنوان مثال برای سوار کردن (mount) پوشه حاوی ریموت استفاده کرد.
.IP
هنگامی که چندین فرآیند git-annex به صورت همزمان در حال اجرا هستند، این دستور ممکن است به دفعات مکرر اجرا شود.
.IP
.IP "\fBremote.<name>.annex\-stop\-command\fP"
دستوری که پس از اتمام استفاده git-annex از ریموت اجرا می‌شود.
.IP
این دستور تنها زمانی اجرا خواهد شد که *تمامی* فرآیندهای در حال اجرای git-annex کار با ریموت را به پایان رسانده باشند.
.IP
.IP "\fBremote.<name>.annex\-shell\fP"
به جای جستجو برای "git-annex\-shell" در PATH، یک فایل اجرایی جایگزین برای git-annex\-shell در سیستم دوردست مشخص می‌کند.
.IP
این گزینه در صورتی مفید است که برنامه git-annex\-shell خارج از PATH قرار داشته باشد یا دارای نامی غیر استاندارد باشد.
.IP
.IP "\fBremote.<name>.annex\-ignore\fP"
اگر روی \fBtrue\fP تنظیم شود، به طور پیش‌فرض از ذخیره یا بازیابی محتوای فایل‌های پیوست‌شده در این ریموت توسط git-annex جلوگیری می‌کند. (هنوز می‌توانید با گزینه‌های \fB\-\-from\fP و \fB\-\-to\fP درخواست استفاده از آن را بدهید.)
.IP
این گزینه برای مثال زمانی مفید است که ریموت در جایی قرار دارد که فاقد git-annex\-shell است. (به عنوان مثال اگر روی GitHub باشد). یا در صورتی که اتصال شبکه بین دو مخزن برای استفاده عادی بیش از حد کند باشد، می‌تواند استفاده شود.
.IP
این تنظیم مانع از کارکرد \fBgit-annex sync\fP، \fBgit-annex pull\fP، \fBgit-annex push\fP، \fBgit-annex assist\fP یا \fBgit-annex assistant\fP روی مخزن git نمی‌شود؛ فقط روی محتوای پیوست‌شده تأثیر می‌گذارد.
.IP
.IP "\fBremote.<name>.annex\-ignore\-command\fP"
در صورت تنظیم، این دستور اجرا می‌شود و اگر با وضعیت غیرصفر خارج شود، مشابه تنظیم annex\-ignore روی true است. این امکان کنترل رفتار را بر اساس مواردی مانند شبکه فعلی فراهم می‌سازد.
.IP
.IP "\fBremote.<name>.annex\-sync\fP"
اگر روی \fBfalse\fP تنظیم شود، از کارکرد \fBgit-annex sync\fP (و \fBgit-annex pull\fP، \fBgit-annex push\fP، \fBgit-annex assist\fP و \fBgit-annex assistant\fP) روی این ریموت به طور پیش‌فرض جلوگیری می‌کند.
.IP
.IP "\fBremote.<name>.annex\-sync\-command\fP"
در صورت تنظیم، این دستور اجرا می‌شود و اگر با وضعیت غیرصفر خارج شود، مشابه تنظیم annex\-sync روی false است. این امکان کنترل رفتار را بر اساس مواردی مانند شبکه فعلی فراهم می‌سازد.
.IP
.IP "\fBremote.<name>.annex\-pull\fP"
اگر روی \fBfalse\fP تنظیم شود، از pull (یا دریافت) کردن \fBgit-annex pull\fP، \fBgit-annex sync\fP، \fBgit-annex assist\fP و \fBgit-annex assistant\fP از این ریموت به طور کامل جلوگیری می‌کند.
.IP
.IP "\fBremote.<name>.annex\-push\fP"
اگر روی \fBfalse\fP تنظیم شود، از push کردن \fBgit-annex push\fP، \fBgit-annex sync\fP، \fBgit-annex assist\fP و \fBgit-annex assistant\fP به این ریموت به طور کامل جلوگیری می‌کند.
.IP
.IP "\fBremote.<name>.annex\-readonly\fP"
اگر روی \fBtrue\fP تنظیم شود، از اعمال هرگونه تغییر توسط git-annex روی یک ریموت جلوگیری می‌کند. این تنظیم مانع از ارسال (push) تغییرات توسط \fBgit-annex sync\fP و \fBgit-annex assist\fP به یک مخزن git می‌شود. همچنین از ذخیره‌سازی یا حذف فایل‌ها از ریموت فقط‌خواندنی جلوگیری می‌نماید.
.IP
.IP "\fBremote.<name>.annex\-verify\fP, \fBannex.verify\fP"
به طور پیش‌فرض، git-annex چِک‌سام‌های اشیای بارگیری‌شده از ریموت‌ها را اعتبارسنجی می‌کند. اگر به یک ریموت اعتماد دارید و سربار ناشی از این بررسی چِک‌سام‌ها را نمی‌خواهید، می‌توانید این گزینه را روی \fBfalse\fP تنظیم کنید.
.IP
توجه داشته باشید که حتی زمانی که این گزینه روی \fBfalse\fP تنظیم شده باشد، git-annex در برخی شرایط خاص (مانند حالتی که احتمال دارد شیء به صورت نادرست بارگیری شده باشد، یا در صورت نیاز برای امنیت) اعتبارسنجی را انجام می‌دهد.
.IP
.IP "\fBremote.<name>.annex\-fastcopy\fP, \fBannex.fastcopy\fP"
برای بهینه‌سازی کپی کردن فایل‌ها به/از یک ریموت، روی "true" تنظیم کنید.
.IP
تنظیم این گزینه به \fBcp\fP اجازه می‌دهد از فراخوان سیستمی \fBcopy_file_range\fP استفاده کند (در صورتی که دستور \fBcp\fP از آن پشتیبانی کند). میزان مزیت به سیستم فایل بستگی دارد. برای مثال در NFS این می‌تواند اجازه دهد یک کپی سمت سرور انجام شود. در ext4 این مورد از برخی سربارهای انتقال حافظه جلوگیری می‌کند، اما فایل همچنان باید کپی شود. در btrfs مزیتی ندارد، زیرا git-annex به طور پیش‌فرض پیوند مجدد CoW با همان سرعت را در btrfs انجام می‌دهد.
.IP
این گزینه در صورتی که git-annex نیاز به خواندن فایل کپی‌شده به منظور اعتبارسنجی آن داشته باشد، کمک چندانی به بهبود سرعت کپی نخواهد کرد. بنابراین برای حداکثر سرعت، علاوه بر تنظیم این گزینه، \fBremote.<name>.annex\-verify\fP یا \fBannex.verify\fP را روی false قرار دهید.
.IP
در حال حاضر تنظیم این گزینه از ادامه کپی‌های متوقف‌شده از جایی که رها شده‌اند جلوگیری می‌کند؛ یک کپی متوقف‌شده دوباره از ابتدا اجرا خواهد شد.
.IP
.IP "\fBremote.<name>.annex\-tracking\-branch\fP"
این گزینه برای استفاده با ریموت‌های ویژه است که از صادرات (export) و واردات (import) پشتیبانی می‌کنند.
.IP
هنگامی که مثلاً روی "master" تنظیم شود، به git-annex می‌گوید که می‌خواهید ریموت ویژه آن شاخه را دنبال (track) کند.
.IP
هنگامی که مثلاً روی "master:subdir" تنظیم شود، ریموت ویژه فقط زیرپوشه آن شاخه را دنبال می‌کند.
.IP
تنظیم این گزینه به برخی دستورات دیگر امکان کار با این ریموت‌های ویژه را می‌دهد: دستور \fBgit-annex pull\fP تغییرات را از ریموت وارد کرده و آنها را در annex\-tracking\-branch ادغام می‌کند. و \fBgit-annex push\fP تغییرات را به ریموت صادر می‌کند. دستورات سطح بالاتر شامل \fBgit-annex sync \-\-content\fP و \fBgit-annex assist\fP هم واردات و هم صادرات را انجام می‌دهند.
.IP
.IP "\fBremote.<name>.annex\-export\-tracking\fP"
نام منسوخ‌شده برای \fBremote.<name>.annex\-tracking\-branch\fP. چنانچه این گزینه پیکربندی شده باشد و \fBremote.<name>.annex\-tracking\-branch\fP تنظیم نشده باشد، همچنان استفاده خواهد شد.
.IP
.IP "\fBremote.<name>.annexUrl\fP"
می‌تواند برای مشخص کردن یک url متفاوت از \fBremote.<name>.url\fP معمولی به کار رود تا git-annex برای دسترسی به ریموت از آن استفاده کند؛ مشابه \fBpushUrl\fP مورد استفاده توسط git\-push.
.IP
هنگامی که این گزینه روی یک نشانی annex+http یا annex+https تنظیم شود، آن url فقط برای عملیات git-annex استفاده می‌شود و از \fBremote.<name>.url\fP برای عملیات گیت استفاده خواهد شد. این کار اجازه می‌دهد با استفاده از git-annex\-p2phttp یک مخزن git-annex را از طریق http سرویس‌دهی کرد.
.IP
هنگامی که این گزینه و \fBremote.<name>.url\fP شامل یک نام میزبان یکسان باشند، و این گزینه یک نشانی annex+http(s) و آن یکی نیز یک نشانی http(s) باشد، git-annex فرض می‌کند که می‌توان از همان نام کاربری و گذرواژه برای هر دو url استفاده کرد. هنگامی که حافظه موقت گذرواژه پیکربندی شده باشد، این امکان فراهم می‌شود که در هنگام استفاده هم‌زمان از git و git-annex تنها یک بار برای دریافت گذرواژه از شما درخواست شود. برای نحوه راه‌اندازی کشینگ گذرواژه به gitcredentials(7) مراجعه کنید.
.IP
.IP "\fBurl.<base>.annexInsteadOf\fP"
این گزینه مشابه \fBurl.<base>.pushInsteadOf\fP در گیت عمل می‌کند و نشانی ریموتی را که با مقدار این پیکربندی آغاز می‌شود بازنویسی می‌کند تا به جای آن با \fB<base>\fP آغاز شود.
.IP
نشانی بازنویسی‌شده توسط git-annex برای دسترسی به ریموت استفاده می‌شود و همانند \fBremote.<name>.annexUrl\fP عمل می‌کند، از جمله پشتیبانی از نشانی‌های annex+http.
.IP
توجه داشته باشید که git-annex از پیکربندی \fBurl.<base>.insteadOf\fP گیت نیز پشتیبانی می‌کند. هنگامی که هر دو تنظیم شده باشند، ابتدا نشانی ریموت توسط insteadOf بازنویسی می‌شود و سپس آن نشانی بازنویسی‌شده می‌تواند مجدداً با استفاده از annexInsteadOf بازنویسی شود.
.IP
.IP "\fBremote.<name>.annex\-uuid\fP"
ابزار git-annex شناسه‌های یکتای جهانی (UUID) مخازن ریموت را در اینجا کش می‌کند.
.IP
.IP "\fBremote.<name>.annex\-config\-uuid\fP"
برای برخی ریموت‌های ویژه استفاده می‌شود و به پیکربندی ریموت ویژه متفاوتی اشاره می‌کند که باید مورد استفاده قرار گیرد.
.IP
.IP "\fBremote.<name>.annex\-retry\fP, \fBannex.retry\fP"
تعداد دفعاتی که می‌توان یک انتقال ناموفق را مجدداً تلاش کرد. (پیش‌فرض 0)
.IP
.IP "\fBremote.<name>.annex\-forward\-retry\fP, \fBannex.forward\-retry\fP"
اگر یک انتقال پیش از شکست مقداری پیشرفت رو به جلو داشته باشد، این گزینه اجازه می‌دهد حتی زمانی که \fBannex.retry\fP اجازه نمی‌دهد، دوباره تلاش شود. مقدار آن حداکثر دفعات انجام این کار است. (پیش‌فرض 5)
.IP
هنگامی که هم \fBannex.retry\fP و هم این گزینه تنظیم شده باشند، حداکثر تعداد تلاش مجدد مقدار بزرگ‌تر میان این دو است.
.IP
.IP "\fBremote.<name>.annex\-retry\-delay\fP, \fBannex.retry\-delay\fP"
تعداد ثانیه‌های تاخیر پیش از نخستین تلاش مجدد برای یک انتقال. هنگام انجام تلاش‌های مجدد چندگانه برای همان انتقال، این تاخیر پس از هر بار تلاش دو برابر می‌شود. (پیش‌فرض 1)
.IP
.IP "\fBremote.<name>.annex\-bwlimit\fP, \fBannex.bwlimit\fP"
این گزینه می‌تواند برای محدود کردن میزان پهنای باند مصرفی جهت انتقال از یا به یک ریموت به کار رود.
.IP
برای نمونه، جهت محدود کردن انتقال‌ها به ۱ مبی‌بایت بر ثانیه:
\fBgit config annex.bwlimit "1MiB"\fP
.IP
این تنظیم با بسیاری از ریموت‌ها، از جمله ریموت‌های گیت، کار خواهد کرد اما نه برای ریموت‌هایی که در آن‌ها فرایند انتقال توسط برنامه‌ای جداگانه از git-annex اجرا می‌شود.
.IP
.IP "\fBremote.<name>.annex\-bwlimit\-download\fP, \fBannex.bwlimit\-download\fP"
محدود کردن پهنای باند برای دانلودها از یک ریموت.
.IP
تنظیمات \fBremote.<name>.annex\-bwlimit\fP و \fBannex.bwlimit\fP را لغو می‌کند.
.IP
.IP "\fBremote.<name>.annex\-bwlimit\-upload\fP, \fBannex.bwlimit\-upload\fP"
محدود کردن پهنای باند برای آپلودها به یک ریموت.
.IP
تنظیمات \fBremote.<name>.annex\-bwlimit\fP و \fBannex.bwlimit\fP را لغو می‌کند.
.IP
.IP "\fBremote.<name>.annex\-stalldetection\fP, \fBannex.stalldetection\fP"
پیکربندی این گزینه اجازه می‌دهد انتقال‌های متوقف‌شده یا بیش از حد کُند شناسایی شده و به آن‌ها رسیدگی شود، به‌طوری که git-annex به جای گیر کردن، عملیات متوقف‌شده را لغو کند. این انتقال به عنوان ناموفق تلقی خواهد شد، بنابراین تنظیماتی مانند annex.retry رفتار بعدی آن را کنترل می‌کنند.
.IP
حالت پیش‌فرض این است که انتقال‌هایی را که احتمالاً متوقف شده‌اند به‌طور خودکار شناسایی کرده و پیکربندی این گزینه را پیشنهاد دهد، اما عملیات متوقف‌شده را لغو نکند. برای کارکرد این قابلیت، ریموت باید وضعیت پیشرفت خود را به‌طور پیوسته به‌روزرسانی کند. ریموت‌هایی که این کار را نمی‌کنند، مشمول تشخیص خودکار توقف نخواهند شد. همچنین در استفاده از تشخیص خودکار توقف، ممکن است مدتی طول بکشد تا git-annex تصمیم بگیرد که یک ریموت واقعاً متوقف شده است، چرا که باید در تشخیص توقف جانب احتیاط را رعایت کند.
.IP
جهت پرهیز از هرگونه تلاش برای تشخیص توقف، مقدار آن را روی "false" تنظیم کنید.
.IP
برای تشخیص و لغو انتقال‌های متوقف‌شده، این گزینه را روی مقداری به شکل "$amount/$timeperiod" تنظیم کنید که حداقل مقدار داده‌ای را که git-annex در یک بازه زمانی معین انتظار جریان آن را دارد مشخص می‌سازد.
.IP
برای نمونه، جهت تشخیص توقف‌های کامل که پس از ۳۰ ثانیه هیچ داده‌ای منتقل نشده است: \fBgit config annex.stalldetection "1KB/30s"\fP
.IP
یا اگر ریموتی روی یک حافظه USB دارید که معمولاً قادر به انتقال چندین مگابایت بر ثانیه است، اما بدسکتورهایی دارد که در آن‌ها برای مدت طولانی گیر می‌کند، می‌توانید از دستور زیر استفاده کنید:
\fBgit config remote.usbdrive.annex\-stalldetection "1MB/1m"\fP
.IP
برخی ریموت‌ها پیشرفت انتقال را گزارش نمی‌کنند و هنگام استفاده از آن‌ها امکان تشخیص توقف وجود ندارد.
.IP
برخی ریموت‌ها گزارش پیشرفت را تنها گهگاه ارائه می‌دهند، برای نمونه پس از هر قطعه (chunk). برای پرهیز از هشدارهای کاذب وقفه زمانی (timeout) در چنین شرایطی، اگر دریافت اولین به‌روزرسانی پیشرفت بیشتر از بازه زمانی پیکربندی‌شده طول بکشد، تشخیص توقف به‌طور خودکار تنظیم می‌شود تا از بازه زمانی طولانی‌تری استفاده کند. برای نمونه، اگر اولین گزارش پیشرفت پس از ۱۰ دقیقه برسد، اما مقدار annex.stalldetection برابر با "1MB/1m" باشد، به عنوان نمونه به صورت "30MB/30m" در نظر گرفته خواهد شد.
.IP
پیکربندی تشخیص توقف می‌تواند موجب استفاده بیشتر git-annex از منابع شود. برای امکان‌پذیر ساختن لغو توقف‌ها، git-annex باید انتقال‌ها را در فرایندهای جداگانه‌ای اجرا کند (یک فرایند به ازای هر وظیفه هم‌زمان). بنابراین ممکن است نیاز به باز کردن اتصالات بیشتری نسبت به معمول به ریموت داشته باشد، یا ارتباط با آن فرایندها سرعت آن را کمی کاهش دهد.
.IP
.IP "\fBremote.<name>.annex\-stalldetection\-download\fP, \fBannex.stalldetection\-download\fP"
تشخیص توقف برای دریافت‌ها (دانلودها) از یک ریموت.
.IP
برای نمونه، اگر ریموتی اغلب سریع است، اما گاهی بسیار کُند می‌شود، و ریموت دیگری وجود دارد که به‌طور پیوسته سرعت متوسطی دارد و حاوی همان داده‌ها است، می‌توان این گزینه را طوری تنظیم کرد که در هنگام کُند شدن ریموت سریع، آن را متوقف‌شده در نظر بگیرد. سپس دستوری مانند \fBgit-annex get\fP برای دانلود به ریموت با سرعت متوسط رجوع خواهد کرد.
.IP
تنظیمات \fBremote.<name>.annex\-stalldetection\fP و \fBannex.stalldetection\fP را لغو می‌کند.
.IP
.IP "\fBremote.<name>.annex\-stalldetection\-upload\fP, \fBannex.stalldetection\-upload\fP"
تشخیص توقف برای بارگذاری‌ها (آپلودها) به یک ریموت.
.IP
تنظیمات \fBremote.<name>.annex\-stalldetection\fP و \fBannex.stalldetection\fP را لغو می‌کند.
.IP
.IP "\fBremote.<name>.annex\-checkuuid\fP"
این گزینه تنها بر ریموت‌هایی اثر می‌گذارد که نشانی آن‌ها به یک پوشه روی همان سیستم اشاره دارد. ابزار git-annex معمولاً در هر بار اجرا شناسه یکتای (uuid) چنین ریموت‌هایی را بررسی می‌کند، که به آن امکان می‌دهد با درایوهای گوناگونی که در زمان‌های مختلف در آن مکان متصل (mount) می‌شوند، به‌طور شفاف کار کند.
.IP
تنظیم annex\-checkuuid روی false مانع از بررسی uuid در هنگام راه‌اندازی می‌شود (اگرچه uuid پیش از اعمال هرگونه تغییر در مخزن ریموت همچنان تایید می‌شود). این گزینه ممکن است برای جلوگیری از چرخش غیرضروری دیسک (spin-up) یا اتصال خودکار یک درایو مفید باشد.
.IP
.IP "\fBremote.<name>.annex\-trustlevel\fP"
سطح اعتماد محلی را برای ریموت پیکربندی می‌کند. این گزینه مقداری را که با دستورات trust و untrust پیکربندی شده است لغو می‌کند. مقدار آن می‌تواند هر یک از مقادیر "trusted"، "semitrusted" یا "untrusted" باشد.
.IP
.IP "\fBremote.<name>.annex\-speculate\-present\fP"
روی "true" تنظیم کنید تا git-annex فرض کند این ریموت ممکن است حاوی محتوای هر فایلی باشد، حتی با اینکه ردیابی موقعیت مکانی عادی آن نشان ندهد که فایل موجود است. این کار سبب می‌شود git-annex تلاش کند محتوای تمام فایل‌ها را از این ریموت دریافت کند. می‌تواند در راه‌اندازی یک ریموت حافظه موقت (caching) سودمند باشد.
.IP
.IP "\fBremote.<name>.annex\-proxy\fP"
روی "true" تنظیم کنید تا مخزن محلی بتواند به عنوان یک پراکسی برای این ریموت عمل کند. این ریموت می‌تواند یک مخزن git-annex یا یک ریموت ویژه باشد.
.IP
پس از پیکربندی این گزینه، دستور git-annex\-updateproxy(1) را اجرا کنید تا پیکربندی جدید در شاخه git-annex ذخیره شود.
.IP
.IP "\fBremote.<name>.annex\-proxied\-by\fP"
معمولاً این گزینه به صورت درونی و هنگام راه‌اندازی ریموت‌های پراکسی‌شده توسط git-annex استفاده می‌شود و نیازی به پیکربندی دستی نخواهد داشت. مقدار آن شناسه یکتای جهانی (UUID) مخزن git-annex است که دسترسی به این ریموت را پراکسی می‌کند.
.IP
.IP "\fBremote.<name>.annex\-cluster\-node\fP"
روی نام یک کلاستر تنظیم کنید تا این ریموت بخشی از آن کلاستر شود. نام چندین کلاستر را می‌توان با فاصله از یکدیگر جدا کرد تا یک ریموت بخشی از بیش از یک کلاستر باشد.
.IP
پس از پیکربندی این گزینه، دستور git-annex\-updatecluster(1) را اجرا کنید تا پیکربندی جدید در شاخه git-annex ذخیره شود.
.IP
.IP "\fBremote.<name>.annex\-cluster\-gateway\fP"
روی UUID کلاستری تنظیم می‌شود که این ریموت به عنوان یک درگاه (gateway) برای آن عمل می‌کند. می‌توان چندین UUID را که با فاصله از هم جدا شده‌اند فهرست کرد. هنگامی که مخزن محلی نیز یک درگاه برای آن کلاستر باشد، به عنوان پراکسی برای گره‌های درگاه ریموت عمل خواهد کرد.
.IP
معمولاً این مورد با اجرای git-annex\-extendcluster راه‌اندازی می‌شود.
.IP
.IP "\fBremote.<name>.annex\-private\fP"
هنگامی که این گزینه روی true تنظیم شود، هیچ اطلاعاتی در مورد این ریموت در شاخه git-annex ثبت نخواهد شد. این قابلیت عمدتاً برای ریموت‌های ویژه کاربرد دارد و هنگام استفاده از git-annex\-initremote(1) به همراه گزینه \fB\-\-private\fP تنظیم می‌شود.
.IP
.IP "\fBremote.<name>.annex\-max\-git\-bundles\fP, \fBannex.max\-git\-bundles\fP"
هنگام استفاده از git\-remote\-annex برای ذخیره یک مخزن گیت در یک ریموت ویژه، این گزینه مشخص می‌کند که پیش از آپلود مجدد یک بسته (bundle) واحد گیت حاوی کل مخزن گیت، چه تعداد شیء باندل گیت جداگانه در ریموت ویژه ذخیره شود.
.IP
مقدار پیش‌فرض 100 است که هدف از آن پرهیز از نیاز به آپلود مجدد مکرر است، در حالی که مانع از نیاز کلون یا واکشی (fetch) به دانلود اشیاء بیش از حد زیاد می‌شود. برای غیرفعال کردن آپلود مجدد، آن را روی 0 تنظیم کنید.
.IP
.IP "\fBremote.<name>.annex\-allow\-encrypted\-gitrepo\fP"
تنظیم این گزینه روی true امکان استفاده از git\-remote\-annex را برای ارسال (push) مخزن گیت به یک ریموت ویژه رمزگذاری‌شده فراهم می‌سازد.
.IP
این کار به‌طور پیش‌فرض مجاز نیست، زیرا دستور git clone از یک ریموت ویژه رمزگذاری‌شده غیرممکن است، چرا که به کلیدهای رمزگذاری ذخیره‌شده در ریموت نیاز دارد. بنابراین دقت کنید در صورت فعال‌سازی این تنظیم، به اینکه ریموت ویژه رمزگذاری‌شده تنها نسخه از مخزن گیت شما باشد اتکا نکنید.
.IP
.IP "\fBremote.<name>.annex\-bare\fP"
می‌تواند برای اعلام به git-annex درباره اینکه آیا یک ریموت یک مخزن bare است یا خیر به کار رود. به‌طور معمول، git-annex این موضوع را به‌صورت خودکار تشخیص می‌دهد.
.IP
.IP "\fBremote.<name>.annex\-availability\fP"
این تنظیم پیکربندی دیگر استفاده نمی‌شود.
.IP
.IP "\fBremote.<name>.annex\-ssh\-options\fP, \fBannex.ssh\-options\fP"
گزینه‌هایی که هنگام استفاده از ssh برای برقراری ارتباط با این ریموت به کار می‌روند.
.IP
.IP "\fBremote.<name>.annex\-rsync\-options\fP, \fBannex.rsync\-options\fP"
گزینه‌های مورد استفاده هنگام استفاده از rsync به یا از این ریموت. برای نمونه، جهت اجبار به استفاده از IPv6 و محدود کردن پهنای باند به 100 کیلوبایت بر ثانیه، آن را روی \fB\-6 \-\-bwlimit 100\fP تنظیم کنید.
.IP
توجه داشته باشید که git-annex\-shell فهرست مجازی از گزینه‌های مجاز rsync دارد و سایر گزینه‌ها به rsync ریموت ارسال نخواهند شد. بنابراین استفاده از برخی گزینه‌ها ممکن است ارتباط میان rsyncهای محلی و ریموت را مختل کند.
.IP
.IP "\fBremote.<name>.annex\-rsync\-upload\-options\fP, \fBannex.rsync\-upload\-options\fP"
گزینه‌هایی که هنگام استفاده از rsync برای بارگذاری (آپلود) یک فایل به یک ریموت به کار می‌روند.
.IP
این گزینه‌ها پس از سایر گزینه‌های کاربردی rsync اعمال می‌شوند، بنابراین می‌توانند برای لغو آن‌ها استفاده شوند. برای نمونه، جهت محدود کردن پهنای باند آپلود به 10 کیلوبایت بر ثانیه، گزینه \fB\-\-bwlimit 10\fP را تنظیم کنید.
.IP
.IP "\fBremote.<name>.annex\-rsync\-download\-options\fP, \fBannex.rsync\-download\-options\fP"
گزینه‌هایی که هنگام استفاده از rsync برای دریافت (دانلود) یک فایل از یک ریموت به کار می‌روند.
.IP
این گزینه‌ها پس از سایر گزینه‌های کاربردی rsync اعمال می‌شوند، بنابراین می‌توانند برای لغو آن‌ها به کار روند.
.IP
.IP "\fBremote.<name>.annex\-rsync\-transport\fP"
پوسته ریموتی که برای اتصال به ریموت rsync استفاده می‌شود. مقادیر ممکن عبارتند از \fBssh\fP (پیش‌فرض) و \fBrsh\fP، به همراه آرگومان‌های آن‌ها؛ برای نمونه \fBssh \-p 2222 \-c blowfish\fP؛ توجه داشته باشید که نام میزبان ریموت نباید در آنجا درج شود، برای جزئیات به rsync(1) مراجعه کنید. هنگامی که حامل مورد استفاده \fBssh\fP باشد، اتصالات به‌طور خودکار کش می‌شوند مگر اینکه \fBannex.sshcaching\fP لغو شده باشد.
.IP
.IP "\fBremote.<name>.annex\-bup\-split\-options\fP, \fBannex.bup\-split\-options\fP"
گزینه‌هایی که هنگام ذخیره محتوا در این ریموت به bup split ارسال می‌شوند. برای نمونه، جهت محدود کردن پهنای باند به 100 کیلوبایت بر ثانیه، آن را روی \fB\-\-bwlimit 100k\fP تنظیم کنید. (هیچ گزینه متناظری برای bup join وجود ندارد.)
.IP
.IP "\fBremote.<name>.annex\-gnupg\-options\fP, \fBannex.gnupg\-options\fP"
گزینه‌هایی که هنگام رمزگذاری داده‌ها به GnuPG ارسال می‌شوند. برای نمونه، جهت استفاده از رمزنگاری AES با یک کلید ۲۵۶ بیتی و غیرفعال کردن فشرده‌سازی، آن را روی \fB\-\-cipher\-algo AES256 \-\-compress\-algo none\fP تنظیم کنید. (این گزینه‌ها بر پیکربندی پیش‌فرض GnuPG که در غیر این صورت استفاده می‌شود، اولویت دارند.)
.IP
.IP "\fBremote.<name>.annex\-gnupg\-decrypt\-options\fP, \fBannex.gnupg\-decrypt\-options\fP"
گزینه‌هایی که هنگام رمزگشایی داده‌ها به GnuPG ارسال می‌شوند. (این گزینه‌ها بر پیکربندی پیش‌فرض GnuPG که در غیر این صورت استفاده می‌شود، اولویت دارند.)
.IP
.IP "\fBremote.<name>.annex\-shared\-sop\-command\fP, \fBannex.shared\-sop\-command\fP"
از این دستور، که پیاده‌سازی رابط خط فرمان Stateless OpenPGP است، به جای GnuPG برای رمزگذاری و رمزگشایی داده‌ها استفاده می‌کند. این گزینه تنها زمانی به کار می‌رود که یک ریموت ویژه با encryption=shared پیکربندی شده باشد.
.IP
برای نمونه، جهت استفاده از دستور sqop متعلق به Sequoia PGP، این گزینه را روی "sqop" تنظیم کنید.
.IP
.IP "\fBremote.<name>.annex\-shared\-sop\-profile\fP, \fBannex.shared\-sop\-profile\fP"
هنگام رمزگذاری با یک دستور Stateless OpenPGP، این گزینه می‌تواند برای تعیین پروفایل مورد استفاده، مانند "rfc4880"، به کار رود.
.IP
برای فهرستی از پروفایل‌های در دسترس، دستوری مانند "sqop list\-profiles encrypt" را اجرا کنید:
.IP
sqop list\-profiles encrypt
.IP
.IP "\fBremote.<name>.annex\-rsyncurl\fP"
توسط ریموت‌های ویژه rsync استفاده می‌شود و مکان مخزن rsync را جهت استفاده پیکربندی می‌کند. معمولاً این مورد به‌طور خودکار توسط \fBgit annex initremote\fP تنظیم می‌شود، اما در صورت نیاز می‌توانید آن را تغییر دهید.
.IP
.IP "\fBremote.<name>.annex\-buprepo\fP"
توسط ریموت‌های ویژه bup استفاده می‌شود و مکان مخزن bup را جهت استفاده پیکربندی می‌کند. معمولاً این مورد به‌طور خودکار توسط \fBgit annex initremote\fP تنظیم می‌شود، اما در صورت نیاز می‌توانید آن را تغییر دهید.
.IP
.IP "\fBremote.<name>.annex\-borgrepo\fP"
توسط ریموت‌های ویژه borg استفاده می‌شود و مکان مخزن borg را جهت استفاده پیکربندی می‌کند. معمولاً این مورد به‌طور خودکار توسط \fBgit annex initremote\fP تنظیم می‌شود، اما در صورت نیاز می‌توانید آن را تغییر دهید.
.IP
.IP "\fBremote.<name>.annex\-compute\fP"
برای شناسایی ریموت‌های ویژه محاسباتی (compute) استفاده می‌شود. معمولاً این مورد به‌طور خودکار توسط \fBgit annex initremote\fP تنظیم می‌شود.
.IP
.IP "\fBremote.<name>.annex\-ddarrepo\fP"
توسط ریموت‌های ویژه ddar استفاده می‌شود و مکان مخزن ddar را جهت استفاده پیکربندی می‌کند. معمولاً این مورد به‌طور خودکار توسط \fBgit annex initremote\fP تنظیم می‌شود، اما در صورت نیاز می‌توانید آن را تغییر دهید.
.IP
.IP "\fBremote.<name>.annex\-directory\fP"
توسط ریموت‌های ویژه پوشه (directory) استفاده می‌شود و مکان پوشه‌ای را که فایل‌های ضمیمه‌شده (annexed) برای این ریموت در آن ذخیره می‌شوند پیکربندی می‌کند. معمولاً این مورد به‌طور خودکار توسط \fBgit annex initremote\fP تنظیم می‌شود، اما در صورت نیاز می‌توانید آن را تغییر دهید.
.IP
.IP "\fBremote.<name>.annex\-adb\fP"
برای شناسایی ریموت‌های موجود روی دستگاه‌های اندرویدی که از طریق adb به آن‌ها دسترسی پیدا می‌شود به کار می‌رود. معمولاً این مورد به‌طور خودکار توسط \fBgit annex initremote\fP تنظیم می‌شود.
.IP
.IP "\fBremote.<name>.annex\-androiddirectory\fP"
توسط ریموت‌های ویژه adb استفاده می‌شود؛ این پوشه‌ای در دستگاه اندرویدی است که فایل‌های مربوط به این ریموت در آن ذخیره می‌شوند. معمولاً این مورد به‌طور خودکار توسط \fBgit annex initremote\fP تنظیم می‌شود، اما در صورت نیاز می‌توانید آن را تغییر دهید.
.IP
.IP "\fBremote.<name>.annex\-androidserial\fP"
توسط ریموت‌های ویژه adb استفاده می‌شود؛ این شماره سریال دستگاه اندرویدی است که توسط ریموت استفاده می‌شود. معمولاً این مورد به‌طور خودکار توسط \fBgit annex initremote\fP تنظیم می‌شود، اما در صورت نیاز می‌توانید آن را تغییر دهید، برای نمونه هنگام ارتقا به یک دستگاه اندرویدی جدید.
.IP
.IP "\fBremote.<name>.annex\-s3\fP"
برای شناسایی ریموت‌های ویژه Amazon S3 استفاده می‌شود. معمولاً این مورد به‌طور خودکار توسط \fBgit annex initremote\fP تنظیم می‌شود.
.IP
.IP "\fBremote.<name>.annex\-s3\-restore\-tier\fP, \fBannex.s3\-restore\-tier\fP"
هنگام استفاده از ریموت ویژه Amazon S3، این گزینه رده (tier) مورد استفاده هنگام بازیابی اشیاء از فضای ذخیره‌سازی عمیق (deep storage) را مشخص می‌کند. می‌تواند روی "standard" (پیش‌فرض)، "bulk" یا "expedited" تنظیم شود.
.IP
.IP "\fBremote.<name>.annex\-s3\-restore\-days\fP, \fBannex.s3\-restore\-days\fP"
هنگام استفاده از ریموت ویژه Amazon S3، این گزینه مشخص می‌کند اشیائی که از فضای ذخیره‌سازی عمیق بازیابی شده‌اند تا چند روز باید در دسترس باقی بمانند. مقدار پیش‌فرض ۱ روز است.
.IP
.IP "\fBremote.<name>.annex\-glacier\fP"
برای شناسایی ریموت‌های ویژه Amazon Glacier استفاده می‌شود. معمولاً این مورد به‌طور خودکار توسط \fBgit annex initremote\fP تنظیم می‌شود.
.IP
.IP "\fBremote.<name>.annex\-rclone\fP"
برای شناسایی ریموت‌های ویژه rclone استفاده می‌شود. معمولاً این مورد به‌طور خودکار توسط \fBgit annex initremote\fP تنظیم می‌شود.
.IP
.IP "\fBremote.<name>.annex\-web\fP"
برای شناسایی ریموت‌های ویژه وب استفاده می‌شود. معمولاً این مورد به‌طور خودکار توسط \fBgit annex initremote\fP تنظیم می‌شود.
.IP
.IP "\fBremote.<name>.annex\-webdav\fP"
برای شناسایی ریموت‌های ویژه webdav استفاده می‌شود. معمولاً این مورد به‌طور خودکار توسط \fBgit annex initremote\fP تنظیم می‌شود.
.IP
.IP "\fBremote.<name>.annex\-tahoe\fP"
برای شناسایی ریموت‌های ویژه tahoe استفاده می‌شود. به پوشه پیکربندی برای tahoe اشاره می‌کند.
.IP
.IP "\fBremote.<name>.annex\-gcrypt\fP"
برای شناسایی ریموت‌های ویژه gcrypt استفاده می‌شود. معمولاً این مورد به‌طور خودکار توسط \fBgit annex initremote\fP تنظیم می‌شود.
.IP
اگر این ریموت یک ریموت gcrypt باشد، روی "true" تنظیم می‌شود. اگر ریموت gcrypt از طریق ssh در دسترس باشد و git-annex\-shell برای مدیریت آن موجود باشد، روی "shell" تنظیم می‌شود.
.IP
.IP "\fBremote.<name>.annex\-git\-lfs\fP"
برای شناسایی ریموت‌های ویژه git\-lfs استفاده می‌شود. معمولاً این مورد به‌طور خودکار توسط \fBgit annex initremote\fP تنظیم می‌شود.
.IP
اگر این یک ریموت git\-lfs باشد، روی "true" تنظیم می‌شود.
.IP
.IP "\fBremote.<name>.annex\-httpalso\fP"
برای شناسایی ریموت‌های ویژه httpalso استفاده می‌شود. معمولاً این مورد به‌طور خودکار توسط \fBgit annex initremote\fP تنظیم می‌شود.
.IP
.IP "\fBremote.<name>.annex\-mask\fP"
توسط ریموت‌های ویژه mask استفاده می‌شود؛ این گزینه روی نام ریموتی که ماسک شده است تنظیم می‌شود. اگر این مقدار روی "true" تنظیم شود، هر ریموتی با UUID مناسب استفاده خواهد شد. معمولاً این مورد به‌طور خودکار توسط \fBgit annex initremote\fP تنظیم می‌شود.
.IP
.IP "\fBremote.<name>.annex\-externaltype\fP"
توسط ریموت‌های ویژه خارجی برای ثبت نوع ریموت استفاده می‌شود.
.IP
برای نمونه، اگر این گزینه روی "foo" تنظیم شود، git-annex یک برنامه "git-annex\-remote\-foo" را برای برقراری ارتباط با ریموت ویژه خارجی اجرا می‌کند.
.IP
اگر این گزینه روی "readonly" تنظیم شود، در این صورت git-annex هیچ برنامه ریموت ویژه خارجی را اجرا نخواهد کرد، بلکه تلاش می‌کند با استفاده از http به موارد ذخیره‌شده در ریموت دسترسی یابد. این روش تنها برای برخی ریموت‌های ویژه خارجی عمل می‌کند، بنابراین به مستندات ریموتی که استفاده می‌کنید مراجعه فرمایید.
.IP
.IP "\fBremote.<name>.annex\-hooktype\fP"
توسط ریموت‌های ویژه هوک برای ثبت نوع ریموت استفاده می‌شود.
.IP
.IP "\fBannex.web\-options\fP, \fBremote.<name>.annex\-web\-options\fP"
گزینه‌هایی که هنگام استفاده از curl توسط git-annex برای دانلود نشانی‌های وب به آن ارسال می‌شوند (به جای دانلودکننده درون‌ساخت پیش‌فرض urlها).
.IP
برای نمونه، جهت اجبار به استفاده از فقط IPv4، آن را روی "\-4" تنظیم کنید.
.IP
تنظیم این گزینه باعث می‌شود git-annex از curl استفاده کند، اما تنها در صورتی که annex.security.allowed\-ip\-addresses به شیوه‌ای خاص پیکربندی شده باشد. مستندات آن را ببینید.
.IP
تنظیم این گزینه مانع از استفاده git-annex از git\-credential برای درخواست گذرواژه‌های http می‌شود. در عوض، می‌توانید "\-\-netrc" را بگنجانید تا curl از فایل ~/.netrc شما استفاده کرده و گذرواژه‌ها را در آنجا ثبت کند.
.IP
.IP "\fBannex.youtube\-dl\-options\fP"
گزینه‌هایی که به yt\-dlp ارسال می‌شوند. برای نمونه اگر یوتیوب برای دانلود به کوکی نیاز دارد، از عبارتی مانند "\-\-cookies\-from\-browser firefox" استفاده کنید.
.IP
برخی گزینه‌ها ممکن است سازگاری و یکپارچگی git-annex با yt\-dlp را مختل کنند. برای نمونه، گزینه \-\-output می‌تواند سبب شود که فایل‌ها در جایی ذخیره شوند که git-annex نتواند آن‌ها را پیدا کند. از تنظیم هرگونه گزینه‌ای در اینجا یا در فایل پیکربندی yt\-dlp که موجب دانلود بیش از یک فایل شود، یا فایل را در جایی غیر از پوشه کاری جاری ذخیره کند، خودداری کنید.
.IP
.IP "\fBannex.youtube\-dl\-command\fP"
منسوخ‌شده و بدون استفاده. git-annex همواره "yt\-dlp" را اجرا می‌کند، چرا که دستور "youtube\-dl" منسوخ شده است.
.IP
.IP "\fBannex.aria\-torrent\-options\fP"
گزینه‌های ارسالی به aria2c هنگام استفاده از آن برای دانلود یک تورنت.
.IP
.IP "\fBannex.http\-headers\fP"
هدرهای HTTP که هنگام دانلود از وب ارسال می‌شوند. چندین خط از این گزینه می‌تواند تنظیم شود، یک خط به ازای هر هدر.
.IP
.IP "\fBannex.http\-headers\-command\fP"
در صورت تنظیم، این دستور اجرا می‌شود و هر خط از خروجی آن به عنوان یک هدر HTTP استفاده خواهد شد. این گزینه annex.http\-headers را لغو می‌کند.
.IP
روش دیگر این است که یک اسکریپت هوک در \fB.git/hooks/http\-headers\-annex\fP نصب شود.
.IP
.IP "\fBannex.security.allowed\-url\-schemes\fP"
فهرستی از طرح‌های URL که git-annex مجاز است محتوا را از آن‌ها دانلود کند. مقدار پیش‌فرض "http https ftp" است.
.IP
پیش از تغییر این گزینه بسیار با دقت بیندیشید؛ این امر پیامدهای امنیتی به همراه دارد. برای نمونه، اگر طوری تغییر یابد که نشانی‌های URL از نوع "file" را مجاز کند، در این صورت هر فردی که بتواند یک کامیت وارد مخزن git-annex شما کند می‌تواند با \fBgit-annex addurl\fP به یک فایل خصوصی در خارج از آن مخزن اشاره کند و احتمالاً باعث شود آن فایل در مخزن شما کپی شده و به سایر ریموت‌ها منتقل گردد و محتوای آن افشا شود.
.IP
هر طرح URL که توسط curl پشتیبانی می‌شود می‌تواند در اینجا فهرست شود، اما همچنین لازم است annex.security.allowed\-ip\-addresses را نیز برای مجاز ساختن استفاده از curl پیکربندی کنید.
.IP
برخی ریموت‌های ویژه از طرح‌های URL مختص به دامنه خود پشتیبانی می‌کنند؛ آن موارد تحت تاثیر این تنظیم پیکربندی قرار نمی‌گیرند.
.IP
.IP "\fBannex.security.allowed\-ip\-addresses\fP"
به‌طور پیش‌فرض، git-annex تنها به آدرس‌های IP عمومی متصل می‌شود؛ این ابزار از استفاده از سرورهای HTTP و سایر سرورها روی localhost یا روی یک شبکه خصوصی امتناع خواهد کرد.
.IP
این تنظیم می‌تواند آن رفتار را لغو کرده و اجازه دسترسی به آدرس‌های IP خاصی را که در حالت عادی مسدود می‌شوند صادر کند. برای نمونه "127.0.0.1 ::1" دسترسی به localhost (هم IPV4 و هم IPV6) را مجاز می‌کند. برای دسترسی به همه آدرس‌های IP، از "all" استفاده کنید.
.IP
پیش از تغییر این گزینه بسیار با دقت بیندیشید؛ این امر پیامدهای امنیتی به همراه دارد. هر کسی که بتواند کامیتی را وارد مخزن git-annex شما کند، می‌تواند با \fBgit annex addurl\fP یک نشانی را روی یک سرور خصوصی اضافه کند و احتمالاً سبب شود که آن فایل در مخزن شما دانلود شده و به سایر ریموت‌ها ارسال گردد و محتوای آن فاش شود.
.IP
توجه داشته باشید از آنجا که واسط‌های curl و yt\-dlp اجازه اعمال این محدودیت‌های آدرس IP را نمی‌دهند، curl و yt\-dlp هرگز استفاده نخواهند شد مگر آنکه annex.security.allowed\-ip\-addresses=all تنظیم شده باشد.
.IP
برای مجاز ساختن دسترسی به آدرس‌های IP محلی یا خصوصی تنها روی درگاه‌های (پورت‌های) خاص، از ساختار "[addr]:port" استفاده کنید. برای نمونه، "[127.0.0.1]:80 [127.0.0.1]:443 [::1]:80 [::1]:443" دسترسی به localhost را تنها روی درگاه‌های http مجاز می‌کند.
.IP
.IP "\fBannex.security.allowed\-http\-addresses\fP"
نام قدیمی برای annex.security.allowed\-ip\-addresses. در صورت تنظیم، مشابه با تنظیم بودن annex.security.allowed\-ip\-addresses در نظر گرفته می‌شود.
.IP
.IP "\fBannex.security.allow\-unverified\-downloads\fP"
به دلایل امنیتی، git-annex از دانلود محتوا از اغلب ریموت‌های ویژه در صورتی که نتواند هش را برای بررسی صحت محتوای دانلودشده تایید کند، امتناع می‌ورزد. این امر به ویژه بر دانلود محتوای کلیدهای URL یا WORM که فاقد هش هستند اثر می‌گذارد.
.IP
بهترین شیوه برای پرهیز از مشکلات ناشی از این مسئله، انتقال فایل‌ها از چنین کلیدهایی پیش از رسیدن محتوای آن‌ها به یک ریموت ویژه است. به git-annex\-migrate(1) مراجعه کنید.
.IP
هنگامی که محتوا تنها از یک ریموت ویژه در دسترس باشد، می‌توانید از این پیکربندی استفاده کنید تا git-annex را ملزم به دانلود آن نمایید. اما شما این کار را با مسئولیت خودتان انجام می‌دهید و بسیار مهم است که ابتدا اطلاعات زیر را بخوانید و درک کنید!
.IP
از دانلود محتوای تاییدنشده از ریموت‌های ویژه رمزگذاری‌شده جلوگیری می‌شود، زیرا ریموت ویژه می‌تواند محتوای رمزگذاری‌شده دیگری غیر از آنچه انتظار دارید ارسال کند، که موجب می‌شود git-annex داده‌هایی را که هرگز وارد git-annex نکرده‌اید رمزگشایی کند و خطر افشای داده‌های رمزگشایی‌شده به هر ریموت رمزگذاری‌نشده‌ای که محتوا به آن ارسال می‌کنید وجود داشته باشد.
.IP
از دانلود محتوای تاییدنشده از ریموت‌های ویژه خارجی (غیر رمزگذاری‌شده) جلوگیری می‌شود، چرا که آن‌ها می‌توانند ریدایرکت‌های http را به وب‌سرورهای روی localhost یا روی شبکه خصوصی، یا در برخی موارد به یک url از نوع file:/// دنبال کنند.
.IP
اگر تصمیم به دور زدن این بررسی امنیتی گرفتید، بهترین کار این است که آن را تنها به‌طور موقت در حین اجرای دستوری که فایل را دریافت می‌کند تنظیم کنید. مقداری که باید برای این پیکربندی تنظیم شود "ACKTHPPT" است. برای نمونه:
.IP
 git \-c annex.security.allow\-unverified\-downloads=ACKTHPPT annex get myfile
.IP
همچنین ایده خوبی است که بررسی کنید آیا فایلی را که انتظار داشتید دانلود کرده است یا خیر.
.IP
.IP "\fBremote.<name>.annex\-security\-allow\-unverified\-downloads\fP"
پیکربندی به ازای هر ریموت برای annex.security.allow\-unverified\-downloads.
.IP
.IP "\fBannex.security.allowed\-compute\-programs\fP"
این یک فهرست جداشده با فاصله از برنامه‌های محاسباتی است، برای نمونه "git-annex\-compute\-foo git-annex\-compute\-bar". درج نام یک برنامه محاسباتی در اینجا به ریموت‌های ویژه محاسباتی که از آن برنامه استفاده می‌کنند اجازه می‌دهد توسط \fBgit-annex enableremote\fP یا به‌طور خودکار فعال شوند.
.IP
.SH "پیکربندی دستیار (CONFIGURATION OF ASSISTANT)"
.IP "\fBannex.delayadd\fP"
.IP
دستورات watch و assistant را وادار می‌کند تا پیش از افزودن یک فایل تازه ایجادشده به annex، به مدت تعداد ثانیه‌های مشخص‌شده درنگ کنند. به‌طور معمول به این گزینه نیازی نیست، زیرا آن‌ها از پیش منتظر می‌مانند تا تمام نویسندگان فایل آن را ببندند.
.IP
توجه داشته باشید که این گزینه فقط افزودن فایل‌های ایجادشده در زمان اجرای دیمون را به تاخیر می‌اندازد. تغییرات انجام‌شده در زمانی که دیمون در حال اجرا نیست، بلافاصله در راه‌اندازی بعدی افزوده خواهند شد.
.IP
.IP "\fBannex.expireunused\fP"
اقدام دستیار (assistant) را در مورد محتویات استفاده‌نشده فایل‌ها که در مخزن ذخیره شده‌اند کنترل می‌کند.
.IP
مقدار پیش‌فرض \fBfalse\fP است که سبب می‌شود تمام محتویات قدیمی و استفاده‌نشده فایل‌ها حفظ شوند، مگر آنکه دستیار بتواند آن‌ها را به مخزن دیگری (مانند مخزن پشتیبان) منتقل کند.
.IP
می‌تواند روی یک مشخصه زمانی مانند "7d" یا "1m" تنظیم شود و در نتیجه محتویات فایلی که مشخص شده است برای یک هفته یا یک ماه استفاده نشده‌اند، حذف خواهند شد.
.IP
.IP "\fBannex.fscknudge\fP"
هنگامی که روی false تنظیم شود، از یادآوری برنامه تحت وب هنگام استفاده از مخازنی که فاقد بررسی‌های یکپارچگی هستند جلوگیری می‌کند.
.IP
.IP "\fBannex.autoupgrade\fP"
هنگامی که روی ask تنظیم شود (پیش‌فرض)، برنامه تحت وب نگارش‌های جدید را بررسی کرده و در صورت وجود از شما می‌پرسد که آیا باید به آن‌ها ارتقا یابد یا خیر. هنگامی که روی true تنظیم شود، بدون پرسش به‌طور خودکار ارتقا می‌یابد (در برخی پلتفرم‌های پشتیبانی‌شده). هنگامی که روی false تنظیم شود، هرگونه بررسی ارتقا را غیرفعال می‌کند.
.IP
توجه داشته باشید که بررسی ارتقا تنها زمانی صورت می‌پذیرد که git-annex از یکی از ایمیج‌های از پیش ساخته وب‌سایت آن نصب شده باشد. این تنظیم کدهای رسیدگی به ارتقای اختصاصی، به عنوان نمونه متعلق به یک توزیع لینوکس را دور نمی‌زند.
.IP
این تنظیم همچنین کنترل می‌کند که آیا در صورت تشخیص تغییر فایل اجرایی git-annex، دستیار git-annex مجدداً راه‌اندازی شود یا خیر. این مورد فارغ از شیوه نصب git-annex مفید است.
.IP
.IP "\fBannex.autocommit\fP"
روی false تنظیم کنید تا از ثبت (commit) خودکار تغییرات فایل‌ها در مخزن توسط \fBgit-annex assistant\fP، \fBgit-annex assist\fP و \fBgit-annex sync\fP جلوگیری به عمل آید.
.IP
جهت پیکربندی این رفتار در تمامی رونوشت‌های (clones) مخزن، این گزینه می‌تواند در git-annex\-config(1) تنظیم شود.
.IP
.IP "\fBannex.startupscan\fP"
روی false تنظیم کنید تا از پویش مخزن برای فایل‌های جدید و تغییریافته در هنگام راه‌اندازی توسط دستیار git-annex جلوگیری شود. این کار مانع از آگاهی آن از تغییراتی می‌شود که در زمان عدم اجرای آن ایجاد شده‌اند، اما می‌تواند یک بهینه‌سازی کارایی کارآمد برای مخازن بزرگ باشد.
.IP
.IP "\fBannex.listen\fP"
آدرس IP که برنامه تحت وب روی آن گوش می‌دهد را پیکربندی می‌کند. مقدار پیش‌فرض localhost است. می‌تواند یک آدرس IP یا یک نام میزبان باشد که به آدرس مورد نظر اشاره دارد.
.IP
.IP "\fBannex.port\fP"
شماره درگاهی (پورتی) که برنامه تحت وب روی آن گوش می‌دهد را پیکربندی می‌کند. مقدار پیش‌فرض انتخاب یک درگاه استفاده‌نشده است.
.IP
.SH "پیکربندی از طریق .gitattributes (CONFIGURATION VIA .gitattributes)"
بک‌اند کلید\-مقدار (key-value) مورد استفاده هنگام افزودن فایلی جدید به annex را می‌توان بر پایه هر نوع فایل از طریق فایل‌های \fB.gitattributes\fP پیکربندی کرد. در این فایل، ویژگی \fBannex.backend\fP می‌تواند روی نام بک‌اند مورد استفاده تنظیم شود. (برای اطلاعات درباره بک‌اندهای موجود به git-annex\-backends(1) مراجعه کنید.)
برای نمونه، در اینجا نحوه استفاده از بک‌اند WORM به‌طور پیش‌فرض، و استفاده از بک‌اند SHA256E برای فایل‌های ogg آورده شده است:
.PP
 * annex.backend=WORM
 *.ogg annex.backend=SHA256E
.PP
ویژگی annex.largefiles وجود دارد که برای پیکربندی اینکه چه فایل‌هایی به اندازه کافی بزرگ هستند تا به annex اضافه شوند استفاده می‌شود. از آنجا که ویژگی‌ها نمی‌توانند حاوی فاصله باشند، استفاده از آن برای تنظیمات پیچیده‌تر annex.largefiles دشوار است. تنظیم annex.largefiles در git-annex\-config(1) روش آسان‌تری جهت پیکربندی آن در تمامی کلون‌های مخزن است. برای جزئیات در مورد نحو، git-annex\-matching\-expression(1) را ببینید.
.PP
تنظیمات numcopies و mincopies را نیز می‌توان بر مبنای هر نوع فایل از طریق ویژگی‌های \fBannex.numcopies\fP و \fBannex.mincopies\fP در فایل‌های \fB.gitattributes\fP پیکربندی کرد. این ویژگی‌ها بر سایر تنظیمات اولویت دارند. برای نمونه، این کار سبب می‌شود ۲ رونوشت برای فایل‌های wav و ۳ رونوشت برای فایل‌های flac مورد نیاز باشد:
.PP
 *.wav annex.numcopies=2
 *.flac annex.numcopies=3
.PP
این تنظیمات توسط git-annex در هر زمان که روی یک فایل منطبق عمل می‌کند رعایت می‌شوند. با این حال، هنگام استفاده از \-\-all، \-\-unused یا \-\-key برای مشخص کردن کلیدهایی که باید پردازش شوند، git-annex روی کلیدها عمل می‌کند و نه روی فایل‌ها، بنابراین تنظیمات حاصل از .gitattributes را اعمال نخواهد کرد. به همین دلیل، دستورات \fBgit annex numcopies\fP و \fBgit annex mincopies\fP برای پیکربندی یک پیش‌فرض سراسری مفید هستند.
.PP
همچنین توجه داشته باشید هنگام استفاده از نماها (views)، تنها فایل .gitattributes سطح بالا در نما حفظ می‌شود، بنابراین تنظیمات دیگر در فایل‌های دیگر اثری نخواهند داشت.
.PP
.SH "وضعیت خروج (EXIT STATUS)"
خودِ git-annex در صورت موفقیت با 0 و در صورت شکست با 1 خارج خواهد شد، مگر آنکه به گزینه \fB\-\-size\-limit\fP یا \fB\-\-time\-limit\fP برخورد کند که در این حالت با 101 خارج می‌شود.
.PP
تعداد کمی از زیردستورات git-annex وضعیت‌های خروج دیگری دارند که برای نشان دادن مشکلات خاص استفاده می‌شوند و در صفحات راهنمای اختصاصی خود مستند شده‌اند.
.PP
.SH "محیط (ENVIRONMENT)"
این متغیرهای محیطی در صورت تنظیم شدن، توسط git-annex استفاده می‌شوند:
.PP
.IP "\fBGIT_WORK_TREE\fP, \fBGIT_DIR\fP"
همانند رفتار گیت با آن‌ها مدیریت می‌شوند، git(1) را ببینید.
.IP
.IP "\fBGIT_SSH\fP, \fBGIT_SSH_COMMAND\fP"
مشابه آنچه در git(1) توصیف شده است مدیریت می‌شوند. تنها تفاوت این است که git-annex گاهی یک پارامتر اضافی "\-n" را به عنوان اولین پارامتر به این‌ها ارسال می‌کند تا مانع خواندن ssh از ورودی استاندارد (stdin) شود. از آنجا که این کار می‌تواند کاربردهای موجود از این متغیرهای محیطی را که انتظار این پارامتر اضافی را ندارند دچار مشکل کند، لازم است \fBGIT_ANNEX_USE_GIT_SSH=1\fP را تنظیم کنید تا git-annex از این‌ها پشتیبانی کند.
.IP
توجه داشته باشید که تنظیم هر یک از این متغیرهای محیطی مانع از فعال‌سازی خودکار کشینگ اتصال ssh توسط git-annex می‌شود (به \fBannex.sshcaching\fP مراجعه کنید)، بنابراین برخی از عملیات با ریموت‌ها از طریق ssh را کُند خواهد کرد. فعال‌سازی کشینگ اتصال ssh در صورت نیاز بر عهده شماست؛ مستندات ssh را ببینید.
.IP
همچنین، در هنگام تنظیم این متغیرهای محیطی، \fBannex.ssh\-options\fP و \fBremote.<name>.annex\-ssh\-options\fP هیچ اثری نخواهند داشت.
.IP
معمولاً بهتر است هرگونه گزینه دلخواه را از طریق فایل ~/.ssh/config خود، یا با تنظیم \fBannex.ssh\-options\fP پیکربندی کنید.
.IP
.IP "\fBGIT_ANNEX_VECTOR_CLOCK\fP"
به‌طور معمول git-annex روی خطوط فایل‌های گزارش متعهدشده (کامیت‌شده) در شاخه git-annex برچسب زمانی درج می‌کند. تنظیم این متغیر محیطی روی یک عدد سبب می‌شود git-annex به جای تعداد ثانیه‌های جاری از مبدا یونیکس (UNIX epoch)، از آن عدد (یا عددی بزرگ‌تر) استفاده کند. توجه داشته باشید که ثانیه‌های اعشاری نیز پشتیبانی می‌شوند.
.IP
این گزینه تنها برای کاربران پیشرفته‌ای ارائه شده است که یا روش بهتری نسبت به ساعت محلی برای تشخیص اینکه کدام کامیت جاری است دارند، یا بنا به دلایل خط‌مشی و سیاست‌ها نیاز دارند از گنجاندن برچسب‌های زمانی خودداری کنند.
.IP
.IP "برخی ریموت‌های ویژه از متغیرهای محیطی دیگری استفاده می‌کنند"
برای احراز هویت و غیره. برای نمونه، \fBAWS_ACCESS_KEY_ID\fP و \fBGIT_ANNEX_P2P_AUTHTOKEN\fP. مستندات ریموت ویژه را ببینید.
.IP
.SH "فایل‌ها (FILES)"
این فایل‌ها توسط git-annex استفاده می‌شوند:
.PP
پوشه \fB.git/annex/objects/\fP در مخزن گیت شما حاوی محتویات فایل‌های ضمیمه‌شده‌ای است که در حال حاضر در دسترس هستند. فایل‌های ضمیمه‌شده در مخزن گیت شما به آن محتوا پیوند نمادین (symlink) دارند.
.PP
پوشه \fB.git/annex/\fP در مخزن گیت شما حاوی سایر اطلاعات زمان اجرای مورد استفاده توسط git-annex است.
.PP
فایل \fB~/.config/git-annex/autostart\fP فهرستی از مخازن گیت است که باید دستیار git-annex در آن‌ها شروع به کار کند.
.PP
.SH "همچنین ببینید (SEE ALSO)"
مستندات بیشتر درباره git-annex در وب‌سایت آن در دسترس است:
<https://git-annex.branchable.com>
.PP
اگر git-annex از طریق یک بسته نصب شده باشد، رونوشتی از مستندات آن باید به عنوان نمونه در \fB/usr/share/doc/git-annex/\fP گنجانده شده باشد.
.PP
.IP "git-annex\-shell(1)"
.IP "git\-remote\-annex(1)"
.IP "git\-remote\-tor\-annex(1)"
.SH "نویسنده (AUTHOR)"
Joey Hess <id@joeyh.name>
.PP
<https://git-annex.branchable.com>
.PP
.PP