|
Size: 4461
Comment:
|
← Revision 23 as of 2022-04-26 07:08:41 ⇥
Size: 4800
Comment:
|
| Deletions are marked like this. | Additions are marked like this. |
| Line 7: | Line 7: |
| <p><b>doveadm</b> [<b>-Dv</b>] [<b>-f</b> <i>formatter</i>] <b>who </b>[<b>-1</b>] [<b>-a</b> <i>anvil_socket_path</i>] [<i>user</i>] [<i>ip</i>[<b>/</b><i>mask</i>]]</p> |
<p><b>doveadm</b> [<b>-Dv</b>] [<b>-f</b> <i>formatter</i>] <b>who </b>[<b>-1</b>] [<b>-f</b> <i>passdb_field</i>] [<b>-a</b> <i>anvil_socket_path</i>] [<i>user_mask</i>] [<i>ip</i>[<b>/</b><i>bits</i>]]</p> |
| Line 57: | Line 58: |
| <dt><b>-f </b><i>passdb_field</i></dt> <dd>Alternative username field to use for kicking, as returned by passdb. Only the passdb fields beginning with the <i>user_</i> prefix are tracked.</dd> |
|
| Line 60: | Line 64: |
| <dt><i>ip</i>[<b>/</b><i>mask</i>]</dt> | <dt><i>ip</i>[<b>/</b><i>bits</i>]</dt> |
| Line 63: | Line 67: |
| <dt><i>user</i></dt> <dd>List only users, whose name match <i>user</i>. It's also possible to use wildcards in the |
<dt><i>user_mask</i></dt> <dd>List only users whose login name matches the <i>user_mask</i>, or the altenative username (user_* field) if the <b>-f</b> parameter is used. It's also possible to use wildcards in the |
Doveadm-Who
Name ☜
doveadm-who - Show who is logged in to the Dovecot server
Synopsis ☜
doveadm [-Dv] [-f formatter] who [-1] [-f passdb_field] [-a anvil_socket_path] [user_mask] [ip[/bits]]
Description ☜
The who command is used to show which users from which hosts are currently connected to which service.
Options ☜
Global doveadm(1) options:
- -D
- Enables verbosity and debug messages.
- -f formatter
- Specifies the formatter for formatting the output. Supported formatters are:
-
- flow
- prints each line with key=value pairs.
- pager
- prints each key: value pair on its own line and separates records with form feed character (^L).
- tab
- prints a table header followed by tab separated value lines.
- table
- prints a table header followed by adjusted value lines.
-
- -o setting=value
- Overrides the configuration setting from /etc/dovecot/dovecot.conf and from the userdb with the given value. In order to override multiple settings, the -o option may be specified multiple times.
- -v
- Enables verbosity, including progress counter.
This command uses by default the output formatter table.
Command specific options:
- -1
- Print one line per user and connection. Otherwise the connections are grouped by the username.
- -a anvil_socket_path
- This option is used to specify an alternative socket. The option's argument is either an
absolute path to a local UNIX domain socket, or a hostname and port (hostname:port),
in order to connect a remote host via a TCP socket.
By default doveadm(1) will use the socket /var/run/dovecot/anvil. The socket may be located in another directory, when the default base_dir setting was overridden in /etc/dovecot/dovecot.conf.
- -f passdb_field
- Alternative username field to use for kicking, as returned by passdb. Only the passdb fields beginning with the user_ prefix are tracked.
Arguments ☜
- ip[/bits]
- Specify an ip address or network range, in CIDR notation, to reduce the result to matching connections.
- user_mask
- List only users whose login name matches the user_mask, or the altenative username (user_* field) if the -f parameter is used. It's also possible to use wildcards in the user name.
Example ☜
Show authenticated sessions, filtered by the client's IP address.
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)
Show authenticated sessions, filtered by username.
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)
See Also ☜
doveadm(1), doveadm-kick(1)