| git-annex-move(1) | General Commands Manual | git-annex-move(1) |
نام (NAME)
git-annex-move - انتقال محتوای فایل میان مخازن
خلاصه دستور (SYNOPSIS)
git annex move [path ...] [--from=remote|--to=remote|--to=here]
توضیحات (DESCRIPTION)
محتوای فایل‌ها را از یا به یک مخزن دوردست (remote) دیگر منتقل می‌کند.
بدون مشخص کردن پارامترها، روی تمام فایل‌های ضمیمه‌شده (annexed) در دایرکتوری فعلی اعمال می‌شود. می‌توان مسیر فایل‌ها یا دایرکتوری‌ها را برای انجام عملیات مشخص کرد.
گزینه‌ها (OPTIONS)
- --from=remote
- انتقال محتوای فایل‌ها از مخزن دوردست مشخص‌شده به مخزن محلی.
- --to=remote
- انتقال محتوای فایل‌ها از مخزن محلی به مخزن دوردست مشخص‌شده.
- --to=here
- انتقال محتوای فایل‌ها از تمام مخازن دوردست در دسترس به مخزن محلی.
- --from=remote1 --to=remote2
- انتقال محتوای فایل‌هایی که در remote1 قرار دارند به remote2. این کار آنچه در مخزن محلی ذخیره شده است را تغییر نمی‌دهد.
- این عمل با دریافت اولیه محتوا از remote1 به مخزن محلی (در صورتی که از قبل موجود نباشد)، سپس ارسال آن به remote2 و در نهایت حذف محتوا از مخزن محلی (اگر از ابتدا در آن وجود نداشته باشد) پیاده‌سازی شده است.
- --from-anywhere --to=remote
- انتقال فایل‌ها از مخزن محلی و از تمام مخازن دوردست در دسترس به مخزن دوردست مقصد.
- --force
- نادیده گرفتن بررسی‌های مربوط به numcopies و محتوای لازم (required content)، و حذف همیشگی فایل‌ها از مخزن مبدأ به محض آنکه مخزن مقصد یک نسخه از آن را دریافت کرد.
- توجه داشته باشید که حتی بدون این گزینه نیز می‌توانید محتوای یک فایل را از یک مخزن به مخزن دیگر انتقال دهید، حتی اگر شرط numcopies برآورده نشود؛ مادامی که این انتقال منجر به کاهش تعداد نسخه‌ها نشود.
- --jobs=N -JN
- فعال‌سازی انتقال‌های موازی تا حداکثر تعداد وظایف مشخص‌شده به‌طور هم‌زمان. برای مثال: -J10
- تنظیم این گزینه بر روی «cpus» به ازای هر هسته پردازنده (CPU) یک وظیفه را اجرا می‌کند.
- توجه داشته باشید که هنگام استفاده از --from به همراه --to، دو برابر این تعداد وظیفه به‌طور هم‌زمان اجرا خواهند شد که به‌طور مساوی بین دو مخزن دوردست تقسیم می‌شوند.
- --all -A
- به جای مشخص کردن یک نام فایل یا مسیر برای انتقال، می‌توان از این گزینه برای انتقال تمام نسخه‌های موجود از تمام فایل‌ها استفاده کرد.
- این رفتار پیش‌فرض هنگام اجرای git-annex در یک مخزن bare است.
- --branch=ref
- اعمال عملیات بر روی فایل‌های موجود در شاخه یا شیء درختی (treeish) مشخص‌شده.
- --unused
- اعمال عملیات بر روی فایل‌هایی که در آخرین اجرای git-annex unused یافت شده‌اند.
- --failed
- اعمال عملیات بر روی فایل‌هایی که اخیراً انتقال آن‌ها با شکست مواجه شده است.
- --key=keyname
- استفاده از این گزینه برای انتقال یک کلید مشخص.
- matching options
- می‌توان از گزینه‌های تطبیق در git-annex-matching-options(1) برای کنترل مواردی که باید منتقل شوند استفاده کرد.
- --batch
- فعال‌سازی حالت دسته‌ای (batch mode)، که در آن خطوط حاوی نام فایل‌های مورد نظر برای انتقال، از ورودی استاندارد (stdin) خوانده می‌شوند.
- با پردازش هر فایل مشخص‌شده، خروجی پیشرفت معمول نمایش داده می‌شود. اگر نیازی به انتقال محتوای یک فایل نباشد، یا با گزینه‌های تطبیق مشخص‌شده همخوانی نداشته باشد، یا یک فایل ضمیمه‌شده نباشد، در پاسخ یک خط خالی چاپ می‌شود.
- از آنجا که خروجی معمول در حین انتقال فایل پر از جزئیات بوده و برای پردازش ماشینی مناسب نیست، ممکن است بخواهید از --json در ترکیب با --batch استفاده کنید.
- --batch-keys
- مشابه --batch است، اما خطوط خوانده‌شده از ورودی استاندارد (stdin) به عنوان کلید تفسیر می‌شوند.
- -z
-
باعث می‌شود ورودی دسته‌ای به‌جای خطوط جدید معمول، با نویسه تهی (null) از هم جدا شوند. - --json
-
فعال‌سازی خروجی JSON. این گزینه برای پردازش توسط برنامه‌هایی که از git-annex استفاده می‌کنند در نظر گرفته شده است. هر خط از خروجی یک شیء JSON است. - --json-progress
- گنجاندن اشیاء پیشرفت در خروجی JSON.
- --json-error-messages
- پیام‌هایی که به‌طور معمول در خروجی خطای استاندارد نمایش داده می‌شدند، در عوض در داخل JSON گنجانده می‌شوند.
- همچنین می‌توان از گزینه‌های git-annex-common-options(1) نیز استفاده کرد.
همچنین ببینید (SEE ALSO)
git-annex(1)
git-annex-get(1)
git-annex-copy(1)
git-annex-drop(1)
نویسنده (AUTHOR)
Joey Hess <id@joeyh.name>