| git-annex-whereis(1) | General Commands Manual | git-annex-whereis(1) |
نام (NAME)
git-annex-whereis - فهرست کردن مخازنی که حاوی محتوای فایل هستند
خلاصه دستور (SYNOPSIS)
git annex whereis [path ...]
توضیحات (DESCRIPTION)
اطلاعات مربوط به محل قرارگیری محتوای فایل‌ها را نمایش می‌دهد.
برای نمونه:
# git annex whereis whereis my_cool_big_file (1 copy) 0c443de8-e644-11df-acbf-f7cd7ca6210d -- laptop whereis other_file (3 copies) 0c443de8-e644-11df-acbf-f7cd7ca6210d -- laptop 62b39bbe-4149-11e0-af01-bb89245a1e61 -- usb drive [here] 7570b02e-15e9-11e0-adf0-9f3f94cb2eaa -- backup drive
توجه داشته باشید که این دستور برای بررسی اینکه آیا مخازن دوردست (remotes) همچنان محتوای فایل‌ها را دارند یا خیر، با آن‌ها ارتباط برقرار نمی‌کند؛ بلکه تنها آخرین اطلاعات دریافت شده از مخازن دوردست را گزارش می‌دهد.
گزینه‌ها (OPTIONS)
- گزینه‌های تطبیق (matching options)
- می‌توان از گزینه‌های تطبیق git-annex-matching-options(1) برای کنترل مواردی که عملیات روی آن‌ها انجام می‌شود استفاده کرد.
- --key=keyname
- محل قرارگیری یک کلید مشخص از git-annex را نمایش می‌دهد.
- --all -A
- اطلاعات whereis را برای تمام کلیدهای شناخته‌شده نمایش می‌دهد.
- (به‌جز کلیدهایی که به‌عنوان مرده/غیرفعال علامت‌گذاری شده‌اند؛ git-annex-dead(1) را ببینید.)
- --branch=ref
- اطلاعات whereis را برای فایل‌های موجود در شاخه یا ارجاع درختی (treeish) تعیین‌شده نمایش می‌دهد.
- --unused
- اطلاعات whereis را برای فایل‌های یافت‌شده در آخرین اجرای git-annex unused نمایش می‌دهد.
- --batch
- حالت دسته‌ای (batch mode) را فعال می‌کند، که در آن نام فایل خط به خط از ورودی استاندارد (stdin) خوانده شده، اطلاعات آن نمایش داده می‌شود و این کار تکرار می‌گردد.
- توجه داشته باشید که اگر فایل یک فایل annex نباشد، یا با گزینه‌های تطبیق تعیین‌شده مطابقت نداشته باشد، یک خط خالی در خروجی درج می‌شود.
- --batch-keys
- مشابه با --batch است اما خطوط خوانده شده از stdin به‌عنوان کلید (key) تجزیه می‌شوند.
- -z
- باعث می‌شود ورودی‌های دسته‌ای به‌جای خطوط جدید معمول، با نویسه تهی (null) از هم جدا شوند.
- --json
- خروجی JSON را فعال می‌کند. این ویژگی برای تجزیه توسط برنامه‌هایی طراحی شده است که از git-annex استفاده می‌کنند. هر خط از خروجی یک شیء JSON خواهد بود.
- --json-error-messages
- پیام‌هایی که معمولاً در خروجی خطای استاندارد چاپ می‌شوند، در عوض در خروجی JSON گنجانده می‌شوند.
- --format=value
- استفاده از قالب‌بندی سفارشی در خروجی.
- مقدار ورودی یک رشته قالب است که در آن '${var}' با مقدار متغیر جایگزین می‌شود. برای راست‌چین کردن یک متغیر با فاصله‌های خالی، از '${var;width}' استفاده کنید؛ برای چپ‌چین کردن یک متغیر، از '${var;-width}' استفاده نمایید؛ و برای گریز (escape) دادن نویسه‌های نامتعارف (شامل نویسه‌های کنترلی) در یک متغیر، از '${escaped_var}' استفاده کنید.
- این متغیرها برای استفاده در قالب‌ها در دسترس هستند: file، key، uuid، url، backend، bytesize، humansize، keyname، hashdirlower، hashdirmixed و mtime (برای فیلد mtime از کلیدهای WORM).
- همچنین '\n' نشان‌دهندهٔ خط جدید و '\000' نشان‌دهندهٔ NULL و غیره است.
- هنگامی که قالب حاوی متغیر uuid باشد، به ازای هر مخزنی که محتوای فایل را در بر دارد به نوبت بسط داده می‌شود. برای نمونه با دستور --format="${file} ${uuid}\n" خروجی به شکل زیر خواهد بود:
-
foo 00000000-0000-0000-0000-000000000001 foo a7f7ddd0-9a08-11ea-ab66-8358e4209d30 bar a7f7ddd0-9a08-11ea-ab66-8358e4209d30
- همین مورد زمانی که متغیر url به کار رود و یک فایل چندین آدرس اینترنتی url ثبت‌شده داشته باشد نیز اعمال می‌شود.
- همچنین گزینه‌های مشترک git-annex-common-options(1) نیز قابل استفاده هستند.
همچنین ببینید (SEE ALSO)
git-annex(1)
git-annex-find(1)
git-annex-list(1)
نویسنده (AUTHOR)
Joey Hess <id@joeyh.name>