نام (NAME)

doveadm-kick - قطع اتصال کاربران بر اساس نام کاربری و/یا نشانی IP

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

doveadm [GLOBAL OPTIONS] kick [-a anvil_socket_path] [-f passdb_field] [-h dest_host] user_mask

doveadm [GLOBAL OPTIONS] kick [-a anvil_socket_path] [-f passdb_field] [-h dest_host] ip [/ bits]

doveadm [GLOBAL OPTIONS] kick [-a anvil_socket_path] [-f passdb_field] [-h dest_host] user_mask ip [/ bits]

doveadm [GLOBAL OPTIONS] kick [-a anvil_socket_path] [-f passdb_field] -h dest_host

توضیحات (DESCRIPTION)

دستور kick در doveadm برای قطع اتصال کاربران بر اساس user_mask و/یا نشانی ip که از آن متصل شده‌اند، به کار می‌رود.

در حالت نخست، اتصال تمام کاربرانی که نام ورود آن‌ها با آرگومان user_mask مطابقت دارد، قطع خواهد شد.

در حالت دوم، اتصال تمام کاربرانی که از نشانی IP یا محدوده شبکه داده‌شده متصل هستند، قطع خواهد شد.

در حالت سوم، تنها اتصال کاربرانی قطع خواهد شد که هم از نشانی IP یا محدوده شبکه داده‌شده متصل باشند و هم نام ورود آن‌ها با مشخصات همخوانی داشته باشد.

در حالت آخر، تمام اتصال‌های پراکسی به میزبان مقصد داده‌شده قطع می‌شوند.

گزینه‌های سراسری (GLOBAL OPTIONS)

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

-D

حالت پُرگویی و پیام‌های اشکال‌زدایی را فعال می‌کند.

-O

هیچ فایل پیکربندی‌ای را نخوانده و صرفاً از مقادیر پیش‌فرض استفاده می‌کند. تنظیم dovecot_storage_version به‌طور پیش‌فرض روی آخرین نسخه قرار دارد، اما می‌توان آن را با -o بازنویسی کرد.

-k

تمام متغیرهای محیط را برای doveadm حفظ می‌کند، نه فقط تنظیمات import_environment را.

-v

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

-i instance-name

در صورت استفاده از چند نمونه‌ی Dovecot، فایل پیکربندی را بر اساس این نام نمونه انتخاب می‌کند.

برای اطلاعات بیشتر، تنظیم instance_name را ببینید.

-c config-file

پیکربندی را از config-file داده‌شده می‌خواند. به‌طور پیش‌فرض ابتدا سوکت پیکربندی را می‌خواند و در صورت عدم دسترسی به /etc/dovecot/dovecot.conf رجوع می‌کند. همچنین می‌توانید آن را به سوکت پیکربندی نمونه‌ای که نسخه سازگار را اجرا می‌کند هدایت کنید.

-o setting=value

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

گزینه‌ها (OPTIONS)

-a anvil_socket_path

این گزینه برای تعیین یک مسیر مطلق به یک سوکت دامنه یونیکس (UNIX domain socket) جایگزین به کار می‌رود.

به‌طور پیش‌فرض doveadm(1) از سوکت /rundir/anvil استفاده خواهد کرد. در صورتی که تنظیم پیش‌فرض base_dir در /etc/dovecot/dovecot.conf بازنویسی شده باشد، ممکن است سوکت در دایرکتوری دیگری قرار گرفته باشد.

-f passdb_field

فیلد نام کاربری جایگزین برای استفاده جهت قطع اتصال، همان‌گونه که توسط passdb بازگردانده شده است. تنها فیلدهای passdb که با پیشوند user_ آغاز می‌شوند ردیابی می‌گردند.

-h dest_host

قطع اتصال‌های پراکسی به dest_host داده‌شده.

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

ip [/bits]

ip یا ip / bits میزبان یا شبکه‌ای است که کاربران از آن متصل شده‌اند.

user_mask

نام ورود یک کاربر است، یا در صورت استفاده از پارامتر -f، نام کاربری جایگزین (فیلد user_*) است. بسته به پیکربندی، نام ورود ممکن است برای نمونه jane یا ⟨john@example.com⟩ باشد. همچنین امکان استفاده از نویسه‌های عام (wildcards) '*' و '?' نیز وجود دارد (مانند -u *@example.org).

مثال‌ها (EXAMPLES)

اگر نمی‌خواهید اتصال تمام کاربران را به‌یک‌باره قطع کنید، می‌توانید بررسی کنید چه کسانی هم‌اکنون وارد سیستم شده‌اند. نخستین مثال نشان می‌دهد چگونه اتصال تمام کاربرانی را که طول نام ورود آن‌ها ۳ نویسه بوده و با ba آغاز می‌شود، قطع کنید:

doveadm who -1 ja\*

username                      service pid ip
jane                          imap   8192 ::1
jano                          imap   8196 ::2
james                         imap   8203 2001:db8:543:2::1

doveadm kick jan?
# The connections for jane and jano are kicked.

مثال بعدی نشان می‌دهد چگونه اتصال‌های کاربر foo را از نشانی‌های *192.0.2 قطع کنید:

doveadm who -1 foo

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

doveadm kick foo 192.0.2.0/24
doveadm who f\*

username                  # service (pids) (ips)
foo                       1 imap    (8135) (fd95:4eed:38ba::25)

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

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

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

doveadm(1)