.TH NBDB_REINDEXD 8
.ad
.fi
.SH "نام (NAME)"
nbdb_reindexd \- سرویس مهاجرت Postfix به پایگاه‌داده‌های غیر Berkeley\-DB
.SH "خلاصه دستور (SYNOPSIS)"
.na
.nf
\fBnbdb_reindexd\fR [generic Postfix daemon options]
.SH "توضیحات (DESCRIPTION)"
.ad
.fi
\fIنکته: این سرویس باید تنها به صورت موقت فعال شود تا اکثر فایل‌های ایندکس‌شدهٔ غیر Berkeley\-DB مورد نیاز Postfix را تولید کند. فعال باقی ماندن این سرویس ممکن است سیستم را در معرض حملات ارتقای سطح دسترسی (privilege escalation) قرار دهد.\fR

سرور \fBnbdb_reindexd\fR(8) درخواست‌های تولید یک فایل پایگاه داده ایندکس‌شدهٔ غیر Berkeley\-DB را برای یک پایگاه داده موجود Berkeley DB (مانند "hash:/path/to/file" یا "btree:/path/to/file") مدیریت می‌کند. این سرویس با اجرای دستور \fBpostmap\fR(1) یا \fBpostalias\fR(1) با مجوزهای مناسب، این فرآیند را پیاده‌سازی می‌نماید.

هنگامی که فایل ایندکس‌شدهٔ غیر Berkeley\-DB از قبل وجود داشته باشد، این سرویس وضعیت موفقیت را گزارش می‌دهد. این وضعیت زمانی رخ می‌دهد که چندین کلاینت درخواست یکسانی ارسال کنند. هنگامی که یک درخواست با موفقیت به پایان می‌رسد، سرویس برای سایر درخواست‌ها نیز وضعیت موفقیت اعلام می‌کند.

این سرویس سیاست‌های ایمنی زیر را اعمال می‌کند:
.IP \(bu
فایل ایندکس‌شدهٔ قدیمی Berkeley DB باید وجود داشته باشد (نام فایل با پسوند ".db" خاتمه می‌یابد). سرویس \fBnbdb_reindexd\fR(8) هنگام اجرای \fBpostmap\fR(1) یا \fBpostalias\fR(1) از شناسه مالک (uid, gid) این فایل استفاده می‌کند. همچنین از این (uid, gid) برای تعدادی از بررسی‌های ایمنی همان‌طور که در ادامه توضیح داده شده، استفاده می‌نماید.
.IP \(bu
فایل منبع ایندکس‌نشده باید وجود داشته باشد (نام فایل بدون پسوند ".db"). این فایل به عنوان ورودی برای \fBpostmap\fR(1) یا \fBpostalias\fR(1) مورد نیاز است. مالکیت فایل باید متعلق به "root" یا شناسه uid بالا باشد و نباید اجازه دسترسی نوشتن به "group" یا "other" داده شود.
.IP \(bu
دایرکتوری والد باید متعلق به "root" یا شناسه uid بالا باشد و نباید اجازه دسترسی نوشتن به "group" یا "other" بدهد.
.IP \(bu
علاوه بر این، پارامتر "non_bdb_migration_allow_root_prefixes" پیشوندهای مجاز دایرکتوری فایل منبع را هنگامی که این سرویس نیاز به اجرای \fBpostmap\fR(1) یا \fBpostalias\fR(1) با دسترسی‌های "root" دارد، محدود می‌کند.
.IP \(bu
پارامتر مشابهی به نام "non_bdb_migration_allow_user_prefixes"، پیشوندهای مجاز دایرکتوری فایل منبع را هنگامی که این سرویس نیاز به اجرای \fBpostmap\fR(1) یا \fBpostalias\fR(1) به عنوان یک کاربر غیرممتاز دارد، محدود می‌سازد.
.SH "امنیت (SECURITY)"
.na
.nf
.ad
.fi
سرور \fBnbdb_reindexd\fR(8) از نظر امنیتی حساس است. این سرور درخواست‌ها را تنها از فرآیندهایی می‌پذیرد که به سوکت‌های زیر \f(CW$queue_directory/private\fR دسترسی داشته باشند (یعنی فرآیندهایی که با دسترسی‌های "root" یا "mail_owner" (معمولاً postfix) اجرا می‌شوند).

بنابراین، تهدید متوجه فرآیند دیمن آسیب‌دیده یا دستکاری‌شدهٔ Postfix است که می‌خواهد از طریق ارسال درخواست‌هایی با نام مسیرهای دست‌ساز، و رقابت (race condition) با سرویس از طریق جابجایی سریع فایل‌ها یا دایرکتوری‌ها، سطح دسترسی خود را ارتقا دهد؛ با این امید که Postfix فریب خورده و یک فایل حساس را با داده‌های تحت کنترل مهاجم بازنویسی کند.

هنگامی که این سرویس \fBpostmap\fR(1) یا \fBpostalias\fR(1) را به عنوان "root" اجرا می‌کند، در صورتی که non_bdb_migration_allow_root_prefixes تنها پیشوندهایی را مشخص کرده باشد که از قبل قابل اعتماد هستند، چنین حملات رقابتی نباید امکان‌پذیر باشند.

اگر اطلاعات کاملی در مورد تمام جداول جستجو (lookup tables) که در فایل‌های پیکربندی Postfix به آن‌ها ارجاع داده شده در دسترس بود، این سرویس می‌توانست تمام درخواست‌های دارای نام مسیرهای دست‌ساز را مسدود کند. متأسفانه در زمانی که به این برنامه نیاز بود، چنین اطلاعاتی در دسترس نبود.
.SH "عیب‌یابی (DIAGNOSTICS)"
.ad
.fi
مشکلات و تراکنش‌ها در \fBsyslogd\fR(8) یا \fBpostlogd\fR(8) ثبت (log) می‌شوند. اگر تلاشی برای ایجاد فایل ایندکس با شکست مواجه شود، این سرویس تلاش خواهد کرد فایل ناقص را حذف کند.
.SH "پارامترهای پیکربندی (CONFIGURATION PARAMETERS)"
.na
.nf
.ad
.fi
تغییرات اعمال‌شده در \fBmain.cf\fR به صورت خودکار شناسایی نمی‌شوند، زیرا فرآیندهای \fBnbdb_reindexd\fR(8) طولانی‌عمر (long\-lived) هستند. پس از هرگونه تغییر در پیکربندی، از دستور "postfix reload" استفاده کنید.

متن زیر تنها خلاصه‌ای از پارامترها را ارائه می‌دهد. برای جزئیات بیشتر شامل مثال‌ها، به \fBpostconf\fR(5) مراجعه کنید.
.SH "کنترل‌های اختصاصی سرویس (SERVICE-SPECIFIC CONTROLS)"
.na
.nf
.ad
.fi
.IP "\fBnon_bdb_migration_level (disable)\fR"
سطح سرویس مهاجرت پایگاه‌داده‌های غیر Berkeley\-DB.
.IP "\fBnon_bdb_migration_allow_root_prefixes (خروجی 'postconf \-d non_bdb_migration_allow_root_prefixes' را ببینید)\fR"
فهرستی از پیشوندهای نام مسیر قابل اعتماد که هنگام نیاز سرویس مهاجرت غیر Berkeley\-DB (\fBnbdb_reindexd\fR(8)) به اجرای دستورات \fBpostmap\fR(1) یا \fBpostalias\fR(1) با دسترسی "root"، باید با آن‌ها مطابقت داشته باشد.
.IP "\fBnon_bdb_migration_allow_user_prefixes (خروجی 'postconf \-d non_bdb_migration_allow_user_prefixes' را ببینید)\fR"
فهرستی از پیشوندهای نام مسیر قابل اعتماد که هنگام نیاز سرویس مهاجرت غیر Berkeley\-DB (\fBnbdb_reindexd\fR(8)) به اجرای دستورات \fBpostmap\fR(1) یا \fBpostalias\fR(1) با دسترسی‌های غیر root، باید با آن‌ها مطابقت داشته باشد.
.SH "کنترل‌های متفرقه (MISCELLANEOUS CONTROLS)"
.na
.nf
.ad
.fi
.IP "\fBconfig_directory (خروجی 'postconf \-d' را ببینید)\fR"
مکان پیش‌فرض فایل‌های پیکربندی main.cf و master.cf در Postfix.
.IP "\fBprocess_id (read\-only)\fR"
شناسه فرآیند (PID) یک دستور یا فرآیند دیمن Postfix.
.IP "\fBprocess_name (read\-only)\fR"
نام فرآیند یک دستور یا فرآیند دیمن Postfix.
.IP "\fBsyslog_facility (mail)\fR"
تسهیلات syslog برای ثبت وقایع Postfix.
.IP "\fBsyslog_name (خروجی 'postconf \-d' را ببینید)\fR"
پیشوندی که به نام فرآیند در رکوردهای syslog اضافه می‌شود؛ به عنوان مثال، "smtpd" به "prefix/smtpd" تبدیل می‌شود.
.IP "\fBservice_name (read\-only)\fR"
نام سرویس master.cf برای یک فرآیند دیمن Postfix.
.SH "همچنین ببینید (SEE ALSO)"
.na
.nf
postfix\-non\-bdb(1), مدیریت مهاجرت
postconf(5), پارامترهای پیکربندی
postlogd(8), ثبت وقایع Postfix
syslogd(8), ثبت وقایع سیستم
.SH "فایل‌های راهنما (README FILES)"
.na
.nf
.ad
.fi
برای یافتن این اطلاعات از «\fBpostconf readme_directory\fR» یا
«\fBpostconf html_directory\fR» استفاده کنید.
.na
.nf
NON_BERKELEYDB_README, راهنمای مهاجرت غیر Berkeley\-DB
.SH "مجوز (LICENSE)"
.na
.nf
.ad
.fi
مجوز Secure Mailer باید همراه با این نرم‌افزار توزیع شود.
.SH "تاریخچه (HISTORY)"
.ad
.fi
.ad
.fi
این سرویس با نسخه 3.11 در Postfix معرفی شد.
.SH "نویسندگان (AUTHORS)"
.na
.nf
Wietse Venema
porcupine.org