| git-annex-addcomputed(1) | General Commands Manual | git-annex-addcomputed(1) |
نام (NAME)
git-annex-addcomputed - افزودن فایل‌های محاسباتی به مخزن
خلاصه دستور (SYNOPSIS)
git annex addcomputed --to=remote -- ...
توضیحات (DESCRIPTION)
فایل‌هایی را که با استفاده از یک ریموت محاسباتی ویژه (compute special remote) از فایل‌های ورودی در مخزن محاسبه می‌شوند، به مخزن ضمیمه اضافه می‌کند.
پس از اضافه شدن یک فایل به یک ریموت محاسباتی، دستوراتی مانند git-annex get از آن برای محاسبه محتوای فایل استفاده خواهند کرد.
قواعد دستوری این دستور بعد از -- وابسته به برنامه‌ای است که ریموت ویژه محاسباتی برای اجرای محاسبات تنظیم شده است.
برای مشاهده نحوه استفاده از برنامه، می‌توانید دستور زیر را اجرا کنید:
git-annex addcomputed --to=foo
به طور کلی شما یک فایل ورودی (یا چند فایل)، و اغلب یک نام فایل خروجی، و پارامترهای اضافی برای کنترل محاسبات ارائه خواهید داد.
می‌توان بیش از یک فایل ورودی را برای محاسبه یک فایل خروجی ترکیب کرد، و چندین فایل خروجی را نیز می‌توان به طور همزمان محاسبه نمود.
چند نمونه از نحوه استفاده:
git-annex addcomputed --to=x -- convert file.raw file.jpeg passes=10 git-annex addcomputed --to=y -- compress foo --level=9 git-annex addcomputed --to=z -- clip foo 2:01-3:00 combine with bar to baz
توجه داشته باشید که پارامترهای ارسال‌شده به git-annex initremote هنگام راه‌اندازی ریموت ویژه محاسباتی، به انتهای پارامترهای ارائه‌شده به git-annex addcomputed اضافه خواهند شد.
گزینه‌ها (OPTIONS)
- --to=remote
- مشخص می‌کند کدام ریموت فایل‌ها را محاسبه خواهد کرد.
- این باید یک ریموت محاسباتی باشد. برای مثال، می‌توان یکی را با دستور زیر مقداردهی اولیه کرد:
- git-annex initremote photoconv type=compute \ program=git-annex-compute-photoconv
- برای جزئیات درباره ریموت‌های محاسباتی و فهرستی از برخی برنامه‌های موجود، ببینید: https://git-annex.branchable.com/special_remotes/compute
- --fast
- فایل‌های محاسباتی را به مخزن اضافه می‌کند، بدون اینکه فعلاً کاری برای محاسبه محتوای آن‌ها انجام دهد.
- این گزینه به طور ضمنی شامل --unreproducible می‌شود، زیرا حتی اگر ریموت محاسباتی خروجی بازتولیدپذیر تولید کند، آن خروجی در دسترس نیست.
- --unreproducible, -u
- نشان می‌دهد که انتظار نمی‌رود محاسبات کاملاً بازتولیدپذیر باشد. ممکن است تغییراتی داشته باشد که فایل‌هایی تولید شوند که به اندازه کافی برای جایگزینی معادل باشند، اما لزوماً یکسان نباشند.
- این حالت پیش‌فرض است مگر اینکه ریموت محاسباتی اعلام کند که خروجی بازتولیدپذیر تولید می‌کند.
- --reproducible, -r
- نشان می‌دهد که انتظار می‌رود محاسبات کاملاً بازتولیدپذیر باشد.
- این حالت زمانی پیش‌فرض است که ریموت محاسباتی نشان دهد خروجی بازتولیدپذیر تولید می‌کند (به جز هنگام استفاده از --fast).
- اگر مشخص شود که یک محاسبه کاملاً بازتولیدپذیر نیست، دریافت یک فایل محاسبه‌شده از ریموت محاسباتی بعداً با خطای اعتبارسنجی چکسام (checksum) مواجه خواهد شد. یک راهکار در این حالت استفاده از دستور git-annex recompute --original --unreproducible است.
- --backend
- مشخص می‌کند از کدام بک‌اند کلید-مقدار استفاده شود.
- --json
- خروجی JSON را فعال می‌کند. این قابلیت برای پردازش توسط برنامه‌هایی که از git-annex استفاده می‌کنند در نظر گرفته شده است. هر خط از خروجی یک شیء JSON است.
- همچنین گزینه‌های عمومی git-annex-common-options(1) نیز قابل استفاده هستند.
همچنین ببینید (SEE ALSO)
git-annex(1)
git-annex-recompute(1)
git-annex-findcomputed(1)
git-annex-initremote(1)
نویسنده (AUTHOR)
Joey Hess <id@joeyh.name>