diff options
Diffstat (limited to 'network/exim/manpages/exigrep.8')
-rw-r--r-- | network/exim/manpages/exigrep.8 | 69 |
1 files changed, 69 insertions, 0 deletions
diff --git a/network/exim/manpages/exigrep.8 b/network/exim/manpages/exigrep.8 new file mode 100644 index 0000000000..7da4816c42 --- /dev/null +++ b/network/exim/manpages/exigrep.8 @@ -0,0 +1,69 @@ +.\" 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 EXIGREP 8 "March 26, 2003" +.\" 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 +EXIGREP \- Search Exim's main log +.SH SYNOPSIS +.B exigrep +.I [\-l] pattern [log file] ... + +.SH DESCRIPTION +The +.B exigrep +utility is a Perl script that searches one or more main log files for +entries that match a given pattern. +When it finds a match, it extracts all the log entries for the relevant +message, not just those that match the pattern. +Thus, +.B exigrep +can extract complete log entries for a given message, or all mail for a given +user, or for a given host, for example. + +The +.I \-l +flag means \(oqliteral\(cq, that is, treat all characters in the pattern as +standing for themselves. +Otherwise the pattern must be a Perl regular expression. +The pattern match is case-insensitive. +If no file names are given on the command line, the standard input is +read. + +If the location of a +.B zcat +command is known from the definition of ZCAT_COMMAND in Local/Makefile, +.B exigrep +automatically passes any file whose +name ends in COMPRESS_SUFFIX through +.B zcat +as it searches it. + +.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), +.BR perlre (1) + + +.SH AUTHOR +This manual page was stitched together from spec.txt by +Andreas Metzler <ametzler at downhill.at.eu.org>, +for the Debian GNU/Linux system (but may be used by others). |