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