نام (NAME)

notmuch-new - گنجاندن و افزودن نامه‌های جدید به پایگاه‌داده notmuch

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

notmuch new [گزینه‌ها]

توضیحات (DESCRIPTION)

یافتن و وارد کردن (ایمپورت) هرگونه پیام جدید به پایگاه‌داده.

دستور new تمام زیرپوشه‌های پایگاه‌داده را پیمایش کرده و نمایه‌سازی تمام‌متنی را روی پیام‌های جدیدِ یافت‌شده انجام می‌دهد. هر پیام جدید به‌طور خودکار با هر دو برچسب inbox و unread نشانه‌گذاری خواهد شد.

شما باید پس از اولین اجرای notmuch <#notmuch-setup-1> جهت ایجاد پایگاه‌داده اولیه، یک بار دستور notmuch new را اجرا کنید. اگر حجم نامه‌های شما زیاد باشد (چندین صد هزار پیام یا بیشتر)، اجرای نخست ممکن است زمان زیادی ببرد. در ادامه، هر زمان که نامه جدیدی دریافت شد و تمایل داشتید آن را به پایگاه‌داده اضافه کنید، باید notmuch new را اجرا نمایید. این اجراهای بعدی بسیار سریع‌تر از اجرای اولیه خواهند بود.

اجرای notmuch بدون هیچ آرگومان دستوری، در صورتی که notmuch <#notmuch-setup-1> قبلاً تکمیل شده باشد ولی notmuch new هنوز اجرا نشده باشد، به صورت خودکار new را اجرا خواهد کرد.

دستور notmuch new در صورت فعال بودن گزینه پیکربندی maildir.synchronize_flags، برچسب‌ها را مطابق با تغییرات پرچم‌های maildir به‌روزرسانی می‌کند. برای جزئیات، notmuch-config <#notmuch-config-1> را ببینید.

دستور new از هوک‌ها (قلاب‌ها) پشتیبانی می‌کند. برای جزئیات بیشتر درباره هوک‌ها، notmuch-hooks <#notmuch-hooks-5> را ببینید.

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

--no-hooks: از اجرای هوک‌ها جلوگیری می‌کند.

--quiet: پیشرفت یا نتایج را چاپ نمی‌کند.

--verbose: نام فایل‌های در حال پردازش را چاپ می‌کند. در صورت ترکیب با --quiet نادیده گرفته می‌شود.

--decrypt=(true|nostash|auto|false)

در صورت تنظیم روی true، هنگام برخورد با یک پیام رمزگذاری‌شده، تلاش می‌کند آن را در حین نمایه‌سازی رمزگشایی کند و کلیدهای نشست (session keys) کشف‌شده را ذخیره نماید. اگر روی auto تنظیم شود، تلاش می‌کند از هر کلید نشستی که از قبل برای این پیام شناخته شده است استفاده کند، اما تلاشی برای استفاده از کلیدهای مخفی کاربر نخواهد کرد. در صورت موفقیت‌آمیز بودن رمزگشایی، متن واضح پیام نمایه‌سازی می‌شود.

توجه داشته باشید که این نمایه به احتمال زیاد برای بازسازی متن واضح خود پیام کافی است (و کلید نشست قطعاً کافی است)، بنابراین لطفاً اطمینان حاصل کنید که نمایه پیام notmuch به میزان کافی محافظت می‌شود. هرگز بدون در نظر گرفتن امنیت نمایه خود از --decrypt=true یا --decrypt=nostash استفاده نکنید.

همچنین index.decrypt را در notmuch-config <#notmuch-config-1> ببینید.

--full-scan: به‌طور پیش‌فرض notmuch-new از زمان آخرین تغییر دایرکتوری (mtime) برای بهینه‌سازی پیمایش دایرکتوری‌ها جهت یافتن نامه‌های جدید استفاده می‌کند. این گزینه آن بهینه‌سازی را غیرفعال می‌کند.

پیکربندی (CONFIGURATION)

نمایه‌سازی تحت تأثیر گزینه‌های پیکربندی index.decrypt <#nmconfig-index.decrypt>، index.header.<prefix> <#nmconfig-index.header.-prefix> و new.ignore <#nmconfig-new.ignore> قرار دارد. برچسب‌گذاری توسط new.tags <#nmconfig-new.tags> و maildir.synchronize_flags <#nmconfig-maildir.synchronize_flags> کنترل می‌شود. برای جزئیات، notmuch-config <#notmuch-config-1> را ببینید.

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

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

75 (EX_TEMPFAIL): یک خطای موقت رخ داد؛ از کاربر خواسته می‌شود دوباره امتحان کند.

همچنین ببینید (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-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>

نویسنده (AUTHOR)

کارل ورث (Carl Worth) و بسیاری دیگر

حق نشر (COPYRIGHT)

2009-2026, Carl Worth and many others