huschi.net

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 ser-
           vice
       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" warn-
           ing was logged
       listen_pending
           if the master process is queuing connections that need to  be  dis-
           patched
       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 ser-
           vice start.
GLOBAL OPTIONS
       Global doveadm(1)
       -D
           Enables verbosity and debug messages.
       -O
           Do not read any config file, just use defaults.  The  dovecot_stor-
           age_version  setting  defaults  to  the  latest version, but can be
           overridden with
       -k
           Preserve entire environment for doveadm, not  just  import_environ-
           ment 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/dove-
           cot.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 mul-
           tiple settings, the -o option may be specified multiple times.
       -f formatter
           Specifies  the  formatter for formatting the output. Supported for-
           matters 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 AT dovecot.org>.  Information  about  reporting bugs is available
       at: https://dovecot.org/bugreport.html
SEE ALSO
       doveadm(1), doveadm-process-status(1)
78ffb79                           March 2025         DOVEADM-SERVICE-STATUS(1)