DOVEADM-INSTANCE(1) Dovecot DOVEADM-INSTANCE(1)

doveadm-instance - مدیریت فهرست نمونه‌های در حال اجرای Dovecot

doveadm [-Dv] [-f formatter] instance list
doveadm [-Dv] instance remove name | base_dir

دستورهای doveadm instance برای مدیریت فهرست نمونه‌های (instances) در حال اجرای Dovecot بر روی سرور استفاده می‌شوند. در بیشتر موارد نصب تنها یک نمونه از Dovecot وجود دارد، اما در برخی شرایط داشتن چندین نمونه می‌تواند مفید باشد (مانند اجرای یک پروکسی director و یک سرور backend روی سروری یکسان).

نمونه‌ها هنگام شروع به کار Dovecot به‌طور خودکار به این فهرست اضافه می‌شوند. هر نمونه به‌طور یکتا با تنظیم base_dir خود شناسایی می‌شود. همچنین می‌توان برای نمونه‌ها با تنظیم instance_name در فایل dovecot.conf هر نمونه، یک نام تعیین کرد. هنگامی که یک نمونه نام‌گذاری شود، می‌توان با ارسال پارامتر خط فرمان -i instance_name به باینری‌های Dovecot (مانند doveadm)، به‌سادگی به آن دسترسی پیدا کرد.

گزینه‌های سراسری doveadm(1):

پیام‌های اشکال‌زدایی (debug) و حالت پرگویی را فعال می‌کند.
قالب‌بند (formatter) را برای قالب‌بندی خروجی مشخص می‌کند. قالب‌بندهای پشتیبانی‌شده عبارتند از:
هر سطر را با جفت‌های key=value چاپ می‌کند.
هر جفت key: value را در یک سطر جداگانه چاپ کرده و رکوردها را با نویسهٔ فرم‌فید (form feed) (^L) از هم جدا می‌کند.
یک سربرگ جدول و به دنبال آن سطرهایی با مقادیر جداشده با تب (tab) را چاپ می‌کند.
یک سربرگ جدول و به دنبال آن سطرهایی با مقادیر تراز‌شده چاپ می‌کند.
تنظیم پیکربندی setting از /etc/dovecot/dovecot.conf و از userdb را با مقدار داده‌شدهٔ value بازنویسی می‌کند. جهت بازنویسی چندین تنظیم، می‌توان گزینهٔ -o را چندین بار مشخص کرد.
حالت پرگویی، شامل شمارندهٔ پیشرفت را فعال می‌کند.

مقدار تنظیم instance_name یک نمونه.
دایرکتوری پایه (base directory) یک نمونه از Dovecot.

doveadm instance list

این دستور نمونه‌های شناخته‌شدهٔ Dovecot را فهرست می‌کند.

doveadm instance remove name | base_dir

این دستور نمونهٔ مشخص‌شده را از فهرست نمونه‌های در حال اجرا حذف می‌کند.

گزارش باگ‌ها، شامل خروجی doveconf -n را به فهرست پستی Dovecot به نشانی <dovecot@dovecot.org> ارسال کنید. اطلاعات دربارهٔ نحوهٔ گزارش باگ‌ها در این نشانی در دسترس است: http://dovecot.org/bugreport.html

doveadm(1)

2012-02-16 Dovecot v2.3