| git-annex-copy(1) | General Commands Manual | git-annex-copy(1) |
نام (NAME)
git-annex-copy - کپی کردن محتوای فایل‌ها به یا از مخزنی دیگر
خلاصه دستور (SYNOPSIS)
git annex copy [path ...] [--from=remote|--to=remote]
توضیحات (DESCRIPTION)
محتوای فایل‌ها را از یا به یک ریموت دیگر کپی می‌کند.
بدون آرگومان، روی تمام فایل‌های ضمیمه‌شده (annexed) در دایرکتوری فعلی عمل می‌کند. می‌توان مسیر فایل‌ها یا دایرکتوری‌ها را برای انجام عملیات مشخص کرد.
گزینه‌ها (OPTIONS)
- --from=remote
- کپی کردن محتوای فایل‌ها از ریموت مشخص‌شده به مخزن محلی.
- هر فایلی که در ریموت موجود نباشد بدون پیام نادیده گرفته می‌شود.
- --to=remote
- کپی کردن محتوای فایل‌ها از مخزن محلی به ریموت مشخص‌شده.
- --to=here
- کپی کردن محتوای فایل‌ها از تمام ریموت‌های قابل دسترس به مخزن محلی.
- --from=remote1 --to=remote2
- کپی کردن محتوای فایل‌های موجود در remote1 به remote2.
- این کار ابتدا با دانلود محتوا از remote1 به مخزن محلی (در صورتی که از قبل موجود نباشد)، سپس ارسال آن به remote2، و در نهایت حذف محتوا از مخزن محلی (اگر از ابتدا در آن موجود نبوده باشد) انجام می‌شود.
- --from-anywhere --to=remote
- کپی کردن فایل‌ها به ریموت، هم از مخزن محلی و هم از تمام ریموت‌های در دسترس.
- --jobs=N -JN
- انتقال موازی را با حداکثر تعداد وظایف (jobs) مشخص‌شده به صورت هم‌زمان فعال می‌کند. به عنوان مثال: -J10
- تنظیم این گزینه روی "cpus" به ازای هر هسته پردازنده یک وظیفه اجرا می‌کند.
- توجه داشته باشید که هنگام استفاده هم‌زمان از --from و --to، دو برابر این تعداد وظیفه به صورت هم‌زمان اجرا می‌شوند که به طور مساوی بین دو ریموت تقسیم خواهد شد.
- --auto
- به جای کپی کردن همه فایل‌های مشخص‌شده، فقط فایل‌هایی کپی می‌شوند که هنوز تعداد رونوشت‌های مورد نظر از آن‌ها وجود ندارد، یا جزو محتوای ترجیحی (preferred content) مخزن مقصد هستند. به git-annex-preferred-content(1) مراجعه کنید.
- --fast
- هنگام کپی کردن محتوا به یک ریموت، از رفت‌وبرگشت شبکه برای بررسی اینکه آیا ریموت از قبل محتوا را دارد یا خیر، خودداری می‌کند. این کار می‌تواند سریع‌تر باشد، اما ممکن است در برخی موارد از کپی محتوا به ریموت صرف‌نظر کند.
- --all -A
- به جای مشخص کردن نام فایل یا مسیر برای کپی، می‌توان از این گزینه برای کپی کردن تمامی نسخه‌های موجود همه فایل‌ها استفاده کرد.
- این رفتار پیش‌فرض هنگام اجرای git-annex در یک مخزن خام (bare) است.
- --branch=ref
- عملیات روی فایل‌های موجود در شاخه یا درختواره (treeish) مشخص‌شده انجام می‌شود.
- --unused
- عملیات روی فایل‌های شناسایی‌شده توسط آخرین اجرای دستور git-annex unused انجام می‌شود.
- --failed
- عملیات روی فایل‌هایی انجام می‌شود که اخیراً انتقال آن‌ها با شکست مواجه شده است.
- --key=keyname
- از این گزینه برای کپی کردن یک کلید مشخص استفاده کنید.
- matching options
- می‌توان از git-annex-matching-options(1) برای تعیین موارد قابل کپی استفاده کرد.
- --batch
- حالت دسته‌ای (batch) را فعال می‌کند که در آن خطوط حاوی نام فایل‌های مورد نظر برای کپی از 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-move(1)
git-annex-drop(1)
نویسنده (AUTHOR)
Joey Hess <id@joeyh.name>