نام (NAME)

git-annex-drop - حذف محتوای فایل‌ها از مخزن

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

git annex drop [path ...]

توضیحات (DESCRIPTION)

در صورت امکان، محتوای فایل‌های ضمیمه‌شده را از این مخزن حذف می‌کند.

اگر git-annex نتواند امن بودن انجام این کار را تأیید کند، از حذف محتوا خودداری خواهد کرد. معمولاً این فرآیند شامل تأیید این موضوع است که محتوا در مخزن دیگری ذخیره شده باشد.

محتوایی که ذخیره آن در مخزن الزامی است، حتی در صورت وجود نسخه‌های کافی در جاهای دیگر، حذف نخواهد شد. به git-annex-required(1) مراجعه کنید.

بدون پارامترها، تلاش می‌کند تمام فایل‌های ضمیمه‌شده در دایرکتوری فعلی را حذف کند. مسیر فایل‌ها یا دایرکتوری‌ها برای حذف می‌توانند مشخص شوند.

مثال‌ها (EXAMPLES)

# git annex drop *.jpeg
drop photo1.jpg (checking origin...) ok
drop photo2.jpg (unsafe)
  Could only verify the existence of 0 out of 1 necessary copies
  Rather than dropping this file, try using: git annex move
  (Use --force to override this check, or adjust numcopies.)
failed
drop photo3.jpg (checking origin...) ok

گزینه‌ها (OPTIONS)

--from=remote
: به جای حذف محتوای فایل‌ها از مخزن محلی، این گزینه می‌تواند یک مخزن دوردست (remote) را مشخص کند که محتوای فایل‌ها باید از آن حذف شود.
--fast: هنگام حذف از یک مخزن دوردست، در صورتی که احتمال داده نشود حاوی فایل است، از انجام هر کاری خودداری می‌کند. معمولاً تلاش می‌شود تک‌تک فایل‌ها از مخزن دوردست حذف شوند. این گزینه می‌تواند سریع‌تر باشد، اما ممکن است در برخی موارد باعث باقی ماندن برخی فایل‌ها در مخزن دوردست شود.
--auto: به جای تلاش برای حذف تمام فایل‌های مشخص‌شده، فقط آن‌هایی را حذف می‌کند که جزو محتوای ترجیحی (preferred content) مخزن نباشند، و در صورتی که نسخه‌های کافی دیگری برای امکان‌پذیر بودن حذف وجود نداشته باشد، از تلاش برای حذف فایل‌ها خودداری می‌کند. به git-annex-preferred-content(1) مراجعه کنید.
--force: از این گزینه با احتیاط استفاده کنید! این گزینه بررسی‌های ایمنی را دور می‌زند و git-annex را مجبور می‌کند تا محتوای فایل‌های مشخص‌شده را حتی از آخرین مخزنی که محتوای آن‌ها را ذخیره کرده است حذف کند. استفاده از این گزینه می‌تواند منجر به از دست رفتن داده‌ها شود.
--all -A: به جای مشخص کردن نام فایل یا مسیر برای حذف، می‌توان از این گزینه برای حذف تمام نسخه‌های موجود از تمام فایل‌ها استفاده کرد.
: این رفتار پیش‌فرض هنگام اجرای git-annex drop در یک مخزن bare است.
: توجه داشته باشید که این گزینه بررسی تنظیمات annex.numcopies در .gitattributes و تنظیمات محتوای موردنیاز (required content) را دور می‌زند.
--branch=ref: حذف فایل‌ها در شاخه یا شیء درختی (treeish) مشخص‌شده.
: توجه داشته باشید که این گزینه بررسی تنظیمات annex.numcopies در .gitattributes و تنظیمات محتوای موردنیاز را دور می‌زند.
--unused: حذف فایل‌هایی که در آخرین اجرای git-annex unused یافت شده‌اند.
: توجه داشته باشید که این گزینه بررسی تنظیمات annex.numcopies در .gitattributes و تنظیمات محتوای موردنیاز را دور می‌زند.
--key=keyname: استفاده از این گزینه برای حذف یک کلید مشخص.
: توجه داشته باشید که این گزینه بررسی تنظیمات annex.numcopies در .gitattributes و تنظیمات محتوای موردنیاز را دور می‌زند.
matching options: می‌توان از گزینه‌های تطبیق در git-annex-matching-options(1) برای مشخص کردن مواردی که باید حذف شوند استفاده کرد.
--jobs=N -JN: اجرای چندین عملیات حذف به صورت موازی. این قابلیت به‌ویژه زمانی مفید است که git-annex باید برای بررسی امکان حذف فایل‌ها، با مخزن‌های دوردست ارتباط برقرار کند. برای مثال: -J4
: تنظیم این مقدار بر روی «cpus» یک عملیات به ازای هر هسته پردازنده (CPU) اجرا خواهد کرد.
--batch: فعال‌سازی حالت دسته‌ای (batch mode)، که در آن خطوط حاوی نام فایل‌های مورد نظر برای حذف، از ورودی استاندارد (stdin) خوانده می‌شوند.
: با پردازش هر فایل مشخص‌شده، خروجی معمول نمایش داده می‌شود. اگر محتوای یک فایل موجود نباشد، یا با گزینه‌های تطبیق مشخص‌شده همخوانی نداشته باشد، یا یک فایل ضمیمه‌شده نباشد، در پاسخ یک خط خالی چاپ می‌شود.
--batch-keys: مشابه --batch است، اما خطوط خوانده‌شده از ورودی استاندارد (stdin) به عنوان کلید تفسیر می‌شوند.
: توجه داشته باشید که این گزینه بررسی تنظیمات annex.numcopies در .gitattributes و تنظیمات محتوای موردنیاز را دور می‌زند.
-z: باعث می‌شود ورودی دسته‌ای به‌جای خطوط جدید معمول، با نویسه تهی (null) از هم جدا شوند.
--json: فعال‌سازی خروجی JSON. این گزینه برای پردازش توسط برنامه‌هایی که از git-annex استفاده می‌کنند در نظر گرفته شده است. هر خط از خروجی یک شیء JSON است.
--json-error-messages: پیام‌هایی که به‌طور معمول در خروجی خطای استاندارد نمایش داده می‌شدند، در عوض درون JSON گنجانده می‌شوند.
همچنین می‌توان از گزینه‌های git-annex-common-options(1) نیز استفاده کرد.

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

git-annex(1)

git-annex-get(1)

git-annex-move(1)

git-annex-copy(1)

نویسنده (AUTHOR)

Joey Hess <id@joeyh.name>