نام (NAME)

git-annex-unlock - قفل‌گشایی فایل‌ها برای ویرایش و تغییر

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

git annex unlock [path ...]

توضیحات (DESCRIPTION)

به‌طور معمول، محتوای فایل‌های ضمیمه‌شده (annexed) در برابر تغییر محافظت می‌شود. قفل‌گشایی یک فایل ضمیمه‌شده امکان تغییر دادن آن را فراهم می‌کند. هنگامی که هیچ فایلی مشخص نشود، تمام فایل‌های ضمیمه‌شده در دایرکتوری فعلی قفل‌گشایی می‌شوند.

قفل‌گشایی یک فایل، نحوه ذخیره‌سازی آن را در مخزن گیت تغییر می‌دهد (از یک پیوند نمادین یا symlink به یک فایل اشاره‌گر یا pointer file)، بنابراین این دستور تغییری ایجاد می‌کند که می‌توانید آن را کامیت (commit) کنید.

محتوای یک فایل قفل‌گشایی‌شده همچنان در git-annex ذخیره می‌شود و نه در گیت، و زمانی که تغییرات اعمال‌شده بر روی فایل را کامیت می‌کنید، این تغییرات نیز در git-annex ذخیره خواهند شد و تنها فایل اشاره‌گر در گیت نگهداری می‌شود.

اگر از git add برای افزودن یک فایل به ضمیمه استفاده کنید، آن فایل از همان ابتدا به‌صورت قفل‌گشایی‌شده اضافه خواهد شد. این امکان جریان‌های کاری را فراهم می‌کند که در آن فایل در ابتدا قفل‌گشایی شده است، در صورت لزوم ویرایش می‌شود و هنگامی که به نسخه نهایی خود رسید، قفل می‌گردد.

به‌طور معمول، قفل‌گشایی یک فایل نیازمند ایجاد یک رونوشت (کپی) از محتوای آن است تا محتوای اصلی آن حفظ شود و در عین حال نسخه کپی قابل تغییر باشد. برای مصرف فضای کمتر، می‌توان annex.thin را روی true تنظیم کرد؛ این کار باعث می‌شود به جای کپی، یک پیوند سخت (hard link) به محتوا ایجاد شود (تنها در صورتی که توسط سیستم فایل پشتیبانی شود). گرچه این کار می‌تواند فضای دیسک قابل‌توجهی را ذخیره کند، اما هرگونه تغییر اعمال‌شده روی فایل باعث از دست رفتن نسخه قدیمی آن از مخزن محلی خواهد شد. بنابراین، annex.thin را با احتیاط فعال کنید.

مثال‌ها (EXAMPLES)

# git annex unlock disk-image
# git commit -m "unlocked to allow VM to make changes as it runs"
# git annex unlock photo.jpg
# gimp photo.jpg
# git commit photo.jpg -m "redeye removal"
# gimp photo.jpg
# git commit photo.jpg -m "fix oversaturation"
# git annex lock photo.jpg

گزینه‌ها (OPTIONS)

گزینه‌های تطبیق فایل (file matching options)

می‌توان از git-annex-matching-options(1) برای مشخص کردن فایل‌ها جهت قفل‌گشایی استفاده کرد.

--json

فعال‌سازی خروجی JSON. این گزینه برای تجزیه توسط برنامه‌هایی که از git-annex استفاده می‌کنند در نظر گرفته شده است. هر خط از خروجی یک شیء JSON است.

--json-error-messages

پیام‌هایی که به‌طور معمول در خروجی خطای استاندارد نمایش داده می‌شدند، در عوض در داخل JSON گنجانده می‌شوند.

همچنین می‌توان از گزینه‌های git-annex-common-options(1) نیز استفاده کرد.

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

git-annex(1)

git-annex-edit(1)

git-annex-add(1)

git-annex-lock(1)

نویسنده (AUTHOR)

Joey Hess <id@joeyh.name>