doveadm-user


SYNOPSIS
       doveadm  [-Dv]  user  [-a userdb_socket_path] [-f field] [-x auth_info]
       user ...

DESCRIPTION
       The user command is used to perform a user lookup - to show what infor-
       mation  Dovecot  sees  about the user(s), or if it exists at all in the
       configured userdb(s).

       The auth_info may be useful when the userdb is for example a SQL  data-
       base  and  you  are  using %variables, like %s or %l, in the user_query
       setting.  Or when you have configured the userdb in a way like this:

       userdb {
         driver = passwd-file
         args = /etc/%s.passwd
       }

OPTIONS
       Global doveadm(1) options:

       -D     Enables verbosity and debug messages.

       -v     Enables verbosity, including progress counter.

       Command specific options:

       -a userdb_socket_path
              This option is used to specify an absolute path to  an  alterna-
              tive UNIX domain socket.

              By   default  doveadm(1)  will  use  the  socket  /var/run/dove-
              cot/auth-userdb.  The socket may be located  in  another  direc-
              tory,  when  the  default  base_dir  setting  was  overridden in
              /etc/dovecot/dovecot.conf.

       -f field
              When this option and the  name  of  a  userdb  field  is  given,
              doveadm(1) will show only the value of the specified field.

       -x auth_info
              auth_info  specifies additional conditions for the user command.
              The auth_info option string has to be given as name=value  pair.
              For multiple conditions the -x option could be supplied multiple
              times.
              Possible names for the auth_info are:

              service
                     The service for which the userdb lookup should be tested.
                     The  value  may  be  the name of a service, commonly used
                     with Dovecot.  For example: imap, pop3 or smtp.

              lip    The local IP address (server) for the test.

EXAMPLE
       Perform a user lookup for the users jane and john@example.com.

       doveadm user jane john@example.com
       userdb: jane
         uid       : 8001
         gid       : 8001
         home      : /home/jane
         mail      : sdbox:~/sdbox
         plugins   : sieve
         quota_rule: *:storage=150M

       userdb: john@example.com
         home      : /srv/mail/8/70312/79832
         uid       : 79832
         gid       : 70312
         mail      : mdbox:~/mdbox

       The next example shows a user lookup, using wildcards.

       doveadm user *.?oe@example.net
       jane.doe@example.net
       judy.roe@example.net
       john.doe@example.net

REPORTING BUGS
       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

SEE ALSO
       doveadm(1)



Dovecot v2.0                      2011-11-04                   DOVEADM-USER(1)
Man Pages Copyright Respective Owners. Site Copyright (C) 1994 - 2017 Hurricane Electric. All Rights Reserved.