نام (NAME)

notmuch-address - استخراج نشانی‌ها از پیام‌های منطبق

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

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

توضیحات (DESCRIPTION)

پیام‌های منطبق با عبارت‌های جستجوی مشخص‌شده را جستجو کرده و نشانی‌های موجود در آن‌ها را نمایش می‌دهد. نشانی‌های تکراری پالایش (حذف) می‌شوند.

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

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

--format=(json|sexp|text|text0): نتایج را در قالب JSON، S-Expressions، متن سادهٔ جداشده با نویسهٔ خط جدید (پیش‌فرض)، یا متن سادهٔ جداشده با نویسهٔ تهی (null) (سازگار با گزینهٔ -0 در xargs(1) https://manpages.debian.org/xargs.1.html در صورت وجود) ارائه می‌دهد.

--format-version=N: استفاده از نسخهٔ مشخص‌شدهٔ قالب خروجی ساختاریافته. این گزینه برای برنامه‌هایی در نظر گرفته شده است که notmuch <#notmuch-1> را به‌صورت داخلی فراخوانی می‌کنند. در صورت عدم ذکر، از آخرین نسخهٔ پشتیبانی‌شده استفاده خواهد شد.

--output=(sender|recipients|count|address): کنترل می‌کند که چه اطلاعاتی در خروجی نمایش یابد. این گزینه می‌تواند چندین بار مشخص شود تا خروجی‌های مختلف با یکدیگر ترکیب شوند. هنگامی که هیچ‌یک از گزینه‌های --output=sender یا --output=recipients داده نشود، --output=sender به‌طور ضمنی اعمال می‌شود.

sender: خروجی دادن تمام نشانی‌ها از سرآیند From.
نکته: جستجو برای sender باید بسیار سریع‌تر از جستجو برای recipients باشد، زیرا نشانی‌های فرستنده مستقیماً در پایگاه‌داده حافظه‌پنهان (cache) می‌شوند؛ در حالی که سایر نشانی‌ها باید از فایل‌های پیام واکشی شوند.
recipients: خروجی دادن تمام نشانی‌ها از سرآیندهای To، Cc و Bcc.
count: چاپ تعداد دفعاتی که نشانی در طول جستجو مشاهده شده است.
نکته: با این گزینه، نشانی‌ها تنها پس از اتمام کامل جستجو چاپ می‌شوند. این عملیات ممکن است زمان زیادی ببرد.
address: خروجی دادن تنها نشانی‌های ایمیل به‌جای صندوق‌های پستی کامل به همراه نام و نشانی ایمیل. این گزینه هیچ تأثیری بر قالب‌های خروجی JSON یا S-Expression ندارد.

--deduplicate=(no|mailbox|address): کنترل حذف موارد تکراری در نتایج.

no: خروجی دادن تمام موارد رخداد نشانی‌ها در پیام‌های منطبق. این حالت با --output=count قابل استفاده نیست.
mailbox: حذف تکرار نشانی‌ها بر اساس نام کامل حساس به حروف بزرگ و کوچک و نشانی ایمیل، یا همان صندوق پستی. این کار در عمل معادل ارسال خروجی --deduplicate=no با لوله‌کشی به sort | uniq است، به استثنای ترتیب نتایج. این حالت پیش‌فرض است.
address: حذف تکرار نشانی‌ها بر اساس بخش نشانی صندوق پستی، بدون حساسیت به حروف بزرگ و کوچک. از میان تمام گونه‌ها (با نام یا حروف بزرگ و کوچک متفاوت)، آن گزینه‌ای چاپ می‌شود که بیشترین تکرار را در میان پیام‌های منطبق داشته باشد. اگر --output=count مشخص شده باشد، تمام گونه‌ها در شمارش لحاظ می‌شوند.

--sort=(newest-first|oldest-first)

این گزینه می‌تواند برای ارائهٔ نتایج بر اساس ترتیب زمانی (oldest-first) یا معکوس زمانی (newest-first) استفاده شود.

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

با این حال، در صورت تعیین هر یک از گزینه‌های --output=count یا --deduplicate=address، این گزینه نادیده گرفته شده و ترتیب نتایج نامشخص خواهد بود.

--exclude=(true|false)

یک پیام در صورتی «مستثناشده» ("excluded") نامیده می‌شود که دست‌کم با یکی از برچسب‌های موجود در search.exclude_tags که صراحتاً در عبارت‌های جستجو نیامده است مطابقت داشته باشد. این گزینه مشخص می‌کند که آیا پیام‌های مستثناشده در فرایند جستجو نادیده گرفته شوند یا خیر.

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

مقدار false به پیام‌های مستثناشده اجازه می‌دهد با عبارت‌های جستجو تطابق پیدا کرده و در نتایج نمایش داده شوند.

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

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

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

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

notmuch <#notmuch-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 <#notmuch-search-1>, notmuch-search-terms <#notmuch-search-terms-7>, notmuch-show <#notmuch-show-1>, notmuch-tag <#notmuch-tag-1>

نویسندگان (AUTHORS)

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

کپی‌رایت و تکثیر (COPYRIGHT)

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