نام (NAME)

doveadm-who - نمایش کاربرانی که به سرور Dovecot وارد شده‌اند

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

doveadm [-Dv] [-f formatter] who [-1] [-a anvil_socket_path] [user] [ip[/mask]]

توضیحات (DESCRIPTION)

دستور who برای نمایش این‌که کدام کاربران از چه میزبان‌هایی در حال حاضر به کدام سرویس متصل هستند، استفاده می‌شود.

گزینه‌ها (OPTIONS)

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

-D: پیام‌های اشکال‌زدایی و پرگویی (verbosity) را فعال می‌کند.
-f formatter: قالب‌بندی‌کننده ( formatter ) را برای قالب‌بندی خروجی مشخص می‌کند. قالب‌بندی‌کننده‌های پشتیبانی‌شده عبارتند از:

flow: هر سطر را با جفت‌های key=value چاپ می‌کند.
pager: هر جفت key: value را در یک سطر جداگانه چاپ می‌کند و رکوردها را با نویسهٔ تغییر صفحه (^L) جدا می‌سازد.
tab: یک سربرگ جدول و به دنبال آن سطرهای مقادیر جداشده با تب را چاپ می‌کند.
table: یک سربرگ جدول و به دنبال آن سطرهای مقادیر تراز شده را چاپ می‌کند.

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

این دستور به‌طور پیش‌فرض از قالب‌بندی خروجی table استفاده می‌کند.

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

-1: یک سطر به ازای هر کاربر و اتصال چاپ می‌کند. در غیر این صورت، اتصالات بر اساس نام کاربری گروه‌بندی می‌شوند.
-a anvil_socket_path: این گزینه برای تعیین یک سوکت جایگزین استفاده می‌شود. آرگومان این گزینه یا یک مسیر مطلق به یک سوکت دامنه یونیکس محلی است، یا یک نام میزبان و درگاه (hostname:port) جهت اتصال به یک میزبان راه دور از طریق یک سوکت TCP.
به‌طور پیش‌فرض doveadm(1) از سوکت /run/dovecot/anvil استفاده می‌کند. هنگامی که تنظیم پیش‌فرض base_dir در /etc/dovecot/dovecot.conf بازنویسی شده باشد، سوکت ممکن است در دایرکتوری دیگری قرار داشته باشد.

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

ip[/mask]: یک آدرس ip یا محدوده شبکه در قالب نمادگذاری CIDR مشخص کنید تا نتایج به اتصالات منطبق محدود شود.
user: تنها کاربرانی را فهرست می‌کند که نام آن‌ها با user تطابق دارد. همچنین امکان استفاده از نویسه‌های عام (wildcard) در نام user وجود دارد.

مثال (EXAMPLE)

نمایش نشست‌های احراز هویت شده، فیلتر شده بر اساس آدرس IP کلاینت.

doveadm who ::1
username                       # proto (pids)        (ips)
jane                           2 imap  (30155 30412) (::1)
doveadm who 192.0.2.0/24
username                        # proto (pids)  (ips)
john@example.com                1 imap  (30257) (192.0.2.34)

نمایش نشست‌های احراز هویت شده، فیلتر شده بر اساس نام کاربری.

doveadm who pvo
username         # proto (pids)                    (ips)
pvo              1 sieve (30343)                   (fd95:4eed:38ba::25)
pvo              4 imap  (25693 25686 25679 25669) (fd95:4eed:38ba::25)
doveadm who ja*
username                    # proto (pids)        (ips)
james                       1 imap  (30091)       (127.0.0.1)
jane                        2 imap  (30155 30412) (::1)

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

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

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

doveadm(1), doveadm-kick(1)