'\" t
.\"     Title: git-grep
.\"    Author: [FIXME: author] [see http://www.docbook.org/tdg5/en/html/author]
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
.\"      Date: 2026-06-29
.\"    Manual: Git Manual
.\"    Source: Git 2.55.0
.\"  Language: Persian
.\"
.TH "GIT\-GREP" "1" "2026\-06\-29" "Git 2\&.55\&.0" "Git Manual"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "نام (NAME)"
git-grep \- چاپ خطوط منطبق با یک الگو
.SH "خلاصه دستور (SYNOPSIS)"
.sp
.nf
\fBgit\fR \fBgrep\fR [\fB\-a\fR | \fB\-\-text\fR] [\fB\-I\fR] [\fB\-\-textconv\fR] [\fB\-i\fR | \fB\-\-ignore\-case\fR] [\fB\-w\fR | \fB\-\-word\-regexp\fR]
           [\fB\-v\fR | \fB\-\-invert\-match\fR] [\fB\-h\fR|\fB\-H\fR] [\fB\-\-full\-name\fR]
           [\fB\-E\fR | \fB\-\-extended\-regexp\fR] [\fB\-G\fR | \fB\-\-basic\-regexp\fR]
           [\fB\-P\fR | \fB\-\-perl\-regexp\fR]
           [\fB\-F\fR | \fB\-\-fixed\-strings\fR] [\fB\-n\fR | \fB\-\-line\-number\fR] [\fB\-\-column\fR]
           [\fB\-l\fR | \fB\-\-files\-with\-matches\fR] [\fB\-L\fR | \fB\-\-files\-without\-match\fR]
           [(\fB\-O\fR | \fB\-\-open\-files\-in\-pager\fR) [\fI<pager>\fR]]
           [\fB\-z\fR | \fB\-\-null\fR]
           [ \fB\-o\fR | \fB\-\-only\-matching\fR ] [\fB\-c\fR | \fB\-\-count\fR] [\fB\-\-all\-match\fR] [\fB\-q\fR | \fB\-\-quiet\fR]
           [\fB\-\-max\-depth\fR \fI<depth>\fR] [\fB\-\-\fR[\fBno\-\fR]\fBrecursive\fR]
           [\fB\-\-color\fR[\fB=\fR\fI<when>\fR] | \fB\-\-no\-color\fR]
           [\fB\-\-break\fR] [\fB\-\-heading\fR] [\fB\-p\fR | \fB\-\-show\-function\fR]
           [\fB\-A\fR \fI<post\-context>\fR] [\fB\-B\fR \fI<pre\-context>\fR] [\fB\-C\fR \fI<context>\fR]
           [\fB\-W\fR | \fB\-\-function\-context\fR]
           [(\fB\-m\fR | \fB\-\-max\-count\fR) \fI<num>\fR]
           [\fB\-\-threads\fR \fI<num>\fR]
           [\fB\-f\fR \fI<file>\fR] [\fB\-e\fR] \fI<pattern>\fR
           [\fB\-\-and\fR|\fB\-\-or\fR|\fB\-\-not\fR|(|)|\fB\-e\fR \fI<pattern>\fR\&...]
           [\fB\-\-recurse\-submodules\fR] [\fB\-\-parent\-basename\fR \fI<basename>\fR]
           [ [\fB\-\-\fR[\fBno\-\fR]\fBexclude\-standard\fR] [\fB\-\-cached\fR | \fB\-\-untracked\fR | \fB\-\-no\-index\fR] | \fI<tree>\fR\&...]
           [\fB\-\-\fR] [\fI<pathspec>\fR\&...]
.fi
.sp
.SH "توضیحات (DESCRIPTION)"
.sp
جستجو برای الگوهای مشخص‌شده در فایل‌های ردیابی‌شده در درخت کاری، blobهای ثبت‌شده در فایل نمایه، یا blobها در اشیاء درخت (tree) داده‌شده\&. الگوها فهرست‌هایی از یک یا چند عبارت جستجو هستند که با نویسه خط جدید از هم جدا شده‌اند\&. یک رشته خالی به عنوان عبارت جستجو با تمام خطوط مطابقت دارد\&.
.SH "گزینه‌ها (OPTIONS)"
.PP
\fB\-\-cached\fR
.RS 4
به جای جستجو در فایل‌های ردیابی‌شده در درخت کاری، در blobهای ثبت‌شده در فایل نمایه جستجو می‌کند\&.
.RE
.PP
\fB\-\-untracked\fR
.RS 4
علاوه بر جستجو در فایل‌های ردیابی‌شده در درخت کاری، در فایل‌های ردیابی‌نشده نیز جستجو می‌کند\&.
.RE
.PP
\fB\-\-no\-index\fR
.RS 4
جستجوی فایل‌ها در دایرکتوری جاری که توسط گیت مدیریت نمی‌شود، یا با نادیده گرفتن اینکه دایرکتوری جاری توسط گیت مدیریت می‌شود\&. این کار تا حدودی شبیه به اجرای ابزار معمولی
\fBgrep\fR(1)
همراه با گزینه
\fB\-r\fR
آن است، اما با مزایای اضافی، مانند استفاده از الگوهای pathspec برای محدود کردن مسیرها؛ برای اطلاعات بیشتر مدخل
\fBpathspec\fR
در
\fBgitglossary\fR(7)
را ببینید\&.
.sp
این گزینه نمی‌تواند همراه با
\fB\-\-cached\fR
یا
\fB\-\-untracked\fR
استفاده شود\&. همچنین به
\fBgrep\&.fallbackToNoIndex\fR
در بخش
\fICONFIGURATION\fR
در زیر مراجعه کنید\&.
.RE
.PP
\fB\-\-no\-exclude\-standard\fR
.RS 4
همچنین در فایل‌های نادیده‌گرفته‌شده با نادیده گرفتن سازوکار
\fB\&.gitignore\fR
جستجو می‌کند\&. تنها با گزینه
\fB\-\-untracked\fR
مفید است\&.
.RE
.PP
\fB\-\-exclude\-standard\fR
.RS 4
به فایل‌های نادیده‌گرفته‌شده مشخص‌شده از طریق سازوکار
\fB\&.gitignore\fR
توجه نمی‌کند\&. تنها هنگام جستجوی فایل‌ها در دایرکتوری جاری با
\fB\-\-no\-index\fR
مفید است\&.
.RE
.PP
\fB\-\-recurse\-submodules\fR
.RS 4
جستجوی بازگشتی در هر زیرماژول که در مخزن فعال و دریافت (checked out) شده است\&. هنگامی که در ترکیب با گزینه
\fI<tree>\fR
استفاده شود، پیشوند تمام خروجی‌های زیرماژول، نام شیء
\fI<tree>\fR
پروژه والد خواهد بود\&. این گزینه نمی‌تواند همراه با
\fB\-\-untracked\fR
استفاده شود، و اگر
\fB\-\-no\-index\fR
مشخص شده باشد هیچ تأثیری ندارد\&.
.RE
.PP
\fB\-a\fR, \fB\-\-text\fR
.RS 4
پردازش فایل‌های باینری به گونه‌ای که گویی متنی هستند\&.
.RE
.PP
\fB\-\-textconv\fR
.RS 4
رعایت تنظیمات فیلتر textconv\&.
.RE
.PP
\fB\-\-no\-textconv\fR
.RS 4
رعایت نکردن تنظیمات فیلتر textconv\&. این حالت پیش‌فرض است\&.
.RE
.PP
\fB\-i\fR, \fB\-\-ignore\-case\fR
.RS 4
نادیده گرفتن تفاوت حروف کوچک و بزرگ بین الگوها و فایل‌ها\&.
.RE
.PP
\fB\-I\fR
.RS 4
عدم تطبیق الگو در فایل‌های باینری\&.
.RE
.PP
\fB\-\-max\-depth\fR \fI<depth>\fR
.RS 4
به ازای هر
\fI<pathspec>\fR
داده‌شده در خط فرمان، حداکثر تا
\fI<depth>\fR
سطح از دایرکتوری‌ها به پایین می‌رود\&. مقدار 1\- به معنی عدم محدودیت است\&. این گزینه در صورتی که
\fI<pathspec>\fR
حاوی نویسه‌های عام (wildcard) فعال باشد نادیده گرفته می‌شود\&. به عبارت دیگر اگر "a*" با دایرکتوری به نام "a*" مطابقت داشته باشد، "*" به صورت تحت‌اللفظی تطبیق داده می‌شود، بنابراین
\fB\-\-max\-depth\fR
همچنان مؤثر است\&.
.RE
.PP
\fB\-r\fR, \fB\-\-recursive\fR
.RS 4
مشابه
\fB\-\-max\-depth=\-1\fR؛
این حالت پیش‌فرض است\&.
.RE
.PP
\fB\-\-no\-recursive\fR
.RS 4
مشابه
\fB\-\-max\-depth=0\fR\&.
.RE
.PP
\fB\-w\fR, \fB\-\-word\-regexp\fR
.RS 4
تطبیق الگو تنها در مرز کلمه (یا در ابتدای خط شروع شود یا قبل از آن یک نویسه غیرکلمه‌ای باشد؛ یا در انتهای خط پایان یابد یا بعد از آن یک نویسه غیرکلمه‌ای باشد)\&.
.RE
.PP
\fB\-v\fR, \fB\-\-invert\-match\fR
.RS 4
انتخاب خطوط غیرمنطبق\&.
.RE
.PP
\fB\-h\fR, \fB\-H\fR
.RS 4
به‌طور پیش‌فرض، دستور نام فایل را برای هر تطابق نشان می‌دهد\&. گزینه
\fB\-h\fR
برای سرکوب این خروجی استفاده می‌شود\&. گزینه
\fB\-H\fR
برای کامل بودن وجود دارد و کاری انجام نمی‌دهد جز اینکه گزینه
\fB\-h\fR
را که پیش‌تر در خط فرمان داده شده لغو می‌کند\&.
.RE
.PP
\fB\-\-full\-name\fR
.RS 4
هنگامی که از یک زیردایرکتوری اجرا می‌شود، دستور معمولاً مسیرها را نسبت به دایرکتوری جاری خروجی می‌دهد\&. این گزینه خروجی مسیرها را نسبت به دایرکتوری اصلی پروژه اجباری می‌کند\&.
.RE
.PP
\fB\-E\fR, \fB\-\-extended\-regexp\fR, \fB\-G\fR, \fB\-\-basic\-regexp\fR
.RS 4
استفاده از عبارات منظم گسترده/پایه POSIX برای الگوها\&. پیش‌فرض استفاده از عبارات منظم پایه است\&.
.RE
.PP
\fB\-P\fR, \fB\-\-perl\-regexp\fR
.RS 4
استفاده از عبارات منظم سازگار با پرل (Perl) برای الگوها\&.
.sp
پشتیبانی از این نوع عبارات منظم یک وابستگی اختیاری زمان کامپایل است\&. اگر گیت با پشتیبانی از آن‌ها کامپایل نشده باشد، ارائه این گزینه باعث خاتمه با خطا خواهد شد\&.
.RE
.PP
\fB\-F\fR, \fB\-\-fixed\-strings\fR
.RS 4
استفاده از رشته‌های ثابت برای الگوها (الگو به عنوان عبارت منظم تفسیر نمی‌شود)\&.
.RE
.PP
\fB\-n\fR, \fB\-\-line\-number\fR
.RS 4
افزودن شماره خط به ابتدای خطوط منطبق\&.
.RE
.PP
\fB\-\-column\fR
.RS 4
افزودن آفست بایتی (شروع از ۱) اولین تطابق از ابتدای خط منطبق، به عنوان پیشوند\&.
.RE
.PP
\fB\-l\fR, \fB\-\-files\-with\-matches\fR, \fB\-\-name\-only\fR, \fB\-L\fR, \fB\-\-files\-without\-match\fR
.RS 4
به جای نمایش هر خط منطبق، تنها نام فایل‌هایی را نشان می‌دهد که حاوی تطابق هستند (یا نیستند)\&. برای سازگاری بهتر با
\fBgit\fR
\fBdiff\fR،
گزینه
\fB\-\-name\-only\fR
مترادفی برای
\fB\-\-files\-with\-matches\fR
است\&.
.RE
.PP
\fB\-O\fR[\fI<pager>\fR], \fB\-\-open\-files\-in\-pager\fR[\fB=\fR\fI<pager>\fR]
.RS 4
باز کردن فایل‌های منطبق در صفحه‌بند (نه خروجی
\fBgrep\fR)\&.
اگر صفحه‌بند "less" یا "vi" باشد و کاربر تنها یک الگو مشخص کرده باشد، اولین فایل به‌طور خودکار در اولین تطابق قرار می‌گیرد\&. آرگومان
\fBpager\fR
اختیاری است؛ در صورت مشخص شدن، باید بدون فاصله به گزینه متصل باشد\&. اگر
\fBpager\fR
مشخص نشود، از صفحه‌بند پیش‌فرض استفاده خواهد شد (ببینید:
\fBcore\&.pager\fR
در
\fBgit-config\fR(1))\&.
.RE
.PP
\fB\-z\fR, \fB\-\-null\fR
.RS 4
استفاده از \e0 به عنوان جداکننده نام مسیرها در خروجی، و چاپ آن‌ها به‌صورت دست‌نخورده\&. بدون این گزینه، نام مسیرهای دارای نویسه‌های «غیرمعمول» طبق توضیحات متغیر پیکربندی
\fBcore\&.quotePath\fR
نقل‌قول می‌شوند (ببینید:
\fBgit-config\fR(1))\&.
.RE
.PP
\fB\-o\fR, \fB\-\-only\-matching\fR
.RS 4
تنها بخش‌های منطبق (غیرخالی) از یک خط منطبق را چاپ می‌کند، به‌طوری که هر بخش در یک خط خروجی جداگانه باشد\&.
.RE
.PP
\fB\-c\fR, \fB\-\-count\fR
.RS 4
به جای نمایش هر خط منطبق، تعداد خطوطی را که مطابقت دارند نشان می‌دهد\&.
.RE
.PP
\fB\-\-color\fR[\fB=\fR\fI<when>\fR]
.RS 4
نمایش تطابق‌های رنگی\&. مقدار باید یکی از موارد
\fBalways\fR
(پیش‌فرض)،
\fBnever\fR
یا
\fBauto\fR
باشد\&.
.RE
.PP
\fB\-\-no\-color\fR
.RS 4
خاموش کردن برجسته‌سازی تطابق‌ها، حتی زمانی که فایل پیکربندی پیش‌فرض را خروجی رنگی قرار داده باشد\&. مشابه
\fB\-\-color=never\fR\&.
.RE
.PP
\fB\-\-break\fR
.RS 4
چاپ یک خط خالی میان تطابق‌های فایل‌های مختلف\&.
.RE
.PP
\fB\-\-heading\fR
.RS 4
نمایش نام فایل در بالای تطابق‌های آن فایل به جای ابتدای هر خط نمایش‌داده‌شده\&.
.RE
.PP
\fB\-p\fR, \fB\-\-show\-function\fR
.RS 4
نمایش خط قبلی حاوی نام تابع مربوط به تطابق، مگر اینکه خود خط منطبق نام تابع باشد\&. نام تابع به همان روشی تعیین می‌شود که
\fBgit\fR
\fBdiff\fR
هدرهای قطعه پچ را مشخص می‌کند (ببینید:
\fIDefining a custom hunk\-header\fR
در
\fBgitattributes\fR(5))\&.
.RE
.PP
\fB\-\fR\fI<num>\fR, \fB\-C\fR \fI<num>\fR, \fB\-\-context\fR \fI<num>\fR
.RS 4
نمایش
\fI<num>\fR
خط قبل و بعد، و قرار دادن خطی شامل
\fB\-\-\fR
میان گروه‌های پیوسته تطابق‌ها\&.
.RE
.PP
\fB\-A\fR \fI<num>\fR, \fB\-\-after\-context\fR \fI<num>\fR
.RS 4
نمایش
\fI<num>\fR
خط بعد، و قرار دادن خطی شامل
\fB\-\-\fR
میان گروه‌های پیوسته تطابق‌ها\&.
.RE
.PP
\fB\-B\fR \fI<num>\fR, \fB\-\-before\-context\fR \fI<num>\fR
.RS 4
نمایش
\fI<num>\fR
خط قبل، و قرار دادن خطی شامل
\fB\-\-\fR
میان گروه‌های پیوسته تطابق‌ها\&.
.RE
.PP
\fB\-W\fR, \fB\-\-function\-context\fR
.RS 4
نمایش متن پیرامونی از خط قبلی حاوی نام تابع تا خط پیش از نام تابع بعدی، که عملاً کل تابعی را که تطابق در آن یافت شده است نشان می‌دهد\&. نام تابع به همان روشی تعیین می‌شود که
\fBgit\fR
\fBdiff\fR
هدرهای قطعه پچ را مشخص می‌کند (ببینید:
\fIDefining a custom hunk\-header\fR
در
\fBgitattributes\fR(5))\&.
.RE
.PP
\fB\-m\fR \fI<num>\fR, \fB\-\-max\-count\fR \fI<num>\fR
.RS 4
محدود کردن تعداد تطابق‌ها در هر فایل\&. هنگام استفاده از گزینه
\fB\-v\fR
یا
\fB\-\-invert\-match\fR،
جستجو پس از تعداد مشخص‌شده از موارد عدم تطابق متوقف می‌شود\&. مقدار 1\- نتایج نامحدود را برمی‌گرداند (پیش‌فرض)\&. مقدار 0 بلافاصله با وضعیت غیرصفر خارج می‌شود\&.
.RE
.PP
\fB\-\-threads\fR \fI<num>\fR
.RS 4
تعداد ریسه‌های کاری
\fBgrep\fR
برای استفاده\&. برای اطلاعات بیشتر
\fBNOTES\fR
\fBON\fR
\fBTHREADS\fR
و
\fBgrep\&.threads\fR
در
\fICONFIGURATION\fR
را ببینید\&.
.RE
.PP
\fB\-f\fR \fI<file>\fR
.RS 4
خواندن الگوها از
\fI<file>\fR،
هر الگو در یک خط\&.
.sp
ارسال الگو از طریق
\fI<file>\fR
امکان ارائه الگوی جستجوی حاوی \e0 را فراهم می‌کند\&.
.sp
همه انواع الگو از الگوهای حاوی \e0 پشتیبانی نمی‌کنند\&. اگر نوع الگوی داده‌شده نتواند از چنین الگویی پشتیبانی کند، گیت با خطا خارج می‌شود\&. نوع الگوی
\fB\-\-perl\-regexp\fR
هنگامی که با بک‌اند PCRE v2 کامپایل شده باشد بیشترین پشتیبانی را برای این نوع الگوها دارد\&.
.sp
در نسخه‌های گیت قبل از 2\&.23\&.0 الگوهای حاوی \e0 بدون اطلاع به عنوان رشته ثابت در نظر گرفته می‌شدند\&. این موضوع هرگز مستند نشده بود، همچنین رفتارهای عجیب و مستندنشده‌ای میان مثلاً الگوهای غیر ASCII حاوی \e0 و
\fB\-\-ignore\-case\fR
وجود داشت\&.
.sp
در نسخه‌های آینده ممکن است پشتیبانی از الگوهای حاوی \e0 برای بک‌اندهای جستجوی بیشتری اضافه شود؛ تا آن زمان، هنگامی که نوع الگوی مورد نظر از آن‌ها پشتیبانی نکند برنامه با خطا پایان می‌یابد\&.
.RE
.PP
\fB\-e\fR
.RS 4
پارامتر بعدی الگو است\&. این گزینه باید برای الگوهایی که با
\fB\-\fR
شروع می‌شوند استفاده شود و باید در اسکریپت‌هایی که ورودی کاربر را به grep ارسال می‌کنند به کار رود\&. الگوهای متعدد با
\fBor\fR
ترکیب می‌شوند\&.
.RE
.PP
\fB\-\-and\fR, \fB\-\-or\fR, \fB\-\-not\fR, ( \fB\&.\&.\&.\fR )
.RS 4
مشخص کردن نحوه ترکیب الگوهای متعدد با استفاده از عبارات بولی\&.
\fB\-\-or\fR
عملگر پیش‌فرض است\&.
\fB\-\-and\fR
اولویت بالاتری نسبت به
\fB\-\-or\fR
دارد\&.
\fB\-e\fR
باید برای تمام الگوها استفاده شود\&.
.RE
.PP
\fB\-\-all\-match\fR
.RS 4
هنگام ارائه چندین عبارت الگو که با
\fB\-\-or\fR
ترکیب شده‌اند، این فلگ برای محدود کردن تطابق به فایل‌هایی که خطوطی منطبق با همه آن‌ها دارند مشخص می‌شود\&.
.RE
.PP
\fB\-q\fR, \fB\-\-quiet\fR
.RS 4
خطوط منطبق را در خروجی چاپ نمی‌کند؛ در عوض، در صورت وجود تطابق با وضعیت 0 و در صورت عدم تطابق با وضعیت غیرصفر خارج می‌شود\&.
.RE
.PP
\fI<tree>\fR\&.\&.\&.
.RS 4
به جای جستجو در فایل‌های ردیابی‌شده در درخت کاری، در blobهای موجود در درخت‌های داده‌شده جستجو می‌کند\&.
.RE
.PP
\fB\-\-\fR
.RS 4
پایان گزینه‌ها را اعلام می‌کند؛ بقیه پارامترها محدودکننده‌های
\fI<pathspec>\fR
هستند\&.
.RE
.PP
\fI<pathspec>\fR\&.\&.\&.
.RS 4
در صورت ارائه، جستجو را به مسیرهایی که حداقل با یک الگو مطابقت دارند محدود می‌کند\&. هم تطابق مسیرهای ابتدایی و هم الگوهای
\fBglob\fR(7)
پشتیبانی می‌شوند\&.
.sp
برای جزئیات بیشتر درباره نحو
\fI<pathspec>\fR،
مدخل
\fBpathspec\fR
در
\fBgitglossary\fR(7)
را ببینید\&.
.RE
.SH "مثال‌ها (EXAMPLES)"
.PP
\fBgit\fR \fBgrep\fR \*(Aqtime_t\*(Aq \fB\-\-\fR \*(Aq*\&.[\fBch\fR]\*(Aq
.RS 4
جستجو برای
\fBtime_t\fR
در تمام فایل‌های ردیابی‌شده c.\& و h.\& در دایرکتوری کاری و زیردایرکتوری‌های آن\&.
.RE
.PP
\fBgit\fR \fBgrep\fR \fB\-e\fR \*(Aq#define\*(Aq \fB\-\-and\fR \fB\e\fR( \fB\-e\fR \fBMAX_PATH\fR \fB\-e\fR \fBPATH_MAX\fR \fB\e\fR)
.RS 4
جستجو برای خطی که دارای #define و یکی از
\fBMAX_PATH\fR
یا
\fBPATH_MAX\fR
باشد\&.
.RE
.PP
\fBgit\fR \fBgrep\fR \fB\-\-all\-match\fR \fB\-e\fR \fBNODE\fR \fB\-e\fR \fBUnexpected\fR
.RS 4
جستجو برای خطی که دارای
\fBNODE\fR
یا
\fBUnexpected\fR
باشد در فایل‌هایی که خطوطی منطبق با هر دو دارند\&.
.RE
.PP
\fBgit\fR \fBgrep\fR \fBsolution\fR \fB\-\-\fR \fB:^Documentation\fR
.RS 4
جستجو برای
\fBsolution\fR،
با استثنا کردن فایل‌های موجود در
\fBDocumentation\fR\&.
.RE
.SH "نکاتی درباره ریسه‌ها (NOTES ON THREADS)"
.sp
هنگامی که از گزینه \fB\-\-open\-files\-in\-pager\fR استفاده شود، گزینه \fB\-\-threads\fR (و پیکربندی \fBgrep\&.threads\fR) نادیده گرفته خواهد شد و اجرای تک‌ریسه‌ای اجباری می‌شود\&.
.sp
هنگام جستجو در مخزن اشیاء (با \fB\-\-cached\fR یا با دادن اشیاء درخت)، در صورتی که \fB\-\-textconv\fR داده شده باشد و تبدیلات متنی بسیار زیادی وجود داشته باشد، اجرا با چندین ریسه ممکن است کندتر از اجرای تک‌ریسه‌ای عمل کند\&. بنابراین، اگر در این حالت کارایی پایینی مشاهده شد، ممکن است استفاده از \fB\-\-threads=1\fR مطلوب باشد\&.
.SH "پیکربندی (CONFIGURATION)"
.sp
تمام موارد زیر این خط در این بخش به‌طور گزینشی از مستندات \fBgit-config\fR(1) آورده شده است\&. محتوا همان چیزی است که در آنجا یافت می‌شود:
.PP
\fBgrep\&.lineNumber\fR
.RS 4
در صورت تنظیم روی
\fBtrue\fR،
گزینه
\fB\-n\fR
را به‌طور پیش‌فرض فعال می‌کند\&.
.RE
.PP
\fBgrep\&.column\fR
.RS 4
در صورت تنظیم روی
\fBtrue\fR،
گزینه
\fB\-\-column\fR
را به‌طور پیش‌فرض فعال می‌کند\&.
.RE
.PP
\fBgrep\&.patternType\fR
.RS 4
تنظیم رفتار تطبیق پیش‌فرض\&. استفاده از مقدار
\fBbasic\fR،
\fBextended\fR،
\fBfixed\fR
یا
\fBperl\fR
به ترتیب گزینه‌های
\fB\-\-basic\-regexp\fR،
\fB\-\-extended\-regexp\fR،
\fB\-\-fixed\-strings\fR
یا
\fB\-\-perl\-regexp\fR
را فعال خواهد کرد، در حالی که مقدار
\fBdefault\fR
از گزینه
\fBgrep\&.extendedRegexp\fR
برای انتخاب بین
\fBbasic\fR
و
\fBextended\fR
استفاده خواهد کرد\&.
.RE
.PP
\fBgrep\&.extendedRegexp\fR
.RS 4
در صورت تنظیم روی
\fBtrue\fR،
گزینه
\fB\-\-extended\-regexp\fR
را به‌طور پیش‌فرض فعال می‌کند\&. این گزینه زمانی که گزینه
\fBgrep\&.patternType\fR
روی مقداری غیر از
\fBdefault\fR
تنظیم شده باشد نادیده گرفته می‌شود\&.
.RE
.PP
\fBgrep\&.threads\fR
.RS 4
تعداد ریسه‌های کاری grep برای استفاده\&. در صورت تنظیم نشدن (یا تنظیم روی 0)، گیت به تعداد هسته‌های منطقی در دسترس از ریسه‌ها استفاده خواهد کرد\&.
.RE
.PP
\fBgrep\&.fullName\fR
.RS 4
در صورت تنظیم روی
\fBtrue\fR،
گزینه
\fB\-\-full\-name\fR
را به‌طور پیش‌فرض فعال می‌کند\&.
.RE
.PP
\fBgrep\&.fallbackToNoIndex\fR
.RS 4
در صورت تنظیم روی
\fBtrue\fR،
اگر
\fBgit\fR
\fBgrep\fR
خارج از یک مخزن گیت اجرا شود، به
\fBgit\fR
\fBgrep\fR
\fB\-\-no\-index\fR
عقب‌نشینی می‌کند\&. مقدار پیش‌فرض
\fBfalse\fR
است\&.
.RE
.SH "گیت (GIT)"
.sp
بخشی از مجموعه \fBgit\fR(1)