.\" Man page generated from reStructuredText .\" by the Docutils 0.22.4 manpage writer. . . .nr rst2man-indent-level 0 . .de1 rstReportMargin \\$1 \\n[an-margin] level \\n[rst2man-indent-level] level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] - \\n[rst2man-indent0] \\n[rst2man-indent1] \\n[rst2man-indent2] .. .de1 INDENT .\" .rstReportMargin pre: . RS \\$1 . nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin] . nr rst2man-indent-level +1 .\" .rstReportMargin post: .. .de UNINDENT . RE .\" indent \\n[an-margin] .\" old: \\n[rst2man-indent\\n[rst2man-indent-level]] .nr rst2man-indent-level -1 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. .TH "NOTMUCH-SEARCH" "1" "Apr 17, 2026" "0.40" "notmuch" .SH "نام (NAME)" notmuch-search \- جستجوی پیام‌های منطبق با عبارت‌های جستجوی داده‌شده .SH "خلاصه دستور (SYNOPSIS)" .sp \fBnotmuch\fP \fBsearch\fP [\fIoption\fP ...] <\fIsearch\-term\fP> ... .SH "توضیحات (DESCRIPTION)" .sp جستجوی پیام‌های منطبق با عبارت‌های جستجوی داده‌شده و نمایش رشته‌گفتگوهای (threads) حاوی پیام‌های منطبق به‌عنوان نتایج. .sp خروجی شامل یک سطر به ازای هر رشته‌گفتگو است که شناسهٔ رشته‌گفتگو (thread ID)، تاریخ جدیدترین (یا قدیمی‌ترین، بسته به گزینهٔ مرتب‌سازی) پیام منطبق در رشته، تعداد پیام‌های منطبق و کل پیام‌های موجود در رشته، نام همهٔ مشارکت‌کنندگان در رشته، و موضوع جدیدترین (یا قدیمی‌ترین) پیام را نمایش می‌دهد. .sp برای آگاهی از جزئیات ساختار نحو پشتیبانی‌شده برای ، به notmuch\-search\-terms \%<#\:notmuch-search-terms-7> مراجعه کنید. .sp گزینه‌های پشتیبانی‌شده برای \fBsearch\fP عبارت‌اند از: .INDENT 0.0 .TP .B \-\-format=(json|sexp|text|text0) نتایج را در قالب JSON، عبارت‌های اس (S\-Expressions)، متن سادهٔ جداشده با نویسهٔ خط جدید (پیش‌فرض)، یا متن سادهٔ جداشده با نویسهٔ تهی (null) (سازگار با گزینهٔ \-0 در \fBxargs(1) \%\fP در صورت وجود) ارائه می‌دهد. .UNINDENT .INDENT 0.0 .TP .B \-\-format\-version=N استفاده از نسخهٔ مشخص‌شدهٔ قالب خروجی ساختاریافته. این گزینه برای برنامه‌هایی در نظر گرفته شده است که notmuch \%<#\:notmuch-1> را به‌صورت داخلی فراخوانی می‌کنند. در صورت نادیده گرفتن، از آخرین نسخهٔ پشتیبانی‌شده استفاده خواهد شد. .UNINDENT .INDENT 0.0 .TP .B \-\-output=(summary|threads|messages|files|tags) .INDENT 7.0 .TP .B summary (default) خروجی خلاصه‌ای از هر رشته‌گفتگو که پیامی منطبق با عبارت‌های جستجو دارد. این خلاصه شامل شناسهٔ رشته، تاریخ، تعداد پیام‌های موجود در رشته (هم تعداد پیام‌های منطبق و هم تعداد کل)، نویسندگان رشته و موضوع است. در حالتی که یک رشته برای برخی پیام‌ها شامل چندین فایل باشد، تعداد کل فایل‌ها درون پرانتز چاپ می‌شود (برای مثال به زیر مراجعه کنید). .TP .B threads چاپ شناسهٔ تمام رشته‌گفتگوهایی که پیامی منطبق با عبارت‌های جستجو دارند؛ به‌صورت یک شناسه در هر خط (\fB\-\-format=text\fP)، جداشده با نویسه‌های تهی (\fB\-\-format=text0\fP)، به‌شکل آرایه‌ای از JSON (\fB\-\-format=json\fP)، یا به‌صورت فهرستی از S\-Expression (\fB\-\-format=sexp\fP). .TP .B messages چاپ شناسه‌های تمام پیام‌های منطبق با عبارت‌های جستجو؛ به‌صورت یک شناسه در هر خط (\fB\-\-format=text\fP)، جداشده با نویسه‌های تهی (\fB\-\-format=text0\fP)، به‌شکل آرایه‌ای از JSON (\fB\-\-format=json\fP)، یا به‌صورت فهرستی از S\-Expression (\fB\-\-format=sexp\fP). .TP .B files چاپ نام فایل‌های تمام پیام‌های منطبق با عبارت‌های جستجو؛ به‌صورت یک نام در هر خط (\fB\-\-format=text\fP)، جداشده با نویسه‌های تهی (\fB\-\-format=text0\fP)، به‌شکل آرایه‌ای از JSON (\fB\-\-format=json\fP)، یا به‌صورت فهرستی از S\-Expression (\fB\-\-format=sexp\fP). .sp توجه داشته باشید که هر پیام ممکن است چندین نام فایل مرتبط داشته باشد. همهٔ آن‌ها در خروجی گنجانده می‌شوند (مگر اینکه با گزینهٔ \fB\-\-duplicate=N\fP محدود شده باشند). این موضوع ممکن است به‌ویژه در جستجوهای \fBfolder:\fP یا \fBpath:\fP در یک دایرکتوری مشخص گیج‌کننده باشد، زیرا پیام‌ها ممکن است نسخه‌های تکراری در دایرکتوری‌های دیگری داشته باشند که در خروجی قرار می‌گیرند، هرچند که این فایل‌ها به‌تنهایی با جستجو مطابقت نداشتند. .TP .B tags چاپ تمام برچسب‌هایی که روی هر پیام منطبق با عبارت‌های جستجو ظاهر می‌شوند؛ به‌صورت یک مورد در هر خط (\fB\-\-format=text\fP)، جداشده با نویسه‌های تهی (\fB\-\-format=text0\fP)، به‌شکل آرایه‌ای از JSON (\fB\-\-format=json\fP)، یا به‌صورت فهرستی از S\-Expression (\fB\-\-format=sexp\fP). .UNINDENT .UNINDENT .INDENT 0.0 .TP .B \-\-sort=(newest\-first|oldest\-first) این گزینه می‌تواند برای ارائهٔ نتایج بر اساس ترتیب زمانی (\fBoldest\-first\fP) یا ترتیب معکوس زمانی (\fBnewest\-first\fP) استفاده شود. .sp نکته: ترتیب رشته‌گفتگوها میان این دو گزینه متفاوت خواهد بود (فراتر از یک معکوس‌سازی ساده). هنگام مرتب‌سازی بر اساس \fBoldest\-first\fP، رشته‌ها بر مبنای قدیمی‌ترین پیام در هر رشته مرتب می‌شوند، اما هنگام مرتب‌سازی با \fBnewest\-first\fP، رشته‌ها بر مبنای جدیدترین پیام در هر رشته مرتب خواهند شد. .sp به‌طور پیش‌فرض، نتایج به ترتیب معکوس زمانی نمایش داده می‌شوند (یعنی جدیدترین نتایج ابتدا نمایش می‌یابند). .UNINDENT .INDENT 0.0 .TP .B \-\-offset=[\-]N صرف‌نظر کردن از نمایش N نتیجهٔ نخست. با درج \(aq\-\(aq در ابتدا، از N‌امین نتیجه از انتها آغاز می‌شود. .UNINDENT .INDENT 0.0 .TP .B \-\-limit=N محدود کردن شمار نتایج نمایش‌داده‌شده به N. .UNINDENT .INDENT 0.0 .TP .B \-\-exclude=(true|false|all|flag) یک پیام در صورتی «مستثنی‌شده» (\(dqexcluded\(dq) نامیده می‌شود که حداقل با یکی از برچسب‌های search.exclude_tags که به‌طور صریح در عبارت‌های جستجو نیامده است مطابقت داشته باشد. این گزینه مشخص می‌کند که آیا پیام‌های مستثنی‌شده در فرآیند جستجو نادیده گرفته شوند یا خیر. .INDENT 7.0 .TP .B true (default) جلوگیری از تطبیق پیام‌های مستثنی‌شده با عبارت‌های جستجو. .TP .B all علاوه بر این، از ظاهر شدن پیام‌های مستثنی‌شده در نتایج نمایش‌داده‌شده جلوگیری می‌کند، و در عمل به‌گونه‌ای رفتار می‌کند که گویی پیام‌های مستثنی‌شده اصلاً وجود ندارند. .TP .B false اجازه دادن به تطبیق پیام‌های مستثنی‌شده با عبارت‌های جستجو و نمایش آن‌ها در نتایج. پیام‌های مستثنی‌شده همچنان در خروجی‌های مربوطه نشانه‌گذاری می‌شوند. .TP .B flag تنها زمانی تأثیر دارد که \fB\-\-output=summary\fP\& باشد. خروجی تقریباً با \fBfalse\fP یکسان است، اما «تعداد انطباق» (\(dqmatch count\(dq) برابر با تعداد پیام‌های منطبقِ غیرمستثنی در رشته است، نه کل پیام‌های منطبق. .UNINDENT .UNINDENT .INDENT 0.0 .TP .B \-\-duplicate=N برای \fB\-\-output=files\fP، نام فایل N‌ام مرتبط با هر پیام منطبق با جستجو را چاپ می‌کند (N بر پایهٔ ۱ است). اگر N بزرگ‌تر از تعداد فایل‌های مرتبط با پیام باشد، چیزی چاپ نمی‌شود. .sp برای \fB\-\-output=messages\fP، تنها شناسه‌های پیام‌هایی را چاپ می‌کند که با عبارت‌های جستجو مطابقت دارند و حداقل N نام فایل با آن‌ها مرتبط است. .sp توجه داشته باشید که این گزینه مستقل از پیشوند جستجوی \fBfolder:\fP عمل می‌کند. آن پیشوند، پیام‌ها را بر اساس نام فایل‌ها مطابقت می‌دهد. این گزینه، نام فایل‌های پیام‌های منطبق را پالایش می‌کند. .UNINDENT .SH "مثال‌ها (EXAMPLES)" .sp نمونهٔ زیر مثالی از قالب خروجی summary را نشان می‌دهد که در آن یک پیام دارای چندین نام فایل است. .INDENT 0.0 .INDENT 3.5 .sp .EX % notmuch search date:today.. and tag:bad\-news thread:0000000000063c10 Today [1/1] Some Persun; To the bone (bad\-news inbox unread) thread:0000000000063c25 Today [1/1(2)] Ann Other; Bears (bad\-news inbox unread) thread:0000000000063c00 Today [1/1] A Thurd; Bites, stings, sad feelings (bad\-news unread) .EE .UNINDENT .UNINDENT .SH "وضعیت خروج (EXIT STATUS)" .sp این دستور از کدهای وضعیت خروج ویژهٔ زیر پشتیبانی می‌کند: .INDENT 0.0 .TP .B \fB20\fP نسخهٔ قالب درخواستی بیش از حد قدیمی است. .TP .B \fB21\fP نسخهٔ قالب درخواستی بیش از حد جدید است. .UNINDENT .SH "همچنین ببینید (SEE ALSO)" .sp notmuch \%<#\:notmuch-1>, notmuch\-address \%<#\:notmuch-address-1> notmuch\-config \%<#\:notmuch-config-1>, notmuch\-count \%<#\:notmuch-count-1>, notmuch\-dump \%<#\:notmuch-dump-1>, notmuch\-hooks \%<#\:notmuch-hooks-5>, notmuch\-insert \%<#\:notmuch-insert-1>, notmuch\-new \%<#\:notmuch-new-1>, notmuch\-reply \%<#\:notmuch-reply-1>, notmuch\-restore \%<#\:notmuch-restore-1>, notmuch\-search\-terms \%<#\:notmuch-search-terms-7>, notmuch\-show \%<#\:notmuch-show-1>, notmuch\-tag \%<#\:notmuch-tag-1> .SH "نویسندگان (AUTHORS)" Carl Worth و بسیاری دیگر .SH "کپی‌رایت و تکثیر (COPYRIGHT)" 2009-2026, Carl Worth و بسیاری دیگر .\" End of generated man page.