Man page or keyword search:   man All Sections 1 - General Commands 2 - System Calls 3 - Subroutines, Functions 4 - Special Files 5 - File Formats 6 - Games and Screensavers 7 - Macros and Conventions 8 - Maintenence Commands 9 - Kernel Interface New Commands Server 4.4BSD AIX Alpinelinux Archlinux Aros BSDOS BSDi Bifrost CentOS Cygwin Darwin Debian DigitalUNIX DragonFly ElementaryOS Fedora FreeBSD Gentoo GhostBSD HP-UX Haiku Hurd IRIX Inferno JazzOS Kali Knoppix LinuxMint MacOSX Mageia Mandriva Manjaro Minix MirBSD NeXTSTEP NetBSD OPENSTEP OSF1 OpenBSD OpenDarwin OpenIndiana OpenMandriva OpenServer OpenSuSE OpenVMS Oracle PC-BSD Peanut Pidora Plan9 QNX Raspbian RedHat Scientific Slackware SmartOS Solaris SuSE SunOS Syllable Tru64 UNIXv7 Ubuntu Ultrix UnixWare Xenix YellowDog aLinux   44335 pages apropos Keyword Search (all sections) Output format html ascii pdf view pdf save postscript

DOVEADM-PROXY(1)		    Dovecot		      DOVEADM-PROXY(1)

NAME
       doveadm-proxy - Handle Dovecot proxy connections

SYNOPSIS
       doveadm [-Dv] [-f formatter] proxy command [OPTIONS] [ARGUMENTS]

DESCRIPTION
       The  doveadm  proxy  commands  are  used to list or kick active Dovecot
       proxy connections.

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 /usr/local/etc/dove‐
	      cot/dovecot.conf and from the userdb with the given  value.   In
	      order to override multiple settings, the -o option may be speci‐
	      fied multiple times.

       -v     Enables verbosity, including progress counter.

       This command uses by default the table output formatter.

       Command specific options:

       -a ipc_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/ipc.
	      The socket may be located in another directory, when the default
	      base_dir	setting was overridden in /usr/local/etc/dovecot/dove‐
	      cot.conf.

ARGUMENTS
       user   Is a user's login name.  Depending on the configuration, a login
	      name  may	 be  for  example jane or john@example.com.  It's also
	      possible to use "*" and "?" wildcards (e.g. *@example.org).

COMMANDS
   proxy kick
       doveadm proxy kick [-a ipc_socket_path] user

       Kick all the connections being proxied for the given user.

   proxy list
       doveadm proxy list [-a ipc_socket_path]

       List all the users currently being proxied.

EXAMPLE
       List all currently active proxy connections:

       doveadm proxy list
       username			   proto src ip		 dest ip     port
       jane@example.net		   imap	 192.168.0.100	 192.168.0.5 143

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.2			  2014-10-07		      DOVEADM-PROXY(1)

Vote for polarhome