table of contents
- experimental 1:2.4.1+dfsg1-1~exp1
| DOVEADM-SERVICE-STATUS(1) | Dovecot | DOVEADM-SERVICE-STATUS(1) |
NAME¶
doveadm-service-status - Show information about dovecot services
SYNOPSIS¶
doveadm [GLOBAL OPTIONS] service status [service [...]]
DESCRIPTION¶
doveadm service status produces a table with a line for each service, containing the following details:
name
the name of the service
process_count
the number of processes actually running for the service
process_avail
the number of additional processes that can be spawned for the service
process_limit
the maximum number of processes that can be active for the service
client_limit
the maximum number of connections that the service will handle simultaneously
throttle_secs
seconds to wait before launching another process when processes are dying unexpectedly early for the service
exit_failure_last
timestamp when the last process was terminated abnormally for the service
exit_failures_in_sec
number of abnormally terminated processes for the service in the last second
last_drop_warning
timestamp when the last time a "dropping client connections" warning was logged
listen_pending
if the master process is queuing connections that need to be dispatched
listening
if service is listening
doveadm_stop
if the service has been stopped by doveadm(1)
process_total
the total number of processes forked for the service since the service start.
GLOBAL OPTIONS¶
Global doveadm(1)
-D
Enables verbosity and debug messages.
-O
Do not read any config file, just use defaults. The dovecot_storage_version setting defaults to the latest version, but can be overridden with
-k
Preserve entire environment for doveadm, not just import_environment setting.
-v
Enables verbosity, including progress counter.
-i instance-name
If using multiple Dovecot instances, choose the config file based on this instance name.
See instance_name setting for more information.
-c config-file
Read configuration from the given config-file. By default it first reads config socket, and then falls back to /etc/dovecot/dovecot.conf. You can also point this to config socket of some instance running compatible version.
-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.
-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.
ARGUMENTS¶
service (optional)
Filters the list according to the specified service or services. By default, all dovecot services are listed.
EXAMPLES¶
doveadm service status
name: fs-auth process_count: 0 process_avail: 0 process_limit: 1 client_limit: 1000 throttle_secs: 0 exit_failure_last: 0 exit_failures_in_sec: 0 last_drop_warning: 0 listen_pending: n listening: y doveadm_stop: n process_total: 0 name: fs-server
REPORTING BUGS¶
Report bugs, including doveconf -n output, to the Dovecot Mailing List ⟨dovecot@dovecot.org⟩. Information about reporting bugs is available at: https://dovecot.org/bugreport.html
SEE ALSO¶
| March 2025 | 78ffb79 |