.\" Copyright (c) 2013-2018 Dovecot authors, see the included COPYING file
.TH DOVEADM\-BATCH 1 "2015-05-09" "Dovecot v2.3" "Dovecot"
.SH "نام (NAME)"
doveadm\-batch \- اجرای چندین دستور برای چندین کاربر
.\"------------------------------------------------------------------------
.SH "خلاصه دستور (SYNOPSIS)"
.BR doveadm " [" \-Dv "] " batch " [" \-S
.IR socket_path "] "
.BI \-A " sep command sep command"
[...]
.br
.\"-------------------------------------
.BR doveadm " [" \-Dv "] " batch " [" \-S
.IR socket_path "] "
.BI \-F " file sep command sep command"
[...]
.br
.\"-------------------------------------
.BR doveadm " [" \-Dv "] " batch " [" \-S
.IR socket_path "] "
.BI \-u " usermask sep command sep command"
[...]
.\"------------------------------------------------------------------------
.SH "توضیحات (DESCRIPTION)"
دستور
.B doveadm batch
برای اجرای متوالی چندین
.IR command
از
.BR doveadm (1)
برای چندین کاربر به کار می‌رود.
این کار در اصل نوعی بهینه‌سازی است که در آن Dovecot می‌تواند تمام عملیات صندوق پستی مربوط به یک کاربر را به‌یک‌باره انجام دهد، به‌جای اینکه نیاز باشد چندین بار در میان کاربران پیمایش کند.
.PP
در شکل نخست،
.BR doveadm (1)
روی تمامی کاربرانی که در
.IR user_db
(های) پیکربندی‌شده تعریف شده‌اند پیمایش کرده و توالی
.IR command ها
را برای هر یک از آن‌ها اجرا می‌کند.
.PP
در شکل دوم،
.BR doveadm (1)
روی تمامی کاربرانی که در
.I file
داده‌شده فهرست شده‌اند پیمایش می‌کند.
.PP
در شکل سوم،
.IR command ها
برای هر کاربری که با
.I usermask
داده‌شده مطابقت داشته باشد اجرا خواهند شد.
.\"------------------------------------------------------------------------
.SH "گزینه‌ها (OPTIONS)"
گزینه‌های عمومی
.BR doveadm (1) :
.TP
.B \-D
پیام‌های با جزئیات و اشکال‌زدایی (debug) را فعال می‌کند.
.TP
.BI \-o\  setting = value
تنظیم پیکربندی
.I setting
را از
.I /etc/dovecot/dovecot.conf
و از userdb با
.IR value
داده‌شده جایگزین می‌کند.
جهت بازنویسی چندین تنظیم، گزینهٔ
.B \-o
می‌تواند چندین بار مشخص شود.
.TP
.B \-v
حالت پرگویی (verbosity)، شامل شمارنده پیشرفت را فعال می‌کند.
.\" --- command specific options --- "/.
.PP
گزینه‌های ویژهٔ دستور:
.\"-------------------------------------
.TP
.B \-A
اگر گزینهٔ
.B \-A
مشخص شده باشد،
.I command
برای تمام کاربران انجام خواهد شد.
استفاده از این گزینه در ترکیب با کاربران سیستمی از
.B userdb { driver = passwd }
توصیه نمی‌شود، زیرا شامل کاربرانی با UID کمتر از مقدار پیکربندی‌شده در تنظیم
.I first_valid_uid
نیز می‌شود.
.sp
هنگام استفاده از ماژول userdb نوع SQL، اطمینان حاصل کنید که تنظیم
.I iterate_query
در
.I /etc/dovecot/dovecot\-sql.conf.ext
با ساختار پایگاه‌داده شما مطابقت داشته باشد.
هنگام استفاده از ماژول LDAP userdb، مطمئن شوید که تنظیمات
.IR iterate_attrs " و " iterate_filter
در
.I /etc/dovecot/dovecot-ldap.conf.ext
با طرحواره (schema) LDAP شما تطابق دارد.
در غیر این صورت
.BR doveadm (1)
قادر به پیمایش روی تمامی کاربران نخواهد بود.
.\"-------------------------------------
.TP
.BI \-F\  file
اجرای
.I command
برای تمامی کاربران موجود در
.IR file .
این گزینه مشابه گزینهٔ
.B \-A
است، اما به‌جای دریافت فهرست کاربران از userdb، آن‌ها از
.IR file
داده‌شده خوانده می‌شوند.
این
.I file
در هر خط شامل یک نام کاربری است.
.\"-------------------------------------
.TP
.BI \-S\  socket_path
آرگومان این گزینه یا یک مسیر مطلق به یک سوکت محلی دامنه یونیکس (UNIX domain socket) است، یا یک نام میزبان و درگاه
.RI ( hostname : port )
جهت اتصال به یک میزبان دوردست از طریق یک سوکت TCP.
.sp
این گزینه به مدیر سیستم اجازه می‌دهد دستورهای ایمیل
.BR doveadm (1)
را از طریق سوکت داده‌شده اجرا کند.
.\"-------------------------------------
.TP
.BI \-u\  user/mask
اجرای
.I command
تنها برای
.IR user
مشخص‌شده.
همچنین استفاده از نویسه‌های عام (wildcard)
.RB \(aq * \(aq
و
.RB \(aq ? \(aq
امکان‌پذیر است (مانند \-u *@example.org).
.br
هنگامی که نه گزینهٔ
.B \-A ،
نه گزینهٔ
.BI \-F\  file
و نه گزینهٔ
.BI \-u\  user
مشخص نشده باشند،
.I command
در محیط کاربری که در حال حاضر وارد سیستم شده است اجرا خواهد شد.
.\"------------------------------------------------------------------------
.SH "آرگومان‌ها (ARGUMENTS)"
.TP
.I command
هر دستوری از
.BR doveadm (1) ،
همراه با آرگومان‌ها و گزینه‌ها \(em به‌جز گزینه‌های
.BR \-A "، " \-S " و " \-u .
.\"-------------------------------------
.TP
.I sep
یک نویسهٔ تکی که به عنوان جداکنندهٔ دستور به کار می‌رود، مانند \(aq:\(aq.
مراقب باشید، نویسه‌های بدون نقل‌قول (unquoted) مانند
.BR ; " یا " &
ممکن است توسط شل شما تفسیر شوند و
.BR doveadm (1)
هرگز آن‌ها را نبیند.
.\"------------------------------------------------------------------------
.SH "مثال‌ها (EXAMPLES)"
در این مثال، ایمیل‌های دیده‌شدهٔ (seen) قدیمی‌تر از یک ماه را برای تمام کاربران example.net به فضای ذخیره‌سازی جایگزین تحت /nfsmount منتقل می‌کنیم:
.br
.nf
mail_location = mdbox:~/mdbox:ALT=/nfsmount/%h/mdbox
.fi
دستور دوم، پیام‌های دارای refcount=0 را از فضای ذخیره‌سازی اصلی حذف خواهد کرد.
.PP
.nf
.ft B
doveadm batch \-u \(rs*@example.net : altmove seen savedbefore 30d : purge
.ft P
.fi
.\"------------------------------------------------------------------------
.SH "گزارش باگ‌ها (BUGS)"
گزارش باگ‌ها، شامل خروجی
.IR "doveconf \-n" ،
را به فهرست پستی Dovecot به نشانی <dovecot@dovecot.org> ارسال کنید.
اطلاعات دربارهٔ گزارش باگ‌ها در نشانی زیر موجود است:
<http://dovecot.org/bugreport.html>
.\"------------------------------------------------------------------------
.SH "همچنین ببینید (SEE ALSO)"
.BR doveadm (1)