DOVEADM-AUTH(1) | Dovecot | DOVEADM-AUTH(1) |
doveadm-auth - Flush/lookup/test authentication data
doveadm [-Dv] [-f formatter] auth command [OPTIONS] [ARGUMENTS]
The doveadm auth COMMANDS can be used to perform various authentication related actions.
Global doveadm(1) options:
Command specific options:
doveadm auth cache flush [-a master_socket_path] [user ...]
Flush the authentication cache. By default the cache is flushed for all the users (which can also be done by sending SIGHUP to the auth process). You can also flush the cache for one or more users by providing their usernames.
By default doveadm(1) will use the socket /var/run/dovecot/auth-master. The socket may be located in another directory, when the default base_dir setting was overridden in /etc/dovecot/dovecot.conf.
doveadm auth lookup [-a userdb_socket_path] [-x auth_info] [-f field] user [...]
Similar to doveadm-user(1) command, except it performs a passdb lookup (without authentication) instead of a userdb lookup.
By default doveadm(1) will use the socket /var/run/dovecot/auth-userdb. The socket may be located in another directory, when the default base_dir setting was overridden in /etc/dovecot/dovecot.conf.
doveadm auth test [-a auth_socket_path] [-x auth_info] user [password]
Test authentication for the given user.
By default doveadm(1) will use the socket /var/run/dovecot/auth-client. The socket may be located in another directory, when the default base_dir setting was overridden in /etc/dovecot/dovecot.conf.
This example demonstrates an imap authentication test for user john, assuming the user is connected from the host with the IP address 192.0.2.143.
doveadm auth test -x service=imap -x rip=192.0.2.143 john Password: passdb: john auth succeeded extra fields:
user=john
Report bugs, including doveconf -n output, to the Dovecot Mailing List <dovecot@dovecot.org>. Information about reporting bugs is available at: http://dovecot.org/bugreport.html
2014-10-19 | Dovecot v2.3 |