نام (NAME)

git-check-ignore - اشکال‌زدایی فایل‌های gitignore / exclude

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

git check-ignore [<options>] <pathname>...
git check-ignore [<options>] --stdin

توضیحات (DESCRIPTION)

به ازای هر نام مسیر داده‌شده از طریق خط فرمان یا از طریق یک فایل با --stdin، بررسی می‌کند که آیا فایل توسط .gitignore (یا سایر فایل‌های ورودی به سازوکار مستثنی‌سازی) نادیده گرفته شده است یا خیر و در صورت مستثنی بودن، مسیر را در خروجی چاپ می‌کند.

به طور پیش‌فرض، فایل‌های ردگیری‌شده (tracked) اصلاً نمایش داده نمی‌شوند زیرا مشمول قوانین مستثنی‌سازی نیستند؛ اما ‘--no-index’ را ببینید.

گزینه‌ها (OPTIONS)

-q, --quiet

-v, --verbose

--stdin

-z

-n, --non-matching

--no-index

خروجی (OUTPUT)

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

اگر --verbose مشخص شود، خروجی به صورت مجموعه‌ای از خطوط با قالب زیر خواهد بود:

<source> <COLON> <linenum> <COLON> <pattern> <HT> <pathname>

<pathname> مسیر فایل مورد پرس‌وجو، <pattern> الگوی تطبیق‌یافته، <source> فایل منبع الگو، و <linenum> شماره خط الگو در آن منبع است. اگر الگو دارای پیشوند «!» یا پسوند «/» باشد، در خروجی حفظ خواهد شد. هنگامی که <source> به فایل پیکربندی‌شده توسط core.excludesFile اشاره کند، یک مسیر مطلق خواهد بود، یا هنگام اشاره به .git/info/exclude یا یک فایل استثنای درون هر دایرکتوری، نسبت به ریشه مخزن خواهد بود.

اگر -z مشخص شود، نام مسیرها در خروجی با نویسه null جدا می‌شوند؛ اگر --verbose نیز مشخص شده باشد، به جای دونقطه و تب سخت (hard tab) نیز از نویسه‌های null استفاده می‌شود:

<source> <NULL> <linenum> <NULL> <pattern> <NULL> <pathname> <NULL>

اگر -n یا --non-matching مشخص شوند، نام مسیرهای نامنطبق نیز در خروجی چاپ خواهند شد، که در این حالت تمام فیلدها در هر رکورد خروجی به جز <pathname> خالی خواهند بود. این می‌تواند هنگام اجرای غیرتعاملی مفید باشد، به طوری که فایل‌ها را می‌توان به صورت تدریجی به STDIN یک فرآیند طولانی‌مدت check-ignore هدایت کرد، و به ازای هر یک از این فایل‌ها، STDOUT مشخص خواهد کرد که آیا آن فایل با الگویی مطابقت داشته است یا خیر. (بدون این گزینه، تشخیص این که آیا نبود خروجی برای یک فایل معین به معنی عدم تطابق با هرگونه الگو بوده، یا این که خروجی هنوز تولید نشده است، غیرممکن خواهد بود).

بافرسازی همان‌طور که ذیل گزینه GIT_FLUSH در git(1) مستند شده است انجام می‌شود. فراخواننده مسئول جلوگیری از بن‌بست‌های ناشی از پر شدن بیش از حد بافر ورودی یا خواندن از بافر خروجی خالی است.

وضعیت خروج (EXIT STATUS)

0

1

128

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

gitignore(5) git-config(1) git-ls-files(1)

GIT

بخشی از مجموعه git(1)