نام (NAME)

git-annex-unused - جستجو و یافتن محتوای فایل‌های بلااستفاده

خلاصه دستور (SYNOPSIS)

git annex unused

توضیحات (DESCRIPTION)

ضمیمه (annex) را برای یافتن داده‌هایی که با هیچ فایلی در هیچ برچسب (tag) یا شاخه‌ای (branch)، یا در نمایه گیت (git index) مطابقت ندارند بررسی کرده و یک فهرست شماره‌گذاری‌شده از این داده‌ها را چاپ می‌کند.

پس از اجرای این دستور، می‌توانید از گزینه --unused همراه با بسیاری از دستورات دیگر git-annex برای انجام عملیات روی تمام داده‌های بلااستفاده یافت‌شده استفاده کنید.

به‌عنوان مثال، برای انتقال تمام داده‌های بلااستفاده به origin:

git annex unused; git annex move --unused --to origin

گزینه‌ها (OPTIONS)

--fast
: فقط فایل‌های موقت (temp) و خراب (bad) بلااستفاده را نشان می‌دهد.
--from=repository: بررسی داده‌های بلااستفاده‌ای که در یک مخزن قرار دارند.
: مخزن باید با استفاده از نام یک ریموت پیکربندی‌شده، یا UUID یا شرح یک مخزن مشخص شود.
--used-refspec=+ref:-ref: به‌طور پیش‌فرض، هر داده‌ای که نمایه گیت استفاده می‌کند، یا هر ارجاعی در مخزن گیت به آن اشاره دارد، مورد استفاده در نظر گرفته می‌شود. اگر فقط می‌خواهید برخی ارجاع‌ها را در نظر بگیرید، می‌توانید از این گزینه برای مشخص کردن آن‌ها استفاده کنید. داده‌هایی که در ارجاع‌های مشخص‌شده قرار ندارند (و توسط نمایه استفاده نمی‌شوند)، بلااستفاده در نظر گرفته خواهند شد.
: برای جزئیات قالب این تنظیم، بخش «قالب مشخصه ارجاع (REFSPEC FORMAT)» را در زیر ببینید.
: پیکربندی گیت annex.used-refspec می‌تواند برای تنظیم دائمی‌تر این مورد استفاده شود.
--json: فعال‌سازی خروجی JSON. این گزینه برای تجزیه توسط برنامه‌هایی که از git-annex استفاده می‌کنند در نظر گرفته شده است.
--json-error-messages: پیام‌هایی که به‌طور معمول در خروجی خطای استاندارد چاپ می‌شدند، در عوض در داخل JSON گنجانده می‌شوند.
همچنین می‌توان از گزینه‌های git-annex-common-options(1) نیز استفاده کرد.

قالب مشخصه ارجاع (REFSPEC FORMAT)

قالب refspec برای --used-refspec و annex.used-refspec فهرستی از افزودن‌ها و حذف‌های ارجاع‌ها است که با دونقطه (:) از هم جدا شده‌اند. یک مثال نمونه:

+refs/heads/*:+HEAD^:+refs/tags/*:-refs/tags/old-tag:reflog

این عبارت تمام ارجاع‌های refs/heads/ و همچنین نسخه قبلی HEAD را اضافه می‌کند. همچنین تمام برچسب‌ها را به جز old-tag اضافه می‌کند. و تمام ارجاع‌ها را از reflog نیز می‌افزاید.

رفتار پیش‌فرض معادل با --used-refspec=+refs/*:+HEAD است.

پردازش refspec با شروع از یک مجموعه خالی از ارجاع‌ها و پیمایش فهرست به ترتیب از چپ به راست انجام می‌شود.

هر + با یک الگو (glob) با تمام ارجاع‌های مربوطه (زیرمجموعه‌ای از git show-ref) مطابقت داده شده و تمام ارجاع‌های منطبق به مجموعه اضافه می‌شوند. برای مثال، "+refs/remotes/*" تمام ارجاع‌های مخزن دوردست (remote) را اضافه می‌کند.

هر + بدون الگو، مقدار را به صورت تحت‌اللفظی به مجموعه اضافه می‌کند. برای مثال، "+HEAD^" مقدار "HEAD^" را اضافه می‌کند.

هر - با مجموعه ارجاع‌های انباشته‌شده تا آن لحظه مطابقت داده می‌شود. هر ارجاعی با نام منطبق، از مجموعه حذف خواهد شد.

مقدار "reflog" تمام ارجاع‌ها را از reflog اضافه می‌کند. این کار باعث می‌شود نسخه‌های گذشته فایل‌ها تا زمانی که ارجاع از reflog منقضی شود (به طور پیش‌فرض ۹۰ روز)، بلااستفاده در نظر گرفته نشوند. توجه داشته باشید که اگر لازم باشد هر ارجاع از reflog بررسی شود، ممکن است اجرای git-annex unused مقداری زمان ببرد.

همچنین ببینید (SEE ALSO)

git-annex(1)

git-annex-dropunused(1)

git-annex-addunused(1)

git-annex-whereused(1)

git-annex-oldkeys(1)

نویسنده (AUTHOR)

Joey Hess <id@joeyh.name>