| git-annex-fsck(1) | General Commands Manual | git-annex-fsck(1) |
نام (NAME)
git-annex-fsck - یافتن و برطرف کردن مشکلات
خلاصه دستور (SYNOPSIS)
git annex fsck [path ...]
توضیحات (DESCRIPTION)
این دستور یکپارچگی و سلامت فایل‌های پیوست‌شده (annexed) را بررسی کرده و دربارهٔ مشکلات یافت‌شده هشدار می‌دهد یا آن‌ها را برطرف می‌کند. این ابزار مکملی مناسب برای git fsck است.
حالت پیش‌فرض، بررسی تمام فایل‌های پیوست‌شده در پوشهٔ جاری و زیرپوشه‌های آن است. با تعیین پارامترها، تنها فایل‌های مشخص‌شده بررسی خواهند شد.
مشکلاتی که fsck پیدا می‌کند شامل فایل‌های آسیب‌دیده، فایل‌هایی که محتوای آن‌ها به شکلی از دست رفته است، فایل‌هایی که هنوز به تعداد نسخه‌های پیکربندی‌شده تکثیر نشده‌اند، و کلیدهایی است که می‌توانند به قالبی بهتر ارتقا یابند.
گزینه‌ها (OPTIONS)
- --from=remote
- بررسی یک ریموت به جای مخزن محلی.
- توجه داشته باشید که به طور پیش‌فرض، فایل‌ها از ریموت کپی می‌شوند تا محتوای آن‌ها بررسی شود. برای جلوگیری از این انتقال پرهزینه و تنها به منظور تأیید این‌که ریموت همچنان فایل‌های مورد انتظار را در خود دارد، گزینهٔ --fast را اضافه کنید.
- --fast
- از محاسبات پرهزینهٔ چکسام (و انتقال‌های پرهزینه هنگام بررسی یک ریموت با fsck) جلوگیری می‌کند.
- --incremental
- شروع یک دورهٔ جدید از fsck افزایشی (incremental)، با پاک کردن سوابق تمام فایل‌هایی که در دورهٔ افزایشی قبلی بررسی شده بودند.
- --more
- نادیده گرفتن فایل‌هایی که از زمان آغاز آخرین دورهٔ fsck افزایشی بررسی شده‌اند.
- توجه داشته باشید که حتی پیش از استفاده از --incremental برای شروع یک دورهٔ افزایشی، فایل‌های بررسی‌شده ثبت می‌شوند و استفاده از این گزینه مانع بررسی مجدد آن‌ها می‌شود.
- ازسرگیری ممکن است برخی از فایل‌های بررسی‌شده را مجدداً و به صورت مازاد بررسی کند. هر فایلی که قبلاً fsck در آن مشکلی پیدا کرده باشد، در زمان ازسرگیری دوباره بررسی خواهد شد. همچنین در حین fsck، هر ۱۰۰۰ فایل یک‌بار یا هر ۵ دقیقه یک چک‌پوینت (نقطهٔ بازرسی) ثبت می‌شود و ادامهٔ کار از آخرین چک‌پوینت از سر گرفته می‌شود؛ بنابراین اگر یک fsck افزایشی مثلاً با ctrl-c متوقف شود، فایل‌هایی که در آخرین چک‌پوینت ثبت نشده‌اند را دوباره بررسی خواهد کرد.
- --incremental-schedule=time
- باعث می‌شود که دورهٔ جدید fsck افزایشی تنها پس از گذشت یک بازهٔ زمانی مشخص از آغاز آخرین دوره اجرا شود.
- زمان به شکل "10d" (۱۰ روز) یا "300h" (۳۰۰ ساعت) مشخص می‌شود.
- شاید مایل باشید شب‌ها به مدت ۵ ساعت fsck را اجرا کنید و هر شب کار از همان‌جا که متوقف شده ادامه یابد تا زمانی که تمام فایل‌ها بررسی شوند. و پس از اتمام، بخواهید یک دورهٔ جدید آغاز شود، اما نه زودتر از ماهی یک‌بار. در این حالت می‌توانید این دستور را در کران‌جاب شبانه قرار دهید:
-
git annex fsck --incremental-schedule 30d --time-limit 5h - --numcopies=N
- نادیده گرفتن تعداد نسخه‌هایی که به صورت معمول پیکربندی شده است.
- برای بررسی صرف سلامت داده‌ها بدون توجه به تعداد نسخه‌های مورد نیاز، از --numcopies=1 استفاده کنید.
- --all -A
- به طور معمول تنها فایل‌های موجود در شاخهٔ فعلی بررسی می‌شوند. این گزینه باعث می‌شود تمام نسخه‌های تمامی فایل‌ها بررسی شوند.
- این رفتار پیش‌فرض هنگام اجرای git-annex در یک مخزن bare است.
- --branch=ref
- عملیات روی فایل‌های موجود در شاخه یا شیء درخت‌مانند (treeish) مشخص‌شده.
- --unused
- عملیات روی فایل‌هایی که در آخرین اجرای دستور git-annex unused پیدا شده‌اند.
- --key=keyname
- استفاده از این گزینه برای بررسی یک کلید مشخص.
- matching options
- می‌توان از git-annex-matching-options(1) برای کنترل مواردی که باید بررسی شوند استفاده کرد.
- --jobs=N -JN
- اجرای هم‌زمان چندین کار fsck به صورت موازی. برای مثال: -J4
- تنظیم این مقدار به "cpus" به ازای هر هستهٔ پردازنده یک کار را اجرا می‌کند.
- --json
- فعال‌سازی خروجی JSON. این گزینه برای تجزیه توسط برنامه‌هایی که از git-annex استفاده می‌کنند در نظر گرفته شده است. هر خط از خروجی یک شیء JSON است.
- --json-error-messages
- پیام‌هایی که معمولاً در خطای استاندارد نمایش داده می‌شوند، در عوض درون JSON گنجانده می‌شوند.
- --quiet
- مشابه تمام دستورات git-annex، این گزینه باعث می‌شود تنها پیام‌های خطا و هشدار نمایش داده شوند. این گزینه به‌ویژه برای fsck مفید است، زیرا به طور معمول تمام فایل‌های در حال بررسی را حتی در صورت سالم بودن نمایش می‌دهد.
- همچنین می‌توان از git-annex-common-options(1) نیز استفاده کرد.
همچنین ببینید (SEE ALSO)
git-annex(1)
git-annex-repair(1)
git-annex-expire(1)
نویسنده (AUTHOR)
Joey Hess <id@joeyh.name>