نام (NAME)

doveadm-batch - اجرای چندین دستور برای چندین کاربر

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

doveadm [-Dv] batch [-S socket_path] -A sep command sep command [...]
doveadm [-Dv] batch [-S socket_path] -F file sep command sep command [...]
doveadm [-Dv] batch [-S socket_path] -u usermask sep command sep command [...]

توضیحات (DESCRIPTION)

دستور doveadm batch برای اجرای متوالی چندین command از doveadm(1) برای چندین کاربر به کار می‌رود. این کار در اصل نوعی بهینه‌سازی است که در آن Dovecot می‌تواند تمام عملیات صندوق پستی مربوط به یک کاربر را به‌یک‌باره انجام دهد، به‌جای اینکه نیاز باشد چندین بار در میان کاربران پیمایش کند.

در شکل نخست، doveadm(1) روی تمامی کاربرانی که در user_db (های) پیکربندی‌شده تعریف شده‌اند پیمایش کرده و توالی commandها را برای هر یک از آن‌ها اجرا می‌کند.

در شکل دوم، doveadm(1) روی تمامی کاربرانی که در file داده‌شده فهرست شده‌اند پیمایش می‌کند.

در شکل سوم، commandها برای هر کاربری که با usermask داده‌شده مطابقت داشته باشد اجرا خواهند شد.

گزینه‌ها (OPTIONS)

گزینه‌های عمومی doveadm(1):

-D

پیام‌های با جزئیات و اشکال‌زدایی (debug) را فعال می‌کند.

-o setting=value

تنظیم پیکربندی setting را از /etc/dovecot/dovecot.conf و از userdb با value داده‌شده جایگزین می‌کند. جهت بازنویسی چندین تنظیم، گزینهٔ -o می‌تواند چندین بار مشخص شود.

-v

حالت پرگویی (verbosity)، شامل شمارنده پیشرفت را فعال می‌کند.

گزینه‌های ویژهٔ دستور:

-A

اگر گزینهٔ -A مشخص شده باشد، command برای تمام کاربران انجام خواهد شد. استفاده از این گزینه در ترکیب با کاربران سیستمی از userdb { driver = passwd } توصیه نمی‌شود، زیرا شامل کاربرانی با UID کمتر از مقدار پیکربندی‌شده در تنظیم first_valid_uid نیز می‌شود.

هنگام استفاده از ماژول userdb نوع SQL، اطمینان حاصل کنید که تنظیم iterate_query در /etc/dovecot/dovecot-sql.conf.ext با ساختار پایگاه‌داده شما مطابقت داشته باشد. هنگام استفاده از ماژول LDAP userdb، مطمئن شوید که تنظیمات iterate_attrs و iterate_filter در /etc/dovecot/dovecot-ldap.conf.ext با طرحواره (schema) LDAP شما تطابق دارد. در غیر این صورت doveadm(1) قادر به پیمایش روی تمامی کاربران نخواهد بود.

-F file

اجرای command برای تمامی کاربران موجود در file. این گزینه مشابه گزینهٔ -A است، اما به‌جای دریافت فهرست کاربران از userdb، آن‌ها از file داده‌شده خوانده می‌شوند. این file در هر خط شامل یک نام کاربری است.

-S socket_path

آرگومان این گزینه یا یک مسیر مطلق به یک سوکت محلی دامنه یونیکس (UNIX domain socket) است، یا یک نام میزبان و درگاه (hostname:port) جهت اتصال به یک میزبان دوردست از طریق یک سوکت TCP.

این گزینه به مدیر سیستم اجازه می‌دهد دستورهای ایمیل doveadm(1) را از طریق سوکت داده‌شده اجرا کند.

-u user/mask

اجرای command تنها برای user مشخص‌شده. همچنین استفاده از نویسه‌های عام (wildcard) '*' و '?' امکان‌پذیر است (مانند -u *@example.org).
هنگامی که نه گزینهٔ -A ، نه گزینهٔ -F file و نه گزینهٔ -u user مشخص نشده باشند، command در محیط کاربری که در حال حاضر وارد سیستم شده است اجرا خواهد شد.

آرگومان‌ها (ARGUMENTS)

command

هر دستوری از doveadm(1)، همراه با آرگومان‌ها و گزینه‌ها — به‌جز گزینه‌های -A، -S و -u.

sep

یک نویسهٔ تکی که به عنوان جداکنندهٔ دستور به کار می‌رود، مانند ':'. مراقب باشید، نویسه‌های بدون نقل‌قول (unquoted) مانند ; یا & ممکن است توسط شل شما تفسیر شوند و doveadm(1) هرگز آن‌ها را نبیند.

مثال‌ها (EXAMPLES)

در این مثال، ایمیل‌های دیده‌شدهٔ (seen) قدیمی‌تر از یک ماه را برای تمام کاربران example.net به فضای ذخیره‌سازی جایگزین تحت /nfsmount منتقل می‌کنیم:

mail_location = mdbox:~/mdbox:ALT=/nfsmount/%h/mdbox

دستور دوم، پیام‌های دارای refcount=0 را از فضای ذخیره‌سازی اصلی حذف خواهد کرد.

doveadm batch -u \*@example.net : altmove seen savedbefore 30d : purge

گزارش باگ‌ها (BUGS)

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

همچنین ببینید (SEE ALSO)

doveadm(1)