| git-annex-findkeys(1) | General Commands Manual | git-annex-findkeys(1) |
نام (NAME)
git-annex-findkeys - جستجوی کلیدهای مطابق با شروط مشخصشده
خلاصه دستور (SYNOPSIS)
git annex findkeys
توضیحات (DESCRIPTION)
فهرستی از کلیدهای شناختهشده برای git-annex را در خروجی نمایش میدهد.
گزینهها (OPTIONS)
- گزینههای تطبیق (matching options)
- میتوان از git-annex-matching-options(1) برای مشخص کردن اینکه کدام کلیدها فهرست شوند استفاده کرد.
- بهطور پیشفرض، دستور findkeys فقط کلیدهایی را فهرست میکند که محتوای آنها در حال حاضر موجود است. تعیین هر یک از گزینههای تطبیق، این رفتار پیشفرض را لغو کرده و تمام کلیدهایی را که git-annex از وجودشان آگاه است تطبیق میدهد.
- برای فهرست کردن تمامی کلیدها، چه موجود باشند و چه نباشند، گزینه --anything را مشخص کنید.
- برای فهرست کردن کلیدهایی که محتوای آنها موجود نیست، --not --in=here را مشخص کنید.
- --print0
- خروجی دادن کلیدهای خاتمهیافته با نویسه تهی (null)، جهت استفاده با xargs -0
- --format=value
- استفاده از قالببندی سفارشی برای خروجی.
- مقدار مشخصشده یک رشته قالب است که در آن ${var} به مقدار متغیر بسط داده میشود. برای راستچین کردن متغیر با فاصلههای خالی، از ${var;width} استفاده کنید؛ برای چپچین کردن متغیر، از ${var;-width} استفاده کنید؛ برای گریز دادن (اسکیپ کردن) نویسههای نامتعارف (شامل نویسههای کنترلی) در یک متغیر، از ${escaped_var} استفاده نمایید.
- این متغیرها برای استفاده در قالبها در دسترس هستند: key، backend، bytesize، humansize، keyname، hashdirlower، hashdirmixed، mtime (برای فیلد mtime از یک کلید WORM).
- همچنین، '\n' خط جدید، '\000' نویسه تهی (NULL) و غیره است.
- قالب خروجی پیشفرض مشابه با --format='${escapedkey}\n' است، به جز زمانی که خروجی به ترمینال ارسال میشود که در آن صورت نویسههای کنترلی اسکیپ خواهند شد.
- --json
- خروجی دادن فهرست کلیدها در قالب JSON.
- این گزینه برای تجزیه خروجی توسط برنامههایی که از git-annex استفاده میکنند در نظر گرفته شده است. هر خط از خروجی یک شیء JSON است.
- --json-error-messages
- پیامهایی که در حالت عادی به جریان خطای استاندارد ارسال میشدند، در عوض درون JSON قرار میگیرند.
- همچنین میتوان از git-annex-common-options(1) استفاده کرد.
همچنین ببینید (SEE ALSO)
نویسنده (AUTHOR)
Joey Hess <id@joeyh.name>