نام (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 وجود دارد. هنگامی که این آرگومان مشخص شود، نتایج به کاربران منطبق محدود می‌شود.

مثال‌ها (EXAMPLES)

نمایش نشست‌های احراز هویت شده، فیلتر شده بر اساس آدرس 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)

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

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

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

doveadm(1), doveadm-kick(1)