.\" Copyright (c) 2014-2018 Dovecot authors, see the included COPYING file
.TH DOVEADM\-REPLICATOR 1 "2014-10-05" "Dovecot v2.3" "Dovecot"
.SH "نام (NAME)"
doveadm\-replicator \- مدیریت همانندسازی ایمیل کاربران
.\"------------------------------------------------------------------------
.SH "خلاصه دستور (SYNOPSIS)"
.BR doveadm " [" \-Dv ]
[\fB\-f\fP \fIformatter\fP]
.BI replicator \ command
.RI [ OPTIONS ]\ [ ARGUMENTS ]
.\"------------------------------------------------------------------------
.SH "توضیحات (DESCRIPTION)"
از
.I COMMANDS
مربوط به
doveadm replicator
می‌توان برای مدیریت همانندسازی خودکار ایمیل کاربران استفاده کرد.
.\"------------------------------------------------------------------------
.SH "گزینه‌ها (OPTIONS)"
.IR گزینه‌های
عمومی
.BR doveadm (1):
.TP
.B \-D
حالت پرگویی (verbosity) و پیام‌های اشکال‌زدایی را فعال می‌کند.
.TP
.BI \-f\  formatter
قالب‌بند
.RI ( formatter )
را برای قالب‌بندی خروجی مشخص می‌کند.
قالب‌بندهای پشتیبانی‌شده عبارتند از:
.RS
.TP
.B flow
هر سطر را به صورت جفت‌های
.IB key = value
چاپ می‌کند.
.TP
.B pager
هر جفت
.IR key :\  value
را در سطر جداگانه‌ای چاپ کرده و رکوردها را با نویسه برگه جدید (form feed)
.RB ( ^L )
از یکدیگر جدا می‌کند.
.TP
.B tab
یک سربرگ جدول و در ادامه سطرهای مقادیر جداشده با تب را چاپ می‌کند.
.TP
.B table
یک سربرگ جدول و در ادامه سطرهای مقادیر تراز شده را چاپ می‌کند.
.RE
.TP
.BI \-o\  setting = value
تنظیم پیکربندی
.I setting
را از
.I /etc/dovecot/dovecot.conf
و از userdb با
.IR value
داده‌شده جایگزین می‌کند.
برای بازنویسی چندین تنظیم، گزینه
.B \-o
می‌تواند چندین بار مشخص شود.
.TP
.B \-v
حالت پرگویی، شامل شمارنده پیشرفت را فعال می‌کند.
.\" --- command specific options --- "/.
.PP
این دستور به‌طور پیش‌فرض از قالب‌بند خروجی
.B flow
(بدون پیشوند
.IR key =
)
استفاده می‌کند.
.PP
.IR گزینه‌های
مختص دستور:
.TP
.BI \-a \ replicator_socket_path
این گزینه برای تعیین یک مسیر مطلق به یک سوکت دامنه یونیکس (UNIX domain socket) جایگزین استفاده می‌شود.
.sp
به‌طور پیش‌فرض
.BR doveadm (1)
از سوکت
.IR /run/dovecot/replicator\-doveadm
استفاده خواهد کرد.
در صورتی که تنظیم پیش‌فرض
.I base_dir
در
.IR /etc/dovecot/dovecot.conf
بازنویسی شده باشد، ممکن است سوکت در دایرکتوری دیگری قرار داشته باشد.
.\"------------------------------------------------------------------------
.SH "آرگومان‌ها (ARGUMENTS)"
.TP
.I user_mask
مشخص می‌کند که دستور باید برای کدام کاربران اجرا شود.
در بیشتر موارد مایل خواهید بود از الگوهایی حاوی نویسه‌های عمومی (wildcard) استفاده کنید؛
مانند \(rs*@example.net برای همه کاربران دامنه example.net، یا صرفاً
\(rs* برای تمام کاربران.
.sp
هنگامی که ماژول SQL userdb استفاده می‌شود، مطمئن شوید که تنظیم
.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)
قادر به پیمایش همه کاربران نخواهد بود.
.\"------------------------------------------------------------------------
.SH "دستورها (COMMANDS)"
.SS replicator add
.B doveadm replicator add
[\fB\-a\fP \fIreplicator_socket_path\fP]
.I user_mask
.PP
کاربر(ان) مشخص‌شده را به replicator اضافه می‌کند.
اگر
.I user_mask
حاوی نویسه‌های عمومی \(dq?\(dq یا \(dq*\(dq باشد، فهرست نام‌های کاربری از
.IR userdb
جستجو می‌شود.
.\"-------------------------------------
.SS replicator dsync\-status
.B doveadm replicator dsync\-status
[\fB\-a\fP \fIreplicator_socket_path\fP]
.PP
وضعیت فرایندهای dsync در حال اجرا را نمایش می‌دهد.
.\"-------------------------------------
.SS replicator remove
.B doveadm replicator remove
[\fB\-a\fP \fIreplicator_socket_path\fP]
.I username
.PP
کاربر مشخص‌شده را از replicator حذف می‌کند.
.\"-------------------------------------
.SS replicator replicate
.B doveadm replicator replicate
[\fB\-a\fP \fIreplicator_socket_path\fP]
.RB [ \-f ]
[\fB\-p\fP \fIpriority\fP]
.I user_mask
.PP
همانندسازی را برای کاربران مشخص‌شده بی‌درنگ آغاز می‌کند.
اگر پارامتر \-f داده شود، همانندسازی کامل برای کاربر انجام خواهد شد.
همچنین می‌توانید اولویت را مشخص کنید که می‌تواند یکی از مقادیر
.B high " یا " low
باشد.
اگر ماسک کاربر شامل نویسه‌های عمومی \(dq?\(dq یا \(dq*\(dq باشد، فهرست نام‌های کاربری از میان کاربرانی که در حال حاضر در replicator وجود دارند (نه از
.IR userdb )
جستجو می‌شود.
.\"-------------------------------------
.SS replicator status
.B doveadm replicator status
[\fB\-a\fP \fIreplicator_socket_path\fP]
.I user_mask
.PP
وضعیت همانندسازی را برای کاربران نمایش می‌دهد.
.\"------------------------------------------------------------------------
.SH "گزارش باگ‌ها (BUGS)"
گزارش‌های باگ، از جمله خروجی
.I doveconf \-n
را به فهرست پستی Dovecot به نشانی <dovecot@dovecot.org> ارسال کنید.
اطلاعات مربوط به گزارش باگ‌ها در نشانی زیر موجود است:
http://dovecot.org/bugreport.html
.\"------------------------------------------------------------------------
.SH "همچنین ببینید (SEE ALSO)"
.BR doveadm (1),
.BR doveadm\-sync (1),
.\"-------------------------------------
.PP
منابع تکمیلی:
.IP "Replication with dsync"
http://wiki2.dovecot.org/Replication