summaryrefslogtreecommitdiffstats
path: root/debian/manpages/exiqgrep.8
blob: e4bc925d265f48c8f172d4f9f5e38b9b18fd95ad (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
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
.\"                                      Hey, EMACS: -*- nroff -*-
.\" First parameter, NAME, should be all caps
.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
.\" other parameters are allowed: see man(7), man(1)
.TH EXIQGREP 8 "January 27, 2022"
.\" Please adjust this date whenever revising the manpage.
.\"
.\" Some roff macros, for reference:
.\" .nh        disable hyphenation
.\" .hy        enable hyphenation
.\" .ad l      left justify
.\" .ad b      justify to both left and right margins
.\" .nf        disable filling
.\" .fi        enable filling
.\" .br        insert line break
.\" .sp <n>    insert n+1 empty lines
.\" for manpage-specific macros, see man(7)
.\" \(oqthis text is enclosed in single quotes\(cq
.\" \(lqthis text is enclosed in double quotes\(rq
.SH NAME
exiqgrep \- Search in the exim queue
.SH SYNOPSIS
.B exiqgrep
.I [\-h] [\-C file] [\-f regexp] [\-r regexp] [\-s regexp] [\-y seconds]
[\-o seconds] [\-z] [\-x] [\-G queuename] [\-c] [\-l] [\-i] [\-b] [\-R] [\-a]

.SH DESCRIPTION
The
.B exiqgrep
utility is a Perl script which offers possibilities to grep in the
exim queue output. Unlike exiqsumm, it invokes exim \-bpu itself and
does not need to be invoked in a pipe.

.SH OPTIONS
.TP 10
\fB\-h\fR
Print help
.TP
\fB\-C <config>\fR
Specify which exim.conf to use
.TP
\fB\-E <path>\fR
Specify a path for the exim binary, overriding the built-in one.
.TP
\fB\-f <regexp>\fR
Match sender address (field is \(lq< >\(rq wrapped)
.TP
\fB\-r <regexp>\fR
Match recipient address
.TP
\fB\-s <regexp>\fR
Match against the size field from long output
.TP
\fB\-y <seconds>\fR
Message younger than
.TP
\fB\-o <seconds>\fR
Message older than
.TP
\fB\-z\fR
Frozen messages only (exclude non-frozen)
.TP
\fB\-x\fR
Non-frozen messages only (exclude frozen)
.TP
\fB\-G <queuename>\fR
Match in given queue only
.TP
\fB\-c\fR
Display match count
.TP
\fB\-l\fR
Long Format [Default]
.TP
\fB\-i\fR
Message IDs only
.TP
\fB\-b\fR
Brief Format
.TP
\fB\-R\fR
Reverse order
.TP
\fB\-a\fR
All recipients (including delivered)
.PP
At least one selection option, or either the \fB\-c\fR or \fB\-h\fR option,
must be given.
.SH BUGS
This manual page needs a major re-work. If somebody knows better groff
than us and has more experience in writing manual pages, any patches
would be greatly appreciated.

.SH SEE ALSO
.BR exim (8),
/usr/share/doc/exim4\-base/

.SH AUTHOR
This manual page was stitched together from the source code by Marc
Haber <mh+debian\-packages@zugschlus.de>, using the exiqsumm man page by
Andreas Metzler <ametzler at downhill.at.eu.org>,
for the Debian GNU/Linux system (but may be used by others).