| git-annex-log(1) | General Commands Manual | git-annex-log(1) |
نام (NAME)
git-annex-log - نمایش گزارش تاریخچه تغییرات موقعیت و مکان فایلها
خلاصه دستور (SYNOPSIS)
git annex log [path ...]
توضیحات (DESCRIPTION)
این دستور اطلاعاتی را از تاریخچه شاخه git-annex نمایش میدهد.
چندین مورد میتواند مانع از در دسترس بودن این اطلاعات برای نمایش شود. هنگامی که از git-annex-forget استفاده میشود، دادههای تاریخی قدیمی از شاخه پاک میشوند. هنگامی که annex.private یا remote.name.annex-private پیکربندی شده باشد، git-annex اصلاً هیچ اطلاعاتی در شاخه ثبت نمیکند. و هنگامی که annex.alwayscommit بر روی false تنظیم شده باشد، ممکن است اطلاعات هنوز در شاخه کامیت نشده باشند.
گزینهها (OPTIONS)
- [path ...]
- گزارش موقعیت مکانی فایل یا فایلهای مشخصشده را نمایش میدهد و هر مخزنی را که این فایلها به آن اضافه شدهاند («+») و از آن حذف شدهاند («-») نشان میدهد. توجه داشته باشید که این گزینه اطلاعات مربوط به محتوای فایلی را که در حال حاضر در این مسیرها قرار دارد نمایش میدهد، نه هرگونه محتوای متفاوتی را که در کامیتهای قبلی در آنجا وجود داشته است.
- matching options
- میتوان از git-annex-matching-options(1) برای کنترل مواردی که هنگام نمایش گزارش موقعیت مکانی برای فایلهای مشخصشده روی آنها اقدام میشود، استفاده کرد.
- --all -A
- تغییرات گزارش موقعیت مکانی را برای تمام محتواها نشان میدهد، بهطوری که جدیدترین تغییرات در ابتدا نمایش داده میشوند. در این حالت، نام فایلها در دسترس نیست و در عوض کلیدها نمایش داده میشوند.
- --key=keyname
- گزارش موقعیت مکانی را برای کلید مشخصشده نمایش میدهد.
- --branch=ref
- گزارش موقعیت مکانی فایلها را در شاخه یا شیء درختی (treeish) مشخصشده نمایش میدهد.
- --unused
- گزارش موقعیت مکانی فایلهای یافتشده در آخرین اجرای git-annex unused را نمایش میدهد.
- --sizesof=repository
- تاریخچهای از اندازه کل فایلهای پیوستشده (annexed) در یک مخزن را در طول زمان، از زمان ایجاد مخزن تا زمان حال نمایش میدهد.
- مخزن میتواند here برای مخزن جاری، یا نام یک مخزن دوردست (remote)، یا توضیحات مخزن یا uuid باشد.
- توجه داشته باشید کلیدهایی که اندازه مشخصی ندارند، در این مجموع محاسبه نمیشوند.
- --sizes
- این گزینه شبیه به --sizesof است، اما به جای نمایش اندازه یک مخزن منفرد، اندازه تمام مخازن شناختهشده را نمایش میدهد.
- خروجی این دستور، یک جدول با قالببندی CSV است.
- --totalsizes
- این گزینه شبیه به --sizesof است، اما مجموع اندازه تمام مخازن شناختهشده را نمایش میدهد.
- --interval=time
- هنگام استفاده از --sizesof، --sizes و --totalsizes، این گزینه حداقل فاصله زمانی بین نمایشهای اندازه را کنترل میکند. حالت پیشفرض نمایش هر اندازه ثبتشده جدید است.
- زمان به شکل 30d یا 1y است.
- --received
- ترکیب این گزینه با --sizesof یا --sizes میزان دادههای دریافت شده در مخازن از زمان چاپ آخرین خط خروجی را نمایش میدهد.
- --gnuplot
- این گزینه را با --sizesof، --sizes یا --totalsizes ترکیب کنید تا با استفاده از gnuplot(1) دادهها به صورت نمودار رسم شوند. فایل gnuplot برای استفاده مجدد شما بر روی دیسک باقی خواهد ماند.
- برای مثال، جهت رسم نمودار اندازه تمام مخازن:
- git-annex log --sizes --interval=1d --gnuplot
- برای رسم نمودار میزان دادههای جدید دریافتشده در هر مخزن در هر ۳۰ روز:
- git-annex log --sizes --interval=30d --gnuplot --recieved
- --bytes
- نمایش اندازهها بر حسب بایت، و غیرفعال کردن واحدهای خواناتر پیشفرض.
- --raw-date
- به جای نمایش معمول تاریخ در منطقه زمانی محلی، ثانیههای سپریشده از مبدأ یونیکس (unix epoch) را نمایش میدهد.
- --since=date, --after=date, --until=date, --before=date, --max-count=N
- این گزینهها به git log ارسال میشوند و میتوانند برای محدود کردن میزان بازگشت به گذشته در جستجوی تغییرات گزارش موقعیت مکانی استفاده شوند.
- برای مثال: --since "1 month ago"
- این گزینهها هنگام استفاده از --sizesof، --sizes و --totalsizes تأثیری ندارند.
- --gource
- خروجی مناسبی برای برنامه مصورسازی gource تولید میکند.
- این گزینه هنگام استفاده از --sizesof، --sizes و --totalsizes تأثیری ندارد.
- --json
- فعال کردن خروجی JSON. این گزینه برای تجزیه و پردازش توسط برنامههایی که از git-annex استفاده میکنند در نظر گرفته شده است. هر خط از خروجی یک شیء JSON است.
- این گزینه هنگام استفاده از --sizesof، --sizes و --totalsizes تأثیری ندارد.
- --json-error-messages
- پیامهایی که بهطور معمول در خروجی خطای استاندارد قرار میگیرند، در عوض در داخل JSON گنجانده میشوند.
- این گزینه هنگام استفاده از --sizesof، --sizes و --totalsizes تأثیری ندارد.
- همچنین میتوان از گزینههای git-annex-common-options(1) نیز استفاده کرد.
همچنین ببینید (SEE ALSO)
git-annex(1)
git-annex-forget(1)
نویسنده (AUTHOR)
Joey Hess <id@joeyh.name>