git-update-index - آنلاین در ابر

برنامه:

نام

git-update-index - محتویات فایل را در درخت کاری در فهرست ثبت کنید

خلاصه

دستگاه گوارش به روز رسانی-شاخص
[--افزودن] [--حذف | --اجبار حذف] [--جایگزینی]
[--بازخوانی] [-q] [--لغو ادغام] [--نادیده گرفتن-مفقود]
[(--cacheinfo ، ، )...]
[--chmod=(+|-)x]
[--[نه-]فرض بدون تغییر]
[--[نه-]پرش-ورک درخت]
[--نادیده گرفتن-زیر ماژول ها]
[--[بدون-]شکاف شاخص]
[--[بدون-|نیروی-]حافظه پنهان]
[--واقعاً تازه کردن] [--حل نشدن] [--دوباره | -g]
[--فقط اطلاعات] [--index-info]
[-z] [--stdin] [--index-version ]
[--مختلف]
[--] [ ...]

شرح

کش فهرست یا فهرست را تغییر می دهد. هر فایل ذکر شده در فهرست و به روز رسانی می شود
هر آب نشده or نیازهای به روز رسانی حالت پاک می شود

همچنین مشاهده کنید git-add(1) برای یک روش کاربرپسندتر برای انجام برخی از رایج ترین عملیات
روی شاخص

راه دستگاه گوارش به روز رسانی-شاخص دسته فایل هایی که در مورد آن گفته می شود را می توان با استفاده از انواع مختلف تغییر داد
گزینه ها:

OPTIONS

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

--برداشتن
اگر یک فایل مشخص شده در فهرست وجود داشته باشد اما گم شده باشد، حذف می شود. رفتار پیش فرض
نادیده گرفتن فایل حذف شده است.

--تازه کردن
به نمایه فعلی نگاه می کند و بررسی می کند که آیا به ادغام یا به روز رسانی نیاز است یا خیر
بررسی اطلاعات stat()

-q
ساکت. اگر --refresh متوجه شود که ایندکس به به روز رسانی نیاز دارد، رفتار پیش فرض این است
خطا این گزینه می سازد دستگاه گوارش به روز رسانی-شاخص ادامه دادن به هر طریق.

--نادیده گرفتن-زیر ماژول ها
سعی نکنید زیر ماژول ها را به روز کنید. این گزینه فقط زمانی رعایت می شود که قبلاً تصویب شده باشد
--تازه کردن.

-- ادغام نشد
اگر --refresh تغییرات ادغام نشده را در ایندکس پیدا کند، رفتار پیش فرض خطا است
بیرون این گزینه می سازد دستگاه گوارش به روز رسانی-شاخص ادامه دادن به هر طریق.

--نادیده گرفتن-غایب
فایل های از دست رفته را در حین بازخوانی -- نادیده می گیرد

--cacheinfo ، ، ، --cacheinfo
مستقیماً اطلاعات مشخص شده را در فهرست قرار دهید. برای سازگاری با عقب، می توانید
همچنین این سه آرگومان را به عنوان سه پارامتر جداگانه ارائه دهید، اما کاربران جدید هستند
تشویق به استفاده از فرم تک پارامتری.

--index-info
اطلاعات فهرست را از stdin بخوانید.

--chmod=(+|-)x
مجوزهای اجرا را روی فایل های به روز شده تنظیم کنید.

--[نه-]فرض-بدون تغییر
هنگامی که این پرچم مشخص می شود، نام اشیاء ثبت شده برای مسیرها به روز نمی شود.
در عوض، این گزینه بیت «تصور بدون تغییر» را برای مسیرها تنظیم/تنظیم می‌کند. وقتی که
بیت "فرض بدون تغییر" روشن است، کاربر قول می دهد فایل را تغییر ندهد و به Git اجازه می دهد
فرض کنید که فایل درخت کاری با آنچه در فهرست ثبت شده مطابقت دارد. اگر شما
می‌خواهید فایل درختی کار را تغییر دهید، باید بیت را تنظیم کنید تا به Git بگویید. این هست
گاهی اوقات هنگام کار با یک پروژه بزرگ روی یک سیستم فایل که بسیار کند است مفید است
lstat(2) فراخوانی سیستم (به عنوان مثال cifs).

Git در صورتی که نیاز به تغییر این فایل در فهرست داشته باشد (به‌خوبی) شکست خواهد خورد
ادغام در یک تعهد؛ بنابراین، در صورتی که فایل فرضی-ردیابی نشده در بالادست تغییر کند، شما
باید وضعیت را به صورت دستی مدیریت کند.

-- واقعاً تازه کردن
پسندیدن --تازه کردن، اما اطلاعات آمار را بدون قید و شرط بررسی می کند
تنظیم "بدون تغییر".

--[no-] skip-worktree
هنگامی که یکی از این پرچم ها مشخص می شود، نام شیء ثبت شده برای مسیرها وجود ندارد
به روز شد. درعوض، این گزینه‌ها بیت «پرش کار درخت» را برای مسیرها تنظیم و تنظیم می‌کنند.
برای اطلاعات بیشتر به بخش "Skip-worktree bit" در زیر مراجعه کنید.

-g، --دوباره
اجرا می شود دستگاه گوارش به روز رسانی-شاخص خود را در مسیرهایی که ورودی های شاخص با آن ها متفاوت است
از HEAD commit.

-- حل نشدن
را بازیابی می کند آب نشده or نیازهای به روز رسانی وضعیت یک فایل در حین ادغام اگر بود
به طور تصادفی پاک شد

-- فقط اطلاعات
در پایگاه داده شی برای همه اشیاء ایجاد نکنید استدلال هایی که به دنبال این موضوع است
پرچم؛ فقط شناسه شی آنها را در ایندکس وارد کنید.

- حذف اجباری
حتی زمانی که دایرکتوری کاری هنوز چنین فایلی دارد، فایل را از فهرست حذف کنید.
(به معنی - حذف است.)

--جایگزین کردن
به طور پیش فرض، هنگامی که یک مسیر فایل در فهرست وجود دارد، دستگاه گوارش به روز رسانی-شاخص تلاشی را رد می کند
برای افزودن مسیر/فایل به طور مشابه اگر مسیر/فایل فایل وجود داشته باشد، مسیر فایل نمی تواند اضافه شود.
با پرچم --replace، ورودی های موجود که با ورودی اضافه شده مغایرت دارند، هستند
به طور خودکار با پیام های هشدار حذف می شود.

--stdin
به جای گرفتن لیست مسیرها از خط فرمان، لیست مسیرها را از خط فرمان بخوانید
ورودی استاندارد مسیرها به طور پیش فرض با LF (یعنی یک مسیر در هر خط) از هم جدا می شوند.

-- پرحرف
گزارش مواردی که از فهرست اضافه و حذف می شوند.

--index-نسخه
نمایه به دست آمده را در نسخه فرمت روی دیسک نامگذاری شده بنویسید. نسخه های پشتیبانی شده
2، 3 و 4 هستند. نسخه پیش‌فرض فعلی بسته به اضافه بودن 2 یا 3 است
از ویژگی هایی مانند git add -N استفاده می شود.

نسخه 4 فشرده سازی نام مسیر ساده را انجام می دهد که اندازه ایندکس را 30 تا 50 درصد کاهش می دهد.
مخازن بزرگ، که منجر به زمان بارگذاری سریعتر می شود. نسخه 4 نسبتا جوان است
(برای اولین بار در 1.8.0 در اکتبر 2012 منتشر شد). سایر پیاده سازی های Git مانند JGit
و libgit2 ممکن است هنوز از آن پشتیبانی نکند.

-z
فقط با --stdin یا --index-info معنادار است. مسیرها با کاراکتر NUL از هم جدا می شوند
به جای LF.

--split-index، --no-split-index
حالت تقسیم فهرست را فعال یا غیرفعال کنید. اگر فعال باشد، ایندکس به دو فایل تقسیم می شود.
$GIT_DIR/index و $GIT_DIR/shareindex. . تغییرات در انباشته شده است
$GIT_DIR/index در حالی که فایل فهرست مشترک شامل تمام ورودی های فهرست است بدون تغییر باقی می ماند.
اگر حالت split-index قبلاً فعال شده باشد و --split-index دوباره داده شود، همه تغییر می کنند
در $GIT_DIR/index به فایل فهرست مشترک بازگردانده می شوند. این حالت برای
نمایه های بسیار بزرگی که خواندن یا نوشتن آنها زمان قابل توجهی را می طلبد.

--untracked-cache, --no-untracked-cache
افزونه کش ردیابی نشده را فعال یا غیرفعال کنید. این می تواند برای دستوراتی که سرعت می بخشد
شامل تعیین فایل های ردیابی نشده مانند وضعیت git است. عملیات زیربنایی
سیستم و فایل سیستم باید فیلد st_mtime دایرکتوری را در صورت اضافه شدن فایل ها تغییر دهند
در آن دایرکتوری حذف شده است.

--force-untracked-cache
برای ایمنی، --untracked-cache تست هایی را روی دایرکتوری کاری انجام می دهد تا مطمئن شود
می توان از کش ردیابی نشده استفاده کرد. این آزمایشات ممکن است چند ثانیه طول بکشد.
-force-untracked-cache را می توان برای رد شدن از تست ها استفاده کرد.

--
هیچ استدلال دیگری را به عنوان گزینه تفسیر نکنید.


فایل هایی برای عمل کردن توجه داشته باشید که فایل هایی که با . دور ریخته می شوند. این شامل فایل ./
و dir/./file. اگر این را نمی‌خواهید، از نام‌های پاک‌تر استفاده کنید. همین امر در مورد
پایان دایرکتوری ها / و مسیرهایی با //

استفاده كردن --تازه کردن

--تازه کردن فایل sha1 جدید را محاسبه نمی کند یا ایندکس را برای آن به روز نمی کند
حالت/محتوا تغییر می کند اما آن چیست میکند do برای "تطبیق مجدد" اطلاعات آمار یک فایل است
با ایندکس، به طوری که بتوانید فهرست را برای فایلی که تغییر نکرده اما بازخوانی کنید
جایی که ورودی آمار قدیمی است.

به عنوان مثال، شما می خواهید این کار را پس از انجام یک انجام دهید دستگاه گوارش درخت خواندن، برای پیوند دادن شاخص آمار
جزئیات با فایل های مناسب

استفاده كردن -- CACHEINFO OR -- INFO-ONLY

--cacheinfo برای ثبت فایلی که در دایرکتوری کاری فعلی نیست استفاده می شود. این
برای ادغام حداقل پرداخت مفید است.

برای اینکه وانمود کنید فایلی با mode و sha1 در مسیر دارید، بگویید:

$ git update-index --cacheinfo ، ،

-- فقط اطلاعات برای ثبت فایل ها بدون قرار دادن آنها در پایگاه داده شی استفاده می شود. این هست
برای مخازن فقط وضعیت مفید است.

هر دو --cacheinfo و -- فقط اطلاعات رفتار مشابهی داشته باشید: شاخص به روز شده است اما شی
پایگاه داده نیست. --cacheinfo زمانی مفید است که شی در پایگاه داده اما فایل باشد
به صورت محلی در دسترس نیست -- فقط اطلاعات زمانی مفید است که فایل موجود باشد، اما شما اینطور نیستید
مایل به به روز رسانی پایگاه داده شی.

استفاده كردن --INDEX-INFO

--index-info مکانیزم قدرتمندتری است که به شما امکان می دهد تعاریف ورودی چندگانه را ارائه دهید
از ورودی استاندارد، و به طور خاص برای اسکریپت طراحی شده است. می تواند ورودی هایی از
سه فرمت:

1. حالت SP sha1 مسیر TAB

فرمت اول چیزی است که "git-apply --index-info" گزارش می دهد و برای بازسازی a استفاده می شود
درخت جزئی که برای ادغام ساختگی درخت پایه در هنگام بازگشت به ادغام 3 طرفه استفاده می شود.

2. حالت SP نوع SP sha1 مسیر TAB

فرمت دوم پر کردن است دستگاه گوارش ls-tree خروجی در فایل فهرست

3. حالت مسیر SP sha1 SP مرحله TAB

این قالب برای قرار دادن مراحل مرتبه بالاتر در فایل فهرست و مسابقات است دستگاه گوارش فایل های ls
--صحنه خروجی.

برای قرار دادن یک ورودی مرحله بالاتر به شاخص، ابتدا باید مسیر را با تغذیه a حذف کرد
mode=0 ورودی مسیر، و سپس تغذیه خطوط ورودی لازم در قالب سوم.

برای مثال، با این شاخص شروع کنید:

$ git ls-files -s
100644 8a1218a1024a212bb3db30becd860315f9f3ac52 0 frotz

می توانید ورودی زیر را به --index-info وارد کنید:

$ git update-index --index-info
0 0000000000000000000000000000000000000000
100644 8a1218a1024a212bb3db30becd860315f9f3ac52 1 frotz
100755 8a1218a1024a212bb3db30becd860315f9f3ac52 2 frotz

خط اول ورودی 0 را به عنوان حالت حذف مسیر تغذیه می کند. SHA-1 ندارد
مهم است به شرطی که به خوبی قالب بندی شده باشد. سپس خط دوم و سوم مرحله 1 را تغذیه می کند و
ورودی های مرحله 2 برای آن مسیر. پس از موارد فوق، به این نتیجه می رسیم:

$ git ls-files -s
100644 8a1218a1024a212bb3db30becd860315f9f3ac52 1 frotz
100755 8a1218a1024a212bb3db30becd860315f9f3ac52 2 frotz

استفاده كردن "فرض بدون تغییر” BIT

بسیاری از عملیات در Git برای داشتن کارآمدی به سیستم فایل شما بستگی دارد lstat(2)
پیاده سازی، به طوری که اطلاعات st_mtime برای فایل های درختی کار می تواند به طور ارزان بررسی شود
برای دیدن اینکه آیا محتوای فایل نسبت به نسخه ثبت شده در فایل فهرست تغییر کرده است یا خیر.
متأسفانه برخی از سیستم های فایل ناکارآمد هستند lstat(2). اگر سیستم فایل شما یکی از
آنها، می توانید بیت "فرض بدون تغییر" را روی مسیرهایی که تغییر نداده اید تنظیم کنید تا باعث شود Git این کار را انجام ندهد.
این بررسی را انجام دهید توجه داشته باشید که تنظیم این بیت در یک مسیر به این معنی نیست که Git آن را بررسی می کند
محتویات فایل برای دیدن اینکه آیا تغییر کرده است یا خیر - باعث می شود Git هر گونه بررسی را حذف کند
فرض کنید دارد نه تغییر کرد. وقتی در فایل های درختی کار تغییراتی ایجاد می کنید، باید این کار را انجام دهید
صراحتاً با انداختن بیت «فرض بدون تغییر»، قبل یا بعد از آن، به Git در مورد آن بگویید.
شما آنها را اصلاح می کنید

برای تنظیم بیت "فرض بدون تغییر"، از گزینه --assume-unchanged استفاده کنید. برای تنظیم، استفاده کنید
--بدون-فرض-بدون تغییر. برای اینکه ببینید کدام فایل‌ها دارای مجموعه بیت «فرض بدون تغییر» هستند، از git استفاده کنید
ls-files -v (نگاه کنید به فایل های git-ls(1).

این دستور به متغیر پیکربندی core.ignorestat نگاه می کند. وقتی این درست است، مسیرها
با git update-index paths... و مسیرهای به روز شده با دستورات Git دیگر که
به روز رسانی هر دو شاخص و درخت کار (به عنوان مثال دستگاه گوارش درخواست --فهرست مطالب, دستگاه گوارش فهرست پرداخت -uو دستگاه گوارش
درخت خواندن -u) به طور خودکار به عنوان "فرض بدون تغییر" علامت گذاری می شوند. توجه داشته باشید که "بدون تغییر فرض کنید"
بیت است نه set if git update-index --refresh پیدا می کند که فایل درخت کاری با ایندکس مطابقت دارد
(اگر می خواهید آنها را به عنوان "فرض بدون تغییر" علامت گذاری کنید، از git update-index --really-refresh استفاده کنید).

مثال ها

برای به‌روزرسانی و بازخوانی فقط فایل‌هایی که قبلاً بررسی شده‌اند:

$ git checkout-index -n -f -a && git update-index - نادیده گرفتن-مفقود -بازخوانی

در یک فایل سیستم ناکارآمد با مجموعه core.ignorestat

$ git update-index --really-refresh (1)
$ git update-index --no-assume-unchanged foo.c (2)
$ git diff ---only (3)
$ ویرایش foo.c
$ git diff ---only (4)
M foo.c
$ git update-index foo.c (5)
$ git diff ---only (6)
$ ویرایش foo.c
$ git diff ---only (7)
$ git update-index --no-assume-unchanged foo.c (8)
$ git diff ---only (9)
M foo.c

1. نیروهای lstat(2) برای تنظیم بیت های "فرض بدون تغییر" برای مسیرهایی که با شاخص مطابقت دارند.
2. مسیر مورد ویرایش را علامت بزنید
3. این کار را انجام می دهد lstat(2) و فهرست مطابق با مسیر را پیدا می کند.
4. این کار را انجام می دهد lstat(2) و شاخص انجام می دهد نه مسیر را مطابقت دهید
5. ثبت نسخه جدید به مجموعه های فهرست "بدون تغییر" بیت.
6. و بدون تغییر فرض می شود.
7. حتی بعد از اینکه آن را ویرایش کردید
8. شما می توانید در مورد تغییر بعد از واقعیت بگویید.
9. اکنون با آن چک می کند lstat(2) و متوجه می شود که تغییر کرده است.

SKIP-WORKTEE BIT

بیت Skip-worktree را می توان در یک جمله (طولانی) تعریف کرد: هنگام خواندن یک ورودی، اگر
به عنوان skip-worktree علامت گذاری شده است، سپس Git وانمود می کند که نسخه دایرکتوری کاری آن به روز است و
به جای آن نسخه شاخص را بخوانید.

برای توضیح بیشتر، "خواندن" به معنای بررسی وجود فایل، خواندن ویژگی های فایل یا فایل است
محتوا. نسخه دایرکتوری کاری ممکن است وجود داشته باشد یا وجود نداشته باشد. در صورت وجود، محتوای آن
ممکن است با نسخه شاخص مطابقت داشته باشد یا خیر. نوشتن تحت تأثیر این بیت، محتوا قرار نمی گیرد
ایمنی همچنان اولویت اول است توجه داشته باشید که Git می توان به روز رسانی فایل دایرکتوری کار، یعنی
skip-worktree علامت گذاری شده است، در صورتی که انجام این کار ایمن باشد (یعنی نسخه دایرکتوری کار با شاخص مطابقت دارد
نسخه)

اگرچه این بیت شبیه بیت فرضی بدون تغییر به نظر می رسد، اما هدف آن متفاوت است
بیت های فرضی بدون تغییر Skip-worktree همچنین بر بیت فرض بدون تغییر زمانی اولویت دارد
هر دو تنظیم شده اند

پیکربندی

دستور به متغیر پیکربندی core.filemode احترام می گذارد. اگر مخزن شما روی یک است
فایل سیستمی که بیت های اجرایی آن غیرقابل اعتماد هستند، باید روی آن تنظیم شود غلط (نگاه کنید به git-
پیکربندی(1)). این امر باعث می شود که دستور نادیده بگیرد تفاوت حالت های فایل ثبت شده در
ایندکس و حالت فایل در سیستم فایل اگر فقط در بیت اجرایی متفاوت باشند. روی چنین
یک فایل سیستم تاسف بار، ممکن است لازم باشد از آن استفاده کنید دستگاه گوارش به روز رسانی-شاخص --chmod=.

به طور کاملاً مشابه، اگر متغیر پیکربندی core.symlinks روی تنظیم شده باشد غلط (نگاه کنید به git-
پیکربندی(1))، پیوندهای نمادین به عنوان فایل های ساده بررسی می شوند، و این دستور این کار را نمی کند
یک حالت فایل ضبط شده را از پیوند نمادین به فایل معمولی تغییر دهید.

این دستور به متغیر پیکربندی core.ignorestat نگاه می کند. دیدن با استفاده از "فرض بدون تغییر"
ذره بخش بالا

این دستور همچنین به متغیر پیکربندی core.trustctime نگاه می کند. زمانی که می تواند مفید باشد
زمان تغییر inode مرتباً توسط چیزی خارج از Git (خزنده‌های سیستم فایل) اصلاح می‌شود
و سیستم های پشتیبان از ctime برای علامت گذاری فایل های پردازش شده استفاده می کنند (نگاه کنید به گیت(1).

از git-update-index به صورت آنلاین با استفاده از خدمات onworks.net استفاده کنید