NOTMUCH-SEARCH(1) notmuch NOTMUCH-SEARCH(1)

notmuch-search - جستجوی پیام‌های منطبق با عبارت‌های جستجوی داده‌شده

notmuch search [option ...] <search-term> ...

جستجوی پیام‌های منطبق با عبارت‌های جستجوی داده‌شده و نمایش رشته‌گفتگوهای (threads) حاوی پیام‌های منطبق به‌عنوان نتایج.

خروجی شامل یک سطر به ازای هر رشته‌گفتگو است که شناسهٔ رشته‌گفتگو (thread ID)، تاریخ جدیدترین (یا قدیمی‌ترین، بسته به گزینهٔ مرتب‌سازی) پیام منطبق در رشته، تعداد پیام‌های منطبق و کل پیام‌های موجود در رشته، نام همهٔ مشارکت‌کنندگان در رشته، و موضوع جدیدترین (یا قدیمی‌ترین) پیام را نمایش می‌دهد.

برای آگاهی از جزئیات ساختار نحو پشتیبانی‌شده برای <search-terms>، به notmuch-search-terms <#notmuch-search-terms-7> مراجعه کنید.

گزینه‌های پشتیبانی‌شده برای search عبارت‌اند از:

نتایج را در قالب JSON، عبارت‌های اس (S-Expressions)، متن سادهٔ جداشده با نویسهٔ خط جدید (پیش‌فرض)، یا متن سادهٔ جداشده با نویسهٔ تهی (null) (سازگار با گزینهٔ -0 در xargs(1) https://manpages.debian.org/xargs.1.html در صورت وجود) ارائه می‌دهد.
استفاده از نسخهٔ مشخص‌شدهٔ قالب خروجی ساختاریافته. این گزینه برای برنامه‌هایی در نظر گرفته شده است که notmuch <#notmuch-1> را به‌صورت داخلی فراخوانی می‌کنند. در صورت نادیده گرفتن، از آخرین نسخهٔ پشتیبانی‌شده استفاده خواهد شد.
خروجی خلاصه‌ای از هر رشته‌گفتگو که پیامی منطبق با عبارت‌های جستجو دارد. این خلاصه شامل شناسهٔ رشته، تاریخ، تعداد پیام‌های موجود در رشته (هم تعداد پیام‌های منطبق و هم تعداد کل)، نویسندگان رشته و موضوع است. در حالتی که یک رشته برای برخی پیام‌ها شامل چندین فایل باشد، تعداد کل فایل‌ها درون پرانتز چاپ می‌شود (برای مثال به زیر مراجعه کنید).
چاپ شناسهٔ تمام رشته‌گفتگوهایی که پیامی منطبق با عبارت‌های جستجو دارند؛ به‌صورت یک شناسه در هر خط (--format=text)، جداشده با نویسه‌های تهی (--format=text0)، به‌شکل آرایه‌ای از JSON (--format=json)، یا به‌صورت فهرستی از S-Expression (--format=sexp).
چاپ شناسه‌های تمام پیام‌های منطبق با عبارت‌های جستجو؛ به‌صورت یک شناسه در هر خط (--format=text)، جداشده با نویسه‌های تهی (--format=text0)، به‌شکل آرایه‌ای از JSON (--format=json)، یا به‌صورت فهرستی از S-Expression (--format=sexp).
چاپ نام فایل‌های تمام پیام‌های منطبق با عبارت‌های جستجو؛ به‌صورت یک نام در هر خط (--format=text)، جداشده با نویسه‌های تهی (--format=text0)، به‌شکل آرایه‌ای از JSON (--format=json)، یا به‌صورت فهرستی از S-Expression (--format=sexp).

توجه داشته باشید که هر پیام ممکن است چندین نام فایل مرتبط داشته باشد. همهٔ آن‌ها در خروجی گنجانده می‌شوند (مگر اینکه با گزینهٔ --duplicate=N محدود شده باشند). این موضوع ممکن است به‌ویژه در جستجوهای folder: یا path: در یک دایرکتوری مشخص گیج‌کننده باشد، زیرا پیام‌ها ممکن است نسخه‌های تکراری در دایرکتوری‌های دیگری داشته باشند که در خروجی قرار می‌گیرند، هرچند که این فایل‌ها به‌تنهایی با جستجو مطابقت نداشتند.

چاپ تمام برچسب‌هایی که روی هر پیام منطبق با عبارت‌های جستجو ظاهر می‌شوند؛ به‌صورت یک مورد در هر خط (--format=text)، جداشده با نویسه‌های تهی (--format=text0)، به‌شکل آرایه‌ای از JSON (--format=json)، یا به‌صورت فهرستی از S-Expression (--format=sexp).
این گزینه می‌تواند برای ارائهٔ نتایج بر اساس ترتیب زمانی (oldest-first) یا ترتیب معکوس زمانی (newest-first) استفاده شود.

نکته: ترتیب رشته‌گفتگوها میان این دو گزینه متفاوت خواهد بود (فراتر از یک معکوس‌سازی ساده). هنگام مرتب‌سازی بر اساس oldest-first، رشته‌ها بر مبنای قدیمی‌ترین پیام در هر رشته مرتب می‌شوند، اما هنگام مرتب‌سازی با newest-first، رشته‌ها بر مبنای جدیدترین پیام در هر رشته مرتب خواهند شد.

به‌طور پیش‌فرض، نتایج به ترتیب معکوس زمانی نمایش داده می‌شوند (یعنی جدیدترین نتایج ابتدا نمایش می‌یابند).

صرف‌نظر کردن از نمایش N نتیجهٔ نخست. با درج '-' در ابتدا، از N‌امین نتیجه از انتها آغاز می‌شود.
محدود کردن شمار نتایج نمایش‌داده‌شده به N.
یک پیام در صورتی «مستثنی‌شده» ("excluded") نامیده می‌شود که حداقل با یکی از برچسب‌های search.exclude_tags که به‌طور صریح در عبارت‌های جستجو نیامده است مطابقت داشته باشد. این گزینه مشخص می‌کند که آیا پیام‌های مستثنی‌شده در فرآیند جستجو نادیده گرفته شوند یا خیر.
جلوگیری از تطبیق پیام‌های مستثنی‌شده با عبارت‌های جستجو.
علاوه بر این، از ظاهر شدن پیام‌های مستثنی‌شده در نتایج نمایش‌داده‌شده جلوگیری می‌کند، و در عمل به‌گونه‌ای رفتار می‌کند که گویی پیام‌های مستثنی‌شده اصلاً وجود ندارند.
اجازه دادن به تطبیق پیام‌های مستثنی‌شده با عبارت‌های جستجو و نمایش آن‌ها در نتایج. پیام‌های مستثنی‌شده همچنان در خروجی‌های مربوطه نشانه‌گذاری می‌شوند.
تنها زمانی تأثیر دارد که --output=summary باشد. خروجی تقریباً با false یکسان است، اما «تعداد انطباق» ("match count") برابر با تعداد پیام‌های منطبقِ غیرمستثنی در رشته است، نه کل پیام‌های منطبق.
برای --output=files، نام فایل N‌ام مرتبط با هر پیام منطبق با جستجو را چاپ می‌کند (N بر پایهٔ ۱ است). اگر N بزرگ‌تر از تعداد فایل‌های مرتبط با پیام باشد، چیزی چاپ نمی‌شود.

برای --output=messages، تنها شناسه‌های پیام‌هایی را چاپ می‌کند که با عبارت‌های جستجو مطابقت دارند و حداقل N نام فایل با آن‌ها مرتبط است.

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

نمونهٔ زیر مثالی از قالب خروجی summary را نشان می‌دهد که در آن یک پیام دارای چندین نام فایل است.

% 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)

این دستور از کدهای وضعیت خروج ویژهٔ زیر پشتیبانی می‌کند:

20
نسخهٔ قالب درخواستی بیش از حد قدیمی است.
21
نسخهٔ قالب درخواستی بیش از حد جدید است.

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>

Carl Worth و بسیاری دیگر

2009-2026, Carl Worth و بسیاری دیگر

April 17, 2026 0.40