.\" 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-INSERT" "1" "Apr 17, 2026" "0.40" "notmuch"
.SH "نام (NAME)"
notmuch-insert \- افزودن یک پیام به maildir و پایگاه‌داده notmuch
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBnotmuch\fP \fBinsert\fP [option ...] [+<\fItag\fP>|\-<\fItag\fP> ...]
.SH "توضیحات (DESCRIPTION)"
.sp
دستور \fBnotmuch insert\fP یک پیام را از ورودی استاندارد خوانده و آن را به دایرکتوری maildir مشخص‌شده توسط گزینه پیکربندی database.mail_root \%<#\:nmconfig-database\:.mail_root> تحویل می‌دهد، سپس پیام را در پایگاه‌داده notmuch ادغام می‌کند. این دستور جایگزینی برای استفاده از یک ابزار جداگانه جهت تحویل پیام و سپس اجرای notmuch\-new \%<#\:notmuch-new-1> پس از آن است.
.sp
پیام جدید ابتدا با برچسب‌های مشخص‌شده در گزینه پیکربندی new.tags \%<#\:nmconfig-new\:.tags> و سپس طبق عملیات مشخص‌شده در خط فرمان برچسب‌گذاری خواهد شد: برچسب‌های دارای پیشوند \(aq+\(aq اضافه شده و برچسب‌های دارای پیشوند \(aq\-\(aq حذف می‌شوند.
.sp
اگر پیام جدید تکراری از یک پیام موجود در پایگاه‌داده باشد (شناسه Message\-ID یکسانی داشته باشد)، به پوشه maildir و پایگاه‌داده notmuch اضافه می‌شود، اما برچسب‌های آن تغییر نخواهند کرد.
.sp
دستور \fBinsert\fP از قلاب‌ها (hooks) پشتیبانی می‌کند. برای جزئیات بیشتر درباره قلاب‌ها به notmuch\-hooks \%<#\:notmuch-hooks-5> مراجعه کنید.
.sp
آرگومان‌های گزینه‌ها باید پیش از هر آرگومان عملیات برچسب قرار گیرند. گزینه‌های پشتیبانی‌شده برای \fBinsert\fP عبارتند از:
.INDENT 0.0
.TP
.B \-\-folder=<folder>
پیام را به پوشه مشخص‌شده، به‌صورت نسبی نسبت به دایرکتوری سطح بالایی که توسط مقدار database.mail_root \%<#\:nmconfig-database\:.mail_root>\& تعیین شده است، تحویل می‌دهد. مقدار پیش‌فرض یک رشته خالی است که به معنای تحویل به دایرکتوری سطح بالا می‌باشد.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-create\-folder
در صورت عدم وجود پوشه مشخص‌شده توسط گزینه \fB\-\-folder\fP، تلاش می‌کند آن را ایجاد کند. در غیر این صورت، برای موفقیت‌آمیز بودن تحویل نامه، پوشه باید از قبل وجود داشته باشد.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-keep
در صورت شکست در نمایه‌سازی (indexing)، فایل پیام را حفظ می‌کند و در صورت عدم موفقیت در اعمال برچسب‌ها یا همگام‌سازی پرچم‌های maildir، پیام را در حالت نمایه‌شده نگه می‌دارد. این خطاها نادیده گرفته شده و وضعیت خروج 0 برای نشان دادن تحویل موفق نامه بازگردانده می‌شود.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-no\-hooks
از اجرای قلاب‌ها (hooks) جلوگیری می‌کند.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-world\-readable
هنگام نوشتن نامه در صندوق پستی (mailbox)، به کاربران دیگر به جز کاربر فعلی اجازه خواندن آن را می‌دهد. توجه داشته باشید که این گزینه umask را لغو یا بازنویسی نمی‌کند. به‌طور پیش‌فرض، نامه تحویل‌داده‌شده فقط توسط کاربر فعلی قابل خواندن است.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-decrypt=(true|nostash|auto|false)
اگر \fBtrue\fP باشد و پیام رمزگذاری شده باشد، در حین نمایه‌سازی تلاش می‌کند پیام را رمزگشایی کرده و هر کلید نشست (session key) کشف‌شده را ذخیره (stash) کند. اگر \fBauto\fP باشد و notmuch از قبل یک کلید نشست برای پیام بداند، با استفاده از آن کلید نشست تلاش به رمزگشایی می‌کند اما تلاشی برای دسترسی به کلیدهای مخفی کاربر نخواهد کرد. اگر رمزگشایی موفقیت‌آمیز باشد، خود متن آشکار (cleartext) نمایه‌سازی می‌شود. در هر دو حالت، پیام همیشه به شکل اصلی خود (متن رمزشده یا ciphertext) روی دیسک ذخیره می‌شود.
.sp
مقدار \fBnostash\fP همانند \fBtrue\fP است با این تفاوت که کلیدهای نشست تازه‌کشف‌شده را در پایگاه‌داده ذخیره (stash) نمی‌کند.
.sp
آگاه باشید که نمایه (index) به احتمال زیاد (و یک کلید نشست ذخیره‌شده قطعاً) برای بازسازی متن آشکار خود پیام کافی است، بنابراین لطفاً اطمینان حاصل کنید که نمایه پیام notmuch به‌اندازه کافی محافظت می‌شود. بدون در نظر گرفتن امنیت نمایه خود، از \fB\-\-decrypt=true\fP یا \fB\-\-decrypt=nostash\fP استفاده نکنید.
.sp
همچنین بخش index.decrypt \%<#\:nmconfig-index\:.decrypt> را در notmuch\-config \%<#\:notmuch-config-1>\& ببینید.
.UNINDENT
.SH "پیکربندی (CONFIGURATION)"
.sp
نمایه‌سازی تحت تأثیر گزینه‌های پیکربندی index.decrypt \%<#\:nmconfig-index\:.decrypt> و index.header.<prefix> \%<#\:nmconfig-index\:.header\:.-prefix>\& قرار دارد. برچسب‌گذاری توسط گزینه‌های new.tags \%<#\:nmconfig-new\:.tags> و maildir.synchronize_flags \%<#\:nmconfig-maildir\:.synchronize_flags>\& کنترل می‌شود. برای جزئیات به notmuch\-config \%<#\:notmuch-config-1> مراجعه کنید.
.SH "وضعیت خروج (EXIT STATUS)"
.sp
این دستور در صورت موفقیت‌آمیز بودن تحویل نامه وضعیت خروج 0 و در غیر این صورت مقداری غیرصفر بازمی‌گرداند. پیش‌فرض این است که در صورت بروز هرگونه خطا، از جمله تحویل فایل پیام به فایل‌سیستم، نمایه‌سازی پیام در پایگاه‌داده Notmuch، تغییر برچسب‌ها و همگام‌سازی برچسب‌ها با پرچم‌های maildir، شکست تحویل نامه گزارش شود. از گزینه \fB\-\-keep\fP می‌توان برای بسنده کردن به تحویل موفقیت‌آمیز فایل پیام استفاده کرد.
.sp
این دستور از کد وضعیت خروج ویژه زیر برای خطاهایی که ماهیت آن‌ها به احتمال زیاد موقتی است، پشتیبانی می‌کند؛ مانند عدم موفقیت در دریافت قفل نوشتن پایگاه‌داده (database write lock).
.INDENT 0.0
.TP
.B \fB75 (EX_TEMPFAIL)\fP
یک خطای موقت رخ داده است؛ از کاربر خواسته می‌شود دوباره تلاش کند.
.UNINDENT
.sp
وضعیت خروج قلاب \fBpost\-insert\fP بر وضعیت خروج دستور \fBinsert\fP تأثیری ندارد.
.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\-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.