.TH "DOVEADM-KICK" "1" "May 2026" "e5ac02a" "Dovecot"
.SH "نام (NAME)"
\fBdoveadm-kick\fR \- قطع اتصال کاربران بر اساس نام کاربری و/یا نشانی IP
.SH "خلاصه دستور (SYNOPSIS)"
.P
\fBdoveadm\fR \[lB]\fIGLOBAL OPTIONS\fR\[rB] \fBkick\fR \[lB]\fB-a\fR \fIanvil_socket_path\fR\[rB] \[lB]\fB-f\fR \fIpassdb_field\fR\[rB] \[lB]\fB-h\fR \fIdest_host\fR\[rB] \fIuser_mask\fR
.P
\fBdoveadm\fR \[lB]\fIGLOBAL OPTIONS\fR\[rB] \fBkick\fR \[lB]\fB-a\fR \fIanvil_socket_path\fR\[rB] \[lB]\fB-f\fR \fIpassdb_field\fR\[rB] \[lB]\fB-h\fR \fIdest_host\fR\[rB] \fIip\fR \[lB]\fB/\fR \fIbits\fR\[rB]
.P
\fBdoveadm\fR \[lB]\fIGLOBAL OPTIONS\fR\[rB] \fBkick\fR \[lB]\fB-a\fR \fIanvil_socket_path\fR\[rB] \[lB]\fB-f\fR \fIpassdb_field\fR\[rB] \[lB]\fB-h\fR \fIdest_host\fR\[rB] \fIuser_mask\fR \fIip\fR \[lB]\fB/\fR \fIbits\fR\[rB]
.P
\fBdoveadm\fR \[lB]\fIGLOBAL OPTIONS\fR\[rB] \fBkick\fR \[lB]\fB-a\fR \fIanvil_socket_path\fR\[rB] \[lB]\fB-f\fR \fIpassdb_field\fR\[rB] \fB-h\fR \fIdest_host\fR
.SH "توضیحات (DESCRIPTION)"
.P
دستور \fBkick\fR در \fBdoveadm\fR برای قطع اتصال کاربران بر اساس \fIuser_mask\fR و/یا نشانی \fIip\fR که از آن متصل شده‌اند، به کار می‌رود.
.P
در حالت نخست، اتصال تمام کاربرانی که نام ورود آن‌ها با آرگومان \fIuser_mask\fR مطابقت دارد، قطع خواهد شد.
.P
در حالت دوم، اتصال تمام کاربرانی که از نشانی IP یا محدوده شبکه داده‌شده متصل هستند، قطع خواهد شد.
.P
در حالت سوم، تنها اتصال کاربرانی قطع خواهد شد که هم از نشانی IP یا محدوده شبکه داده‌شده متصل باشند و هم نام ورود آن‌ها با مشخصات همخوانی داشته باشد.
.P
در حالت آخر، تمام اتصال‌های پراکسی به میزبان مقصد داده‌شده قطع می‌شوند.
.SH "گزینه‌های سراسری (GLOBAL OPTIONS)"
.P
\fIگزینه‌های\fR سراسری doveadm(1):
.P
\fB-D\fR
.RS 0
.RS 4
.P
حالت \fIپُرگویی\fR و پیام‌های اشکال‌زدایی را فعال می‌کند.
.RE 0

.RE 0

.P
\fB-O\fR
.RS 0
.RS 4
.P
هیچ فایل پیکربندی‌ای را نخوانده و صرفاً از مقادیر پیش‌فرض استفاده می‌کند. تنظیم \fBdovecot_storage_version\fR به‌طور پیش‌فرض روی آخرین نسخه قرار دارد، اما می‌توان آن را با \fB-o\fR بازنویسی کرد.
.RE 0

.RE 0

.P
\fB-k\fR
.RS 0
.RS 4
.P
تمام متغیرهای محیط را برای doveadm حفظ می‌کند، نه فقط تنظیمات \fBimport_environment\fR را.
.RE 0

.RE 0

.P
\fB-v\fR
.RS 0
.RS 4
.P
حالت پرگویی، شامل شمارنده پیشرفت را فعال می‌کند.
.RE 0

.RE 0

.P
\fB-i\fR \fIinstance-name\fR
.RS 0
.RS 4
.P
در صورت استفاده از چند نمونه‌ی Dovecot، فایل پیکربندی را بر اساس این نام نمونه انتخاب می‌کند.
.P
برای اطلاعات بیشتر، تنظیم \fBinstance_name\fR را ببینید.
.RE 0

.RE 0

.P
\fB-c\fR \fIconfig-file\fR
.RS 0
.RS 4
.P
پیکربندی را از \fIconfig-file\fR داده‌شده می‌خواند. به‌طور پیش‌فرض ابتدا سوکت پیکربندی را می‌خواند و در صورت عدم دسترسی به \fI/etc/dovecot/dovecot.conf\fR رجوع می‌کند. همچنین می‌توانید آن را به سوکت پیکربندی نمونه‌ای که نسخه سازگار را اجرا می‌کند هدایت کنید.
.RE 0

.RE 0

.P
\fB-o\fR \fIsetting\fR\fB=\fR\fIvalue\fR
.RS 0
.RS 4
.P
تنظیمات پیکربندی (\fIsetting\fR) را از \fI/etc/dovecot/dovecot.conf\fR و از userdb با مقدار داده‌شده (\fIvalue\fR) بازنویسی می‌کند. برای بازنویسی چندین تنظیم، می‌توان گزینه \fB-o\fR را چندین بار مشخص کرد.
.RE 0

.RE 0

.SH "گزینه‌ها (OPTIONS)"
.P
\fB-a\fR \fIanvil_socket_path\fR
.RS 0
.RS 4
.P
این گزینه برای تعیین یک مسیر مطلق به یک سوکت دامنه یونیکس (UNIX domain socket) جایگزین به کار می‌رود.
.P
به‌طور پیش‌فرض doveadm(1) از سوکت \fI/rundir/anvil\fR استفاده خواهد کرد. در صورتی که تنظیم پیش‌فرض \fIbase_dir\fR در \fI/etc/dovecot/dovecot.conf\fR بازنویسی شده باشد، ممکن است سوکت در دایرکتوری دیگری قرار گرفته باشد.
.RE 0

.RE 0

.P
\fB-f\fR \fIpassdb_field\fR
.RS 0
.RS 4
.P
فیلد نام کاربری جایگزین برای استفاده جهت قطع اتصال، همان‌گونه که توسط passdb بازگردانده شده است. تنها فیلدهای passdb که با پیشوند \fIuser_\fR آغاز می‌شوند ردیابی می‌گردند.
.RE 0

.RE 0

.P
\fB-h\fR \fIdest_host\fR
.RS 0
.RS 4
.P
قطع اتصال‌های پراکسی به \fIdest_host\fR داده‌شده.
.RE 0

.RE 0

.SH "آرگومان‌ها (ARGUMENTS)"
.P
\fIip\fR \[lB]/\fIbits\fR\[rB]
.RS 0
.RS 4
.P
\fIip\fR یا \fIip\fR \fB/\fR \fIbits\fR میزبان یا شبکه‌ای است که کاربران از آن متصل شده‌اند.
.RE 0

.RE 0

.P
\fIuser_mask\fR
.RS 0
.RS 4
.P
نام ورود یک کاربر است، یا در صورت استفاده از پارامتر \fB-f\fR، نام کاربری جایگزین (فیلد user_*) است. بسته به پیکربندی، نام ورود ممکن است برای نمونه \fBjane\fR یا \fB\fI\(lajohn@example.com\(ra\fB\fR باشد. همچنین امکان استفاده از نویسه‌های عام (wildcards) '*\fB\fB' و '\fB?\fR' نیز وجود دارد (مانند \-u *@example.org).
.RE 0

.RE 0

.SH "مثال‌ها (EXAMPLES)"
.P
اگر نمی‌خواهید اتصال تمام کاربران را به‌یک‌باره قطع کنید، می‌توانید بررسی کنید چه کسانی هم‌اکنون وارد سیستم شده‌اند. نخستین مثال نشان می‌دهد چگونه اتصال تمام کاربرانی را که طول نام ورود آن‌ها ۳ نویسه بوده و با \fBba\fR آغاز می‌شود، قطع کنید:
.P
.RS 2
.nf
doveadm who -1 ja\[rs]*
.fi
.RE
.P
.RS 2
.nf
username                      service pid ip
jane                          imap   8192 ::1
jano                          imap   8196 ::2
james                         imap   8203 2001:db8:543:2::1
.fi
.RE
.P
.RS 2
.nf
doveadm kick jan?
# The connections for jane and jano are kicked.
.fi
.RE
.P
مثال بعدی نشان می‌دهد چگونه اتصال‌های کاربر foo را از نشانی‌های *192.0.2 قطع کنید:
.P
.RS 2
.nf
doveadm who -1 foo
.fi
.RE
.P
.RS 2
.nf
username                     service pid ip
foo                          imap   8135 fd95:4eed:38ba::25
foo                          imap   9112 192.0.2.53
foo                          imap   8216 192.0.2.111
.fi
.RE
.P
.RS 2
.nf
doveadm kick foo 192.0.2.0/24
doveadm who f\[rs]*
.fi
.RE
.P
.RS 2
.nf
username                  # service (pids) (ips)
foo                       1 imap    (8135) (fd95:4eed:38ba::25)
.fi
.RE
.SH "گزارش باگ‌ها (BUGS)"
.P
گزارش باگ‌ها، از جمله خروجی \fIdoveconf -n\fR را به فهرست پستی Dovecot به نشانی \fI\(ladovecot@dovecot.org\(ra\fR ارسال کنید. اطلاعات بیشتر درباره گزارش باگ‌ها در این نشانی در دسترس است: \fI\(lahttps://dovecot.org/bugreport.html\(ra\fR
.SH "همچنین ببینید (SEE ALSO)"
.P
doveadm(1)