.\" 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-DUMP" "1" "Apr 17, 2026" "0.40" "notmuch"
.SH "نام (NAME)"
notmuch-dump \- ایجاد خروجی متنی ساده از برچسب‌های هر پیام
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBnotmuch\fP \fBdump\fP [\-\-gzip] [\-\-format=(batch\-tag|sup)] [\-\-output=<\fIfile\fP>] [\-\-] [<\fIsearch\-term\fP> ...]
.SH "توضیحات (DESCRIPTION)"
.sp
تهیه خروجی از برچسب‌های پیام‌های منطبق با عبارت‌های جستجوی ارائه‌شده.
.sp
خروجی در صورت تعیین نام فایل، درون آن و در غیر این صورت در stdout نوشته می‌شود.
.sp
این برچسب‌ها تنها داده‌هایی در پایگاه داده notmuch هستند که نمی‌توان آن‌ها را مجدداً از خود پیام‌ها بازسازی کرد. بنابراین، خروجی notmuch dump تنها بخش حیاتی برای پشتیبان‌گیری است (و سازگاری بسیار بیشتری نسبت به فایل‌های بومی پایگاه داده با پشتیبان‌گیری افزایشی دارد).
.sp
برای جزئیات نحو (syntax) پشتیبانی‌شده برای <search\-terms>، به notmuch\-search\-terms \%<#\:notmuch-search-terms-7> مراجعه کنید. در صورت عدم ارائه عبارت‌های جستجو، خروجی کاملی از تمام پیام‌های پایگاه داده تولید خواهد شد. آرگومان \fB\-\-\fP به notmuch اعلام می‌کند که آرگومان‌های باقی‌مانده عبارت‌های جستجو هستند.
.sp
گزینه‌های پشتیبانی‌شده برای \fBdump\fP عبارتند از:
.INDENT 0.0
.TP
.B \-\-gzip
فشرده‌سازی خروجی با قالبی سازگار با \fBgzip(1) \%<https://\:manpages\:.debian\:.org/\:gzip\:.1\:.html>\fP\&.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-format=(sup|batch\-tag)
دستور notmuch restore از دو قالب خروجی متنی ساده پشتیبانی می‌کند، که هر دو شامل یک message\-id در هر خط و به دنبال آن فهرستی از برچسب‌ها هستند.
.INDENT 7.0
.TP
.B batch\-tag
قالب خروجی پیش‌فرض \fBbatch\-tag\fP به گونه‌ای طراحی شده است که در برابر message\-idهای معیوب و برچسب‌های حاوی فاصله‌های خالی یا نویسه‌های غیر \fBascii(7) \%<https://\:manpages\:.debian\:.org/\:ascii\:.7\:.html>\fP مقاوم‌تر باشد. هر خط دارای ساختار زیر است:
.INDENT 7.0
.INDENT 3.5
.sp
.EX
+<*encoded\-tag*\e > +<*encoded\-tag*\e > ... \-\- id:<*quoted\-message\-id*\e >
.EE
.UNINDENT
.UNINDENT
.sp
برچسب‌ها با جایگزین کردن هر بایتی که با عبارت منظم \fB[A\-Za\-z0\-9@=.,_+\-]\fP تطابق ندارد با \fB%nn\fP (که در آن nn کد هگز دورقمی است) کدگذاری هگز می‌شوند. شناسه پیام (message ID) یک پرس‌وجوی معتبر Xapian است که با استفاده از قوانین نقل‌قول عبارات بولی Xapian نقل‌قول شده است: اگر شناسه حاوی فاصله یا پرانتز بسته باشد، یا با یک نقل‌قول دوتایی (double quote) شروع شود، باید داخل نقل‌قول‌های دوتایی قرار گیرد و نقل‌قول‌های دوتایی درون شناسه باید دوبرابر شوند. خواننده دقیق متوجه خواهد شد که این مورد یک حالت خاص از قالب ورودی دسته‌ای (batch) برای notmuch\-tag \%<#\:notmuch-tag-1> است؛ توجه داشته باشید که پرس‌وجوی تک message\-id برای notmuch\-restore \%<#\:notmuch-restore-1>\& اجباری است.
.TP
.B sup
قالب فایل خروجی \fBsup\fP به طور ویژه برای سازگاری با قالب فایل‌های تولیدشده توسط \fBsup\-dump(1) \%<https://\:manpages\:.debian\:.org/\:sup-dump\:.1\:.html>\fP انتخاب شده است\&. بنابراین اگر پیش از این برای نامه‌های خود از sup استفاده می‌کردید، دستور notmuch\-restore \%<#\:notmuch-restore-1> روشی را برای وارد کردن تمام برچسب‌هایتان (یا همان برچسب‌ها که sup آن‌ها را label می‌نامد) فراهم می‌کند. هر خط دارای ساختار زیر است:
.INDENT 7.0
.INDENT 3.5
.sp
.EX
<*message\-id*\e > **(** <*tag*\e > ... **)**
.EE
.UNINDENT
.UNINDENT
.sp
با صفر یا چند برچسب که با فاصله از هم جدا شده‌اند. توجه داشته باشید که message\-idهای (معیوب) ممکن است شامل نویسه‌های دلخواه غیر تهی (non\-null) باشند. همچنین توجه داشته باشید که برچسب‌های حاوی فاصله با این قالب به درستی بازیابی نخواهند شد.
.UNINDENT
.UNINDENT
.INDENT 0.0
.TP
.B \-\-include=(config|properties|tags)
تعیین نوع فراداده‌هایی که در خروجی گنجانده می‌شوند.
.INDENT 7.0
.TP
.B config
داده‌های پیکربندی ذخیره‌شده در پایگاه داده را در خروجی می‌آورد. هر خط با \(dq#@ \(dq شروع می‌شود که به دنبال آن یک جفت کلید\-مقدار جداشده با فاصله قرار دارد. در صورت نیاز، هم کلید و هم مقدار با هگز کدگذاری می‌شوند.
.TP
.B properties
فراداده‌های (کلید، مقدار) به ازای هر پیام را در خروجی می‌آورد. هر خط با \(dq#= \(dq شروع می‌شود که به دنبال آن یک شناسه پیام و فهرستی از جفت‌های key=value جداشده با فاصله قرار دارد. شناسه‌ها، کلیدها و مقادیر در صورت نیاز با هگز کدگذاری می‌شوند. برای جزئیات بیشتر به notmuch\-properties \%<#\:notmuch-properties-7> مراجعه کنید.
.TP
.B tags
فراداده‌های بولی به ازای هر پیام، یعنی برچسب‌ها را در خروجی می‌آورد. برای شرح خروجی، بخش \fIformat\fP در بالا را ببینید.
.UNINDENT
.sp
حالت پیش‌فرض شامل تمام انواع داده‌های موجود است. این گزینه می‌تواند چندین بار مشخص شود تا زیرمجموعه‌ای از آن‌ها انتخاب شود. از نسخه ۳ قالب خروجی (dump format)، یک خط سرآیند به شکل زیر وجود دارد:
.INDENT 7.0
.INDENT 3.5
.sp
.EX
#notmuch\-dump <*format*>:<*version*> <*included*>
.EE
.UNINDENT
.UNINDENT
.sp
که در آن <\fIincluded\fP> فهرستی جداشده با ویرگول از گزینه‌های بالا است.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-output=<filename>
نوشتن خروجی در فایل مشخص‌شده به جای stdout.
.UNINDENT
.SH "همچنین ببینید (SEE ALSO)"
.sp
notmuch \%<#\:notmuch-1>,
notmuch\-config \%<#\:notmuch-config-1>,
notmuch\-count \%<#\:notmuch-count-1>,
notmuch\-hooks \%<#\:notmuch-hooks-5>,
notmuch\-insert \%<#\:notmuch-insert-1>,
notmuch\-new \%<#\:notmuch-new-1>,
notmuch\-properties \%<#\:notmuch-properties-7>,
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.