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>

                                                          git-annex-whereis(1)