.\" 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-ADDRESS" "1" "Apr 17, 2026" "0.40" "notmuch"
.SH "نام (NAME)"
notmuch-address \- استخراج نشانی‌ها از پیام‌های منطبق
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBnotmuch\fP \fBaddress\fP [\fIoption\fP ...] <\fIsearch\-term\fP> ...
.SH "توضیحات (DESCRIPTION)"
.sp
پیام‌های منطبق با عبارت‌های جستجوی مشخص‌شده را جستجو کرده و نشانی‌های موجود در آن‌ها را نمایش می‌دهد. نشانی‌های تکراری پالایش (حذف) می‌شوند.
.sp
برای جزئیات ساختار دستوری پشتیبانی‌شده برای <search\-terms>، بخش notmuch\-search\-terms \%<#\:notmuch-search-terms-7> را ببینید.
.sp
گزینه‌های پشتیبانی‌شده برای \fBaddress\fP عبارت‌اند از:
.INDENT 0.0
.TP
.B \-\-format=(json|sexp|text|text0)
نتایج را در قالب JSON، S\-Expressions، متن سادهٔ جداشده با نویسهٔ خط جدید (پیش‌فرض)، یا متن سادهٔ جداشده با نویسهٔ تهی (null) (سازگار با گزینهٔ \-0 در \fBxargs(1) \%<https://\:manpages\:.debian\:.org/\:xargs\:.1\:.html>\fP در صورت وجود) ارائه می‌دهد.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-format\-version=N
استفاده از نسخهٔ مشخص‌شدهٔ قالب خروجی ساختاریافته. این گزینه برای برنامه‌هایی در نظر گرفته شده است که notmuch \%<#\:notmuch-1> را به‌صورت داخلی فراخوانی می‌کنند. در صورت عدم ذکر، از آخرین نسخهٔ پشتیبانی‌شده استفاده خواهد شد.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-output=(sender|recipients|count|address)
کنترل می‌کند که چه اطلاعاتی در خروجی نمایش یابد. این گزینه می‌تواند چندین بار مشخص شود تا خروجی‌های مختلف با یکدیگر ترکیب شوند. هنگامی که هیچ‌یک از گزینه‌های \fB\-\-output=sender\fP یا \fB\-\-output=recipients\fP داده نشود، \fB\-\-output=sender\fP به‌طور ضمنی اعمال می‌شود.
.INDENT 7.0
.TP
.B sender
خروجی دادن تمام نشانی‌ها از سرآیند \fIFrom\fP.
.sp
نکته: جستجو برای \fBsender\fP باید بسیار سریع‌تر از جستجو برای \fBrecipients\fP باشد، زیرا نشانی‌های فرستنده مستقیماً در پایگاه‌داده حافظه‌پنهان (cache) می‌شوند؛ در حالی که سایر نشانی‌ها باید از فایل‌های پیام واکشی شوند.
.TP
.B recipients
خروجی دادن تمام نشانی‌ها از سرآیندهای \fITo\fP، \fICc\fP و \fIBcc\fP.
.TP
.B count
چاپ تعداد دفعاتی که نشانی در طول جستجو مشاهده شده است.
.sp
نکته: با این گزینه، نشانی‌ها تنها پس از اتمام کامل جستجو چاپ می‌شوند. این عملیات ممکن است زمان زیادی ببرد.
.TP
.B address
خروجی دادن تنها نشانی‌های ایمیل به‌جای صندوق‌های پستی کامل به همراه نام و نشانی ایمیل. این گزینه هیچ تأثیری بر قالب‌های خروجی JSON یا S\-Expression ندارد.
.UNINDENT
.UNINDENT
.INDENT 0.0
.TP
.B \-\-deduplicate=(no|mailbox|address)
کنترل حذف موارد تکراری در نتایج.
.INDENT 7.0
.TP
.B no
خروجی دادن تمام موارد رخداد نشانی‌ها در پیام‌های منطبق. این حالت با \fB\-\-output=count\fP قابل استفاده نیست\&.
.TP
.B mailbox
حذف تکرار نشانی‌ها بر اساس نام کامل حساس به حروف بزرگ و کوچک و نشانی ایمیل، یا همان صندوق پستی. این کار در عمل معادل ارسال خروجی \fB\-\-deduplicate=no\fP با لوله‌کشی به \fBsort | uniq\fP است، به استثنای ترتیب نتایج. این حالت پیش‌فرض است.
.TP
.B address
حذف تکرار نشانی‌ها بر اساس بخش نشانی صندوق پستی، بدون حساسیت به حروف بزرگ و کوچک. از میان تمام گونه‌ها (با نام یا حروف بزرگ و کوچک متفاوت)، آن گزینه‌ای چاپ می‌شود که بیشترین تکرار را در میان پیام‌های منطبق داشته باشد. اگر \fB\-\-output=count\fP مشخص شده باشد، تمام گونه‌ها در شمارش لحاظ می‌شوند.
.UNINDENT
.UNINDENT
.INDENT 0.0
.TP
.B \-\-sort=(newest\-first|oldest\-first)
این گزینه می‌تواند برای ارائهٔ نتایج بر اساس ترتیب زمانی (\fBoldest\-first\fP) یا معکوس زمانی (\fBnewest\-first\fP) استفاده شود.
.sp
به‌طور پیش‌فرض، نتایج به ترتیب معکوس زمانی نمایش داده می‌شوند (یعنی جدیدترین نتایج ابتدا نمایش می‌یابند).
.sp
با این حال، در صورت تعیین هر یک از گزینه‌های \fB\-\-output=count\fP یا \fB\-\-deduplicate=address\fP، این گزینه نادیده گرفته شده و ترتیب نتایج نامشخص خواهد بود.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-exclude=(true|false)
یک پیام در صورتی «مستثناشده» (\(dqexcluded\(dq) نامیده می‌شود که دست‌کم با یکی از برچسب‌های موجود در search.exclude_tags که صراحتاً در عبارت‌های جستجو نیامده است مطابقت داشته باشد. این گزینه مشخص می‌کند که آیا پیام‌های مستثناشده در فرایند جستجو نادیده گرفته شوند یا خیر.
.sp
مقدار پیش‌فرض، \fBtrue\fP، از تطابق پیام‌های مستثناشده با عبارت‌های جستجو جلوگیری می‌کند.
.sp
مقدار \fBfalse\fP به پیام‌های مستثناشده اجازه می‌دهد با عبارت‌های جستجو تطابق پیدا کرده و در نتایج نمایش داده شوند.
.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\-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>
.SH "نویسندگان (AUTHORS)"
Carl Worth و بسیاری دیگر
.SH "کپی‌رایت و تکثیر (COPYRIGHT)"
2009-2026, Carl Worth و بسیاری دیگر
.\" End of generated man page.