نام (NAME)

git-annex-find - فهرست کردن فایل‌های در دسترس

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

git annex find [path ...]

توضیحات (DESCRIPTION)

فهرستی از فایل‌های ضمیمه‌شده (annexed) در مسیر مشخص‌شده را در خروجی نمایش می‌دهد. در صورت مشخص نکردن مسیر، فایل‌ها را در دایرکتوری جاری و زیردایرکتوری‌های آن پیدا می‌کند.

گزینه‌ها (OPTIONS)

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

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

به‌طور پیش‌فرض، دستور find تنها فایل‌های ضمیمه‌شده‌ای را فهرست می‌کند که محتوای آن‌ها در حال حاضر موجود است. مشخص کردن هر یک از گزینه‌های تطبیق، این رفتار پیش‌فرض را لغو می‌کند.

برای فهرست کردن تمام فایل‌های ضمیمه‌شده، چه موجود باشند و چه نباشند، گزینه --anything را مشخص کنید.

برای فهرست کردن فایل‌های ضمیمه‌شده‌ای که محتوای آن‌ها موجود نیست، --not --in=here را مشخص کنید.

--branch=ref

فهرست کردن فایل‌ها در شاخه (branch) یا treeish مشخص‌شده.

--print0

خروجی دادن نام فایل‌های خاتمه‌یافته با نویسه تهی (null)، جهت استفاده با xargs -0

--format=value

استفاده از قالب‌بندی خروجی سفارشی.

مقدار مشخص‌شده یک رشته قالب است که در آن ${var} به مقدار متغیر بسط داده می‌شود. برای راست‌چین کردن متغیر با فاصله‌های خالی، از ${var;width} استفاده کنید؛ برای چپ‌چین کردن متغیر، از ${var;-width} استفاده کنید؛ برای گریز دادن (اسکیپ کردن) نویسه‌های نامتعارف (شامل نویسه‌های کنترلی) در یک متغیر، از ${escaped_var} استفاده نمایید.

این متغیرها برای استفاده در قالب‌ها در دسترس هستند: file، key، backend، bytesize، humansize، keyname، hashdirlower، hashdirmixed، mtime (برای فیلد mtime از یک کلید WORM).

همچنین، '\n' خط جدید، '\000' نویسه تهی (NULL) و غیره است.

قالب خروجی پیش‌فرض مشابه با --format='${file}\n' است، به جز زمانی که خروجی به ترمینال ارسال می‌شود که در آن صورت نویسه‌های کنترلی اسکیپ خواهند شد.

--json

خروجی دادن فهرست فایل‌ها در قالب JSON.

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

--json-error-messages

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

--batch

حالت دسته‌ای (batch mode) را فعال می‌کند، که در آن یک فایل در یک خط از ورودی استاندارد (stdin) خوانده می‌شود، اطلاعات آن نمایش می‌یابد و این روند تکرار می‌شود.

توجه داشته باشید که اگر فایل مورد نظر یک فایل ضمیمه‌شده نباشد، یا موجود نباشد، یا به هر نحو دیگری با گزینه‌های تطبیق همخوانی نداشته باشد، به جای آن یک خط خالی در خروجی چاپ خواهد شد.

-z

باعث می‌شود ورودی --batch به جای خطوط جدید معمول، با نویسه‌های تهی (null) از هم جدا شوند.

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

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

git-annex(1)

git-annex-whereis(1)

git-annex-findkeys(1)

نویسنده (AUTHOR)

Joey Hess <id@joeyh.name>