summaryrefslogtreecommitdiffstats
path: root/doc/man/dovecot-sysreport.1.in
blob: e3b30cebf39acb18ea16f0a185d918804d1631a4 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
.\" Copyright (c) 2010-2018 Dovecot authors, see the included COPYING file
.TH DOVECOT-SYSREPORT 1 "2020-01-21" "Dovecot v2.3" "Dovecot"
.SH NAME
dovecot-sysreport \- Dovecot\(aqs system report utility
.\"------------------------------------------------------------------------
.SH SYNOPSIS
.BR dovecot-sysreport " [" \-h|\-\-help "] [" \-c|\-\-core " ["\c
.IR binary "] " core " [...]]"
.BR "[\-d|\-\-destination
.IR dest "]
.BR "[\-k|\-\-keeptemp]
.\"------------------------------------------------------------------------
.SH DESCRIPTION
.B dovecot-sysreport
is a utility that should be used to gather information from the current
system to be reported for dovecot bug fixes. It will collect dovecot's
ps output, service status, process status, uptime command's output,
error log, stats dump and if given, a core file along with its binary
dependencies.
.\"------------------------------------------------------------------------
.SH OPTIONS
.TP
.B \-h|\-\-help
Prints a help message.
.TP
.BI \-c|\-\-config\  root_config_file
Sets the root file of the dovecot's configuration. If not set, it will be
assumed to be in the default configuration path.
.TP
.BI \-o|\-\-core\ [ binary "] " core " [...]]"
Includes core files along with their dependencies extracted from the
specified binary file.
.TP
.BI \-d|\-\-destination\  dest
Sets the file location which the report archive should be put to. The default 
value is dovecot-sysreport-<hostname>-<current_timestamp>.tar.gz in the
current path.
.TP
.B \-k|\-\-keeptemp
If set, temp files would not be deleted at the end.