.TH git-annex-matching-options 1
.SH "نام (NAME)"
git-annex\-matching\-options \- تعیین مواردی که باید روی آن‌ها عملیات انجام شود
.PP
.SH "توضیحات (DESCRIPTION)"
بسیاری از دستورات git-annex از این گزینه‌ها برای مشخص کردن فایل‌هایی که روی آن‌ها
عملیات انجام می‌دهند، پشتیبانی می‌کنند. برخی از این گزینه‌ها همچنین می‌توانند توسط دستورات
برای مشخص کردن کلیدهایی که روی آن‌ها عملیات انجام می‌شود، استفاده شوند.
.PP
با استفاده از این گزینه‌ها می‌توان عبارت‌های پیچیده و دلخواهی ساخت؛ برای نمونه:
.PP
.EX
\-\-include='*.mp3' \-\-and \-( \-\-in=usbdrive \-\-or \-\-in=archive \-)
.EE
.PP
مثال بالا باعث می‌شود git-annex تنها بر روی فایل‌های mp3 که در هر یک از آن دو مخزن
وجود دارند، عمل کند.
.PP
.SH "گزینه‌ها (OPTIONS)"
.IP "\fB\-\-exclude=glob\fP"
.IP
فایل‌های منطبق با الگوی سراسری (glob pattern) را نادیده می‌گیرد. این الگو نسبت به دایرکتوری جاری سنجیده می‌شود؛ برای نمونه:
.PP
.EX
git annex get \-\-exclude='*.mp3' \-\-exclude='subdir/*'
.EE
.IP
توجه داشته باشید که هنگام استفاده از
.B \-\-all
یا
.B \-\-unused
این گزینه هیچ چیزی را مطابقت نخواهد داد.
.IP
.IP "\fB\-\-include=glob\fP"
فایل‌هایی را که با الگوی سراسری (glob) مطابقت ندارند نادیده می‌گیرد. (مشابه با
.BR "\-\-not \-\-exclude" .)
برای نمونه، جهت گنجاندن فقط فایل‌های mp3 و ogg:
.PP
.EX
git annex get \-\-include='*.mp3' \-\-or \-\-include='*.ogg'
.EE
.IP
توجه داشته باشید که هنگام استفاده از
.B \-\-all
یا
.B \-\-unused
این گزینه مانع پردازش هیچ موردی نخواهد شد.
.IP
.IP "\fB\-\-excludesamecontent=glob\fP"
اگر فایل دیگری با همین محتوا وجود داشته باشد که نام آن با الگوی glob مطابقت دارد، فایل را نادیده می‌گیرد. این الگو نسبت به دایرکتوری جاری سنجیده می‌شود.
.IP
برای نمونه، جهت حذف فایل‌ها در دایرکتوری archive، به جز زمانی که همان محتوا توسط فایلی در دایرکتوری work استفاده شده است:
.PP
.EX
git annex drop archive/ \-\-excludesamecontent='work/*'
.EE
.IP
.IP "\fB\-\-includesamecontent=glob\fP"
چنانچه فایل دیگری با همین محتوا که نامش با الگوی glob مطابقت دارد وجود نداشته باشد، فایل را نادیده می‌گیرد. (مشابه با
.BR "\-\-not \-\-excludesamecontent" )
.IP
برای نمونه، اگر دایرکتوری‌های inbox و outbox را دارید و می‌خواهید هر موردی در inbox را که محتوایی یکسان با چیزی در outbox دارد بیابید:
.PP
.EX
git annex find inbox \-\-includesamecontent='outbox/*'
.EE
.IP
.IP "\fB\-\-in=repository\fP"
تنها زمانی مطابقت دارد که git-annex بر این باور باشد که محتوا در مخزن مورد نظر موجود است.
.IP
مخزن باید با استفاده از نام یک ریموت پیکربندی‌شده، یا شناسهٔ یکتا (UUID) یا توضیحات یک مخزن مشخص شود. برای مخزن جاری، از «here» استفاده کنید.
.IP
توجه داشته باشید که این گزینه مخازن راه دور (remotes) را بررسی نمی‌کند تا اطمینان یابد محتوا هنوز روی آن‌ها وجود دارد یا خیر. با این حال، هنگام بررسی مخزن جاری، بررسی می‌کند که محتوا واقعاً در آن وجود داشته باشد.
.IP
.IP "\fB\-\-in=repository@{date}\fP"
تنها زمانی مطابقت دارد که محتوا در تاریخ مشخص‌شده در آن مخزن وجود داشته است.
.IP
تاریخ با همان ساختار مستندشده در
.BR gitrevisions (7)
مشخص می‌شود. توجه داشته باشید که این گزینه از reflog استفاده می‌کند، بنابراین تاریخ‌های بسیار قدیمی در گذشته قابل پرس‌وجو نیستند.
.IP
برای نمونه، شاید لازم باشد دستور
.B git annex drop .
را برای آزادسازی موقت فضای دیسک اجرا کنید. روز بعد، می‌توانید فایل‌هایی را که رها کرده‌اید با استفاده از دستور
.B git annex get . \-\-in=here@{yesterday}
بازگردانید.
.IP
.IP "\fB\-\-expected\-present\fP"
تنها زمانی مطابقت دارد که git-annex تصور کند محتوا در مخزن محلی موجود است.
.IP
این گزینه شبیه به
.B \-\-in=here
است، با این تفاوت که بررسی نمی‌کند محتوا واقعاً وجود فیزیکی دارد یا خیر. بنابراین می‌توان از آن در شرایطی استفاده کرد که مشخص است اطلاعات ردیابی مکان قدیمی شده‌اند.
.IP
برای نمونه، اگر مخزنی از روی یک نسخهٔ پشتیبان که اشیای git-annex را شامل نمی‌شده در حال بازیابی است، می‌توان از این گزینه برای بازگرداندن تمام فایل‌هایی که انتظار می‌رفت در آن باشند استفاده کرد:
.PP
.EX
git-annex get \-\-expected\-present
.EE
.IP
.IP "\fB\-\-copies=number\fP"
تنها زمانی مطابقت دارد که git-annex بر این باور باشد که به تعداد مشخص‌شده یا بیشتر نسخه از محتوا وجود دارد. توجه داشته باشید که ریموت‌ها را برای تایید اینکه آیا نسخه‌ها هنوز وجود دارند بررسی نمی‌کند.
.IP
.IP "\fB\-\-copies=trustlevel:number\fP"
تنها زمانی مطابقت دارد که git-annex بر این باور باشد که به تعداد مشخص‌شده نسخه بر روی ریموت‌هایی با سطح اعتماد مشخص‌شده وجود دارد؛ برای نمونه:
.BR \-\-copies=trusted:2
.IP
برای مطابقت با هر سطح اعتمادی برابر یا بالاتر از یک سطح معین، از '+trustlevel' استفاده کنید؛ برای نمونه:
.BR \-\-copies=semitrusted+:2
.IP
.IP "\fB\-\-copies=groupname:number\fP"
تنها زمانی مطابقت دارد که git-annex تصور کند تعداد نسخه‌های مشخص‌شده روی ریموت‌های عضو گروه مشخص‌شده وجود دارد؛ برای نمونه:
.BR \-\-copies=archive:2
.IP
.IP "\fB\-\-lackingcopies=number\fP"
تنها زمانی مطابقت دارد که git-annex بر این باور باشد که به تعداد مشخص‌شده یا بیشتر نسخهٔ اضافی باید ایجاد شود تا تنظیمات numcopies ارضا گردند.
.IP
.IP "\fB\-\-approxlackingcopies=number\fP"
مشابه lackingcopies است، اما تنظیمات annex.numcopies در .gitattributes را بررسی نمی‌کند. این کار سرعت آن را به طور چشمگیری افزایش می‌دهد.
.IP
.IP "\fB\-\-inbackend=name\fP"
تنها زمانی مطابقت دارد که محتوا با استفاده از بک‌اند کلید\-مقدار مشخص‌شده ذخیره شده باشد.
.IP
.IP "\fB\-\-securehash\fP"
تنها زمانی مطابقت دارد که محتوا با استفاده از یک تابع درهم‌سازی امن از نظر رمزنگاری (cryptographically secure) هش شده باشد.
.IP
.IP "\fB\-\-inallgroup=groupname\fP"
تنها زمانی مطابقت دارد که git-annex تصور کند محتوا در تمام مخازن موجود در گروه مشخص‌شده حاضر است.
.IP
.IP "\fB\-\-onlyingroup=groupname\fP"
تنها زمانی مطابقت دارد که git-annex بر این باور باشد که محتوا حداقل در یک مخزن عضو گروه مشخص‌شده وجود دارد، و در هیچ‌یک از مخازنی که در آن گروه نیستند وجود ندارد.
.IP
.IP "\fB\-\-smallerthan=size\fP"
.IP "\fB\-\-largerthan=size\fP"
تنها زمانی مطابقت دارد که اندازهٔ محتوا از اندازهٔ مشخص‌شده کوچک‌تر، یا بزرگ‌تر باشد.
.IP
اندازه را می‌توان با هر یک از واحدهای متداول، مانند «0.5 gb» یا «100 KiloBytes» مشخص کرد.
.IP
.IP "\fB\-\-metadata field=glob\fP"
تنها زمانی مطابقت دارد که یک فیلد فراداده (metadata) پیوست‌شده با مقداری که با الگوی glob مطابقت دارد وجود داشته باشد. تطابق مقادیر فیلدهای فراداده بدون حساسیت به حروف کوچک و بزرگ انجام می‌شود.
.IP
.IP "\fB\-\-metadata field<value\fP / \fB\-\-metadata field>value\fP"
.IP "\fB\-\-metadata field<=value\fP / \fB\-\-metadata field>=value\fP"
تنها زمانی مطابقت دارد که فیلد فراداده‌ای پیوست‌شده با مقداری به ترتیب کمتر یا بیشتر از مقدار مشخص‌شده وجود داشته باشد.
.IP
هنگامی که هر دو مقدار عدد باشند، مقایسه به صورت عددی انجام می‌شود. زمانی که یکی از مقادیر عدد نباشد، مقایسه به صورت الفبایی (lexicographically) انجام می‌گیرد.
.IP
(توجه داشته باشید که باید پارامتر دوم را داخل علامت نقل‌قول قرار دهید تا از تغییر مسیر خروجی توسط شل جلوگیری شود.)
.IP
.IP "\fB\-\-url=glob\fP"
زمانی مطابقت دارد که ثبت شده باشد محتوا در یک آدرس اینترنتی (URL) منطبق با الگوی glob قرار دارد.
.IP
.IP "\fB\-\-want\-get\fP"
تنها زمانی مطابقت دارد که تنظیمات محتوای ترجیحی برای مخزن محلی تمایل به دریافت محتوا داشته باشند. توجه داشته باشید که این گزینه حتی زمانی که محتوا از قبل موجود باشد نیز تطابق پیدا می‌کند، مگر اینکه مثلاً با
.B \-\-not \-\-in=here
محدود شود.
.IP
.IP "\fB\-\-want\-drop\fP"
تنها زمانی مطابقت دارد که تنظیمات محتوای ترجیحی برای مخزن محلی تمایل به رها کردن (drop) محتوا داشته باشند. توجه داشته باشید که این گزینه حتی زمانی که محتوا وجود نداشته باشد نیز تطابق دارد، مگر اینکه مثلاً با
.B \-\-not \-\-in=here
محدود شود.
.IP
مواردی که با این گزینه تطابق دارند الزاماً توسط
.B git-annex drop \-\-auto
رها نخواهند شد. این گزینه بررسی نمی‌کند که آیا نسخه‌های کافی برای رهاسازی وجود دارد یا خیر. همچنین ممکن است همان محتوا توسط فایلی استفاده شود که تمایلی به رهاسازی آن وجود ندارد.
.IP
.IP "\fB\-\-want\-get\-by=repository\fP"
تنها زمانی مطابقت دارد که تنظیمات محتوای ترجیحی برای مخزن مشخص‌شده، تمایل به دریافت محتوا را مشخص کرده باشند. توجه داشته باشید که حتی اگر محتوا از قبل در آن مخزن موجود باشد نیز تطابق خواهد داشت، مگر اینکه با
.B \-\-not \-\-in=repository
محدود شود.
.IP
مخزن باید با استفاده از نام یک ریموت پیکربندی‌شده، یا شناسهٔ UUID یا توضیحات مخزن مشخص شود.
.B \-\-want\-get\-by=here
همان
.B \-\-want\-get
است.
.IP
.IP "\fB\-\-want\-drop\-by=repository\fP"
تنها زمانی مطابقت دارد که تنظیمات محتوای ترجیحی برای مخزن مشخص‌شده، تمایل به رهاسازی محتوا داشته باشند. توجه داشته باشید که این گزینه حتی زمانی که محتوا موجود نباشد نیز تطابق دارد، مگر اینکه با
.B \-\-not \-\-in=repository
محدود شده باشد.
.IP
مخزن باید با استفاده از نام یک ریموت پیکربندی‌شده، یا شناسهٔ UUID یا توضیحات مخزن مشخص شود.
.B \-\-want\-drop\-by=here
همان
.B \-\-want\-drop
است.
.IP
.IP "\fB\-\-accessedwithin=interval\fP"
زمانی مطابقت دارد که به محتوا در مخزن محلی اخیراً و در بازهٔ زمانی مشخص‌شده دسترسی صورت گرفته باشد.
.IP
بازهٔ زمانی می‌تواند به شکل «5m» یا «1h» یا «2d» یا «1y»، یا ترکیبی مانند «1h5m» باشد.
.IP
بنابراین برای نمونه،
.B \-\-accessedwithin=1d
زمانی تطابق دارد که در طول یک روز گذشته به محتوا دسترسی یافته شده باشد.
.IP
اگر سیستم‌عامل یا سیستم‌فایل از زمان‌های دسترسی (access times) پشتیبانی نکنند، این گزینه با هیچ موردی تطابق نخواهد داشت.
.IP
.IP "\fB\-\-presentsince=repository:interval\fP"
زمانی مطابقت دارد که محتوای فایل در طول تمام بازهٔ زمانی مشخص‌شده، در مخزن مورد نظر وجود داشته است.
.IP
مخزن باید با استفاده از نام یک ریموت پیکربندی‌شده، یا شناسهٔ UUID یا توضیحات یک مخزن مشخص شود. برای مخزن جاری، از «here» استفاده کنید.
.IP
بازهٔ زمانی می‌تواند به شکل «5m» یا «1h» یا «2d» یا «1y»، یا ترکیبی مانند «1h5m» باشد.
.IP
بنابراین برای نمونه،
.B \-\-presentsince=here:1d
با فایل‌هایی که به مدت ۱ روز در مخزن جاری بوده‌اند مطابقت دارد.
.IP
.IP "\fB\-\-lackingsince=repository:interval\fP"
این گزینه عکس
.B \-\-presentsince
است؛ زمانی مطابقت دارد که در طول تمام بازهٔ زمانی مشخص‌شده، محتوا در مخزن مورد نظر حضور نداشته است.
.IP
برای نمونه،
.B \-\-lackingsince=here:1d
با فایلی که بیش از ۱ روز پیش از مخزن محلی رها شده و از آن زمان تاکنون در آن نبوده است تطابق پیدا می‌کند. همچنین با فایل‌هایی که هرگز در مخزن محلی حاضر نبوده‌اند نیز تطابق خواهد داشت.
.IP
.IP "\fB\-\-changedsince=repository:interval\fP"
زمانی مطابقت دارد که تغییری در محتوای ذخیره‌شده در مخزن در طول بازهٔ زمانی مشخص‌شده رخ داده باشد.
.IP
برای نمونه،
.B \-\-changedsince=here:2d
با فایلی که در مخزن حاضر بوده اما ۱ روز پیش رها شده است مطابقت دارد، و با فایلی که مخزن ۱ روز پیش آن را دریافت کرده است نیز تطابق دارد؛ اما با فایلی که از ۲ روز پیش تاکنون در مخزن پیوسته حضور داشته است مطابقت نخواهد داشت.
.IP
.IP "\fB\-\-unlocked\fP"
با فایل‌های ضمیمه‌شده‌ای که قفل‌گشایی شده‌اند (unlocked) مطابقت دارد.
.IP
.IP "\fB\-\-locked\fP"
با فایل‌های ضمیمه‌شده‌ای که قفل هستند (locked) مطابقت دارد.
.IP
.IP "\fB\-\-mimetype=glob\fP"
نوع MIME یک فایل را بررسی کرده و انطباق الگوی glob با آن را می‌سنجد.
.IP
برای نمونه،
.B \-\-mimetype="text/*"
با انواع گوناگونی از فایل‌های متنی مطابقت دارد، از جمله «text/plain»، و همچنین «text/x\-shellscript»، «text/x\-makefile» و غیره.
.IP
انواع MIME دقیقاً همان‌هایی هستند که با اجرای دستور
.B file \-\-mime\-type
نمایش داده می‌شوند.
.IP
اگر محتوای ضمیمه‌شدهٔ فایل حاضر نباشد، فایل تطابق داده نخواهد شد.
.IP
این گزینه تنها زمانی در دسترس است که git-annex با فلگ ساخت MagicMime کامپایل شده باشد.
.IP
.IP "\fB\-\-mimeencoding=glob\fP"
کدگذاری MIME یک فایل را بررسی کرده و تطابق الگوی glob با آن را می‌سنجد.
.IP
برای نمونه،
.B \-\-mimeencoding=binary
با انواع فایل‌های باینری مطابقت دارد.
.IP
کدگذاری‌های MIME همان‌هایی هستند که با اجرای دستور
.B file \-\-mime\-encoding
نمایش داده می‌شوند.
.IP
اگر محتوای ضمیمه‌شدهٔ فایل حاضر نباشد، فایل تطابق نخواهد داشت.
.IP
این گزینه تنها زمانی در دسترس است که git-annex با فلگ ساخت MagicMime کامپایل شده باشد.
.IP
.IP "\fB\-\-anything\fP"
همیشه مطابقت دارد. یکی از کاربردهای مفید آن این است که
.B git-annex find \-\-anything
تمام فایل‌های ضمیمه‌شده را، صرف‌نظر از اینکه محتوای آن‌ها حاضر باشد یا خیر، فهرست می‌کند.
.IP
.IP "\fB\-\-nothing\fP"
هرگز مطابقت ندارد. (مشابه با
.BR "\-\-not \-\-anything" )
.IP
.IP "\fB\-\-not\fP"
گزینهٔ تطبیقی بعدی را معکوس می‌کند. برای نمونه، جهت مطابقت در حالتی که کمتر از ۳ نسخه وجود دارد، از
.B \-\-not \-\-copies=3
استفاده کنید.
.IP
.IP "\fB\-\-and\fP"
الزام می‌کند که هم گزینهٔ تطبیق قبلی و هم بعدی مطابقت داشته باشند. این حالت پیش‌فرض است.
.IP
.IP "\fB\-\-or\fP"
الزام می‌کند که گزینهٔ تطبیق قبلی یا بعدی مطابقت داشته باشند.
.IP
.IP "\fB\-(\fP"
یک گروه از گزینه‌های تطبیق را باز می‌کند.
.IP
.IP "\fB\-)\fP"
یک گروه از گزینه‌های تطبیق را می‌بندد.
.IP
.SH "همچنین ببینید (SEE ALSO)"
.BR git-annex (1)
.PP
.SH "نویسندگان (AUTHORS)"
Joey Hess <id@joeyh.name>